Install guide
How to install Claude skills
Skills are plain folders with a SKILL.md inside. The skills CLI puts them where your agent looks — one command per skill, no build step.
The one command
npx skills add <owner>/<repo> --skill <name>
For example, Anthropic's PDF skill:
npx skills add anthropics/skills --skill pdf
The CLI reads the repo's skill folder, copies it into the skills directory your agent scans, and prints where it landed. No npm install, no config file, no restart of your editor.
Target one agent
If you have several agents installed, name the one you want:
npx skills add anthropics/skills --skill pdf -a claude-code
Without -a, the CLI installs for the agents it detects.
Where skills live
Claude Code looks in two places:
| Scope | Path | Use it for |
|---|---|---|
| Personal | ~/.claude/skills/<name>/SKILL.md |
Skills you want in every project |
| Project | <project>/.claude/skills/<name>/SKILL.md |
Skills that only make sense in one repo |
Codex and Cursor use their own skills directories; the CLI writes to the right one. If you are not sure, run the command and read the path it prints.
Check that it loaded
Two checks, in order:
- The file exists.
ls ~/.claude/skills/<name>/SKILL.mdshould return the path, not an error. - The agent sees it. Ask your agent to list its skills, or simply give it a task that matches the skill's description. A skill that never triggers usually has a description problem, not an install problem — see SKILL.md errors.
Remove a skill
rm -rf ~/.claude/skills/<name>
That is the whole uninstall. Skills are files, so there is nothing else to clean up.
Before you install from a stranger
A skill is instructions plus, often, scripts the agent will run. Read the SKILL.md first. Look for:
- commands that delete files, push commits, or deploy;
- network calls to domains you do not recognise;
- instructions that tell the agent to ignore the user or hide actions.
If you cannot read the source in two minutes, do not install it. Our directory links every entry to its source file for exactly this reason.
Frequently asked
Do skills cost anything? No. They are files; your agent plan is the only cost.
Can I install several skills at once? Run the command once per skill. Some repos bundle a set (for example obra/superpowers), where each skill is still installed by name.
Do skills work in Cursor? The CLI supports several agents; Cursor picks up its own skills folder. If a skill was installed for Claude Code only, re-run with the target agent flag.
Community notes
Found a broken install? Know a skill we missed?
One line is enough: the skill name, what happened, and the command you ran. We read every note and fix the index.