Agent guide
Cursor skills
Cursor reads the same SKILL.md format as other agents. The skills CLI can install a skill directly for Cursor — here is the command, where it lands, and which skills are worth starting with.
Do skills work in Cursor?
Cursor is one of the agents the skills CLI supports as an install target. A skill is a plain folder with a SKILL.md; installing for Cursor copies that folder into the skills location Cursor reads, with no build step and no plugin.
The important part is the same as in any agent: the description decides when the skill loads. Installing ten skills does not make the agent use them — precise requests do.
Install a skill for Cursor
npx skills add <owner>/<repo> --skill <name> -a cursor
For example:
npx skills add anthropics/skills --skill frontend-design -a cursor
Without -a cursor, the CLI installs for the agents it detects. Naming the agent avoids writing into folders you did not intend.
Where it lands
The CLI writes the skill folder where Cursor looks for skills and prints the path. If you are unsure, run the command and read the output; to remove a skill, delete that folder.
Which skills to start with
These are the most-installed skills in the index — they are general-purpose, so they are a reasonable first install in Cursor too:
| # | Skill | Author | Installs | Grade |
|---|---|---|---|---|
| 1 | find-skills | Vercel | 4.4M | A |
| 2 | hyperframes-cli | HeyGen | 1.6M | A |
| 3 | grill-me | Matt Pocock | 1.6M | A |
| 4 | hyperframes | HeyGen | 1.6M | A |
| 5 | agent-browser | Vercel | 1.5M | A |
| 6 | media-use | HeyGen | 1.5M | A |
| 7 | hyperframes-registry | HeyGen | 1.3M | A |
| 8 | grill-with-docs | Matt Pocock | 1.3M | A |
| 9 | improve-codebase-architecture | Matt Pocock | 1.3M | A |
| 10 | tdd | Matt Pocock | 1.2M | A |
| 11 | setup-matt-pocock-skills | Matt Pocock | 1.2M | A |
| 12 | handoff | Matt Pocock | 1.1M | A |
| 13 | frontend-design | Anthropic | 1.1M | A |
| 14 | grilling | Matt Pocock | 1.1M | A |
| 15 | prototype | Matt Pocock | 1.1M | A |
Every row links to the skill page with its trigger description and source file; the full list is in all skills.
Cursor-specific tips
- Install for Cursor explicitly.
-a cursorkeeps skills out of other agents’ folders. - Keep the set small. Five focused skills trigger more reliably than fifteen overlapping ones.
- Use the skill’s vocabulary. If the description says “review this pull request”, ask for a review in those words.
- Check the grade before you install. A skill that pipes
curlinto a shell is a decision, not a convenience — see security grades. - Prefer project scope for repo-specific skills. Install from the project root when the skill only makes sense in that codebase.
Frequently asked
Are Cursor skills different from Claude skills? The file format is the same; the difference is where the agent looks for skills and which model reads them. A skill that works in Claude Code generally works in Cursor, assuming the instructions do not depend on Claude-only tools.
Do I need a paid Cursor plan to use skills? That depends on Cursor’s plan features, not on the skill. The skill itself is a free file; the skills CLI is free.
How do I update a skill? Re-run the install command — it overwrites the folder with the version in the repo. There is no auto-update.
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.