Claude Code Skills 速查表：附 Codex 和 Cursor

先说结论

1目录： ~/.claude/skills · ~/.agents/skills（还有旧目录 ~/.codex/skills）· ~/.cursor/skills
2运行： /name（Claude Code、Cursor）· $name（Codex）· Cursor 里用 @name 把它附加进对话
3看装了哪些： /skills · Customize → Skills
4安装： npx --yes skillry-cli@latest install <slug>，装给 Claude Code 要加 --agent claude-code

每个 Agent 的 Skills 目录

个人目录里的 Skill 在你打开的每个项目里都能用；项目目录里的 Skill 跟着仓库走，谁克隆了仓库谁就有。

Agent	个人	项目
Claude Code	`~/.claude/skills/`	`.claude/skills/`
Codex	`~/.agents/skills/`（旧目录：`~/.codex/skills/`）	`.agents/skills/`，从启动时所在的文件夹一路往上，到仓库根目录为止
Cursor	`~/.cursor/skills/`、`~/.agents/skills/`	`.cursor/skills/`、`.agents/skills/`

每个 Agent 还会读哪些目录、两份同名时用哪份，见 Skill 存放位置。

想确认 Skill 装好没有，最快的办法是按名字调用一次。能跑起来，就说明 Agent 认得它。

要做的事	Claude Code	Codex	Cursor
列出 Skills	`/skills`	`/skills`	Customize → Skills
运行某个	`/name`	`$name`	`/name`、`@name`
插件里的 Skill	`/plugin:name`	通过插件	通过插件
一直开着	—	—	Option/Alt+Enter（Custom Mode）
改完之后	自动生效；新建的目录要运行 `/reload-skills`	自动生效；没生效就重启	新开对话或重新加载窗口

每个 Skill 都有一个 SKILL.md，设置写在文件顶部两行 --- 之间。下面这几个字段会影响 Agent 怎么对待它。

字段	限制 / 作用	Claude Code	Codex	Cursor
`name`	最多 64 个字符；只用 a–z、0–9 和连字符；和文件夹同名	可选	必填	必填
`description`	最多 1,024 个字符；写清它做什么、什么时候用	建议填	必填	必填
`allowed-tools`	可以直接用、不必再问你的工具（规范里还是实验性的）	支持	—	—
`paths`	只在匹配的文件上自动运行	支持	—	支持

Skillry CLI 会从 Skillry 下载 Skill，再放进你那个 Agent 对应的目录。

命令	作用
`skillry-cli login`	打开浏览器，用设备码登录
`skillry-cli status`	看当前登录的是哪个账号
`skillry-cli install <slug>`	装到 `~/.agents/skills/<slug>/`
`--agent claude-code`	…改装到 `~/.claude/skills/<slug>/`
`--target <dir>`	…装到任意 Skills 目录，比如 `.claude/skills`
`--force`	覆盖已有的那份，旧的会留备份
`skillry-cli logout`	退出登录，同时作废这次会话

每条命令前面都要加 npx --yes skillry-cli@latest。支持 macOS 和 Windows，需要 Node.js 22+。--agent 和 --target 只能二选一。

/skills 列出已装的 Skill，/skill-name 运行其中一个，/plugin-name:skill-name 运行插件自带的 Skill，/reload-skills 让它认出你刚新建的 Skills 目录。

对比 Agent 把同样的内容配上例子讲了一遍。

这篇对你有帮助吗？