@handsontable/hyperformula-skill

An agent skill for HyperFormula — the headless, open-source TypeScript spreadsheet calculation engine. It gives any AI coding agent deep, task-oriented knowledge of HyperFormula so the agent can help you integrate, configure, and debug the engine faster.

This package is the npm distribution of the hyperformula skill maintained in handsontable/handsontable-skills. The package version tracks the HyperFormula product version the skill targets (e.g. 3.3.0 targets HyperFormula 3.3.0).

What's in the package

A self-contained skill — plain markdown, no runtime dependencies:

SKILL.md        ← entry point: concepts, routing, and a docs map (YAML frontmatter + body)
references/     ← task-oriented deep-dives the agent reads on demand

SKILL.md follows the Agent Skills layout (a YAML frontmatter block with name/description, followed by markdown instructions). Any agent that can load a skill — or simply read a folder of markdown instructions — can use it.

Install

npm install @handsontable/hyperformula-skill

The installed package lives at node_modules/@handsontable/hyperformula-skill. Resolve that path programmatically with:

node -p "require.resolve('@handsontable/hyperformula-skill/SKILL.md')"

Then make the skill available to your agent using whichever of the following matches it:

Claude Code

Copy the package into a skills directory. User scope (available in every project):

cp -r node_modules/@handsontable/hyperformula-skill ~/.claude/skills/hyperformula

Or project scope, from your project root:

cp -r node_modules/@handsontable/hyperformula-skill .claude/skills/hyperformula

Claude API

Upload the package contents (SKILL.md + references/) to the Skills API.

OpenAI Codex

Codex discovers skills as folders containing a SKILL.md, under ~/.agents/skills (available in every repo) or .agents/skills in a repo (checked in for your team). Copy the package into one of those locations:

# User scope — available in every repo
cp -r node_modules/@handsontable/hyperformula-skill ~/.agents/skills/hyperformula

# Repo scope — from your project root
cp -r node_modules/@handsontable/hyperformula-skill .agents/skills/hyperformula

Codex also follows symlinked skill folders, so you can instead link the installed package and let npm install keep it current:

ln -s "$PWD/node_modules/@handsontable/hyperformula-skill" ~/.agents/skills/hyperformula

Any other agent

Most coding agents support a skills, rules, or knowledge directory. Copy (or symlink) the package folder into it, for example:

# Replace <agent-skills-dir> with your agent's skills/knowledge directory
cp -r node_modules/@handsontable/hyperformula-skill <agent-skills-dir>/hyperformula

If your agent reads a single instruction file rather than a folder, point it at SKILL.md; it links the files under references/ so the agent can pull them in as needed. For RAG / vector-store setups, ingest SKILL.md together with every file under references/ (the repository also publishes a pre-flattened hyperformula-rag.md for this case).

Other distribution formats

The same skill source is also shipped as a drag-and-drop .zip (Cowork / Claude.ai web), a flattened -rag.md doc (RAG / vector stores), and a Claude Code plugin marketplace entry. See the repository README for details.

License

MIT — see the repository. HyperFormula itself is separately licensed (GPLv3 or commercial); see the licensing guide.