用途：这是一份指导你设计、撰写和维护 Claude Skill 的教程，涵盖何时该把它做成 Skill、如何写能真正触发的 description、如何组织 SKILL.md 与 references，以及如何测试和迭代。
适用场景：反复写同一提示或指令；想把某套工作流或框架打包复用；已有 Skill 该触发却没触发；要发布给他人使用；想让 Claude 学会某个领域特定工作方式；需要评审他人写的 Skill。不适合：一次性提示、应放在系统上下文而非渐进式披露的信息、要改变 Claude 在所有对话中的通用行为（应使用设置或系统提示）、替代工具调用（Skill 是指令不是工具）。
框架：Skill 是一个含 SKILL.md 的文件夹，SKILL.md 有 YAML frontmatter（name 和 description）及正文指令，还可包含按需加载的参考文件、脚本或模板。核心是渐进式披露：description 常驻系统提示，正文与参考文件仅在触发时加载。
流程：1）判断形态，看是否重复 5 次以上、输出需一致结构、有明确触发条件、指令超 200 词、模板或参考资料有用、他人也可能受益。2）定义触发，写出会触发它的具体说法或情境。3）写 description，包含做什么、何时用、Also triggers when 边界、Useful for 受众四部分。4）组织正文，常见章节为 When to use、When NOT to use、Required inputs、The framework、Workflow、Failure patterns、Output format、Reference files。5）把过长或不常需要的内容放进 references，命名可用 [noun]-template.md、[noun]-checklist.md、[noun]-playbook.md、example-[scenario].md，并在正文中一行说明。6）测试与迭代：触发测试、边界测试、误触发测试、输出测试、长度测试（SKILL.md 保持 250 行内、参考文件 400 行内）。
常见失败：description 过窄或过宽、缺触发短语、SKILL.md 过长、参考文件与正文重复、缺 When NOT to use、缺示例、只围绕单一用例、发布后不迭代、公开 Skill 混入品牌或实现细节（公开 Skill 宜讲方法论，实现细节留在内部）。
输出物：触发分析、description 草稿、SKILL.md 正文、参考文件计划、至少一份完整参考文件、测试提示计划。
限制：资料未提供安装命令、价格、平台或效果数据。