Equip

Equip manages skills across coding agents. You maintain a central skill library, and equip handles syncing skills to ~/.claude, ~/.codex, ./project/.cursor, and any other agent directory on your machine.

Install

cargo install --path .

Setup

equip init

This detects your agents (Claude, Codex, Cursor), offers popular skill sources, and creates your skill library at ~/.local/share/equip/. The library is a git-friendly directory you can push to a repo and share across machines.

Add Sources

Sources provide skills. Point equip at a GitHub repo, local directory, or archive and it figures out the structure.

equip add https://github.com/acme/agent-skills
equip add acme/agent-skills                      # GitHub shorthand
equip add ~/dev/my-skills                        # local dir (symlinked)
equip add ~/dev/my-skills --copy                 # local dir (snapshot)
equip add acme/agent-skills --ref v2.0           # pinned to a tag

See what you have:

equip list                    # all skills
equip list "legal/*"          # glob filter
equip list --external         # list sources
equip status                  # overview

Equip Skills

Pick agents with @, pick a kit with +, and pass skill patterns as arguments.

# Equip skills to Claude
equip @claude "legal/*" "productivity/start" -f

# Equip a kit
equip @claude +developer -f

# Kit plus extra skills
equip @claude +developer "legal/*" -f

# Multiple agents
equip @claude @codex +developer -f

# Omit @agent to target all auto-sync agents
equip +developer -f

# Preview first
equip -n @claude +developer

# Interactive conflict resolution
equip @claude +developer -i

# Unequip
equip @claude +developer -r -f

Collect Edits

When someone tweaks a skill directly at the agent, collect brings changes back to your library.

equip agent collect --agent claude                     # show tracked vs untracked
equip agent collect --agent claude --skill code-review # collect one skill
equip agent collect --agent claude --adopt             # adopt untracked skills

Kits

Kits are named skill sets you equip and unequip as a unit.

equip kit create developer "dev*" "productivity/*"
equip kit add developer "legal/contract-review"
equip kit drop developer "productivity/start"
equip kit list
equip kit show developer

Or create on-the-fly during equip:

equip @claude +new-kit -s "dev*" "legal/*" -f

Agents

equip agent detect                                          # auto-detect
equip agent add claude ~/.claude --name claude-global       # manual
equip agent add claude ./.claude --name project --scope repo
equip agent list
equip agent show claude-global
equip agent remove project --force

Agents have a scope (machine or repo) and a sync mode (auto or explicit). Auto-sync agents are targeted by default when you omit @agent. Repo-scoped agents default to explicit sync.

Updating Sources

equip update              # all sources
equip update acme         # one source
equip update acme --ref v3.0
equip update acme --ref latest   # unpin

Custom Adapters

Built-in adapters cover Claude, Codex, Cursor, Gemini, and VS Code. Define your own in equip.toml:

[adapter.my-agent]
skill_dir = "prompts/{name}"
skill_file = "prompt.md"
format = "agentskills"
copy_dirs = ["scripts", "references"]

Global Flags

Every command supports these:

Development

just test           # unit + integration tests
just harness        # Docker offline tests
just sandbox-test   # Docker tests against real repos
just check          # clippy + fmt

License

MIT