The short answer
- 1Keep the Skill in
~/.cursor/skills/for all projects (the only folder Cloud Agents sync), or in.cursor/skills/for one. - 2The
nameinSKILL.mdmust equal the folder’s name: lowercase letters, digits and hyphens only. - 3Find it in Customize → Skills; start it with
/skill-nameor attach it with@skill-name. - 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.
| Folder | Used 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 ~ versions | Read 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.
- 1
On the Skill’s The Frontier Brief page, choose Copy install prompt, then Copy in the dialog.
- 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
Approve the device code your browser shows.
- 1
Sign in the first time. Your browser opens and asks you to approve a device code.
Terminal npx --yes fable5-cli@latest login - 2
Run the install. Leave the flag off: the CLI’s default folder is already one Cursor reads.
Terminal npx --yes fable5-cli@latest install <slug>
On the Skill’s page, choose Download ZIP, or use a Skill folder from elsewhere. Look through SKILL.md and scripts/ first, since the agent acts on those instructions and may run those scripts. Then move the folder across whole:
mkdir -p ~/.cursor/skills
mv ~/Downloads/my-skill ~/.cursor/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
descriptionnext to it
Start a Skill in Cursor
In chat, type / with the Skill’s name, followed by your request:
/launch-page Tidewell, a booking site for a small surf schoolTo 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:
- 1Store the Skill in
~/.cursor/skills/. Project Skills and anything in~/.agents/skills/never leave your computer. - 2In Settings → Agents → Context and Tools, turn Sync Skills for Cloud Agents on.
- 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.
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
Guidance kept in context
.mdcfiles inside.cursor/rules/; plain.mdfiles there are skipped- Four modes: Apply Manually, Apply to Specific Files, Apply Intelligently, Always Apply
- Brief conventions;
AGENTS.mdandCLAUDE.mdare 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?
