Skill Creator 技能创建指南
指导你设计、编写、验证和迭代可复用的 Codex 技能。
技能仅指导创建技能、生成配置和运行本地验证脚本，未见恶意行为、凭据窃取或隐蔽外传；但未明确用户确认、权限边界、数据流、回滚机制或敏感数据处理，且许可证元数据未知，因此扣分。
文档提供了较清晰的创建、编辑、验证流程，脚本之间的主要路径基本一致；但本次为静态审查，未执行脚本，缺少提交的测试套件、CI覆盖和针对异常输入的完整诊断反馈，且默认提示词不符合其引用规范，因此限制在静态上限内并扣分。
名称、触发描述、目标用户和主要使用场景较明确，覆盖新建或更新技能；但非适用范围、语义误触发边界、中文使用说明和中国大陆网络环境适配证据不足，因此未接近满分。
文档结构清晰，说明了渐进式披露、目录组织、资源类型、命名和验证流程；但许可证、版本策略、变更记录、维护责任和更新路径不完整，且缺少故障排查与FAQ，故扣分。
技能可提供创建技能的模板、流程和辅助脚本，核心任务具有直接帮助；但输出质量依赖后续人工编辑，代表性结果未被执行验证，且相对手工流程的收益证据有限，因此按静态审查保守评分。
源文件、脚本逻辑和验证规则可审计，提供有限的可复核依据；但没有执行记录、第三方复现证据、测试套件或CI结果，因此仅给予静态证据范围内的分数。
- 使用前应确认脚本运行范围、写入目标和是否会覆盖现有文件，并自行保留备份；当前文档未提供回滚方案。
- 许可证、版本、维护责任和更新来源未在选定技能路径中明确，分发前应补充核验。
- 默认提示词未按引用规范明确包含$skill-creator，可能影响一致的调用体验。
- 本评估未执行脚本或验证真实输出，不能视为运行可靠性或结果质量证明。
它能做什么 & 适用场景
Skill Creator 是一个面向 Codex 技能开发者的流程指南。它说明如何规划技能内容、组织 SKILL.md 及可选的脚本、参考资料和资源，并强调渐进式披露与适当的自由度。指南还覆盖技能命名、初始化、编辑、验证和后续迭代。该技能适合需要创建或更新 Codex 技能的开发者，但内容明确围绕 Codex 的技能结构和工具展开。
指导用户分析具体使用示例，规划 scripts、references 和 assets，使用 init_skill.py 初始化技能，编写带有 name 与 description 的 SKILL.md，生成或更新 agents/openai.yaml，并使用 quick_validate.py 验证技能。它提供关于技能结构、触发描述、资源组织、命名规则和渐进式披露的书面规范。
- 需要为特定领域创建新 Codex 技能的开发者，可按步骤规划内容并初始化技能目录。
- 需要把重复代码或确定性流程封装为脚本的团队，可依据指南决定何时加入 scripts 资源。
- 需要为数据库架构、公司政策或 API 文档提供按需上下文的开发者，可使用 references 组织资料。
- 需要更新已有技能的开发者，可根据真实使用情况修改 SKILL.md 或资源并重新验证。
优缺点一览
- 提供从需求理解到验证迭代的完整开发流程。
- 明确区分 SKILL.md、脚本、参考资料和输出资源的职责。
- 强调简洁、渐进式披露和按任务风险设置自由度。
- 包含技能命名、前置元数据和验证规则。
- 内容针对 Codex 技能创建，迁移到其他 Agent Skills 客户端可能需要调整。
- 资料未展示所引用辅助脚本的完整实现，无法据此确认所有平台行为。
- 未提供测试套件、平台覆盖范围或单技能许可证文本。
- 该仓库 README 标明已弃用，建议参考 OpenAI Plugins 仓库和新的插件构建指南。
如何安装
该技能位于仓库的 skills/.system/skill-creator/SKILL.md。README 说明，.system 技能会随最新版本 Codex 自动安装；来源未提供单独的手动安装命令。单个技能的许可证应查看其目录中的 LICENSE.txt，但本资料未提供该文件内容。
如何使用
在 Codex 中提出创建或更新技能的请求，例如“创建一个用于处理 PDF 的技能”或“更新现有技能以支持新的工作流”。创建技能时，指南要求依次理解示例、规划可复用内容、运行 scripts/init_skill.py、编辑 SKILL.md、运行 scripts/quick_validate.py，并根据实际使用迭代；具体脚本参数应以源代码或本地环境为准。