用途：当用户要求创建、撰写、编辑或测试一个技能时使用；也用于为未来的 Claude 实例沉淀可复用的技术、模式或工作流。其核心理念是“技能撰写即是把测试驱动开发（TDD）应用于流程文档化”——先写压力测试场景，观察代理在无技能时违反基线，再写技能使其遵守，最后重构堵住漏洞。使用前必须理解 superpowers:test-driven-development，并遵循同一铁律：没有失败测试，就不写技能（新建与修改皆然）。
主要能力与结构：技能分三层加载——元数据（YAML frontmatter 的 name 与 description，始终加载，约 100 tokens）、指令（SKILL.md 主体，触发时加载，建议 5000 tokens 内、500 行内）、资源（脚本、模板、参考文档，按需加载）。frontmatter 仅支持 name 与 description，总长不超过 1024 字符；description 只写“何时使用”（以 Use when... 开头、第三人称、含触发症状），绝不概括工作流，否则 Claude 可能只读 description 而不读技能正文。技能类型分技术（Technique）、模式（Pattern）、参考（Reference）。目录为扁平命名空间，SKILL.md 必需，重型参考与可复用工具单独成文件。应按动词开头命名（如 creating-skills），并做关键词与 token 效率优化。
使用方式：按 RED-GREEN-REFACTOR 流程——先用子代理跑基线压力场景并记录其合理化借口，再写针对性技能，再验证代理是否遵守，然后循环堵漏。对纪律约束型、技术型、模式型技能需采用不同的测试方式；可用 render-graphs.js 将流程图渲染为 SVG，用 wc -w 检查字数。多技能协同时应让各自触发条件互不重叠。
适用场景：需要跨项目复用的方法、模式或工具文档；不适用一次性方案、他处已充分记录的通用做法或项目专属约定（后者应放入 CLAUDE.md）。
限制：资料未提供具体代码实现、收费或平台细节；官方最佳实践另见 anthropic-best-practices.md。