用途：这是一份编写和编辑技能（skill）的参考，围绕“可预测性”这一核心目标——指智能体每次运行都走同一流程，而非产出相同结果。适用场景为该工作流与用户请求匹配时。
主要内容： 一、调用方式。模型调用型技能保留描述，智能体可自主触发、其他技能也可调用，但描述会持续占用上下文；做法是省略 disable-model-invocation，并写面向模型的描述。用户调用型技能移除描述，只能由用户手动输入名称触发，零上下文占用；做法是设置 disable-model-invocation: true。仅当智能体或其它技能需自主触及时才用模型调用。用户调用型过多时，可用一个“路由技能”统一索引。
二、描述撰写。模型调用型描述要说清技能是什么、列出应触发的分支；每个分支只写一个触发词，合并同义重复，删去正文已有的身份信息，并前置“引导词”。
三、信息层级。技能由步骤与参考两类内容构成。层级包括：技能内步骤（SKILL.md 中的有序动作，主层级，每步以可检验、必要时穷尽的完成标准收尾）、技能内参考（按需查阅的定义规则）、外部参考（经上下文指针触发的独立文件）。渐进披露即把内容下移到链接文件以保持顶部可读；同分支都需要的内联，仅部分分支需要的放入指针背后。
四、拆分与修剪。按调用拆分（有独立引导词或他技能需触及时）或按顺序拆分（后续步骤诱使提前完成时）。修剪要求单一事实来源、逐句检验相关性、对无效句整句删除而非改写。
五、引导词。引导词是模型预训练中已有的紧凑概念，正文中锚定执行、描述中锚定触发，可减少 token 并增强可预测性。
六、失败模式：提前完成、重复、沉积、臃肿、无效句。
限制：该工作流若涉及上游工具、账号、API key 或本地环境，需相应准备；未经用户明确批准，不得执行破坏性、生产、付费或外部消息类操作；产出或建议须与用户真实来源核对后方可视为最终。来源为 mattpocock/skills（MIT）。