用途：writing-skills 是面向智能体技能的编写与验证方法论，把测试驱动开发（RED-GREEN-REFACTOR）套用到流程类文档上。它适用于创建新技能、修改已有技能、部署前验证技能。
主要能力：给出技能定义与类型划分（技术、模式、参考）；定义目录结构与 SKILL.md 结构，含 YAML frontmatter 的 name、description 要求；提供技能发现优化（SDO）建议，如 description 只写触发条件、不总结工作流、关键词覆盖、动宾命名、词数控制；说明跨技能引用标记、流程图使用边界、代码示例选择与文件组织方式。
必要用法：个人技能放在运行时 skills 目录，采用扁平命名空间；使用前必须先理解 superpowers:test-driven-development，其定义 RED-GREEN-REFACTOR 循环。流程为先跑基线场景、观察失败、记录智能体的具体合理化说辞，再写技能覆盖这些违规，最后验证通过并反复重构补漏。铁律是“没有失败测试就不写技能”，同样适用于对已有技能的编辑。字数可用 wc -w skills/path/SKILL.md 核查；流程图可用 ./render-graphs.js ../some-skill 或加 --combine 渲染为 SVG。
适用场景：需要沉淀可复用技法、模式或参考资料时；判断是否创建技能、如何命名、如何控制加载成本、如何针对不同类型技能设计测试时。
限制：不适用于一次性方案、已有完善文档的标准做法、项目专属约定（应写入说明文件）以及可用正则或校验自动化处理的机械约束。资料未提供具体收费、价格、支持平台或实施效果数据。