The short answer
- 1Claude Code:
~/.claude/skills/<name>/SKILL.mdfor you,.claude/skills/for a project - 2Codex:
~/.agents/skills/for you,.agents/skills/per repo; legacy~/.codex/skills/still works - 3Cursor:
~/.cursor/skills/or~/.agents/skills/, project folders, plus the Claude Code and Codex ones
Where Claude Code, Codex and Cursor look for Skills
Each agent pairs a personal folder under your home directory with a project folder in the repo. Some also scan other agents' folders, so one copy can appear in several tools. Installing through MCP? The The Frontier Brief MCP tool reference lists the folder each agent value writes to.
| Agent | Your own | In the repo | Also scanned |
|---|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/, plus nested ones in subfolders Claude works in | Plugins, enterprise managed settings, and Skills from claude.ai, which sync into ~/.claude/skills/synced/ |
| Codex | ~/.agents/skills/ | .agents/skills/ in the working directory and each parent, up to the repository root | Built-in system Skills, legacy ~/.codex/skills/, admin /etc/codex/skills/ |
| Cursor | ~/.cursor/skills/, ~/.agents/skills/ | .cursor/skills/, .agents/skills/, at any depth | .claude/skills/ and .codex/skills/, in the project and under ~ |
Windows users: ~ stands for the user profile folder, so the Claude Code path is C:\Users\you\.claude\skills.
How a Claude Code Skills folder is laid out
One folder per Skill, with SKILL.md at its top level. References, scripts and other extras go in subfolders beside it.
~/.claude/skills/
└── release-notes/
├── SKILL.md
├── references/
└── scripts/When a ZIP adds a level
Extracting an archive often creates a second folder: release-notes/release-notes/SKILL.md. Claude Code checks skills/<name>/SKILL.md and nothing deeper, so the Skill never shows up there. Codex and Cursor search further and may still find it, hence reports of a Skill that works in Cursor but not Claude Code. Move the inner folder up a level and every agent sees it.
When two Skills have the same name, which one runs
Only Claude Code documents a priority. Codex may show both copies; Cursor's docs are silent.
| Agent | One name, two locations |
|---|---|
| Claude Code | Enterprise beats personal, personal beats project. Plugin Skills can't collide, since their names include the plugin's. |
| Codex | Keeps them separate; you may see both. |
| Cursor | Its Skills docs don't say. |
Don't rely on any order: keep one copy, or rename one.
Cursor Cloud Agents and your Skills
Cloud Agents get Skills from ~/.cursor/skills/ alone, and only while the Sync Skills for Cloud Agents setting is on. A Skill kept in ~/.agents/skills/ may run locally yet be absent in the cloud.
Once you have moved a Skill
Usually the agent notices by itself. If the Skill is still missing:
| Agent | How to pick up the change |
|---|---|
| Claude Code | Nothing; for a brand-new Skills folder, run /reload-skills |
| Codex | Normally nothing; restart it if the Skill stays hidden |
| Cursor | Reload the window or start a fresh chat |
Common questions
Which folder holds my Claude Skills?
A personal Skill lives at ~/.claude/skills/<name>/SKILL.md. A project Skill lives at .claude/skills/<name>/SKILL.md within the repo.
Where does Codex keep Skills?
Personal ones go in ~/.agents/skills/, repo ones in .agents/skills/. Codex still reads the legacy ~/.codex/skills/, where OpenAI's $skill-installer writes.
Is there a single folder all agents read?
No. Cursor scans every one of them, but Claude Code only reads ~/.claude/skills/, and Codex reads ~/.agents/skills/ or ~/.codex/skills/.
Sources
Did this guide help?
