一文快速入门Codex Skill
西柚云
Codex也有Skill
Codex同样使用“Skill”这一术语,其核心文件、存储结构、使用方式与Claude Code几乎一致,具体对比如下:
| Claude Code | OpenAI Codex CLI | |
|---|---|---|
| 官方术语 | Skill | Skill |
| 核心文件 | SKILL.md | SKILL.md |
| 存储位置 | ~/.claude/skills/ | ~/.codex/skills/ |
| 触发方式 | 自动匹配或 /skill-name | 自动匹配或 $skill-name |
| 内置创建工具 | skill-creator(需安装) | $skill-creator(内置) |
Codex Skill的核心机制:渐进式披露
Codex使用渐进式披露管理上下文 :
- 始终加载:Skill的元数据(name, description, 文件路径)
- 触发时加载:完整的SKILL.md指令
- 按需加载:scripts/和references/中的资源
这样即使安装几十个Skill,也不会拖慢速度。
Codex Skill的介绍
文件结构
my-skill/
├── SKILL.md # 必需:指令+元数据
├── scripts/ # 可选:可执行脚本
├── references/ # 可选:文档资料
├── assets/ # 可选:模板、图标
└── agents/
└── openai.yaml # 可选:UI配置和依赖核心文件
与Claude Code Skill基本一致,Codex的核心文件也是SKILL.md,基本模板:
--- name: your-skill-name description: 触发条件:什么场景下Codex自动调用 --- # 技能标题 ## 核心指令 1. 步骤一 2. 步骤二 ## 示例 - 用户问:"..." → 你应该:"..." ## 补充规则 - 规则 1 - 规则 2
创建和使用
Codex Skill的创建
方式一:使用内置创建器(推荐)
Codex内置$skill-creator,无需安装 :
$skill-creator
在Codex中运行$skill-creator,若此前已有中文对话,Codex识别到中文环境后会直接输出中文;否则首次可能输出英文,需先用中文对话几句,后续即可切换为中文交互。根据提示提供名称、触发示例和存放位置等信息,即可自动生成Skill。

方式二:手动创建
第一步:创建 Skill 文件夹
mkdir -p ~/.codex/skills/fasta-tools
第二步:编写 SKILL.md
vim ~/.codex/skills/fasta-tools/SKILL.md
示例内容:
--- name: fasta-tools description: FASTA 文件操作。当用户提到 fasta、序列、基因、基因组时使用。 --- # FASTA 工具箱 ## 指令 1. 询问具体需求(统计、提取、转换、过滤) 2. 提供 shell 命令(推荐)或 Python 代码 3. 解释命令每个参数的含义 ## 示例 - "统计序列数量" → `grep -c "^>" input.fa` - "提取长度>1000的序列" → `seqtk seq -L 1000 input.fa > output.fa` ## 补充规则 - 优先给一行命令,复杂需求才给脚本 - 提醒用户修改输入/输出文件名
第三步:验证安装
ls ~/.codex/skills/

Codex Skill的使用
验证安装:输入$(或运行/skills后选“List skills”),即可查看可用Skill列表,确认fasta-tools是否创建成功。

fasta-tools创建成功后,可通过以下方式使用:
方式一:自然语言触发(推荐)
“怎么统计fasta文件有多少条序列”

方式二:命令行调用
$fasta-tools

哪里可以找到别人写好的Skill?
与Claude Skill类似,Codex Skill也有官方和社区资源可供选择:
| 来源 | 地址 | 特点 |
|---|---|---|
| OpenAI 官方 | github.com/openai/skills | 内置示例 |
| bioSkills | github.com/GPTomics/bioSkills | 62 分类 425 技能,支持 Codex |
| SkillMD.ai | https://skillmd.ai/ | 社区市场(10万+ Agent Skills) |
也可通过以下方式补充:
- 改造通用Skill:用$skill-creator创建后修改
- 关注官方仓库:OpenAI Skills仓库(github.com/openai/skills)
- 自建团队库:封装实验室流程,内部共享
结语
Skill的本质是“知识复用”。Claude Code和Codex的Skill几乎完全相同——同样的SKILL.md结构,同样的使用逻辑,学会一个,另一个自然就会。这才是真正的“一次编写,到处运行”。
到此这篇关于一文快速入门Codex Skill的文章就介绍到这了,更多相关Codex Skill内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!
