Black Friday: Lock in your founding rate.Compare plans

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

Skip to content

Where are Claude Skills stored? The folders every agent reads

The precise Skills folders for Claude Code, Codex and Cursor, what an agent does when one Skill lives in two of them, and the extra folder level behind most “I installed it but it isn’t there” reports.

For
Anyone hunting for a Skill
Covers
Claude Code, Codex, Cursor
Time
5 min

The short answer

  1. 1Claude Code: ~/.claude/skills/<name>/SKILL.md for you, .claude/skills/ for a project
  2. 2Codex: ~/.agents/skills/ for you, .agents/skills/ per repo; legacy ~/.codex/skills/ still works
  3. 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.

AgentYour ownIn the repoAlso scanned
Claude Code~/.claude/skills/.claude/skills/, plus nested ones in subfolders Claude works inPlugins, 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 rootBuilt-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.

A layout all three agents accept
~/.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.

AgentOne name, two locations
Claude CodeEnterprise beats personal, personal beats project. Plugin Skills can't collide, since their names include the plugin's.
CodexKeeps them separate; you may see both.
CursorIts 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:

AgentHow to pick up the change
Claude CodeNothing; for a brand-new Skills folder, run /reload-skills
CodexNormally nothing; restart it if the Skill stays hidden
CursorReload 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?