skillpack

A package manager for skills.sh that reads from a skillpack.yaml file and batch-installs skills to AI agents.

Installation

npm install -g skillpack

Or run directly with npx:

npx skillpack install

Quick Start

1. Create a skillpack.yaml in your project:

skillpack init

2. Edit the file to add your skills:

agents:
  - claude-code
  - antigravity
  - cursor

skills:
  vercel-labs/agent-skills:
    - vercel-react-best-practices
    - web-design-guidelines

3. Install all skills:

skillpack install

Configuration

skillpack.yaml

# Install skills to global folders (default: false)
# global: true

# Target agents to install skills to (defaults to all agents if omitted)
# agents:
#   - claude-code
#   - github-copilot
#   - cursor

# Skills to install (owner/repo format)
skills:
  # Install specific skills from a repo
  vercel-labs/agent-skills:
    - vercel-react-best-practices
    - web-design-guidelines

  # Install all skills from a repo
  another-org/repo: all

  # Pin to a specific git ref (tag, branch, or commit)
  pinned-org/skill-repo:
    ref: v1.0.0
    skills:
      - specific-skill

Supported Agents

Skillpack supports all 25 agents from skills.sh:

Agent	Local Skills Dir	Global Skills Dir
amp	.agents/skills/	~/.config/agents/skills/
antigravity	.agent/skills/	~/.gemini/antigravity/skills/
claude-code	.claude/skills/	~/.claude/skills/
clawdbot	skills/	~/.clawdbot/skills/
cline	.cline/skills/	~/.cline/skills/
codex	.codex/skills/	~/.codex/skills/
command-code	.commandcode/skills/	~/.commandcode/skills/
cursor	.cursor/skills/	~/.cursor/skills/
droid	.factory/skills/	~/.factory/skills/
gemini-cli	.gemini/skills/	~/.gemini/skills/
github-copilot	.github/skills/	~/.copilot/skills/
goose	.goose/skills/	~/.config/goose/skills/
kilo	.kilocode/skills/	~/.kilocode/skills/
kiro-cli	.kiro/skills/	~/.kiro/skills/
mcpjam	.mcpjam/skills/	~/.mcpjam/skills/
neovate	.neovate/skills/	~/.neovate/skills/
opencode	.opencode/skills/	~/.config/opencode/skills/
openhands	.openhands/skills/	~/.openhands/skills/
pi	.pi/skills/	~/.pi/agent/skills/
qoder	.qoder/skills/	~/.qoder/skills/
qwen-code	.qwen/skills/	~/.qwen/skills/
roo	.roo/skills/	~/.roo/skills/
trae	.trae/skills/	~/.trae/skills/
windsurf	.windsurf/skills/	~/.codeium/windsurf/skills/
zencoder	.zencoder/skills/	~/.zencoder/skills/

Skills are installed by the underlying npx skills add command from skills.sh.

Lockfile

Running skillpack install creates a skillpack-lock.yaml file that tracks installed versions. Commit this file to ensure reproducible installs across your team.

Commands

Command	Description
skillpack install	Install all skills from skillpack.yaml
skillpack init	Create a skillpack.yaml template

Flags

--dry-run       # Show what would be installed without installing
--force         # Reinstall even if already present
--verbose       # Detailed output
--config <path> # Custom config file path
--no-lock       # Ignore lockfile and install latest
-g, --global    # Install skills to global folders

Examples

Preview what will be installed:

skillpack install --dry-run

Force reinstall all skills:

skillpack install --force

Use a custom config file:

skillpack install --config ./configs/skills.yaml

License

MIT