用途：writing-skills 用于创建新技能、编辑已有技能，或在部署前验证技能是否有效。它把测试驱动开发（TDD）的 RED-GREEN-REFACTOR 循环套用到流程文档上：先写压力测试场景并观察智能体在无技能时的基线失败行为，再编写技能文档，然后验证智能体是否遵守，最后重构以堵住漏洞。使用前要求先理解 test-driven-development 技能。
主要能力：区分技能类型（技术、模式、参考），给出目录结构与 SKILL.md 结构（YAML frontmatter 含 name 与 description，总长不超过 1024 字符）；提供技能发现优化（SDO）建议，强调 description 只写触发条件、不总结工作流，并覆盖关键词、命名、token 效率与交叉引用；说明流程图仅用于非显而易见的决策点；建议代码示例只保留一个可运行的好例子；给出针对纪律型、技术型、模式型、参考型技能的不同测试方法，以及常见跳过测试的借口与反驳。
使用方式：技能放在运行时已安装的技能目录，Codex、Copilot CLI、Gemini CLI 均识别 ~/.agents/skills/ 作为跨运行时别名。目录为 skills/skill-name/SKILL.md，重参考或可复用工具另建文件。可用 wc -w skills/path/SKILL.md 检查字数，用 ./render-graphs.js ../some-skill 或加 --combine 渲染流程图为 SVG。
限制：铁律是“没有失败测试就不写技能”，对新建和编辑同样适用，未测试的改动应删除重来。资料未提供具体收费、价格、平台支持范围或效果数据。