Black Friday: Lock in your founding rate.Compare plans

Every Premium Skill for $19.9/month. Cancel anytime. See plans

Skip to content

Cursor Skills: install and run Agent Skills in Cursor

Cursor searches more Skill folders than Claude Code or Codex, yet silently drops any Skill whose name differs from its folder. Where Skills go, how to start them, and how they compare with Cursor rules.

For
People who use Cursor
Time
About 8 minutes

The short answer

  1. 1Keep the Skill in ~/.cursor/skills/ for all projects (the only folder Cloud Agents sync), or in .cursor/skills/ for one.
  2. 2The name in SKILL.md must equal the folder’s name: lowercase letters, digits and hyphens only.
  3. 3Find it in Customize → Skills; start it with /skill-name or attach it with @skill-name.
  4. 4Want something finished? Browse Cursor Skills, each a single command away.

The folders Cursor reads

Besides its own folders, Cursor reads the shared ~/.agents/skills/ plus the Claude Code and Codex folders, so Skills from those agents may already be there.

FolderUsed for
~/.cursor/skills/All projects. Only this folder can sync to Cloud Agents.
~/.agents/skills/All projects on this machine. The Frontier Brief installs here; Codex also uses it.
.cursor/skills/ or .agents/skills/Per project, at any depth; a nested folder covers the files beneath it.
.claude/skills/, .codex/skills/ and their ~ versionsRead so Claude Code and Codex Skills work here too.

How to add a Skill to Cursor

The Frontier Brief CLI writes to ~/.agents/skills/, which Cursor reads, so no flag is needed. Copying a folder by hand? Use ~/.cursor/skills/, the only folder Cloud Agents can sync.

Quickest when Cursor is already running
  1. 1

    On the Skill’s The Frontier Brief page, choose Copy install prompt, then Copy in the dialog.

  2. 2

    Paste it into Cursor and send. Cursor fetches The Frontier Brief install steps and runs the right command for you.

    Install prompt
    Read https://fable5.app/skills/<slug>/install.md and follow the instructions to install the skill.
  3. 3

    Approve the device code your browser shows.

    You should see: Cursor naming the version it put in and the path, somewhere under ~/.agents/skills/.

Cursor scans for Skills at startup, so open a fresh chat (or reload the window), then look in the Agent Decides group of Customize → Skills.

The name rule that hides Skills

Cursor loads a Skill only when the name in its SKILL.md is identical to its folder’s name. If they differ there is no warning; the Skill is just absent.

Where did it go?

You install launch-page, rename its folder to landing, and it disappears: folder and name no longer agree. Rename the folder back or set name to landing.

What Cursor needs from a name

  • Lowercase letters, digits and hyphens, nothing else
  • Exactly the same as the folder that contains SKILL.md
  • A description next to it

Start a Skill in Cursor

In chat, type / with the Skill’s name, followed by your request:

Cursor chat
/launch-page Tidewell, a booking site for a small surf school

To keep a Skill on all session, highlight it in the / menu, then press Alt+Enter on Windows or Option+Enter on a Mac, or pick Use as Mode. It becomes a Custom Mode until you exit.

Skills in Cloud Agents

Cloud Agents run on Cursor’s machines, so they see only the Skills Cursor syncs to them:

  1. 1Store the Skill in ~/.cursor/skills/. Project Skills and anything in ~/.agents/skills/ never leave your computer.
  2. 2In Settings → Agents → Context and Tools, turn Sync Skills for Cloud Agents on.
  3. 3To share a personal Skill with teammates, select Publish on it in Customize → Skills.

Cursor rules or Skills?

Rules are brief guidance Cursor puts in the conversation, on every turn or for certain files. Skills hold procedures fetched only when needed. Conventions go in rules, multi-step jobs in Skills.

Skill

A procedure, loaded when needed

  • A folder holding SKILL.md
  • Runs when it fits the task, or when you type /name
  • Multi-step jobs, scripts, templates
Rule

Guidance kept in context

  • .mdc files inside .cursor/rules/; plain .md files there are skipped
  • Four modes: Apply Manually, Apply to Specific Files, Apply Intelligently, Always Apply
  • Brief conventions; AGENTS.md and CLAUDE.md are read too

Moving old rules? Cursor’s /migrate-to-skills converts slash commands, and rules set to “Apply Intelligently”, into Skills.

Skill missing in Cursor? Check these

Check the name first; a mismatch with the folder is the usual cause.

Absent from Customize → Skills

Make name equal the folder’s name, then reload the window or open a fresh chat.

Absent in Cloud Agents

Move it into ~/.cursor/skills/ and switch sync on.

Never chosen by itself

The description is worded unlike your requests, or paths points it at different files.

Common questions

How do Cursor rules differ from Skills?

A rule is guidance Cursor inserts into the chat on every turn or for certain files. A Skill holds a procedure the agent uses when relevant or when called.

Does Cursor work with Claude Skills?

It does: ~/.claude/skills/ and .claude/skills/ are both on Cursor’s list, provided every name matches its folder.

Which folders hold Cursor Skills?

For all projects, ~/.cursor/skills/ or ~/.agents/skills/; for one project, .cursor/skills/ or .agents/skills/.

Can Cursor Cloud Agents use Skills?

Only those in ~/.cursor/skills/, and only with Sync Skills for Cloud Agents turned on.

Sources

Did this guide help?