用途：本技能覆盖 SKILL.md 的编写方法。SKILL.md 是跨工具开放标准（agentskills.io），同一文件可用于 Claude Code（.claude/skills/）、Codex CLI（.agents/skills/）与 Antigravity（.agent/skills/）。规范仅要求 name 和 description 两个字段；各工具特有的扩展项（如 Claude 的 model:/allowed-tools:、Codex 的 agents/openai.yaml 旁挂文件）在各自的 conventions 技能中说明。代理编写见 writing-agents，插件架构见 writing-plugins。
主要能力与用法：
- 描述字段（description）决定技能何时被加载，它不是摘要而是触发机制。应以“Use when...”或“How to...”开头，包含 3 个以上具体触发短语，明确写出工具/框架名称，并匹配用户真实提问。判定标准：若列不出 3 条能匹配该描述的真实用户问题，就重写。
- 正文结构建议顺序：作用域说明（若存在相关技能）、最常用模式（约 80% 提问）、决策矩阵表格、含评分的正反示例、常见错误（反模式）、参考链接。标题规则：H1 仅技能标题且每文件一个；H2 为编号主章节；H3 为主章节下子节；不得跳级。代码示例须先展示问题再给出解法，要求可运行、有上下文、只注释关键行。
- 渐进披露：SKILL.md 保持在 500 行以内，深度内容放入文件系统：references/ 放深度内容与边缘情况，examples/ 放可运行示例，scripts/ 放工具脚本。仅大家都需要的前 5 个模式、少量决策表留在主文件。
- 常见错误：描述写成功能清单、正文讲 Claude 已掌握的理论、超过 500 行、缺作用域说明、伪代码示例、各节权重均等。
- 发布前质量清单：描述含 3 个以上具体触发短语、以“Use when...”开头、有作用域说明、章节编号规范、代码示例先问题后解法、有 A/B 决策表、总行数小于 500、不含模型已知内容、至少一个带前后对比的示例。
限制：资料未提供该技能自身的官方安装命令、定价或平台支持细节；具体工具特有扩展字段需参阅对应 conventions 技能。