Skill Creator 技能创建指南
帮助你设计、编写、验证和迭代可复用的 Agent Skill。
内容强调先询问创建位置、使用参数化脚本并通过验证器检查结构；但未系统说明权限边界、敏感数据、网络/外部副作用、用户确认、回滚或依赖安全，因此扣分。
SKILL.md、初始化脚本、YAML 生成脚本和验证脚本的主要流程相互一致，并包含基本错误处理；但静态审查无法证明脚本已执行，缺少针对关键路径、异常输入和跨环境行为的提交测试，因此按静态上限保守扣分。
触发描述明确针对创建或更新 Codex skill，并覆盖工作流、资源、命名和验证；但未充分界定不适用场景、输入输出契约、语义误触发边界，也未说明中文使用或中国大陆网络环境适配，因此扣分。
文档结构清晰，渐进式披露、资源分类、命名规则和引用关系较完整；但缺少明确版本、变更记录、维护责任和更新路径，且 openai.yaml 引用了未在所给证据中确认存在的图标资源，因此扣分。
该技能能提供创建 skill 的流程、模板和三个辅助脚本，核心任务具有直接帮助；但输出仍需用户补全文档并自行测试，缺少真实任务产物或比较收益证据，静态校准下不得超过7分。
提供了可审计的源代码、验证器和流程说明，部分关键主张可由文件追踪；但没有第三方执行证据、CI 覆盖或独立复现结果，事实与预期设计仍未充分交叉验证，因此扣分。
- 这是静态审查，未执行任何脚本或验证命令；不要将流程描述视为已验证的运行结果。
- 初始化脚本会创建目录和文件，使用前应确认目标路径、文件权限及是否需要保留或清理生成内容。
- 应补充图标资源存在性、版本/维护信息、异常输入测试以及敏感数据和外部副作用说明。
它能做什么 & 适用场景
Skill Creator 用于指导新技能的创建和现有技能的更新。它说明了技能的目录结构、SKILL.md 前置元数据、正文组织方式，以及 scripts、references 和 assets 等可选资源的用途。指南强调简洁性、渐进式披露、适当的自由度和验证完整性。它还提供从理解需求到初始化、编辑、验证和迭代的完整流程。
读取技能需求和使用示例，规划可复用的脚本、参考资料和资源；指导创建包含 SKILL.md 的技能目录；说明如何编写 name 与 description 前置字段和正文指令；建议使用 init_skill.py 初始化技能、使用 quick_validate.py 验证技能；指导检查 agents/openai.yaml 与 SKILL.md 是否一致，并通过真实任务进行迭代测试。
- 需要为特定领域创建新 Agent Skill 的开发者，可用它规划目录、资源和触发描述。
- 需要扩展现有技能工作流的团队，可用它判断哪些内容应放入 SKILL.md、references 或 scripts。
- 需要确保技能元数据和命名符合约定的维护者，可用它配合初始化和验证脚本进行检查。
- 需要优化上下文占用的技能作者，可用它设计渐进式披露结构并拆分大型参考资料。
- 需要通过真实任务检查技能泛化能力的开发者，可用它组织前向测试和迭代流程。
优缺点一览
- 覆盖技能创建、更新、验证和迭代的完整生命周期。
- 明确区分 SKILL.md、scripts、references 和 assets 的职责。
- 提供命名、前置字段、上下文控制和渐进式披露的具体规则。
- 包含可复制的初始化和验证命令。
- 内容主要面向 Codex 技能打包和工作流，迁移到其他平台可能需要调整。
- 源材料没有提供该技能的独立安装流程或测试结果。
- 指南要求根据具体任务进行前向测试，但没有附带现成测试套件。
如何安装
该源材料没有记录 skill-creator 的独立安装命令。它位于 openai/codex 仓库的 codex-rs/skills/src/assets/samples/skill-creator/SKILL.md。README 记录的 Codex CLI 安装方式包括：在 macOS 或 Linux 执行 curl -fsSL https://chatgpt.com/codex/install.sh | sh，在 Windows 执行 powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"，或使用 npm install -g @openai/codex、brew install --cask codex。
如何使用
在 Codex 中提出类似“创建一个用于处理 PDF 的新技能，并规划其 scripts、references 和 assets”的请求。若要初始化技能，指南给出的命令是 scripts/init_skill.py <skill-name> --path <output-directory> [--resources scripts,references,assets] [--examples]；完成编辑后运行 scripts/quick_validate.py <path/to/skill-folder>。