Agent Skills
Cursor
How Cursor finds, installs and reads a skill, from its own docs, checked 26 Oct 2026.
Where it looks for skills
| Scope | Folders it reads |
|---|---|
| This project | .agents/skills/, .cursor/skills/, .claude/skills/ and .codex/skills/ |
| All your projects | ~/.agents/skills/, ~/.cursor/skills/, ~/.claude/skills/ and ~/.codex/skills/ |
From Cursor’s own docs, checked 26 Oct 2026.
Install a skill
- Copy the skill’s folder, with its SKILL.md at the top, into .agents/skills/ in your project, or into ~/.agents/skills/ for all your projects.
- Keep the folder named exactly as the name field in its SKILL.md, as The skill folder explains.
- On qai.io/skills, every skill’s page has the steps for Cursor, starting from Install skills in Cursor.
Fields it reads
Beyond the six fields every SKILL.md can hold, Cursor reads paths, globs, disable-model-invocation, icon and color.
SKILL.md sets out the six fields and their limits.
Watch out for
- Cursor also loads the Claude Code and Codex skill folders, so a skill installed for either already appears in Cursor.
- The name field must match the folder name.
- Only ~/.cursor/skills syncs to Cloud Agents; ~/.agents/skills stays on your machine.
- To add skills from GitHub inside Cursor, the repo has to be a plugin with .cursor-plugin/marketplace.json.