Cursor Skills: What They Are and How to Use Them (2026)
Quick answer: Cursor skills are folders with a
SKILL.mdfile that Cursor's agent loads when a task matches, using the same open standard as Claude skills.Add one in
.cursor/skills/, or type/in Agent chat to run it by name.
Cursor, the AI code editor, supports agent skills. Its documentation calls Agent Skills an open standard rather than a Cursor feature, which is the most useful thing to know before you write one.
This guide covers where Cursor looks for skills, how to add and run them, and how to move existing rules over.
Cursor skills at a glance
| Question | Answer |
|---|---|
| What is a Cursor skill? | A folder containing a SKILL.md file, plus optional scripts, references and assets |
| Which format? | The open Agent Skills standard, the same one Claude and Codex use |
| Where do they live? | .cursor/skills/ or .agents/skills/, in a project or your user folder |
| How do they run? | Automatically when relevant, or by typing / in Agent chat |
| How do you add one from GitHub? | Cursor Settings, Rules, Add Rule, Remote Rule (GitHub) |
| How do you convert old rules? | The built-in /migrate-to-skills skill |
How Cursor skills work
Cursor finds skills when it starts and shows them to its agent. The agent then decides when each one is relevant, based on the skill's description and your request.
Like Claude, Cursor loads skills in stages. The agent sees the short description first and reads the full instructions only when it uses the skill.
New to the format? Read what Claude skills are, because the file is the same.
Where Cursor looks for skills
Cursor scans several folders, including ones used by other tools.
| Folder | Scope |
|---|---|
.cursor/skills/ | Project |
.agents/skills/ | Project |
.claude/skills/ | Project, for Claude compatibility |
.codex/skills/ | Project, for Codex compatibility |
~/.claude/skills/ | Your user account, for Claude compatibility |
~/.codex/skills/ | Your user account, for Codex compatibility |
Because Cursor reads the Claude and Codex folders, a skill you installed for one tool may already work in Cursor. Cursor also walks its skills folder recursively, so you can group skills in subfolders such as shipping/ or debugging/.
How to add a Cursor skill
1. Create the folder
Make a folder for the skill inside .cursor/skills/, for example .cursor/skills/deploy-staging/. Add a SKILL.md file inside it.
2. Write the file
Start with a name and a description between lines of three dashes, then plain instructions. Our guide on how to create Claude skills has a template you can copy, since the format is identical.
3. Add extras if needed
A skill can include optional folders.
scripts/for code the agent can run.references/for long documentation loaded on demand.assets/for templates and other fixed files.
Keep SKILL.md focused and move detail into separate files.
4. Start using it
Skills appear in the Agent Decides section of Cursor's rules settings. Ask for the task in Agent chat and Cursor applies the skill when it matches.
How to run a skill by name
You do not have to wait for the agent to choose. Type / in Agent chat and search for the skill's name to run it directly.
Cursor's agent may also use some built-in skills on its own when your request clearly matches.
How to import skills from GitHub
You can pull a skill straight from a repository.
- Open Cursor Settings and go to Rules.
- In the Project Rules section, click Add Rule.
- Choose Remote Rule (GitHub).
- Enter the repository address.
Read any skill before you import it, and use our safety checklist.
Built-in Cursor skills
Cursor ships a few skills of its own, which appear alongside yours.
| Skill | What it does |
|---|---|
/create-skill | Creates a new Agent Skill, including its structure and SKILL.md |
/create-rule | Creates Cursor rules with the right scope |
/migrate-to-skills | Converts eligible rules and slash commands into skills |
/review | Selects and runs a code-review agent |
You can run any of them by typing / in Agent chat.
Moving from rules and commands to skills
Many Cursor users already have dynamic rules and slash commands. Cursor can convert them for you.
- Type
/migrate-to-skillsin Agent chat. - The agent finds eligible rules and commands.
- It converts them into skills.
Slash commands become skills that run only when you call them, so they behave as before. This migration is available in Cursor 2.4 and later.
Limit a skill to certain files
You can scope a skill so it applies only to some files. Add a paths field to the skill's settings, and the skill is used only when the agent works with matching files.
Skills in a nested project folder are also scoped to files inside that folder, which suits monorepos.
Cursor skills vs Claude skills vs Codex skills
All three use SKILL.md, so most skills move between them.
| Cursor | Claude | Codex | |
|---|---|---|---|
| Format | Agent Skills standard | Agent Skills standard | Agent Skills standard |
| Required fields | name, description | name, description | name, description |
| Project folder | .cursor/skills/ | .claude/skills/ | Codex skills folder |
| Run by name | / in Agent chat | Type the skill's name | $ commands |
| Reads other tools' folders | Yes, Claude and Codex | No | See OpenAI's docs |
Read more in our guide to Codex skills. Test each skill in the tool you use, because supported scripts and settings can differ.
Skills from our directory to try in Cursor
These skills use the open format, and many suit an editor workflow. Test them in Cursor before you rely on them.
- Systematic Debugging: find the root cause before fixing a bug.
- Test Driven Development: write the test first.
- Frontend Design: build distinctive interfaces.
- GitHub Actions: write and fix CI workflows.
Browse more in the Coding category and the best Claude Code skills.
Frequently asked questions
Does Cursor support skills?
Yes. Cursor supports Agent Skills, an open standard, and loads them from skill folders in your project or user account. The agent uses them automatically or on request.
Where do Cursor skills go?
In .cursor/skills/ or .agents/skills/. Cursor also loads skills from Claude and Codex folders for compatibility.
How do I run a Cursor skill?
Type / in Agent chat and search for the skill's name. The agent may also use it automatically when your request matches.
Can I use a Claude skill in Cursor?
Often yes, because Cursor reads the same format and even scans Claude's skills folders. Test it, since some scripts or settings may not carry over.
What is /migrate-to-skills?
It is a built-in Cursor skill that converts eligible rules and slash commands into skills. It is available in Cursor 2.4 and later.
Related guides
- 25 Claude skills examples you can copy: Real skill descriptions and six patterns to reuse.
- Claude Code subagents vs skills vs hooks vs plugins: What each extension point does and when to use it.
Methodology and disclosure
This guide draws on Cursor's published documentation and independent write-ups, checked in November 2026. Folder names and commands change between releases, so confirm details in Cursor's documentation.
We have no affiliation with Cursor, and this article contains no affiliate links.