用途：write-skills 用于创建或修订智能体技能文件，适用于新增技能、重命名技能、简化已有技能、改进触发描述，或判断技能该如何拆分与组织。
主要能力：给出技能写作的第一性原理与结构模板。核心观点是技能不是文档，而是压缩的操作记忆，目标是可预测性——让智能体每次运行走同一流程，而非产出相同结果。只保留会改变智能体行为的上下文。
关键原则：从 description 触发，frontmatter 的 description 是技能加载前唯一被读取的部分，需说明技能做什么以及具体触发场景，不要把触发规则藏在正文。像花稀缺资源一样花 token，假设智能体已擅长通用推理，只给方向。写流程而非散文，优先使用祈使规则、决策点和小例子。使用渐进披露，主文件保持简短，长 schema、示例、供应商文档放入被链接的 references/ 文件，可重复的脆弱操作放入 scripts/，可复用输出材料放入 assets/。通过实际使用验证，让全新智能体在真实任务上盲跑，并在会运行它的最弱模型上测试。示例应记录问题而非解决方案，写失败模式与征兆，让智能体针对当前代码自行推导修复。
引导词：引导词是模型预训练中已有的紧凑概念，如 fog of war、tracer bullets、red、tight，一个词即可招募模型已有先验，用最少 token 锚定一整片行为。
调用方式：模型调用（默认）保留 description 以便智能体自行触发，代价是每轮占用上下文；用户调用设置 disable-model-invocation: true，仅用户输入名称可调用，零上下文负载。
信息层级：技能内步骤、技能内参考、外部参考。步骤需有可检查的完成标准。拆分按调用或按序列进行，每次拆分都有成本。
失败模式：过早完成、禁运、侥幸通过、重复、沉积、战争故事、实现索引、蔓延、无效行。
结构模板：frontmatter 含 name 与 description，正文含标题、一段定义、Workflow 步骤、Rules 规则。
编辑检查：名称用动作加复数名词的小写连字符形式，如 audit-tests、write-skills，文件夹与 frontmatter 名称保持一致；description 要具体到无需正文即可触发；删除正文中的“何时使用”章节、陈旧历史、占位符、文件路径与行号；优先一条强规则而非多条重叠要点；示例保持微小真实；除非是技能明确指示读取的参考，否则不加 README、changelog 或辅助文档；可用时运行技能验证器。
限制：资料未提供具体安装命令、收费方式、支持平台或运行环境要求。