官方 Skill 逐项阅读示例：从 skill-creator 开始

这页用真实 Skill 练阅读，不用空模板。

练习对象：openai/skills 里的 skills/.system/skill-creator/SKILL.md。

为什么选它：

• 它是系统 Skill。
• 它本身就在教你怎么创建 Skill。
• 它能让新手看清 name、description、正文、脚本、参考资料之间的关系。

第一步：只看 frontmatter

先读最开头的 YAML 区域：

name: skill-creator
description: ...

你要回答：

字段	应该判断什么
name	名称是否明确，是否和目录一致
description	它是不是说清楚“什么时候用这个 Skill”

不要只看名字。skill-creator 这个名字告诉你它和创建 Skill 有关，但真正决定触发的是 description。

第二步：看它怎么解释 Skill 结构

读正文时重点找这些段落：

• Skill 的 anatomy。
• SKILL.md 的用途。
• scripts/ 什么时候有必要。
• references/ 适合放什么。
• assets/ 适合放什么。

读完应该能输出：

一个 Skill 至少要说清：
1. 什么时候触发
2. 任务步骤是什么
3. 输入和输出是什么
4. 是否需要脚本
5. 是否需要参考资料或模板
6. 如何验证完成

第三步：判断它有没有危险动作

skill-creator 作为教学 Skill，本身适合只读学习。但你仍然要养成检查习惯：

检查项	对 skill-creator 的判断
会不会部署	不会
会不会自动提交代码	不会
会不会要求 Token	不应该
会不会创建文件	只有当你要求创建/更新 Skill 时才可能写文件
是否适合新手只读	适合

关键是：只读分析很安全；让它帮你真正创建 Skill 时，才进入写文件阶段。

第四步：把它转成自己的输出

复制这段给 Codex：

请只读阅读 openai/skills 的 skill-creator，不要创建文件，不要安装任何 Skill。

请按下面格式输出：

## Skill 基本信息
- name:
- description:
- 触发场景：
- 不适合场景：

## 正文工作流
1. 它要求先做什么
2. 它如何判断是否需要 scripts
3. 它如何使用 references
4. 它如何使用 assets
5. 它要求最终输出什么

## 新手可学走的写法
- 写法 1：
- 写法 2：
- 写法 3：

## 风险判断
- 当前只读是否安全：
- 什么时候会写文件：
- 什么时候应该停止：

第五步：再读 openai-docs

第二个练习对象是 skills/.system/openai-docs/SKILL.md。

它适合学习“资料型 Skill”怎么写。你要看：

• 它什么时候被触发。
• 它如何要求使用官方资料。
• 它如何要求标注来源。
• 它如何避免凭过时记忆回答。

复制这段：

请只读阅读 openai-docs Skill，不要联网，不要查询新资料。

我只想学习它的工作流写法。请输出：
1. 它适合什么问题
2. 它如何限制资料来源
3. 它如何处理过时风险
4. 它如何要求引用来源
5. 这套写法如何迁移到“Codex 教程内容复测”

一个合格拆解应该长什么样

合格：

这个 Skill 的 description 明确绑定到“创建或更新 Skill”场景。它不是通用写作助手。
正文要求先判断用户目标，再决定是否需要脚本、references、assets。脚本不是默认选择，只有重复且确定的动作才适合脚本化。
当前只读安全；如果让它创建文件，就进入写入阶段，需要确认目标目录。

不合格：

这个 Skill 很强，可以帮助创建 Skill，建议安装使用。

后者没有触发场景、没有文件边界、没有风险判断，等于没读。

成功标志

你完成这页后，应该能：

• 拿任意一个 SKILL.md 说出它的触发场景。
• 判断正文是不是只有空话。
• 判断有没有脚本和写文件风险。
• 把一个 Skill 拆成“可学习的流程”和“暂时不能执行的动作”。

来源与日期

• 来源：openai/skills、Codex Agent Skills。
• 采集日期：2026-06-17。
• 复测日期：2026-06-17。