Codex skills。
Codex skill 就是一个带 SKILL.md 文件的文件夹,教 Codex 做某一类工作,比如修 CI 或评审设计。下面讲 skill 放在哪里、怎么安装和调用、怎么写出 Codex 能在合适时机选中的 skill,以及先装哪些。
更新于 2026年11月12日 · 阅读约 7 分钟
先说结论
- skill 就是一个文件夹,里面有一个
SKILL.md文件:包含name、description,以及用 Markdown 写的指令。文件夹里还可以放脚本和参考文件。 - 安装:在 Codex 里输入
$skill-installer,再加上 skill 的名称或 GitHub 链接;也可以直接把文件夹复制到~/.agents/skills。装完重启 Codex。 - 使用:运行
/skills,或者输入$加 skill 名称。当你的请求和某个 skill 的描述匹配时,Codex 也会自己选用。 - 自己写:用内置的
$skill-creator。描述决定了 Codex 什么时候用它,所以大部分功夫要花在描述上。 - OpenAI 的
openai/skills目录已弃用。 新的官方 skill 都放在openai/plugins仓库的插件里。
Codex skill 是什么
skill 把某一项任务的指令打包起来,也可以附带脚本和资源。Codex 在会话开始时只读取每个 skill 的名称和描述。当任务和某个描述匹配,或者你点名提到这个 skill 时,它才会加载完整的 SKILL.md。所以装几十个 skill 也不会占满上下文窗口。
skill 遵循开放的 Agent Skills 格式,所以同一个文件夹通常也能用在其他读取 SKILL.md 的 Agent 里,包括 Claude Code。插件是另一回事:它是一个可安装的包,里面可以有好几个 skill,还有 MCP 服务器和 hook。两者的区别见 Codex 插件和 skill 的区别。
Codex skill 放在哪里
| 范围 | 路径 | 适合用来放 |
|---|---|---|
| 仓库 | 当前目录或其上级的 .agents/skills,一直查到仓库根目录 | 只属于某一个项目的 skill |
| 用户 | ~/.agents/skills | 你想在所有项目里都能用的 skill |
| 组织 | /etc/codex/skills | 管理员统一安装、所有人都能用的 skill |
| 系统 | Codex 自带 | skill-creator、skill-installer 等几个 |
Codex 会从你启动它的目录开始,一级一级往上,检查每个 .agents/skills 文件夹,直到仓库根目录。同名的两个 skill 不会合并,两个都会出现在列表里。skill 文件夹可以是符号链接,如果你把所有 skill 放在同一个 Git 仓库里,这很方便。
怎么使用 skill
- 选择:在 Codex CLI 或 IDE 扩展里运行
/skills,选一个。 - 点名:在提示词里输入
$加 skill 名称,比如$gh-fix-ci the build on this branch is red。 - 让 Codex 自己选:像平时一样描述任务。如果和某个 skill 的描述匹配,Codex 会自己加载它。
在 ChatGPT 桌面应用里,用 @ 代替 $。
怎么安装 Codex skills
用 $skill-installer
$skill-installer 是 Codex 自带的系统 skill。给它一个名称或一个 GitHub 文件夹链接就行:
$skill-installer gh-address-comments
$skill-installer install https://github.com/ummydev/pretty-ui/tree/main/skills/pretty-ui
只写名称,就从 OpenAI 的精选目录安装。给链接,就能从任意公开仓库安装。如果新 skill 没有出现,重启 Codex。
直接复制文件夹
skill 只是一堆文件,所以你也可以把它的文件夹克隆或复制到 ~/.agents/skills(所有项目可用)或 .agents/skills(只用于一个项目)。想和团队共享 skill,这是最简单的办法:把它提交到仓库里,所有人用 Codex 打开这个项目就都有了。
从插件安装
OpenAI 已经弃用了 openai/skills 仓库,现在把自己的 skill 放在 openai/plugins 仓库的插件里:Figma、Notion、Linear、GitHub、Vercel、Build Web Apps、Product Design 等等。在 Codex CLI 里运行 /plugins 就能浏览和安装。装一个插件,它的 skill 和所需的工具会一起装好。
怎么自己写 skill
最快的办法是直接让 Codex 来写:
$skill-creator 创建一个用户级 skill,名叫 design-review。它对照项目里的 DESIGN.md 检查 UI 界面:颜色和字体只能用文件里定义的,间距遵循 8px 网格,正文 16px 或更大,不能用 emoji 当图标。把问题列成清单,注明文件和行号,然后修好。
也可以自己写文件,放在 ~/.agents/skills/design-review/SKILL.md:
---
name: design-review
description: Review a UI screen against the project's DESIGN.md. Use when the user asks for a design review, says a screen looks off, or before finishing any UI change.
---
1. Read DESIGN.md. If there is none, say so and stop.
2. Check colors, fonts, spacing, and type sizes against it.
3. List each problem with the file and line, then fix it.
Codex 会不会用一个 skill,主要看这三点:
- 描述要写给“匹配”看。 写清楚这个 skill 做什么、什么时候用,用人们平时真会打的字。“Use when the user asks for a design review”(用户要求做设计评审时使用)有效;“Design helper”(设计助手)没用。
- SKILL.md 要短。 长篇参考资料放进
references/文件夹,再告诉 skill 什么时候去读。Codex 只在需要时才加载这些额外文件。 - 精确的步骤交给脚本。 如果某件事每次都必须一模一样地执行,比如检查或格式转换,就放进
scripts/,让 skill 去运行它。
如果想让 Codex 不自己调用某个 skill,但 $name 仍然能用,在 skill 文件夹里加一个 agents/openai.yaml,写上 policy: { allow_implicit_invocation: false }。
值得安装的 Codex skills
| Skill | 作用 | 怎么获取 |
|---|---|---|
skill-creator、skill-installer | 创建和安装 skill | 内置 |
imagegen | 在 Codex 里根据提示词生成图片 | 内置 |
gh-fix-ci | 读取失败的 GitHub Actions 日志并修好构建 | $skill-installer gh-fix-ci |
gh-address-comments | 逐条处理你打开的 pull request 上的评审意见 | $skill-installer gh-address-comments |
playwright | 用真实浏览器测试并截图 Codex 做出来的东西 | $skill-installer playwright |
security-best-practices | 检查代码里常见的安全错误 | $skill-installer security-best-practices |
| Figma skills | 把 Figma 画板转成代码,也能把代码转回 Figma | Figma 插件,通过 /plugins 安装 |
| Taste Skill | 让 UI 摆脱千篇一律的 AI 味 | 见教程 |
| pretty-ui | 检查 UI 里的 AI 设计痕迹并修掉 | $skill-installer install https://github.com/ummydev/pretty-ui/tree/main/skills/pretty-ui |
如果只看设计方面,我们在 Codex 前端设计 skill 推荐和 Taste Skill、Impeccable、UI UX Pro Max 对比里做了比较。
关闭 skill,或者修复不显示的 skill
想关掉某个 skill 又不想删除,在 ~/.codex/config.toml 里加上下面这段,然后重启 Codex:
[[skills.config]]
path = "/Users/you/.agents/skills/design-review/SKILL.md"
enabled = false
如果用 name = "design-review" 代替 path,就会关掉所有同名的 skill。
如果 /skills 里看不到某个 skill:
- 重启 Codex。 新 skill 在会话开始时才会加载。
- 检查文件夹。 文件必须叫
SKILL.md,并且直接放在 skill 文件夹里,文件夹要在上面某个路径下。 - 检查开头的 frontmatter。
name和description都必须有。 - 可能装得太多了。 开场的 skill 列表大约只占上下文窗口的 2%。超出之后,Codex 会缩短描述,还可能漏掉一些 skill,并给出警告。可以在
config.toml里用skills.max_context_tokens调大额度,或者删掉不用的 skill。
常见问题
Claude Code 的 skill 能在 Codex 里用吗?
通常可以。两者用的都是 SKILL.md 格式。把 ~/.claude/skills 里的文件夹复制到 ~/.agents/skills 就行。如果 skill 里要求 Agent 使用只有其中一方才有的工具,就需要改一改。
skill 和 AGENTS.md 有什么区别?
AGENTS.md 在该项目的每个会话里都会加载,适合放始终要遵守的规则。skill 只在任务需要时才加载,适合偶尔用到的工作流程,而且可以带脚本和参考文件。
去哪里找更多 Codex skills?
可以看 /plugins 里 OpenAI 的插件、已弃用但仍可阅读的 openai/skills 仓库,以及作者发布在 GitHub 上的 skill。安装前先读一遍 skill 的文件,尤其是脚本:skill 拥有和 Codex 一样的权限。