Agent Skills

Cursor

How Cursor finds, installs and reads a skill, from its own docs, checked 26 Oct 2026.


Where it looks for skills

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