用途：writing-skills 用于创建新技能、编辑已有技能，以及在部署前验证技能是否真正有效。其核心主张是：技能写作就是应用到流程文档上的测试驱动开发（TDD）。
主要能力：把 TDD 概念映射到技能创建——测试用例对应带子智能体的压力场景，生产代码对应 SKILL.md 文档，测试失败（RED）对应智能体在无技能时违反规则，测试通过（GREEN）对应智能体在有技能时遵守规则，重构对应在保持合规的同时堵住漏洞。核心原则是：如果没有先观察智能体在没有该技能时失败，就不知道技能是否教对了东西。
使用方式：技能放在智能体专属目录，如 Claude Code 的 ~/.claude/skills、Codex 的 ~/.agents/skills/。目录结构为 skills/skill-name/SKILL.md，重参考（100 行以上）或可复用工具拆分为独立文件。SKILL.md 使用 YAML frontmatter，必填 name 与 description，总计不超过 1024 字符；name 只用字母、数字和连字符；description 用第三人称，只描述何时使用（以 Use when... 开头），不要总结技能流程，尽量控制在 500 字符内。正文建议包含 Overview、When to Use、Core Pattern、Quick Reference、Implementation、Common Mistakes 等部分。可用 wc -w skills/path/SKILL.md 检查篇幅，用 ./render-graphs.js ../some-skill 渲染流程图。
适用场景：技能类型分为技术（具体步骤）、模式（思考方式）、参考（API 与语法文档）。创建时机包括：技术并非显而易见、会跨项目反复参考、模式适用范围广、对他人有帮助。不适合创建的情况：一次性方案、已有充分文档的标准实践、项目专属约定（应放入 CLAUDE.md）、可用正则或校验自动化的机械约束。
限制与要求：使用前必须理解 superpowers:test-driven-development，它定义了 RED-GREEN-REFACTOR 循环。铁律是“没有失败的测试就不写技能”，对新建和编辑同样适用；先写技能再测试就应删除重来。不同技能类型需不同测试方式：纪律类用学术问题与多重压力场景，技术类用应用与变体场景，模式类用识别与反例场景，参考类用检索与缺口测试。资料未提供具体收费、价格或平台支持信息。