Skill 是 Claude Code 此前推出的一个核心功能,用好Skill 真的能够大大提升工作流的执行效率。
这不刚刚更新的 Codex CLI 0.65 也加入了实验性的 Skills 支持,我把自己在 Claude 里的几个技能迁到了 Codex,简单跑了一遍。
Skills 让“规则与流程”从长 Prompt 中解耦,按需加载,减少上下文开销,也更容易在项目间复用;Codex 这套Skill 支持 和 Claude Skills 基本兼容,迁移成本很低。
Skills 是什么?
以往我会把 CSS 命名规则、测试规范等塞进 AGENTS.md 或每次手动贴到 Prompt。
但这带来了两个问题:
- 上下文占用:长规则占了 Token,影响核心任务。
- 复用困难:不同项目之间很难共享同一套流程。
Codex CLI 的 Skills 提供了一个全局技能库(默认 ~/.codex/skills),每个技能用一个 SKILL.md 定义:
- AI 启动时只读取技能的名称与描述。
- 只有被显式调用,或模型判断需要时,才加载技能全文。
这属于“渐进式披露”的设计:需要时再给细节,避免把所有规则一次性塞进上下文。
差异化与适配性:和传统 Prompt、Claude Skills 的对比
| 维度 | 传统 Prompt/AGENTS.md | Codex CLI Skills | Claude Code Skills |
|---|---|---|---|
| 功能范围 | 把规则直接嵌入到提示词/文档 | 全局技能库,按需加载具体工作流 | 全局技能库,按需加载具体工作流 |
| 技术特征 | 一次性注入,持续占用上下文 | SKILL.md(YAML 头+Markdown),延迟读取 | SKILL.md(YAML 头+Markdown),延迟读取 |
| 兼容性 | 无 | 与 Claude Skills 基本一致,格式直接可用 | 生态成熟,官方库丰富 |
| 使用门槛 | 低,直接写提示词 | 中,需要配置与目录管理(实验性开关) | 中,需配置与目录管理 |
| 适合人群 | 一次性、小型任务 | 需要跨项目复用规则、沉淀流程的个人/团队 | 同左,已在 Claude 生态的用户 |
快速上手:我如何在 Codex 开启第一个 Skill
目前 Skills 是实验特性,需要先打开配置。
开启功能(~/.codex/config.toml):
[features]
skills = true
创建技能目录:
mkdir -p ~/.codex/skills/pdf-processing
编写 SKILL.md(YAML 头 + Markdown 正文):
---
name: pdf-processing
description: Extract text and tables from PDFs; use when PDFs, forms, or document extraction are mentioned.
---
# PDF Processing
- Use pdfplumber to extract text.
- For form filling, see FORMS.md.
重启 Codex CLI 后,通过 /skills 查看,或在对话中用 $pdf-processing 之类的方式调用。

我的体验是:规则不再常驻上下文,调用时模型再读技能全文,响应更聚焦。
如果你之前在 Claude Code 写过技能,直接复制即可:
cp -r ~/.claude/skills/pdf-to-md ~/.codex/skills/pdf-to-md
官方技能库:拿来即用
Anthropic 维护了一个开源仓库 anthropics/skills(https://github.com/anthropics/skills),我挑了两个对开发者友好的示例:
Document Skills(docx/pdf/pptx/xlsx):包括 PDF 表单字段读取、PPT 生成、Excel 数据分析。
Frontend Design:内置 UI 设计原则(排版、色彩、布局),可以规避“功能正确但审美一般”的页面输出。

这些示例不仅能直接用,也便于学习如何把“原则-流程-边界条件”写进一个可重用模块。
从 Claude 迁移到 Codex:基本零改动
Codex 的 SKILL.md 与 Claude 基本一致。我实际迁移步骤:
克隆官方仓库:
git clone https://github.com/anthropics/skills.git
复制所需技能:
cp -r skills/skills/frontend-design ~/.codex/skills/
重启 Codex,/skills 检查是否生效。
迁移后无需重写格式,能直接用,这对已有 Claude 资产的团队很友好。
0.65 版本其他改动:稳定性和交互小升级
- Codex Max 成为默认模型,修复了 TUI 的异步崩溃问题。
- 新增
/resume,恢复中断会话更顺畅。 - TUI 支持
Ctrl-P/N历史导航,修复 Windows 粘贴问题。
结语
从我的使用视角看,Skills 把“规则/流程”从 Prompt 中抽离成可复用模块,并通过按需加载控制上下文规模。
这更接近“在终端里搭建代理工作流”的方式。
对于已经在 Claude 生态沉淀了技能的团队,迁移到 Codex 成本很低,可以直接获得收益。
现在我把它放进了团队的试点清单:先从文档处理和前端规范两个技能起步,配套依赖与命名规范,跑一到两个迭代观察命中率与协作成本,再决定是否扩大覆盖面。