Docs
Supported agents
The skills CLI detects which agents you have installed and writes the skill into each one's own directory. You rarely need to name them — but when you do, these are the identifiers and the paths a skill lands in.
Auto-detection
With no flags, the CLI looks for every agent it knows about and installs to all of them. This is the recommended path — nothing to configure, and adding a new agent later picks up your existing skills on the next update.
npx skills add <url>— installs into every detected agent, project-local
Targeting specific agents
Pass -a once per agent, using the id from the table below. Add -g to install into your home directory instead of the project.
npx skills add <url> -a claude-code -a codex -a cursornpx skills add <url> -a claude-code -g— global install, available in every project on this machine
The shared directory
19 of these agents — Codex, Cursor, Cline, Zed, OpenCode, Gemini CLI, Kimi, Amp and others — read from .agents/skills rather than a directory of their own. One install there serves all of them, which is why the same skill often shows up in an agent you never explicitly targeted.
All agents
id · project path · global path
| Agent | -a id | Project | Global (-g) |
|---|---|---|---|
| Amp | amp | .agents/skills | $XDG_CONFIG_HOME/agents/skills |
| Antigravity | antigravity | .agents/skills | ~/.gemini/antigravity/skills |
| Claude Code | claude-code | .claude/skills | ~/.claude/skills |
| Cline | cline | .agents/skills | ~/.agents/skills |
| Codex | codex | .agents/skills | ~/.codex/skills |
| Continue | continue | .continue/skills | ~/.continue/skills |
| Crush | crush | .crush/skills | ~/.config/crush/skills |
| Cursor | cursor | .agents/skills | ~/.cursor/skills |
| Droid | droid | .factory/skills | ~/.factory/skills |
| Gemini CLI | gemini-cli | .agents/skills | ~/.gemini/skills |
| GitHub Copilot | github-copilot | .agents/skills | ~/.copilot/skills |
| Goose | goose | .goose/skills | $XDG_CONFIG_HOME/goose/skills |
| Junie | junie | .junie/skills | ~/.junie/skills |
| Kilo Code | kilo | .kilocode/skills | ~/.kilocode/skills |
| Kimi Code CLI | kimi-code-cli | .agents/skills | ~/.agents/skills |
| OpenCode | opencode | .agents/skills | $XDG_CONFIG_HOME/opencode/skills |
| Qwen Code | qwen-code | .qwen/skills | ~/.qwen/skills |
| Roo Code | roo | .roo/skills | ~/.roo/skills |
| Trae | trae | .trae/skills | ~/.trae/skills |
| Warp | warp | .agents/skills | ~/.agents/skills |
| Windsurf | windsurf | .windsurf/skills | ~/.codeium/windsurf/skills |
| Zed | zed | .agents/skills | ~/.agents/skills |
Not supported
This list mirrors the CLI, so it is the CLI's coverage, not ours. Notable absences at the time of writing: GLM / Zhipu CodeGeeX has no entry, and neither does any Zhipu-branded CLI.
If your agent reads .agents/skills you can still use every skill here — install with -a universal and point the agent at that directory. Failing that, a skill is just a markdown file: fetch the raw URL from any skill page and drop it wherever your agent looks.
To get an agent added properly, open an agent request against the CLI. Once it ships there, it works here with no change on our side — and our CLI reference covers the rest of the commands.