用途：帮助创建、审查与改进 Claude/Codex 技能，使技能能正确触发、稳定执行并保持简洁。
主要能力：采用渐进式披露——frontmatter（name、description）用于触发选择，SKILL.md 正文承载核心工作流，references/ 存放按需加载的深层细节；强调技能可组合、对脆弱校验优先使用确定性脚本。
工作流：定义 2-3 个具体用例；起草触发力强的 frontmatter；设计可复用资源（scripts/、references/、assets/）；编写可执行指令与错误处理；运行触发/功能/性能测试；依据欠触发或过触发信号迭代。
frontmatter 设计：name 用 kebab-case 且与文件夹名一致；description 需同时说明技能做什么与何时使用，公式为“[做什么]+[何时用]+[关键能力]”，可加负向触发词减少过触发，并提及相关文件类型。
资源规则：SKILL.md 保持紧凑并链接 references/；技能文件夹内避免多余文档（如 README.md、changelog）。
指令写作：使用祈使句、可测试步骤，包含步骤顺序与依赖、校验检查点、常见错误及修复、示例输入与预期输出；关键检查优先用脚本。
测试协议：触发测试（明显请求、改写请求应触发，无关请求不应触发，目标 10-20 条提示中约 90% 相关提示触发）；功能测试（输出、工具/API 调用、错误路径、边界情况）；性能对比（有无技能时的澄清轮数、失败调用、token 用量、端到端质量）。
迭代规则：欠触发时补充清晰触发短语与技术术语；过触发时加负向触发词并收紧范围；执行问题时收紧指令、加显式校验、脚本化关键检查。
打包：分发前校验并打包，命令为 python3 .agents/skills/skill-creator/scripts/quick_validate.py <skill-dir> 与 python3 .agents/skills/skill-creator/scripts/package_skill.py <skill-dir>。
排错：上传失败提示缺少 SKILL.md 时文件名须精确为 SKILL.md；frontmatter 无效时检查 YAML 分隔符 --- 与语法；技能名无效时用小写 kebab-case；技能未被遵循时把关键指令移到顶部并具体化；行为缓慢时把长内容移入 references/ 并减少启用技能。
参考文件：references/checklist.md、prompt-templates.md、patterns.md、source.md、trigger-examples.md、failure-remedies.md。
限制：资料未提供具体收费、价格、平台支持范围与效果数据。