用途：writing-skills 是一套编写 A Team 技能的参考方法。技能被定位为智能体在行动前查阅的参考指南，而不是教程、偏好清单（那属于规则文件）或智能体定义（那属于 .claude/agents/）。
主要能力：给出把技能写好的标准与流程。一个技能必须定义何时使用（触发条件）、何时不该使用（范围限制）、流程（步骤与决策点）、红旗（表示已偏离轨道的模式），并且可验证——智能体照做能产出可衡量的结果。
TDD 流程：RED 阶段先写初稿，给智能体一个应触发该技能的任务，观察它们在哪跳过步骤、哪步理解偏差、哪步以为完成却没完成、哪处技能对重要情况沉默，这些缺口即失败的测试。GREEN 阶段针对每个失败补充明确语言、为智能体的合理化借口加红旗、为含糊步骤加具体示例、必要时把步骤拆小。REFACTOR 阶段删除被忽略的内容、合并冗余章节，并让每个技能保持在约 300 行以内，超出就拆分或抽取。
文件结构：技能文件采用 frontmatter，含 name（与目录名一致的 kebab-case）和 description（一句触发条件加一句产出物），正文含 When to Use、When NOT to Use、The Process（分支可用流程图记号）、Red Flags、Integration 等章节。目录为 skills/kebab-case-name/，文件固定为 SKILL.md，辅助文件为 skills/kebab-case-name/supporting-file.md。
常见错误与修正：技能覆盖过多应拆分为两个聚焦技能；步骤含糊（如“review the code”）应具体化（如“run git diff --staged”）；缺少红旗章节应补上三种最常见误用；缺少“何时不用”应补范围限制；偏好清单移至 .claude/rules/；智能体角色描述移至 .claude/agents/。
注册与验证：写完后将技能加入 CLAUDE.md 技能表、AGENTS.md 技能表，以及 skills/using-a-team/SKILL.md 的触发表，并测试任务能否正确触发与使用。未被使用的技能等于不存在。限制：资料未提供收费、价格、平台支持范围等细节。