作为 Codex 扩展任务能力的核心机制，Codex Skills 遵循开源标准，并以文件夹封装指令、脚本和资源。其渐进式加载机制能够减少 Token 消耗并提高运行效率。本文将系统说明 Skills 的定义与核心优势，逐步演示内置工具创建和手动搭建两种方法，再介绍技能调用方式，并通过创建文件夹的实战案例，帮助开发者快速掌握 Codex 技能扩展。

一、Skills

什么是 Codex Skill?

本质上，Skills 是面向特定任务的能力包，以文件夹形式收纳指令、脚本与资源，并遵循开源标准 http://agentskills.io。

一个 Skill 的核心是 SKILL.md 以 Markdown 格式写成的文件，详细指令与元数据均收录其中。

Skills 采用了颇为巧妙的“渐进式加载”（progressive disclosure）设计：初始上下文中，Codex 仅载入 Skill 的名称和简短描述，以免浪费 token；等到确有需要时，再读取完整指令。因此，Codex 处理长任务时仍能保持高效。

Skills 的主要优势

• 可靠执行特定工作流：涵盖集成任务管理工具、自动修复 CI 失败等场景。
• 易共享：Skill 可由团队或社区便捷分发，也支持跨平台，例如从 Claude 迁移到 Codex。
• 上下文高效：仅在需要时激活，不会污染主提示。
• 可扩展：能够选配脚本、参考文档及资源文件。

plan 负责规划复杂任务，skill-creator 用于创建新 Skill，skill-installer 则用于安装 Skill；这些都属于 Codex 自带的几个系统 Skill。

二、如何创建 Skills

2.1 内置 skill-creator 的使用

在 Codex 中直接调用 $skill-creator，然后描述你想要的 Skill 功能。

例如：“用 pdfplumber 库提取 PDF 文件中的文本和表格，为此创建一个 Skill。”

文件夹结构及 SKILL.md 模板会由 Codex 自动生成。

你还可以先用 $plan Skill 规划，再结合 skill-creator 完善。

2.2 手动创建

基本格式如下：先选定合适目录并添加 SKILL.md 文件，再创建以 Skill 名命名的文件夹。

---
name: your-skill-name
description: 当用户提到 XXX 时使用这个 Skill，帮助完成 YYY。
metadata:
    short-description: 可选的简短用户可见描述
---
# Skill 标题
这里写详细指令：一步步指导 Codex 如何执行任务。
- 使用哪些工具或库
- 处理边缘情况
- 输出格式要求
- 示例等

可选添加子文件夹：

• scripts/：用于存放可执行脚本。
• references/：用于存放参考文档。
• assets/：用于存放模板或其他资源。

从高到低排列 Skill 的存放位置：

• 项目当前目录：.codex/skills/（适用于当前 repo 专用）。
• 项目根目录：repo_root/.codex/skills/（供团队共享）。
• 个人全局：~/.codex/skills/（默认存放位置）。
• 系统内置：由 Codex 自带，无法覆盖。

更高优先级的 Skill 会覆盖同名低优先级 Skill，便于自定义覆盖。

三、如何使用 Skills

Skills 可通过两种方式使用：

显式调用（推荐精确控制）：

• 直接在提示中写 $.skill-name（例如 $.linear）。
• 或在 CLI/IDE 中使用 /skills 命令进行选择。

自动选择（更加自然）：description 字段是否准确，决定了 Codex 能否从任务描述中智能判断并加载相匹配的 Skill。

启动时输入 codex，再输入一个斜杠，即可看到 Skills。

输入 /skills 进入技能菜单，再输入 skill-creator。也能直接通过 $ 调出功能菜单。

四、实战案例

4.1 输入命令

$skill-creator firstskill

4.2 输出内容

由于你明确提出创建名为 firstskill 的新技能，我将使用 skill-creator。

请先用简短中文回答，以完成第 1 步所需的用途和触发场景说明：

1. 这个 skill 具体要解决什么任务？
2. 以“用户会怎么提问”为内容，写出 2–3 句触发语句示例。
3. 若涉及 scripts / references / assets，具体需要哪一类固定流程、脚本或参考资料？
4. 预期输出采用什么形式，例如文字说明、命令或模板文件等？

技能命名、最小 SKILL.md 草案和目录结构，将在确认后给出。

输入内容：

收到，将继续使用 skill-creator。

先确认命名和触发方式，简短回复即可：

1. 触发示例：请提供 2–3 条用户可能提出的问题，使用中文即可。
2. 技能名称：建议 make-folder 或 create-folder，你倾向于哪一个？
3. 是否需要脚本？如果只是通过命令行创建目录，也可以不添加 scripts/。你是否希望加入脚本？

输入内容：

触发演示例子：请帮我创建文件夹test，我要创建一个文件夹，创建文件夹等；名字就叫makefolder；我希望包含脚本。

4.3 输出内容

makefolder 技能骨架及脚本已经建好，采用 skill-creator 完成，兼顾可用与精简。

变更说明

• 新增 skills/makefolder/SKILL.md，其中包含触发描述和使用规则
• 新增 skills/makefolder/scripts/make_folder.ps1，用于在当前项目中创建单一文件夹

文件位置

• skills/makefolder/SKILL.md
• skills/makefolder/scripts/make_folder.ps1

下一步建议

试用脚本：./skills/makefolder/scripts/make_folder.ps1 test

请告诉我你的偏好：加入更多校验规则，或把说明调整为中文。

完成后，项目目录中就会出现一个 Skills。

在 Skills 下方有一个名为 makefolder 的子文件夹。

目录的具体结构如下：

skills/
└── makefolder/
    ├── SKILL.md
    └── scripts/
        └── make_folder.ps1

总结

为了帮助读者灵活拓展 Codex 自动化工作流，本文以新建文件夹为例完成实操演示，并说明显式调用、自动匹配两种使用方式与多优先级存放目录。创建方案涵盖手动编写配置和内置指令生成两种；在此基础上，再系统阐明 Codex Skills 的定义、规范、低耗加载等核心优势，以及自带的规划、创建、安装等系统技能。