用途：在编写或升级智能体技能时使用，目标是产出能捕获真实任务知识、自包含可移植、能在正确用户意图下触发、有清晰默认路径与边界、并可用真实提示测试的技能，而非只写一份好看的 SKILL.md。
主要能力与工作流：先捕获真实源材料，再定义技能边界与相邻技能，将技能打包为所需内容全部位于技能目录内，撰写同时说明“做什么”和“何时使用”的强描述，保持 SKILL.md 精简并把细节移入 references/、scripts/、assets/，补充默认值、坑点、验证步骤与输出预期，最后建立小型评估集，对比有技能与基线并迭代。
硬性要求：不要仅凭通用最佳实践合成技能，应从真实运行、文档、修复、追踪、规格与纠正中挖掘；保持包自包含，所需指南、模板、模式或辅助脚本应内置或重写在本技能内，不指向仓库外部文档；捆绑文件使用相对技能根目录的路径；SKILL.md 聚焦几乎每次调用都需要的流程；触发指引放在 frontmatter 的 description 中；优先一条清晰默认路径而非等价选项菜单；对容易造假、跳过或微妙出错之处加入验证步骤。
按需阅读：references/authoring-guide.md 为起草与重构指导；references/spec-quick-reference.md 为格式、frontmatter、布局与路径规则；references/evals-and-iterations.md 为输出质量评估循环、断言、评分与迭代；references/description-optimization.md 为触发评估与描述调优；references/scripts.md 为捆绑辅助脚本与脚本接口设计；assets/skill-template.md 为新技能起始骨架；assets/evals-template.json 与 assets/trigger-evals-template.json 为评估起始文件。
打包规则：从仓库文档、对话或旧技能提取时，把必要知识复制或重写进本技能自己的文件，不依赖技能目录外的仓库文档、绝对路径、仅存在于提取会话的隐性知识或部署包中缺失的上游文档。技能仍可操作用户或项目文件，但指令与捆绑资源应位于技能内部。
编写循环：从真实成功工作提取有效步骤、纠正、环境怪癖、输入输出格式、验证步骤与可复用命令；按成功任务记录、项目文档与规格、缺陷修复与评审、已有可用技能、通用指导的顺序取材。定义边界时明确该技能端到端负责什么、哪些邻近任务不在范围、什么应触发本技能、哪些子变体放 references/。包布局为 skills-best-practices/ 下含 SKILL.md、references/、scripts/、assets/。描述是触发面，须说明做什么、何时用、用用户意图措辞，并覆盖近乎显然的触发情形，宁可略偏主动。正文用渐进披露，指向参考时说明何时阅读。优先默认而非菜单，替代方案仅作回退并说明切换时机。加入命名不匹配、隐藏过滤、API 语义意外、环境或认证怪癖、危险路径等坑点，多步或破坏性工作要求清单、计划-验证-执行流程或完成前具体验证。
最终检查：目录名与 name 一致；描述含做什么与何时用；SKILL.md 为仍保留默认流程的最短版本；细节与变体移入 references/；重复确定性逻辑移入 scripts/；输出模板或夹具放 assets/；主要坑点明确；默认路径与回退分支清晰；需要处有验证步骤；至少 2-3 个真实输出质量评估提示；描述质量重要时另有触发评估集。退出标准是另一智能体无需原始仓库文档或对话即可冷启动并正确完成工作。