先说结论
- 1想让所有仓库都能用，就把 Skill 文件夹放进
~/.agents/skills/；只给一个仓库用，就放进它的.agents/skills/。 - 2Codex 要求
SKILL.md里同时写name（最多 64 个字符）和description（最多 1,024 个字符）。 - 3输入
$加 Skill 名字来运行，或者用/skills从列表里挑。
开始之前
Skills 能在三个地方用：Codex CLI、Codex IDE 扩展，以及 ChatGPT 桌面应用里的 Codex。如果要用 Skillry CLI 安装，还需要 macOS 或 Windows，以及 Node.js 22 或更新版本。
怎么给 Codex 添加 Skills
Codex 和 Skillry CLI 默认用的是同一个目录 ~/.agents/skills/，所以不用加任何参数。下面三种方式，挑顺手的就行。
- 1
打开 Skillry 上的 Skill 页面，点 复制安装提示词，再在弹窗里点 复制。
- 2
粘贴到 Codex 里发出去。它会自己去读 Skillry 的安装说明，执行该跑的命令。
安装提示词 Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
浏览器要你批准设备码时，点批准。
正常的话你会看到： Codex 告诉你装好的版本号和所在目录，就在
~/.agents/skills/下面。
- 1
先登录一次。浏览器会打开一个页面，让你批准设备码。
终端 npx --yes skillry-cli@latest login - 2
直接安装，不用加参数。CLI 默认装到的目录，正好就是 Codex 读取的目录。
终端 npx --yes skillry-cli@latest install <slug>正常的话你会看到：
Installed <slug> <version> to ~/.agents/skills/<slug>
在 Skill 页面点 下载 ZIP，或者用你从别处拿到的 Skill 文件夹。装之前先翻一遍 SKILL.md 和 scripts/，因为 Agent 会照着里面的说明做事，也可能运行那些脚本。看完再把整个文件夹移过去：
mkdir -p ~/.agents/skills
mv ~/Downloads/my-skill ~/.agents/skills/ZIP 解压后经常多套一层，变成 my-skill/my-skill/SKILL.md。SKILL.md 必须直接放在 Skill 文件夹里，否则 Agent 找不到。
Codex 自己也带了一个安装工具 $skill-installer，专门装 OpenAI 官方目录里的 Skills。它装到 ~/.codex/skills/，这个旧目录 Codex 仍然会读，所以两边装的 Skill 会一起出现。
Codex 认到了吗？这样检查
在 CLI 或 IDE 扩展里，输入 /skills，或者输入 $ 再敲名字的开头。在 ChatGPT 桌面应用里，打开侧边栏的 Skills。Codex 会自己发现新装的 Skill；没出现的话，重启一下 Codex。
在 Codex 里运行 Skill
输入 $ 和 Skill 名字，后面接你的需求：
$launch-page Parcelo，一个给小网店用的包裹追踪面板确认能用之后，直接用大白话提需求也行，Codex 会挑描述对得上的那个 Skill。装的 Skill 一多，Codex 会把描述截短，好让整个列表塞进大约 2% 的上下文窗口。所以描述的第一句就要写清主要用途，免得被截掉。
Codex 去哪里找 Skills
Codex 会从五个范围收集 Skills，平时用得到的是两个：你的个人目录和仓库里的目录。
| 范围 | 位置 |
|---|---|
| 仓库 | 从启动 Codex 的文件夹一直到仓库根目录，每一层的 .agents/skills/ |
| 个人 | ~/.agents/skills/ |
| 个人（旧目录） | ~/.codex/skills/，仍会读取（文档里没写，但 Codex 源码里能确认） |
| 管理员 | /etc/codex/skills/ |
| 系统 | 随 Codex 内置，比如 $skill-creator 和 plan |
两个同名 Skill 不会合并，可能同时出现在选择列表里。不想要的那份，删掉或改个名。
Codex Skills 和 AGENTS.md 有什么区别
Codex 每次运行开始都会读 AGENTS.md，所以它适合放始终要遵守的简短规则。Skill 只在任务用得上时才加载，适合放篇幅较长、会反复用到的流程。
用到才加载
.agents/skills/里的一个文件夹- 任务对得上时加载，或者你输入
$name时加载 - 适合可重复的多步骤工作
每次运行开始就读
- 先读
~/.codex/AGENTS.md，再从仓库根目录往下，每层读一个，直到启动目录 - 离启动目录越近的文件越优先，会覆盖前面的；默认总共 32 KiB
- 适合简短规则：测试命令、代码风格、各种限制
比较顺手的分法：AGENTS.md 控制在一屏左右的规则，一步一步的操作流程都挪进 Skills。详细对比见Skills 与指令文件。
Codex Skill 没出现？对照现象找原因
找不到的 Skill，多半是放错了目录，或者解压时多套了一层。先在左列找到你看到的现象。
| 现象 | 解决办法 |
|---|---|
/skills 里没有 | 移到 ~/.agents/skills/<name>/，再检查 ZIP 有没有多套一层 |
| 列出来了，但没有描述 | 修好 frontmatter，Codex 要求同时有 name 和 description |
| 项目 Skill 找不到 | 在仓库目录里启动 Codex |
在 ChatGPT 桌面应用里，$ 什么都搜不到 | 这是已有人报告的 bug（openai/codex#28505）。先查 /skills、重启，或者在 ~/.codex/skills/ 放一份副本试试（我们还没实测） |
常见问题
Codex 的 Skills 存在哪里？
自己用的在 ~/.agents/skills/，仓库里的在 .agents/skills/，管理员还可以用 /etc/codex/skills/。Codex 也读旧目录 ~/.codex/skills/，$skill-installer 就把 Skills 装在那里。
Codex Skills 和 AGENTS.md 有什么区别？
AGENTS.md 每次运行开始都会读；Skill 只在任务需要时才加载。
Codex Skills 能在 ChatGPT 里用吗？
独立的 Skill 能在 ChatGPT 桌面应用、Codex CLI 和 IDE 扩展里用。想在网页版或手机版 ChatGPT 里用，得把它打包进插件。
怎么做自己的 Codex Skill？
让 $skill-creator 帮你做。它是 Codex 自带的系统 Skill 之一。
参考来源
这篇对你有帮助吗？
