$ skilldirectory
— zsh — registry.skilldirectory.dev
skill libraryblogguidesabout

home / blog / agent skills

Cursor Skills: What They Are and How to Use Them (2026)

Quick answer: Cursor skills are folders with a SKILL.md file 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

QuestionAnswer
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.

FolderScope
.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.

  1. Open Cursor Settings and go to Rules.
  2. In the Project Rules section, click Add Rule.
  3. Choose Remote Rule (GitHub).
  4. 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.

SkillWhat it does
/create-skillCreates a new Agent Skill, including its structure and SKILL.md
/create-ruleCreates Cursor rules with the right scope
/migrate-to-skillsConverts eligible rules and slash commands into skills
/reviewSelects 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.

  1. Type /migrate-to-skills in Agent chat.
  2. The agent finds eligible rules and commands.
  3. 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.

CursorClaudeCodex
FormatAgent Skills standardAgent Skills standardAgent Skills standard
Required fieldsname, descriptionname, descriptionname, description
Project folder.cursor/skills/.claude/skills/Codex skills folder
Run by name/ in Agent chatType the skill's name$ commands
Reads other tools' foldersYes, Claude and CodexNoSee 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.

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.

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.