一、用途 skill-creator 用于在用户想要创建新技能或更新已有技能、以扩展 Codex 能力时提供指导。技能是模块化、自包含的文件夹，可为 Codex 提供专门知识、工作流和工具。
二、主要能力
- 说明技能的核心原则：内容需简洁，仅添加 Codex 不具备的上下文；按任务脆弱性设置自由度。
- 定义技能结构：必需的 SKILL.md（含 YAML frontmatter 的 name 与 description，以及 Markdown 指令），推荐的 agents/openai.yaml，可选 scripts/、references/、assets/ 资源目录。
- 阐述渐进式披露：元数据常驻上下文，SKILL.md 正文在触发时加载（建议 500 行内、<5k 词），捆绑资源按需加载。
- 给出创建流程：用具体示例理解技能、规划可复用资源、初始化、编辑、校验、迭代。
三、必要用法 初始化新技能时运行： scripts/init_skill.py <skill-name> --path <output-directory> [--resources scripts,references,assets] [--examples] 例如： scripts/init_skill.py my-skill --path skills/public 脚本会生成目录、带 TODO 的 SKILL.md 模板及 agents/openai.yaml；可通过 --interface key=value 传入 display_name、short_description、default_prompt，或用 scripts/generate_openai_yaml.py <path/to/skill-folder> --interface key=value 重新生成。 技能命名仅用小写字母、数字和连字符，长度小于 64 字符，文件夹名与技能名一致。
四、适用场景与限制 适用于创建或更新扩展 Codex 能力的技能，尤其是含可复用脚本、参考资料或模板的任务。技能中不应包含 README.md、INSTALLATION_GUIDE.md、CHANGELOG.md 等附加文档；避免深层嵌套引用，长参考文件应在顶部加目录。资料未说明具体收费、价格、平台支持范围及校验脚本 quick_validate.py 的详细参数。