Skillpack CLI 🧰✨

Install curated skill packs into your coding agent (Codex / Claude / Copilot / Cursor / Windsurf / custom).

A skill is a folder containing SKILL.md.
A pack is a YAML file that selects skills (from your repo and optional git imports) and installs them into an agent’s skills directory.

Install

npm (recommended)

npm install -g @nikhilp0/skillpack
sp --help

from source

cargo build --release
./target/release/sp --help

Quick start 🚀

# list what's available
sp skills
sp packs

# preview what a pack resolves to
sp show general

# install into an agent
sp install general --codex

# see what's installed
sp installed

# uninstall
sp uninstall general --codex

Machine-friendly output:

sp packs --format plain
sp show general --format json

Repo layout

<repo>/
  skills/
    ... nested ok ...
    <some-skill>/
      SKILL.md
      (optional extra files)
  packs/
    <pack>.yaml

Pack files

Minimal (local-only)

name: general
include:
  - general/**
  - coding/**

With git imports

name: team
include:
  - general/**

imports:
  - repo: github.com/acme/shared-skills
    ref: v1.3.0     # optional
    include:
      - "**/pr-review"
      - tools/**

Optional exclusions + install naming

name: group-x

include:
  - general/**
  - coding/dotnet/**

exclude:
  - "**/experimental/**"

install:
  prefix: group-x
  sep: "__"

Install targets (“agents”)

Built-in agents map to default skill directories:

• codex → ~/.codex/skills
• claude → ~/.claude/skills
• copilot → ~/.copilot/skills
• cursor → ~/.cursor/skills
• windsurf → ~/.windsurf/skills

Install to a built-in:

sp install group-x --codex

Custom destination:

sp install group-x --custom --path /tmp/skills

View effective agent paths (defaults + overrides):

sp config

Typical workflows

One pack per role:

sp install daily --codex
sp install pr-review --codex
sp install infra --codex

Same pack across agents:

sp install team --codex --claude --copilot

Update behavior (re-run install):

sp install team --codex

Remove a pack:

sp uninstall team --codex