Skills Reference

Reference for installing Hyperstack agent skills manually. For an overview of how skills, the CLI, and agent.md fit together, see Agent Skills.

The universal install command (auto-detects your editor):

npx skills add usehyperstack/skills

---

Per-Editor Installation

Cursor

npx skills add usehyperstack/skills --agent cursor

Files are created in .agents/skills/:

.agents/skills/
├── hyperstack/SKILL.md
├── hyperstack-consume/SKILL.md
└── hyperstack-build/SKILL.md

Allow CLI access

When Cursor asks to run hs explore, approve it.

Claude Code

npx skills add usehyperstack/skills --agent claude-code

Files are created in .claude/skills/:

.claude/skills/
├── hyperstack/SKILL.md
├── hyperstack-consume/SKILL.md
└── hyperstack-build/SKILL.md

You can also set project-level context in CLAUDE.md at the project root.

Windsurf

npx skills add usehyperstack/skills --agent windsurf

Files are created in .windsurf/skills/:

.windsurf/skills/
├── hyperstack/SKILL.md
├── hyperstack-consume/SKILL.md
└── hyperstack-build/SKILL.md

OpenCode

npx skills add usehyperstack/skills --agent opencode

Files are created in .agents/skills/. You can also load skills directly using the /skill command in OpenCode.

GitHub Copilot

npx skills add usehyperstack/skills --agent github-copilot

Files are created in .agents/skills/.

Cline

npx skills add usehyperstack/skills --agent cline

Files are created in .cline/skills/.

Other

npx skills supports 35+ agents:

Agent	Flag
Codex	--agent codex
Gemini CLI	--agent gemini-cli
Roo Code	--agent roo
Goose	--agent goose
Continue	--agent continue

If your editor isn’t listed, manually copy the SKILL.md files from the skills repository into whatever directory your editor reads custom context from.

---

Verifying Installation

Ask your agent:

What stacks are available on Hyperstack? Show me the entities and fields for the ore stack.

The agent should run hs explore --json, then hs explore ore --json, and present the entity names, field paths, and types. If it doesn’t recognise Hyperstack commands, check that the skill files are in the correct directory for your editor.

---

Updating Skills

npx skills add usehyperstack/skills

This overwrites existing skill files with the latest versions. The static patterns (SDK syntax, DSL macros) change rarely — dynamic data (entity schemas, field types) always comes from hs explore at runtime, so it’s always current regardless of skill version.