Claude Skills 存在哪里？各 Agent 的 Skills 目录一览

先说结论

1Claude Code： ~/.claude/skills/<name>/SKILL.md，项目里是 .claude/skills/
2Codex： ~/.agents/skills/，仓库里是 .agents/skills/；旧目录 ~/.codex/skills/ 也照样读
3Cursor： ~/.cursor/skills/ 或 ~/.agents/skills/，再加上项目目录，以及 Claude Code 和 Codex 的目录

Claude Code、Codex、Cursor 的 Skills 目录在哪？

每个 Agent 都有两处：家目录下的个人目录，和仓库里的项目目录。有的 Agent 还会顺带读别家的目录，所以同一份 Skill 可能在好几个工具里都看得到。

Agent	个人	项目	还会读
Claude Code	`~/.claude/skills/`	`.claude/skills/`；Claude 在子文件夹里干活时，也读子文件夹里的	Enterprise 托管设置、插件、你的 claude.ai 账号（同步到 `~/.claude/skills/synced/`）
Codex	`~/.agents/skills/`	`.agents/skills/`，从启动时所在的文件夹一路往上，到仓库根目录为止	`~/.codex/skills/`（旧目录）、`/etc/codex/skills/`、系统 Skills
Cursor	`~/.cursor/skills/`、`~/.agents/skills/`	`.cursor/skills/`、`.agents/skills/`，放在仓库哪一层都行	`.claude/skills/`、`.codex/skills/`，以及 `~` 下的这两个目录

Windows 上的 ~ 就是你的用户文件夹，比如 C:\Users\you\.claude\skills。

Claude Code 的 Skills 文件夹该长什么样？

一个 Skill 一个文件夹，SKILL.md 直接放在这个文件夹里，其他辅助文件放进旁边的子文件夹。

所有 Agent 都认的结构

~/.claude/skills/
└── launch-page/
    ├── SKILL.md
    ├── references/
    └── scripts/

ZIP 陷阱

解压 ZIP 时经常会多出一层，变成 launch-page/launch-page/SKILL.md。Claude Code 只看 skills/<name>/SKILL.md 这一层，多一层它就列不出来。Cursor 和 Codex 会往深处找，可能还是能找到，所以才会有人说“Cursor 里好好的，Claude Code 里没有”。把里面那层文件夹往上挪一级，哪个 Agent 都能用。

两个 Skill 同名，用哪一份？

只有 Claude Code 写明了先后顺序。Codex 可能两份都列出来，Cursor 则没有说明。

Agent	同名 Skill 出现在两处
Claude Code	先 Enterprise，再个人，最后项目。插件里的 Skill 带着插件名，不会撞名。
Codex	不合并，两个都可能出现。
Cursor	文档没写 Skills 的情况。

别靠顺序碰运气。只留一份，或者给其中一个改个名。

Cursor Cloud Agents 里的 Skills

只有 ~/.cursor/skills/ 会同步到 Cursor Cloud Agents，而且得先打开 Sync Skills for Cloud Agents。放在 ~/.agents/skills/ 的 Skill，可能本地用得好好的，到云端就没了。

挪了 Skill 的位置之后

大多数时候 Agent 自己就能发现。如果 Skill 还是没出来，按下表处理：

Agent	怎么让改动生效
Claude Code	不用管；Skills 目录是新建的话，运行 `/reload-skills`
Codex	一般不用管；没出来就重启
Cursor	新开对话或重新加载窗口

常见问题