superskill

Multi-agent skill, command, subagent, hook, and MCP config distribution and authoring CLI. Install a Claude Code plugin to any coding agent, and create / validate / evaluate / refine / evolve agent-facing content from the command line.

Install

npm i -g @gobing-ai/superskill

# or go with bun
bun add -g @gobing-ai/superskill

From source (contributors):

proto use          # install pinned tool versions (Bun, etc.)
bun install
bun run build
cd apps/cli && bun link

Requires Bun ≥ 1.3.14. See Installation guide for details and troubleshooting.

Quick start

# Distribute a plugin cc in current repo to every supported target
superskill install cc --targets all

# Author a skill: scaffold → validate → evaluate → refine
superskill skill scaffold my-skill --description "Deploy a Cloudflare Worker"
superskill skill validate my-skill
superskill skill evaluate my-skill --save
superskill skill refine my-skill --auto

# Package a skill for distribution, or merge skills
superskill skill package my-skill
superskill skill migrate ./source-skill-1 ./source-skill-2 ./dest-skill

# Emit a hook to a single target agent
superskill hook emit my-hook --target pi

Full walkthrough: Quick start guide.

Supported agents

| Agent | Skills | Commands | Subagents | Hooks | |-------|:------:|:--------:|:---------:|:-----:| | Claude Code | ✓ | ✓ | ✓ | ✓ | | Codex | ✓ | ✓ | ✓ | — | | Pi | ✓ | ✓ | ✓ | — | | omp | ✓ | ✓ | ✓ | — | | OpenCode | ✓ | ✓ | ✓ | — | | Antigravity IDE | ✓ | ✓ | — | — | | Antigravity CLI | ✓ | — | — | — | | Hermes | ✓ | ✓ | — | ✓ | | OpenClaw | ✓ | — | — | — |

See entity locations for the exact install directories per agent.

Agents that don't natively support some entity types still get them. superskill install adapts commands and subagents as Skills 2.0 skill directories for targets that lack them — so every agent receives the full plugin surface, regardless of native feature set.

Commands

| Command | What it does | Docs | |---------|-------------|------| | install | Distribute a plugin's skills, commands, subagents, hooks, MCP to target agents | cmd_install.md | | agent | Manage subagent definitions (scaffold / validate / evaluate / refine / evolve) | cmd_agent.md | | skill | Manage skill definitions (+ package, migrate) | cmd_skill.md | | command | Manage slash command definitions | cmd_command.md | | hook | Manage hook definitions (+ emit) | cmd_hook.md | | magent | Manage main-agent configurations | cmd_magent.md |

The five type commands share a common lifecycle: scaffold → validate → evaluate → refine → evolve, with type-specific quality dimensions and rubrics.

Further reading

| Topic | Document | |-------|----------| | Full help index | docs/help/index.md | | Quality system (rubrics, scoring, evolve gate) | docs/help/quality_system.md | | Entity locations per target agent | docs/help/entity_locations.md | | Bundled cc plugin | docs/help/bundled_plugin.md | | Development guide (stack, build, tests) | docs/help/development.md | | Architecture decisions (authoritative) | docs/00_ADR.md | | Product scope | docs/01_PRD.md | | CLI surface reference | docs/04_DESIGN.md |

License

Apache 2.0