用途:skill-creator 提供创建与更新有效技能(skill)的指导。技能是模块化、自包含的文件夹,为 Codex 等代理补充专业知识、工作流与工具,相当于特定领域的“上手引导”。
主要能力:先确定目标宿主(Codex 默认 $CODEX_HOME/skills 或 ~/.codex/skills;Claude Code 默认 ~/.claude/skills;GitHub Copilot 或共享目录按用户指定路径与宿主发现规则)。可移植技能应保持 SKILL.md、scripts、references 与安全规则宿主中立,把宿主专用命令放入明确标注的路由段落并提供回退方案。技能结构包含必需的 SKILL.md(YAML frontmatter 的 name 与 description,以及 Markdown 正文),推荐 agents/openai.yaml 界面元数据,以及可选 scripts、references、assets。
使用方式:按步骤进行——用具体示例理解技能、规划可复用内容、运行 scripts/init_skill.py <skill-name> --path <output-directory> [--resources scripts,references,assets] [--examples] 初始化、编辑资源与 SKILL.md、运行 quick_validate.py 验证,再依据真实使用迭代。命名使用小写字母、数字与连字符,长度小于 64 字符,文件夹名与技能名一致。
适用场景:为特定领域构建多步工作流、工具集成、公司专属知识或可复用脚本与模板。
限制:应保持简洁,SKILL.md 正文建议少于 500 行;不要创建 README.md、INSTALLATION_GUIDE.md 等多余文档;避免深层嵌套引用;不要覆盖宿主管理的系统技能。具体脚本参数与完整示例以资料为准,部分内容暂未提供。