先说结论
- 1目录: Claude Code 读
~/.claude/skills;Codex 读~/.agents/skills,也读旧目录~/.codex/skills;Cursor 读自己的目录,外加前面这两个。 - 2按名字调用: Claude Code 和 Cursor 用
/skill-name,Codex 用$skill-name。 - 3必填字段: Codex 和 Cursor 要求写
name和description,Cursor 还要求name和文件夹一致。Claude Code 两个都不强制。
Claude Code、Codex、Cursor 一张表看懂
三者遵循同一套 Agent Skills 格式,写规范的 Skill 文件夹放进哪个都能跑。差别在于各自去哪找、怎么调用,以及对 frontmatter 的要求有多严。
| Claude Code | Codex | Cursor | |
|---|---|---|---|
| 个人目录 | ~/.claude/skills/ | ~/.agents/skills/,旧目录 ~/.codex/skills/ | ~/.cursor/skills/ 或 ~/.agents/skills/ |
| 项目目录 | .claude/skills/ | .agents/skills/,从启动目录一直到仓库根目录 | .cursor/skills/ 或 .agents/skills/ |
| 查看已安装 | /skills | /skills(CLI、IDE);ChatGPT 桌面应用侧边栏里的 Skills | Customize → Skills |
| 按名字调用 | /skill-name | $skill-name | /skill-name 或 @skill-name |
| 必填字段 | 无 | name、description | name(= 文件夹名)、description |
| 同名出现两次 | Enterprise 优先,其次个人,再次项目 | 两个都可能出现 | 文档未说明 |
| 改完之后 | 当前会话里直接生效 | 会自动识别,不行就重启 | 启动时查找;新开对话或重新加载 |

换 Agent?你的 Skills 可能已经在那边了
从 Claude Code 换到 Cursor
Cursor 也读 ~/.claude/skills/ 和 ~/.codex/skills/,所以你给 Claude Code 装的 Skills,不用复制就会出现在 Cursor 里。要注意的是 Cursor 的命名规则:name 必须和文件夹名一致。一个在 Claude Code 里连 name 都没写也能跑的 Skill,到了 Cursor 可能会被跳过。
想让一个 Skill 在哪几个 Agent 里能用,就照下表选目录:
| Skill 放在 | 可用于 |
|---|---|
~/.claude/skills/ | Claude Code 和 Cursor |
~/.agents/skills/ | Codex 和 Cursor |
~/.cursor/skills/ | Cursor,开启同步后也包括 Cloud Agents |
在云端、网页版和团队里用 Skills
放在个人目录里的 Skill 只在你的电脑上。云端会话、网页版应用和你的同事都看不到它,除非你把它放到他们拿得到的地方。
| Agent | 你的个人 Skills 到不了的地方 | 怎么办 |
|---|---|---|
| Claude Code | 云端会话、routines 和 Cowork | 在你的 claude.ai 账号里启用该 Skill;云端会话也会加载提交到 .claude/skills/ 的 Skills |
| Codex | 网页版和手机版 ChatGPT | 独立 Skill 可以在 ChatGPT 桌面应用、CLI 和 IDE 扩展里用;网页版和手机版需要打包成插件 |
| Cursor | Cloud Agents(除非开启同步) | 放在 ~/.cursor/skills/,并开启 Sync Skills for Cloud Agents |
在各个 Agent 里安装 Skillry Skill
三个 Agent 用的是同一条安装命令,只有一处不同。
| Agent | 命令 |
|---|---|
| Claude Code | npx --yes skillry-cli@latest install <slug> --agent claude-code |
| Codex、Cursor | npx --yes skillry-cli@latest install <slug> |
CLI 的默认目录 ~/.agents/skills/ 正是 Codex 和 Cursor 共用的目录,所以只有 Claude Code 需要多加一个参数。安装提示词和 ZIP 这两种装法,见 Claude Code、Codex 和 Cursor 各自的指南。
常见问题
Cursor 能用 Claude 的 Skills 吗?
能。为了兼容,Cursor 会加载 ~/.claude/skills/ 和 .claude/skills/,前提是每个 Skill 的 name 都和文件夹一致。
Claude Code 的 Skill 能拿到 Codex 里用吗?
能,只要它的 SKILL.md 同时写了 name 和 description,因为 Codex 要求这两个字段。把文件夹从 ~/.claude/skills/ 复制到 ~/.agents/skills/,或者不加 --agent claude-code,从 Skillry 重新装一次。
哪个 Agent 用 Skills 最好?
三者读的是同一种格式,用你平时在用的那个就行。这页列的差别,只有在换 Agent 或和团队共享 Skills 时才要紧。
Codex Skills 能在网页版 ChatGPT 里用吗?
独立的 Skill 不行,只能在 ChatGPT 桌面应用、Codex CLI 和 IDE 扩展里用。打包进插件的 Skills,网页版、桌面版和手机版 ChatGPT 都能用。
参考来源
这篇对你有帮助吗?
