Manage agent skills via the `npx skills` CLI. Handle installing skills from GitHub repos, searching for available skills, checking for updates, and updating installed skills.
Determine 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.
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
</quick_start>
Detect the agent you are running as. Map to the correct `--agent` flag value:
| 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").
</agent_type>
- **Project** (default): Installs to `.//skills/` in the current project.
- **Global** (`-g`): Installs to `~//skills/`. Only use when the user says "global", "globally", or "for all projects".
</install_scope>
User says: install, add, get, set up a skill
1. Identify the skill source. Accepts:
- `owner/repo` — installs all skills from the repo
- Full GitHub/GitLab URL to a repo, directory, or SKILL.md file (e.g., `https://github.com/owner/repo/tree/main/skills/foo`)
- Local filesystem path
- Use `-s skill-name` to cherry-pick a specific skill by name from a multi-skill repo
2. Determine scope: project (default) or global (`-g`).
3. Determine agent type(s) to target.
4. Run:
```bash
npx skills add {source} --yes --agent {agent-type}
```
Add `-g` if global. Add multiple `--agent` flags if targeting multiple agents.
"Install the vercel-labs/skills skill" →
`npx skills add vercel-labs/skills --yes --agent claude-code`
"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
User says: find, search, discover, look for, browse skills
1. If user gave a keyword, pass it directly.
2. Run:
```bash
npx skills find {keyword} --yes
```
3. Present results to the user. If they pick one, follow the install operation.
User says: check for updates, are my skills up to date
Run:
```bash
npx skills check --yes
```
Report which skills have updates available. Offer to update if any are found.
User says: update skills, upgrade skills
Run:
```bash
npx skills update --yes
```
Report what was updated.
User says: list skills, show installed skills, what skills do I have
Run:
```bash
npx skills add --list --yes
```
- Always use `--yes` to skip confirmation prompts.
- Default to project scope unless the user explicitly says global.
- Default to the current agent type only. Add others only if the user asks.
- If a command fails, show the error output and suggest fixes (e.g., check the source URL, network).
- After installing, confirm success and mention where the skill was installed.
- The requested skill operation completed successfully.
- Output was shown to the user confirming what happened.
- Scope and agent targeting matched user intent (project/global, correct agent).
</success_criteria>