Primary commands:
npx skills add {source} --yes --agent {agent-type}
npx skills find {keyword} --yes
npx skills check --yes
npx skills update --yes
npx skills add --list --yes
| Agent |
Flag value |
| Amp |
amp |
| Claude Code |
claude-code |
| Cline |
cline |
| Codex |
codex |
| Continue |
continue |
| Cursor |
cursor |
| Gemini CLI |
gemini-cli |
| GitHub Copilot |
github-copilot |
| Goose |
goose |
| Kilo Code |
kilo |
| Kiro CLI |
kiro-cli |
| OpenCode |
opencode |
| Qwen Code |
qwen-code |
| Roo Code |
roo |
| Trae |
trae |
| Windsurf |
windsurf |
If unsure, check for config directories (e.g., .claude/, .codex/, .cursor/).
Only include additional agent types if the user explicitly requests it (e.g., "install for all agents" or "also install for codex").
"Install just the managing-skills skill from that repo" →
npx skills add vercel-labs/skills --yes -s managing-skills --agent claude-code
"Install this skill: github.com/owner/repo/tree/main/skills/foo" →
npx skills add https://github.com/owner/repo/tree/main/skills/foo --yes --agent claude-code
"Globally install foo/bar for all agents" →
npx skills add foo/bar --yes -g --all
1---2name: managing-skills3description: Install, find, update, and manage agent skills. Use when the user wants to add a new skill, search for skills that do something, check if skills are up to date, or update existing skills. Triggers on: install skill, add skill, get skill, find skill, search skill, update skill, check skills, list skills.4---56<objective>7Manage agent skills via the `npx skills` CLI. Handle installing skills from GitHub repos, searching for available skills, checking for updates, and updating installed skills.8</objective>910<quick_start>11Determine which operation the user wants and run the appropriate command. Always include `--yes` to skip confirmations. Default to project-level install and the current agent type unless told otherwise.1213Primary commands:14```15npx skills add {source} --yes --agent {agent-type}16npx skills find {keyword} --yes17npx skills check --yes18npx skills update --yes19npx skills add --list --yes20```21</quick_start>2223<context>24<agent_type>25Detect the agent you are running as. Map to the correct `--agent` flag value:2627| Agent | Flag value |28|-------|-----------|29| Amp | `amp` |30| Claude Code | `claude-code` |31| Cline | `cline` |32| Codex | `codex` |33| Continue | `continue` |34| Cursor | `cursor` |35| Gemini CLI | `gemini-cli` |36| GitHub Copilot | `github-copilot` |37| Goose | `goose` |38| Kilo Code | `kilo` |39| Kiro CLI | `kiro-cli` |40| OpenCode | `opencode` |41| Qwen Code | `qwen-code` |42| Roo Code | `roo` |43| Trae | `trae` |44| Windsurf | `windsurf` |4546If unsure, check for config directories (e.g., `.claude/`, `.codex/`, `.cursor/`).47Only include additional agent types if the user explicitly requests it (e.g., "install for all agents" or "also install for codex").48</agent_type>4950<install_scope>51- **Project** (default): Installs to `./<agent>/skills/` in the current project.52- **Global** (`-g`): Installs to `~/<agent>/skills/`. Only use when the user says "global", "globally", or "for all projects".53</install_scope>54</context>5556<operations>5758<operation name="install">59<trigger>User says: install, add, get, set up a skill</trigger>60<steps>611. Identify the skill source. Accepts:62 - `owner/repo` — installs all skills from the repo63 - Full GitHub/GitLab URL to a repo, directory, or SKILL.md file (e.g., `https://github.com/owner/repo/tree/main/skills/foo`)64 - Local filesystem path65 - Use `-s skill-name` to cherry-pick a specific skill by name from a multi-skill repo662. Determine scope: project (default) or global (`-g`).673. Determine agent type(s) to target.684. Run:69```bash70npx skills add {source} --yes --agent {agent-type}71```72Add `-g` if global. Add multiple `--agent` flags if targeting multiple agents.73</steps>74<examples>75"Install the vercel-labs/skills skill" →76`npx skills add vercel-labs/skills --yes --agent claude-code`7778"Install just the managing-skills skill from that repo" →79`npx skills add vercel-labs/skills --yes -s managing-skills --agent claude-code`8081"Install this skill: github.com/owner/repo/tree/main/skills/foo" →82`npx skills add https://github.com/owner/repo/tree/main/skills/foo --yes --agent claude-code`8384"Globally install foo/bar for all agents" →85`npx skills add foo/bar --yes -g --all`86</examples>87</operation>8889<operation name="find">90<trigger>User says: find, search, discover, look for, browse skills</trigger>91<steps>921. If user gave a keyword, pass it directly.932. Run:94```bash95npx skills find {keyword} --yes96```973. Present results to the user. If they pick one, follow the install operation.98</steps>99</operation>100101<operation name="check">102<trigger>User says: check for updates, are my skills up to date</trigger>103<steps>104Run:105```bash106npx skills check --yes107```108Report which skills have updates available. Offer to update if any are found.109</steps>110</operation>111112<operation name="update">113<trigger>User says: update skills, upgrade skills</trigger>114<steps>115Run:116```bash117npx skills update --yes118```119Report what was updated.120</steps>121</operation>122123<operation name="list">124<trigger>User says: list skills, show installed skills, what skills do I have</trigger>125<steps>126Run:127```bash128npx skills add --list --yes129```130</steps>131</operation>132133</operations>134135<guidelines>136- Always use `--yes` to skip confirmation prompts.137- Default to project scope unless the user explicitly says global.138- Default to the current agent type only. Add others only if the user asks.139- If a command fails, show the error output and suggest fixes (e.g., check the source URL, network).140- After installing, confirm success and mention where the skill was installed.141</guidelines>142143<success_criteria>144- The requested skill operation completed successfully.145- Output was shown to the user confirming what happened.146- Scope and agent targeting matched user intent (project/global, correct agent).147</success_criteria>