Codex Skills 入门：先读真实 Skill，再决定是否安装
Skill 不是“更高级的提示词”，也不是看到高星就该安装的插件。对新手来说，Skill 最有价值的第一课是：它把一个可重复的 agent 工作流写成文件，让 Codex 在合适任务里按这套流程做事。
这页给你一条可照做的学习路径。先读真实 Skill，再决定是否安装。
今天先做这 4 件事
Section titled “今天先做这 4 件事”| 顺序 | 做什么 | 打开哪页 | 完成标志 |
|---|---|---|---|
| 1 | 理解 Skill 怎么被 Codex 发现和触发 | Skill 是什么 | 你能说清 name、description、正文、scripts 分别做什么 |
| 2 | 用真实目录读 openai/skills | Codex Skill 清单 | 你认识 skill-creator、openai-docs、playwright、gh-fix-ci、cloudflare-deploy 的用途和风险 |
| 3 | 按真实任务找高频 Skill | 高频 Skill 应用地图 | 你能把查资料、验收网页、修 CI、部署、安全检查这些任务对应到具体 Skill |
| 4 | 用一张卡片拆一个 Skill | 真实 Skill 只读卡片 | 你能输出“触发场景、会读什么、会不会运行命令、能不能空仓库测试” |
不要从安装开始。先只读。
Codex 里真实存在的 Skill 分层
Section titled “Codex 里真实存在的 Skill 分层”OpenAI 的 openai/skills 仓库当前分为两类：
| 层级 | 例子 | 新手怎么对待 |
|---|---|---|
| System | skill-creator、skill-installer、openai-docs | 先读结构和触发描述；它们是理解 Codex Skills 的入口 |
| Curated | gh-fix-ci、gh-address-comments、playwright、cloudflare-deploy、vercel-deploy、security-threat-model、migrate-to-codex | 先按用途分组阅读；涉及 GitHub、浏览器、部署、迁移时只在测试环境练 |
你要学的不是“哪个 Skill 最强”，而是看到一个 Skill 时能判断：
- 它解决什么重复任务。
- Codex 什么时候会触发它。
- 它是否只写说明，还是会调用脚本、浏览器、GitHub、云服务。
- 它适合只读学习、空仓库测试，还是暂不安装。
新手 30 分钟实战
Section titled “新手 30 分钟实战”0-10 分钟：读 skill-creator
Section titled “0-10 分钟：读 skill-creator”打开 openai/skills 里的 skills/.system/skill-creator/SKILL.md，只看三处：
name：Skill 的名字。description：什么时候该用这个 Skill。- “Anatomy of a Skill”：它如何解释
SKILL.md、scripts/、references/、assets/。
复制给 Codex：
请只读分析 openai/skills 里的 skill-creator，不要安装、不要运行命令。
请输出：1. 这个 Skill 什么时候应该触发2. 它认为一个 Skill 必须包含哪些部分3. 它建议什么时候写脚本，什么时候只写说明4. 新手写自己的第一个 Skill 时最容易犯哪 3 个错误5. 我能从它学走哪一个可复用写法10-20 分钟：读 openai-docs
Section titled “10-20 分钟：读 openai-docs”openai-docs 的价值是让你理解“只基于官方资料回答”的工作流。它适合本站这种教程项目，因为所有 Codex、API、模型、安装信息都可能变化。
你要学到的不是 OpenAI 文档内容，而是这套约束：
- 先找官方资料。
- 不知道就说不知道。
- 推断要标明是推断。
- 给用户来源链接。
20-30 分钟：读一个高风险 Skill
Section titled “20-30 分钟：读一个高风险 Skill”选 cloudflare-deploy、gh-fix-ci 或 playwright 任意一个，只做只读审查：
请只读审查这个 Skill，不要安装、不要运行命令。
Skill 名称：{cloudflare-deploy / gh-fix-ci / playwright}来源：openai/skills访问日期：2026-06-17
请输出：1. 它会让 Codex 做什么真实动作2. 它可能需要哪些账号、权限、命令或外部服务3. 它适合空仓库测试还是真实项目4. 新手照做前必须确认哪 5 件事5. 如果我只是学习它的工作流，应该读哪几段安装前的最低门槛
Section titled “安装前的最低门槛”只有同时满足这些条件，才考虑安装或测试：
- 你知道 Skill 装在哪里。
- 你知道它是否会读写文件、联网、运行脚本。
- 你准备的是空测试仓库，不是真实生产项目。
- 你没有放真实
.env、Token、cookie、客户数据。 - 你知道怎么禁用或删除。
如果做不到，就保持只读学习。
- 想按任务选择：高频 Skill 应用地图。
- 想看真实清单：Codex Skill 清单。
- 想学结构：官方 Skill 结构拆解。
- 想拿一个 Skill 逐项读：官方 Skill 逐项阅读示例。
- 想判断能不能装：Skill 安装风险检查。
- 来源：Codex Agent Skills、openai/skills、Agent Skills open standard。
- 访问日期：2026-06-17。
- 说明：Skill 名称、安装方式、路径和 curated 列表会变化；涉及安装时必须当天复测。