一文快速入门Codex Skill

每次新开对话都要重新教Codex怎么做？Skill帮你把知识、流程、规范打包好，需要时自动调用。手把手教你从零创建和使用Codex Skill，附官方仓库及社区资源获取方式。

西柚云

3106人浏览 · 2026-04-03 08:30:00

西柚云 · 2026-04-03 08:30:00 发布

上一篇我们介绍了Skill的概念、价值，以及Claude Code中Skill的使用方法：一文快速入门ClaudeCode Skill。今天来看看OpenAI Codex CLI的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 "^&gt;" input.fa`
- "提取长度&gt;1000的序列" → `seqtk seq -L 1000 input.fa &gt; 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）