用途:创建或重构 Ship Faster 风格的技能,让技能像“迷你资深工程师”一样正确触发、确定性运行,并在磁盘上留下可续取的产物。
目录约定:SKILL.md 保持简短且易触发,包含路由、安全、输入输出与输出契约;references/ 存放按需加载的深度文档,并从 SKILL.md 直接链接;scripts/ 存放重复或易错工作的确定性辅助脚本;assets/ 存放供复制的模板或文件。
推荐创建流程:收集真实触发短语;定义只含路径的输入输出契约与必需产物;先实现可复用资源(scripts、references、assets);最后写 SKILL.md,其 frontmatter 描述应包含触发短语,正文简短并外链资源;可选地用脚本验证并打包。
主要脚本:初始化 python scripts/init_skill.py <skill-name> --path <output-directory>;验证 python scripts/quick_validate.py /path/to/<skill-name>;同步目录 python scripts/sync_catalog.py;检查 python scripts/skill_lint.py --check-generated;打包 python scripts/package_skill.py /path/to/<skill-name> [output-directory]。
贡献注意:命名前缀建议 workflow-、tool-、review-、mcp-、skill-、publish-;副作用需先写计划、确认后执行、再验证;增删技能后更新 skills/manifest.json。
Claude Code 说明:斜杠命令与技能已合并,.claude/commands/<name>.md 与 .claude/skills/<name>/SKILL.md 都会创建 /<name>,旧命令文件继续可用;新技能可用 disable-model-invocation、user-invocable、context: fork 与 agent、allowed-tools 等 frontmatter 控制。旧版长文指南见 references/legacy-skill-creator.md。具体收费、价格与平台支持暂未提供。