Codex 插件和 skill 的区别。
一个 skill 教 Codex 怎么做某一类工作。插件则是你要安装的那个包，里面可以有好几个 skill，以及它们要用到的工具。下面讲清两者怎么配合，以及什么时候该用哪个。
更新于 2026年11月5日 · 阅读约 6 分钟
先说结论
| Skill | 插件 | |
|---|---|---|
| 是什么 | 一个装着指令的文件夹，可附带脚本和参考文件 | 一个可安装的能力包 |
| 包含什么 | 一个 SKILL.md 文件，可附带脚本和资源文件 | skill、MCP 服务器、浏览器扩展和 hook |
| 会增加新工具吗？ | 不会。它只是引导 Codex 使用已有的工具 | 会，通过包里的 MCP 服务器 |
| 怎么获取 | 复制文件夹，或者用 $skill-installer | 从插件目录或插件市场安装 |
| 最适合 | 你自己的工作流程，用在一个仓库里或你的电脑上 | 把一整套工作流程分享给别人 |
Codex skill 是什么？
skill 就是一个包含 SKILL.md 文件的目录。文件开头写 name 和 description，后面是用普通 Markdown 写的指令。文件夹里还可以放 scripts/、references/ 和 assets/。
---
name: brand-ui-review
description: 按照我们的品牌规范审查 UI 设计稿。当用户要求做设计评审时使用。
---
逐个界面检查：
- 只用品牌色板里的颜色
- 界面文字用 Inter，正文最小 16px
- 遵循 8px 间距网格
Codex 一开始只读取每个 skill 的名称和描述。当任务和某个描述匹配，或者你点名提到这个 skill 时，它才会加载完整的指令。这样就能同时备着很多 skill，又不会占满上下文窗口。
skill 放在哪里
- 仓库里：
.agents/skills。Codex 会从你当前工作的目录开始，一级一级往上检查，直到仓库根目录。 - 用户级：
~/.agents/skills - 组织级：
/etc/codex/skills，由管理员统一管理。 - 内置：Codex 自带的系统 skill。
怎么用
在 Codex CLI 或 IDE 扩展里，运行 /skills，或者输入 $ 直接提到某个 skill。当你的请求和某个 skill 的描述匹配时，Codex 也会自己选用它。想新建 skill，就让内置的 $skill-creator 来写。想从 skill 合集或代码仓库安装 skill，用 $skill-installer。如果新 skill 没有出现，重启一下 Codex。
Codex 插件是什么？
插件把各种能力打包在一起，一步就能装好。根据 OpenAI 的文档，插件可以包含：
- Skill，也就是上面讲的可复用指令。
- MCP 服务器，给 Codex 增加新工具，比如访问 GitHub、Slack 或某个本地应用。
- 浏览器扩展，用于需要浏览器能力的工作流程。
- Hook，在 Codex 运行过程中的固定节点执行的命令。信任它们之前，先检查一遍。
插件可以从插件目录（Plugins Directory，ChatGPT 和 Codex 共用）安装，也可以从插件市场安装，比如一个 Git 仓库。在 Codex CLI 里运行 /plugins 就能浏览。插件可以在 Codex CLI 里用，也可以在 ChatGPT 桌面应用里的 Codex 中用；IDE 扩展不支持插件。装好之后新开一个会话，新的 skill 和工具才会加载进来。
举个例子：Codex Design 是怎么构成的
Codex Design 是一个插件，两部分都少不了：
- 一个 MCP 服务器，负责添加画布工具：创建画布、打开画布，添加或移动图片和 HTML 节点。没有这些工具，Codex 就没有画布可用。
- 一个 skill，讲清楚怎么用好这些工具：先打开画布再添加界面，每个 HTML 文件都要自包含，并按对应设备设置每个界面的尺寸。
光有 skill，可以描述画布，却没法创建画布。光有 MCP 服务器，工具是有了，却缺少用好它们的门道。插件用一条安装命令就把两者都带来了。参见如何安装 Codex Design。
该用哪个？
适合写 skill 的情况
- 工作流程只需要 Codex 已有的工具，比如读文件、运行命令。
- 它只针对某一个项目，比如你们团队的设计评审清单。
- 你想快速迭代：改一个 Markdown 文件就行。
适合开发或安装插件的情况
- Codex 需要新工具，或者需要访问其他服务。
- 你想把几个相互配套的 skill 打包在一起。
- 你希望别人能一次装好整套工作流程。
常见问题
一个插件可以包含多个 skill 吗？
可以。一个插件可以打包好几个 skill，再加上 MCP 服务器等其他部分。
Codex skill 和 Agent Skills 是一回事吗？
Codex skill 基于开放的 Agent Skills 格式。为其他 Agent 写的 skill，只要用的是同样的 SKILL.md 格式，通常复制到 .agents/skills 里就能在 Codex 中使用。
怎么在不删除的情况下关闭一个 skill？
在 ~/.codex/config.toml 里加一条 [[skills.config]]，写上这个 skill 的路径和 enabled = false，然后重启 Codex。