简体中文

Codex 技能:工作原理与 2026 年最佳 8 款安装指南

技能是一个 Codex 可以读取的文件夹 — 一次安装,代理每次都以相同方式运行您的剧本。
💡TL;DR

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 中关闭单个技能。

技能 vs. AGENTS.md vs. 插件

AGENTS.md 是始终开启的项目上下文——每次会话都会加载,无论是否相关。Codex 技能是按需过程,仅在任务匹配时加载。插件是 OpenAI 较新的分发包装器:您将工作流编写为技能,然后当您希望其他人安装时将其打包为插件。目前还没有一个官方的 Codex 技能市场——分发通过 GitHub 仓库、社区注册表和插件目录进行。

如何在 Codex 中安装技能

安装比分散的文档所暗示的要简单:技能只是一个文件夹,因此任何将文件夹放入发现路径的操作都有效。GitHub 上的大多数 Codex 技能都可以通过以下路线之一在一分钟内安装。

  1. 1
    检查您已有的技能

    在 Codex 中运行 /skillsskill-installer skill-creator 等系统技能随最新版 Codex 一起提供,因此安装工具已经存在。

  2. 2
    使用技能 CLI 从 GitHub 安装

    开源技能 CLI 支持 Codex、Claude Code 和 70 多个其他代理:npx skills add <owner>/<repo> -y 安装到您的项目 .agents/skills/ 中;添加 -g 用于您的个人库。使用 --skill <name> 从多技能仓库中挑选。我们的 技能 CLI 指南 涵盖了完整的标志集。

  3. 3
    或使用内置安装程序

    在 Codex 会话中,输入 $skill-installer,后跟技能名称或 GitHub URL。它会下载文件夹并注册它——重新启动 Codex 以获取新安装的技能。

  4. 4
    或手动复制文件夹

    克隆任何仓库,并将技能目录放入 .agents/skills/(项目)或 ~/.agents/skills(个人)。如果它有一个有效的 SKILL.md,Codex 就会找到它。

  5. 5
    调用并验证

    输入 $ 加上技能名称以显式触发它,或者只描述任务并让描述匹配完成工作。如果技能从未隐式触发,其描述可能过于模糊。

您的代理会编码。它能找到客户吗? Lessie 技能为 Codex、Claude Code 和任何 MCP 兼容代理提供跨 100 多个来源的实时人员搜索,电子邮件准确率达 95%——一键安装,免费开始。

将 Lessie 添加到您的代理 →

2026 年 8 个最佳 Codex 技能

以下最佳 Codex 技能是根据当前安装路径验证的——与 awesome-codex-skills 等社区列表和实际操作的撰写文章交叉核对——而不是从发布周综述中复制的。选择偏见提前声明:排名第一的是我们自己的技能,之所以排在第一位,是因为它是唯一一个将 Codex 扩展到代码之外,进入实时业务数据的技能,并且每个条目都有一个诚实的缺点。

1

Lessie Skill

最适合人员和公司数据 — 销售、招聘、市场进入研究
Lessie 技能页面显示基于代理的人员搜索

Lessie Skill 在此列表中显得格格不入——但这正是重点。其他所有技能都让 Codex 更擅长构建软件。Lessie 则使其在软件周边工作中有用:寻找客户、候选人、合作伙伴以及验证联系数据以联系他们。在 Codex 中输入 $lessie find Engineering Managers at Stripe(相同的请求在 Claude Code 中运行为 /lessie),代理会搜索 100 多个实时数据源,并在大约 1.9 秒内返回个人资料。

在底层,它暴露了九个工具:find_peopleenrich_people(验证电子邮件和电话号码)、review_peoplefind_organizationsenrich_organizationget_company_job_postingssearch_company_news,以及一个缓存的 web_search web_fetch,这些都是免费的。由于整个流程——搜索、丰富、验证——都存在于一个技能中,使用它进行外展的团队报告称,冷回复率从 1% 提升到 12%。电子邮件准确率达到 95%,并且一个信用池涵盖所有内容。请参阅 Lessie 技能页面 获取完整的工具参考。

诚实缺点:它是一个人员和公司数据技能,而不是编码辅助工具——如果您的代理从不离开代码库,您就不需要它。超出免费分配的丰富调用会消耗积分。

最适合: 从您的终端查找和丰富人员或公司数据
安装: npx skills add LessieAI/lessie-skill -y -g
定价: 免费开始,统一信用池(需要 Lessie 账户)
显著特点: 100+ 实时来源,95% 电子邮件准确率,平均搜索时间约 1.9 秒
2

Superpowers

最适合工程过程规范
Superpowers 技能集合仓库

Superpowers 是 Jesse Vincent 的软件工程过程技能集合:在构建前进行头脑风暴、测试驱动开发、系统调试、编写和执行实施计划以及干净地完成分支。它诞生于 Claude Code 生态系统,其技能通过技能 CLI 安装到 Codex 中,是希望代理遵循流程而不是即兴创作的团队的常见首选。

诚实缺点:它具有强烈的主观性,并且安装整个集合会使您的技能列表变得拥挤——当技能库存超出其上下文预算时,Codex 会开始缩短描述。请挑选您将使用的那些工作流。

最适合: TDD、系统调试、计划驱动开发
安装: npx skills add obra/superpowers -y
显著特点: 经过实战检验的工作流集合,完全开源
3

frontend-design

最适合避免通用 AI 外观的 UI
Anthropic 技能仓库包含 frontend-design

frontend-design 是 Anthropic 的设计质量技能,它已成为可移植性的典范:为 Claude 编写,却不断安装到 Codex 中。它引导代理远离尖叫着“AI 构建”的通用渐变英雄、圆角卡片美学,转向有意的排版、间距和布局决策。如果您的 Codex 输出交付给真实用户,这是您能获得的最便宜的设计审查。

诚实缺点:它推崇一种强烈的视觉观点。在具有既定设计系统的代码库上,它的观点可能会与您的令牌和组件发生冲突。

最适合: 独特、生产级的网页界面
安装: npx skills add anthropics/skills --skill frontend-design
显著特点: 跨代理安装最多的设计技能之一
4

grill-me

最适合在编码前对计划进行压力测试
Matt Pocock 技能仓库包含 grill-me

grill-me 颠覆了通常的流程:Codex 不再执行您的计划,而是审问计划——一次一个尖锐的问题——直到假设、边缘情况和未说明的需求都摆上桌面。结果是减少了错误方向的构建,这在代理时间尺度上是最昂贵的失败模式。

诚实缺点:审问是开放式的,没有固定的终点,这对于两行代码的修复来说是不必要的摩擦。将其用于重新制作成本高昂的工作。

最适合: 在实施前发现隐藏的假设
安装: npx skills add mattpocock/skills --skill grill-me
显著特点: 由 Matt Pocock 制作;一次一个尖锐问题
5

gh-fix-ci

最适合修复损坏的 GitHub Actions
OpenAI 技能目录仓库

gh-fix-ci 来自 OpenAI 自己的精选集:它读取您失败的 GitHub Actions 运行,总结根本原因,并在您批准后实施修复。它的目录兄弟也值得在同一会话中获取——yeet 一次性暂存、提交、推送并打开 PR,而 gh-address-comments 则遍历 PR 审查评论并应用您选择的修复。

诚实缺点:仅限 GitHub Actions,并且需要经过身份验证的 gh CLI。请注意,OpenAI 已弃用独立的目录仓库,转而使用其插件系统,因此预计此安装路径会迁移。

最适合: 诊断和修复失败的 CI 运行
安装: $skill-installer gh-fix-ci (在 Codex 内部)
显著特点: 来自 OpenAI 精选目录;修复前需批准
6

MCP Builder

最适合交付生产 MCP 服务器
Anthropic 技能仓库包含 mcp-builder

MCP Builder 指导代理完成构建模型上下文协议 (MCP) 服务器的四阶段流程:研究 API、实现、测试,然后通过实际调用进行评估。由于 MCP 现在是 Codex、Claude 和大多数其他代理之间的共享管道,因此能够生成在生产环境中实际运行的服务器的技能具有不成比例的价值。

诚实缺点:刻意的四阶段工作流比快速搭建要慢。对于一次性内部工具,它比您需要的仪式更多。

最适合: 构建带有测试和评估的 MCP 服务器
安装: npx skills add anthropics/skills --skill mcp-builder
显著特点: 四阶段流程:研究、构建、测试、评估
7

handoff

最适合跨会话和代理的连续性
Matt Pocock 技能仓库包含 handoff

handoff 解决了上下文窗口死亡问题:它将当前会话中所有重要内容——决策、状态、未完成的线程——压缩成一个 Markdown 文档,新的会话可以接手。由于文档是纯 Markdown,因此交接也适用于跨代理:在 Codex 中开始调查,在 Claude Code 中完成,反之亦然。

诚实缺点:生成的文档默认存储在临时目录中。如果您不提交或移动它,您精心压缩的上下文会随着操作系统清理而消失。

最适合: 在会话、模型或代理之间移动工作
安装: npx skills add mattpocock/skills --skill handoff
显著特点: 将会话状态压缩为可移植的 Markdown 文档
8

Excalidraw Diagrams

最适合从提示生成架构图
Excalidraw 图表技能仓库

Excalidraw Diagrams 将提示——或 Codex 刚刚读取的代码库——转换为 Excalidraw 流程图或架构图。输出是真实的、可编辑的 Excalidraw 文件而不是渲染图像,这是其区别所在:代理起草图表,您拖动框直到它正确。

诚实缺点:除非您的团队已经在使用 Excalidraw,否则它很小众,并且复杂的图表在生成后仍然需要手动布局清理。

最适合: 流程图和系统图作为可编辑文件
安装: npx skills add coleam00/excalidraw-diagram-skill
显著特点: 输出是可编辑的 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%。

免费试用 Lessie — 无需信用卡 →

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 中不变地安装。

常见问题解答

什么是 Codex 技能?

Codex 技能是 OpenAI 的 Codex 代理可重用的指令包:一个包含 SKILL.md 文件的文件夹,带有名称和描述前置元数据,以及可选的脚本和参考文件。Codex 仅在上下文中保留描述(上限约为窗口的 2%),并在任务匹配时加载技能的完整指令——因此技能增加了功能而没有永久的令牌成本。

Codex 技能是免费的吗?

格式是免费的,大多数社区技能都是开源的——从 GitHub 安装是免费的。可能需要付费的是技能所封装的服务:例如,Lessie 的丰富工具在您超出免费分配后会使用免费开始的信用池。在安装之前,请检查每个 SKILL.md 以了解外部依赖项。

哪些 Codex 技能最适合销售和市场进入 (GTM) 工作?

Lessie 技能是其中的佼佼者——它专为人员和公司数据而非代码而构建。它为 Codex 提供了诸如 find_people 和 enrich_people 等工具,可跨 100 多个实时来源提供 95% 的电子邮件准确率,因此潜在客户研究、候选人搜寻和联系人丰富可以在与您的工程工作相同的终端中运行。它还捆绑了一个缓存的 web_search 和 web_fetch 用于一般研究。请参阅 Lessie 技能页面 获取完整的工具列表。

安装第三方 Codex 技能安全吗?

将技能视为任何依赖项:它是指令加上以您的代理权限运行的脚本。在安装之前阅读 SKILL.md 和捆绑脚本,优先选择维护良好的仓库(openai、anthropics、obra、mattpocock、LessieAI),并通过 ~/.codex/config.toml 中的 [[skills.config]] 禁用任何可疑内容。Codex 的沙盒和批准提示仍然适用于技能执行的任何操作。

如何从 GitHub 安装 Codex 技能?

有三种途径。最快:npx skills add owner/repo -y 安装到 .agents/skills/(添加 -g 用于您的个人库)。在会话中:向 $skill-installer 提供技能名称或仓库 URL,然后重新启动 Codex。手动:GitHub 上的大多数 Codex 技能都是普通文件夹——克隆并将文件夹复制到 .agents/skills/ 中。之后使用 /skills 进行验证。

我可以在 Codex 和 Claude Code 中使用相同的技能吗?

通常可以。两个代理都读取文件夹加 SKILL.md 格式,因此一个技能库可以同时为两者服务——像技能 CLI 这样的跨代理安装程序可以在一个命令中从同一个仓库中定位 Codex 和 Claude Code。Lessie 技能就是一个工作示例:安装一次,它就可以在 Codex ($lessie)、Claude Code (/lessie) 和任何 MCP 兼容代理中运行。

安装一项技能。获取 100+ 实时数据源。

Lessie 技能将 Codex、Claude Code 或任何 MCP 兼容代理转变为人员搜索引擎:来自 100 多个实时来源的验证联系人,电子邮件准确率达 95%,平均每次搜索约 1.9 秒。免费开始。

免费开始 →

相关文章