swarmskills

A CLI and MCP server for managing skills across ~45 code CLI agents.

• Multi-agent: Claude Code, Cursor, Codex, Goose, Gemini CLI, OpenCode, GitHub Copilot, Windsurf, OpenHands, Qwen Code, Cline, Continue, Crush, iFlow, Junie, Kiro, Kode, Roo Code, Kilo Code, Antigravity, Amp, Droid, Firebender, Replit, Warp, Augment, Bob, CodeBuddy, Command Code, Cortex Code, Deep Agents, Kimi, MCPJam, Mistral Vibe, OpenClaw, TRAE, TRAE CN, Mux, Neovate, Pi, Pochi, Qoder, Zencoder, AdaL, Hermes — plus user-defined custom tools.

• CLI: list, show, search, sync skills across tools; manage Claude Code plugins and marketplaces.

• MCP server: 18 tools that let Claude (or any MCP client) discover, install, enable, and sync skills mid-session.

All agents use the same SKILL.md + YAML-frontmatter format; swarmskills knows where each one looks for them.

Install

npm install -g swarmskills

Requires Node.js 20+.

Related MCP server: aiskillstore

CLI usage

Multi-agent

# See every supported tool and which ones are detected on this machine
swarmskills tools list
swarmskills tools list --detected
swarmskills tools detect cursor

# List skills for a specific tool
swarmskills list --tool=cursor
swarmskills list --tool=goose

# List skills across every detected tool
swarmskills list --skills --all-tools

# Search across every detected tool
swarmskills search "test driven" --tool=all

# Show a skill's content from a non-Claude tool
swarmskills show my-skill --tool=cursor

# Register a custom tool
swarmskills tools add-custom myagent /abs/path/to/skills --name "My Agent"
swarmskills tools remove-custom myagent

Set a default tool

Tired of typing --tool=cursor every time? Pick a default and list, show, search (without --tool) will use it.

# Interactive picker — shows every detected tool, you choose one
swarmskills tools set-default

# Or pass the key directly
swarmskills tools set-default cursor
swarmskills tools set-default all              # default to cross-tool discovery

swarmskills tools get-default                  # show effective default + sources
swarmskills tools clear-default                # revert to claude-code

Resolution precedence (highest first):

1. Explicit --tool=<key> flag on the command

2. SWARMSKILLS_DEFAULT_TOOL environment variable

3. defaults.tool in ~/.config/swarmskills/config.json

4. claude-code

Sync skills across tools

# Mirror a skill from Claude Code into Cursor + Goose (symlink by default)
swarmskills sync my-skill --from claude-code --to cursor,goose

# Mirror every skill from one tool to another
swarmskills sync --all --from claude-code --to cursor

# Force overwrite, copy instead of symlinking
swarmskills sync my-skill --from claude-code --to cursor --copy --force

Claude Code plugins (Claude-only)

swarmskills list                                # plugins + skills for Claude Code
swarmskills enable superpowers@claude-plugins-official
swarmskills disable superpowers@claude-plugins-official
swarmskills install superpowers@claude-plugins-official
swarmskills marketplace list
swarmskills marketplace add my-marketplace owner/repo
swarmskills marketplace refresh claude-plugins-official

MCP server usage

Add to your MCP config (~/.claude.json or project .mcp.json or any other MCP-aware client):

{
  "mcpServers": {
    "swarmskills": {
      "command": "npx",
      "args": ["-y", "swarmskills-mcp"]
    }
  }
}

The server exposes 18 tools:

Restart caveat: Most CLI agents read their skill state at session start. Mutating tools (enable, install, sync) return requiresRestart: true — restart the affected agent for changes to take effect.

For HTTP transport instead of stdio:

swarmskills-mcp-http --port 4100

Supported tools (built-in)

Path list cribbed from xingkongliang/skills-manager — credit where due.

.config/... paths also honour XDG_CONFIG_HOME when set. Need a tool that's not on this list? swarmskills tools add-custom <key> <skillsDir>.

How it works

For each tool, swarmskills resolves the on-disk skills directory and parses the YAML frontmatter from each SKILL.md. Claude Code additionally has plugin-bundled skills under ~/.claude/plugins/cache/<marketplace>/<plugin>/skills/, surfaced via the same list_skills API.

State managed:

• ~/.claude/skills/ — Claude Code standalone skills

• ~/.claude/plugins/installed_plugins.json — Claude plugin registry

• ~/.claude/plugins/known_marketplaces.json — Claude marketplace registry

• ~/.claude/settings.json enabledPlugins — Claude per-plugin enabled flags

• ~/.config/swarmskills/config.json — swarmskills's own config (custom tools, defaults)

All writes are atomic (write to .tmp then rename).

To run against a non-default home for testing:

SWARMSKILLS_HOME=/path/to/fake-home swarmskills tools list

Development

pnpm install
pnpm test
pnpm build

License

MIT © SwarmClaw AI