用途：这是一份关于如何写好与编辑技能（skill）的参考，核心目标是让智能体在每次运行时走上同样的流程，即可预测性，而非产出相同结果。正文以参考条目为主，术语定义收录在 GLOSSARY.md。
主要能力与原则： 调用方式分两种。模型调用型技能保留描述，智能体可自主触发，其他技能也能触达，但描述会常驻上下文；机制是省略 disable-model-invocation，并写面向模型的描述，加入丰富触发措辞。用户调用型技能移除描述，只能由人输入名称触发，上下文负载为零，但消耗记忆负担；机制是设置 disable-model-invocation: true，描述转为面向人。只有智能体或别的技能必须自主触达时才用模型调用。用户调用技能过多时，可用一个路由技能统一指路。
描述撰写：模型调用型描述需说明技能是什么并列出应触发它的分支。前置主导词；每个分支只留一个触发；同义改写属重复应合并；删掉正文已有的身份信息；只保留触发与必要触达句。
信息层级：内容分步骤与参考两类，按智能体需要材料的即时程度排列。技能内步骤是 SKILL.md 中的有序动作，每步以完成标准收尾，标准要可检验，必要时穷尽。技能内参考是按需查阅的定义、规则或事实。外部参考是被指针引出 SKILL.md、按需加载的文件。完成标准越严格，越能驱动深入工作。渐进披露即把材料下移到链接文件，保持顶层易读；分支是披露的检验标准，各分支都要用的内联，只有部分分支用的放到指针后。同一概念的定义、规则与注意事项应放在同一标题下。
何时拆分：按调用拆，当有独立主导词可自行触发或别的技能必须触达时。按序列拆，当后续步骤会诱使智能体草率完成当前步骤时，把后续步骤藏起来。
精简：每个含义只保留单一权威出处；逐行检查相关性；逐句做无效测试，失败就删整句而非改写。
引导词：引导词是模型预训练中已有的紧凑概念，反复出现可累积分布式定义，用最少 token 锚定一片行为。正文中锚定执行，描述中锚定调用。应主动重构技能以使用引导词，例如把“快、确定、低开销”收成 tight，把“你相信的循环”收成 red。
失败模式：过早完成、重复、沉积（陈旧层堆积）、臃肿、无效句、否定式（应正面陈述目标行为，禁止句只作无法正面表达的硬护栏，并配以该做什么）。
限制：资料未提供具体安装命令、收费与价格、支持平台、版本或性能效果说明。