Codex 技能是指令文件夹——一个 SKILL.md 文件加上可选脚本——它们教会 OpenAI 的 Codex 代理每次都以相同方式执行特定任务。Codex 在 .agents/skills 中发现它们,仅在上下文中保留其描述,并通过显式(输入 $)或自动方式激活它们。安装只需一个命令,并且由于格式是可移植的,大多数 Claude Code 技能也可以在 Codex 中运行。本指南介绍了该系统的工作原理,然后列出了 2026 年值得安装的 8 个最佳 Codex 技能。
Codex 技能悄然成为 OpenAI 编码代理中最有用的定制界面。您无需在每次会话中重新解释部署流程、测试约定或研究工作流,而是将程序打包一次,Codex 会在任务匹配时将其引入。但问题是:生态系统尚处于早期阶段,分散在 GitHub 仓库和社区列表中,并且仍在重组——在我们撰写本文时,OpenAI 已经弃用了其原始技能目录,转而采用新的插件系统。
因此,本文有两项任务。首先,用通俗易懂的语言解释截至 2026 年年中 OpenAI Codex 技能的实际工作原理——根据当前的官方文档验证,而非去年的博客文章。其次,列出八个值得今天安装的 Codex 技能,附带真实的安装命令和每个技能的一个诚实缺点。
什么是 Codex 技能?
Codex 技能是一个目录,其中包含一个 SKILL.md 文件——带有 YAML 前置元数据块的 Markdown 指令,声明一个 name 和一个 description——以及可选的 scripts/、references/ 和 assets/ 文件夹。它是一个剧本:描述告诉 Codex 何时应用该技能,主体告诉它如何精确执行。
这种设计有意地节省上下文。启动时,Codex 仅加载已安装技能的名称和描述列表,上限约为模型上下文窗口的 2%(当窗口未知时约为 8,000 个字符)。完整指令仅在技能实际触发时加载。激活方式有三种:
- 显式提及 — 在 CLI 或 IDE 中输入
$按名称提及技能,或运行/skills浏览已安装的技能。 - 隐式匹配 — 当您的任务与技能的描述字段匹配时,Codex 会自行选择一个技能。良好范围的描述很重要。
- 提示内引用 — 在您的请求中直接命名技能。
Codex 从四个位置发现技能:您的仓库中的 .agents/skills(与克隆它的所有人共享)、您的个人库的 ~/.agents/skills、机器范围默认值的 /etc/codex/skills,以及 Codex 自身捆绑的系统技能——例如用于创作的 skill-creator 和用于从 GitHub 拉取技能的 skill-installer。可以在 ~/.codex/config.toml 中关闭单个技能。
AGENTS.md 是始终开启的项目上下文——每次会话都会加载,无论是否相关。Codex 技能是按需过程,仅在任务匹配时加载。插件是 OpenAI 较新的分发包装器:您将工作流编写为技能,然后当您希望其他人安装时将其打包为插件。目前还没有一个官方的 Codex 技能市场——分发通过 GitHub 仓库、社区注册表和插件目录进行。
如何在 Codex 中安装技能
安装比分散的文档所暗示的要简单:技能只是一个文件夹,因此任何将文件夹放入发现路径的操作都有效。GitHub 上的大多数 Codex 技能都可以通过以下路线之一在一分钟内安装。
- 1检查您已有的技能
在 Codex 中运行
/skills。skill-installer和skill-creator等系统技能随最新版 Codex 一起提供,因此安装工具已经存在。 - 2使用技能 CLI 从 GitHub 安装
开源技能 CLI 支持 Codex、Claude Code 和 70 多个其他代理:
npx skills add <owner>/<repo> -y安装到您的项目.agents/skills/中;添加-g用于您的个人库。使用--skill <name>从多技能仓库中挑选。我们的 技能 CLI 指南 涵盖了完整的标志集。 - 3或使用内置安装程序
在 Codex 会话中,输入
$skill-installer,后跟技能名称或 GitHub URL。它会下载文件夹并注册它——重新启动 Codex 以获取新安装的技能。 - 4或手动复制文件夹
克隆任何仓库,并将技能目录放入
.agents/skills/(项目)或~/.agents/skills(个人)。如果它有一个有效的SKILL.md,Codex 就会找到它。 - 5调用并验证
输入
$加上技能名称以显式触发它,或者只描述任务并让描述匹配完成工作。如果技能从未隐式触发,其描述可能过于模糊。
您的代理会编码。它能找到客户吗? Lessie 技能为 Codex、Claude Code 和任何 MCP 兼容代理提供跨 100 多个来源的实时人员搜索,电子邮件准确率达 95%——一键安装,免费开始。
2026 年 8 个最佳 Codex 技能
以下最佳 Codex 技能是根据当前安装路径验证的——与 awesome-codex-skills 等社区列表和实际操作的撰写文章交叉核对——而不是从发布周综述中复制的。选择偏见提前声明:排名第一的是我们自己的技能,之所以排在第一位,是因为它是唯一一个将 Codex 扩展到代码之外,进入实时业务数据的技能,并且每个条目都有一个诚实的缺点。
Lessie Skill
最适合人员和公司数据 — 销售、招聘、市场进入研究
Lessie Skill 在此列表中显得格格不入——但这正是重点。其他所有技能都让 Codex 更擅长构建软件。Lessie 则使其在软件周边工作中有用:寻找客户、候选人、合作伙伴以及验证联系数据以联系他们。在 Codex 中输入 $lessie find Engineering Managers at Stripe(相同的请求在 Claude Code 中运行为 /lessie),代理会搜索 100 多个实时数据源,并在大约 1.9 秒内返回个人资料。
在底层,它暴露了九个工具:find_people、enrich_people(验证电子邮件和电话号码)、review_people、find_organizations、enrich_organization、get_company_job_postings、search_company_news,以及一个缓存的 web_search 和 web_fetch,这些都是免费的。由于整个流程——搜索、丰富、验证——都存在于一个技能中,使用它进行外展的团队报告称,冷回复率从 1% 提升到 12%。电子邮件准确率达到 95%,并且一个信用池涵盖所有内容。请参阅 Lessie 技能页面 获取完整的工具参考。
诚实缺点:它是一个人员和公司数据技能,而不是编码辅助工具——如果您的代理从不离开代码库,您就不需要它。超出免费分配的丰富调用会消耗积分。
Superpowers
最适合工程过程规范
Superpowers 是 Jesse Vincent 的软件工程过程技能集合:在构建前进行头脑风暴、测试驱动开发、系统调试、编写和执行实施计划以及干净地完成分支。它诞生于 Claude Code 生态系统,其技能通过技能 CLI 安装到 Codex 中,是希望代理遵循流程而不是即兴创作的团队的常见首选。
诚实缺点:它具有强烈的主观性,并且安装整个集合会使您的技能列表变得拥挤——当技能库存超出其上下文预算时,Codex 会开始缩短描述。请挑选您将使用的那些工作流。
frontend-design
最适合避免通用 AI 外观的 UI
frontend-design 是 Anthropic 的设计质量技能,它已成为可移植性的典范:为 Claude 编写,却不断安装到 Codex 中。它引导代理远离尖叫着“AI 构建”的通用渐变英雄、圆角卡片美学,转向有意的排版、间距和布局决策。如果您的 Codex 输出交付给真实用户,这是您能获得的最便宜的设计审查。
诚实缺点:它推崇一种强烈的视觉观点。在具有既定设计系统的代码库上,它的观点可能会与您的令牌和组件发生冲突。
grill-me
最适合在编码前对计划进行压力测试
grill-me 颠覆了通常的流程:Codex 不再执行您的计划,而是审问计划——一次一个尖锐的问题——直到假设、边缘情况和未说明的需求都摆上桌面。结果是减少了错误方向的构建,这在代理时间尺度上是最昂贵的失败模式。
诚实缺点:审问是开放式的,没有固定的终点,这对于两行代码的修复来说是不必要的摩擦。将其用于重新制作成本高昂的工作。
gh-fix-ci
最适合修复损坏的 GitHub Actions
gh-fix-ci 来自 OpenAI 自己的精选集:它读取您失败的 GitHub Actions 运行,总结根本原因,并在您批准后实施修复。它的目录兄弟也值得在同一会话中获取——yeet 一次性暂存、提交、推送并打开 PR,而 gh-address-comments 则遍历 PR 审查评论并应用您选择的修复。
诚实缺点:仅限 GitHub Actions,并且需要经过身份验证的 gh CLI。请注意,OpenAI 已弃用独立的目录仓库,转而使用其插件系统,因此预计此安装路径会迁移。
MCP Builder
最适合交付生产 MCP 服务器
MCP Builder 指导代理完成构建模型上下文协议 (MCP) 服务器的四阶段流程:研究 API、实现、测试,然后通过实际调用进行评估。由于 MCP 现在是 Codex、Claude 和大多数其他代理之间的共享管道,因此能够生成在生产环境中实际运行的服务器的技能具有不成比例的价值。
诚实缺点:刻意的四阶段工作流比快速搭建要慢。对于一次性内部工具,它比您需要的仪式更多。
handoff
最适合跨会话和代理的连续性
handoff 解决了上下文窗口死亡问题:它将当前会话中所有重要内容——决策、状态、未完成的线程——压缩成一个 Markdown 文档,新的会话可以接手。由于文档是纯 Markdown,因此交接也适用于跨代理:在 Codex 中开始调查,在 Claude Code 中完成,反之亦然。
诚实缺点:生成的文档默认存储在临时目录中。如果您不提交或移动它,您精心压缩的上下文会随着操作系统清理而消失。
Excalidraw Diagrams
最适合从提示生成架构图
Excalidraw Diagrams 将提示——或 Codex 刚刚读取的代码库——转换为 Excalidraw 流程图或架构图。输出是真实的、可编辑的 Excalidraw 文件而不是渲染图像,这是其区别所在:代理起草图表,您拖动框直到它正确。
诚实缺点:除非您的团队已经在使用 Excalidraw,否则它很小众,并且复杂的图表在生成后仍然需要手动布局清理。
以下是整个 Codex 技能库一览——每个技能的用途、安装方式和成本:
| 技能 | 最适合 | 安装 | 成本 |
|---|---|---|---|
| Lessie Skill | 用于市场进入的人员和公司数据 | npx skills add LessieAI/lessie-skill | 免费开始 |
| Superpowers | 工程过程规范 | npx skills add obra/superpowers | 免费 |
| frontend-design | 非通用 UI 设计 | npx skills add anthropics/skills | 免费 |
| grill-me | 编码前计划审问 | npx skills add mattpocock/skills | 免费 |
| gh-fix-ci | 修复失败的 GitHub Actions | $skill-installer gh-fix-ci | 免费 |
| MCP Builder | 生产 MCP 服务器 | npx skills add anthropics/skills | 免费 |
| handoff | 跨代理会话连续性 | npx skills add mattpocock/skills | 免费 |
| Excalidraw Diagrams | 可编辑的架构图 | npx skills add coleam00/excalidraw-diagram-skill | 免费 |
其中七项技能让您的代理成为更好的工程师。一项技能使其成为创收工具。 Lessie 从 100 多个实时来源搜索经过验证的人员和公司数据,电子邮件准确率达 95%——使用它的团队将冷回复率从 1% 提升到 12%。
Codex 技能 vs Claude 技能
从功能上讲,它们是两种方言中的相同概念:两个代理都将技能定义为包含 SKILL.md 的文件夹,其前置元数据带有名称和触发描述。Claude Code 读取 .claude/skills 并使用 /name 调用;Codex 读取 .agents/skills 并使用 $name 或隐式匹配调用。大多数技能可以在它们之间零修改或进行微小修改即可移植——Anthropic 自己的 frontend-design 和 MCP Builder 是 Codex 列表上的固定项目,跨代理安装程序将两者视为可互换的目标。
实际结果:维护一个技能库,而不是两个。将技能保存在 Git 仓库中,并使用技能 CLI(-a codex -a claude-code)在一个命令中安装到两个代理。Codex 添加了一些平台特定的额外功能——一个可选的 agents/openai.yaml、用于从录制演示中起草技能的记录和回放功能,以及作为分发包装器的插件——但这些都不会破坏可移植性。对于另一方面,我们的 Claude 技能指南 解释了 Anthropic 的实现,我们还维护了一个单独的 最佳 Claude 技能 排名列表——其中大部分,如上所述,可以在 Codex 中不变地安装。
