用途：本技能用于创建新技能、编辑已有技能，或在部署前验证技能是否有效。其核心主张是“编写技能即把测试驱动开发（TDD）应用于流程文档”：先写测试用例（用子代理构造压力场景），观察失败（基线行为），再写技能（文档），观察通过（代理遵守），最后重构（堵住漏洞）。若未先观察到代理在无技能时的失败，就无法判断技能是否教对了东西。
使用前提：必须先理解 superpowers:test-driven-development（RED-GREEN-REFACTOR 循环）；官方作者最佳实践另见 anthropic-best-practices.md。
创建时机：技术不直观、会跨项目复用、模式适用范围广、对他人有益时创建；一次性方案、已有充分文档的常规做法、项目专属约定（放 CLAUDE.md）、可用正则或校验自动化的机械约束，都不应写成技能。技能类型分技术（有步骤的方法）、模式（思考问题的方式）、参考（API、语法、工具文档）。
目录结构：采用扁平命名空间，每个技能一个目录，内含必需的 SKILL.md，仅在有需要时添加支持文件，如 100 行以上的重型参考或可复用工具脚本。
SKILL.md 结构：YAML frontmatter 仅两个必填字段 name 与 description，总计不超过 1024 字符；name 只用字母、数字和连字符；description 用第三人称，以“Use when...”开头，只描述何时使用，不总结技能流程，尽量控制在 500 字符内。正文建议包含概览、何时使用（含不适用情况）、核心模式、快速参考、实现、常见错误，可选真实影响。
发现优化（CSO）：描述只写触发条件，若总结工作流，Claude 可能照描述执行而跳过正文；关键词要覆盖错误消息、症状、同义词、工具名；命名用动词开头的主动语态。token 效率方面，常加载技能应控制篇幅，细节尽量移到工具帮助或交叉引用。交叉引用其他技能时只写技能名并标注 REQUIRED SUB-SKILL 或 REQUIRED BACKGROUND，避免使用 @ 链接以免提前强制加载、消耗上下文。
流程图只用于非显而易见的决策点、可能过早停止的流程循环以及 A/B 选择，不用于参考表格、代码示例和线性步骤。代码示例只给一个完整可运行、有注释、来自真实场景的范例即可。
铁律：没有先失败的测试，就没有技能。对新建和编辑同样适用，不得以“简单新增”“只加一节”“文档更新”为借口跳过；未测试的改动要删除重来。不同类型技能测试方式不同：纪律型用学术问题、压力场景和多重压力验证；技术型用应用、变体和信息缺口测试；模式型用识别、应用和反例测试；参考型用检索、应用和盲区测试。
常见借口（技能很清楚、只是参考、测试多余、出问题再测、太繁琐、我很有信心、学术审阅足够、没时间测）都指向同一结论：部署前必须测试。为对抗合理化，需显式封堵每个漏洞，并尽早声明“违反规则的字面即违反规则的精神”。本页资料未提供安装命令、价格或平台支持等信息。