用途：writing-skills 将测试驱动开发（TDD）方法应用于流程文档，指导创建新技能、编辑已有技能，以及在部署前验证技能是否有效。它把技能编写映射为 RED-GREEN-REFACTOR：先写压力测试场景并观察基线失败，再写技能文档，再验证智能体遵守，最后重构以堵住漏洞。
主要能力：说明何时该创建技能（技术不直观、跨项目复用、模式适用面广、他人受益），何时不该创建（一次性方案、已有标准做法、项目专属约定、可用正则或校验自动化的机械约束）；区分技能类型（技术、模式、参考）；给出目录结构与 SKILL.md 结构；强调描述字段只写触发条件、不总结工作流，并覆盖关键词、命名、token 效率、交叉引用、流程图使用、代码示例与文件组织等要点。
使用方式：技能放在智能体专属目录（如 Claude Code 的 ~/.claude/skills、Codex 的 ~/.codex/skills）。SKILL.md 的 frontmatter 仅支持 name 和 description 两个字段，总计不超过 1024 字符；name 只用字母、数字和连字符；description 用第三人称、以 Use when 开头、尽量控制在 500 字符内。可用 wc -w skills/path/SKILL.md 检查字数；可用 ./render-graphs.js ../some-skill 或加 --combine 渲染流程图。
适用场景：为智能体编写可复用技能文档、审查和修订技能、在部署前做验证。
限制：使用前必须理解 superpowers:test-driven-development；铁律是“没有失败的测试就不写技能”，新技能和编辑均适用，未测试的改动应删除重来。官方最佳实践另见 anthropic-best-practices.md，说服原理见 persuasion-principles.md。资料未提供具体收费、价格与平台支持信息。