用途
Writing Great Skills 是一个针对智能体技能（agent skill，SKILL.md 技能包）的写作与审查规范，用于新建、修订或复核一个技能包。它的目标是把技能写成令牌用量最少、但语义无歧义的形式，并保证范围、路由、披露层级与验证要求都清晰可查。
主要能力与规则要点
范围（Scope）
技能的范围等于用户请求、已确定的约束条件以及已有的授权之和；技能本身不新增任何权限。
代理文案（Agent prose）
写作要求是「最少令牌 + 无歧义含义」。在清晰的前提下可使用 =、→、+ 以及简洁的要点或表格；删除填充内容与重复表述。必须保留条件、动作、例外和证据（proof）；晦涩缩写不等于有效压缩。
路由（Routes）
只加载匹配的路由；Core 始终生效。资料中以 Mermaid 流程图给出核心与两个参考文件的连接关系：
- Core →|Package / metadata / invocation| references/package.md
- Core →|Observed skill failure| references/repair.md
Core 检查项
- Need（必要性）：删掉后是否丢失可复用、非默认的行为；应省略通用型代理建议。
- Trigger（触发）：目的明确且用途区分明显；相关提示能匹配，无关提示不匹配。除非用户要求仅显式触发，否则保留隐式选择。
- Disclosure（披露）：SKILL.md 只放路由与必要的共享规则；条件化的工作流、示例与细节放入 references。每条路由需包含加载条件与直接链接，只加载适用的路由。简短通用规则保留在正文。
- Diagram（图表）：涉及流程、决策、状态或依赖时默认使用 Mermaid；标签简洁，只用一种表示方式，不再用文字重复。非关系型规则用要点或表格。
- Split（拆分）：相同动作与证据放在一起；出现独立使用需求，或出现无法通过更清晰完成度解决的既有失败时，才拆分。
- Resource（资源）：脚本用于重复且易错的逻辑；reference 用于条件化知识；asset 用于被复制的输出。每项资源都需有当前的使用者；不强制固定文件数量。
- Ownership（归属）：规则、定义与注意事项由单一位置负责。检查技能包及相关同级文件与项目说明，合并重复项并删除过期规则。
- Steering（引导）：写明目标动作与可观察的完成标准；对可能出现的错误，给出替代动作。
- Validation（验证）：使用可用的原生验证器，确认改动过的链接、工具、技能存在且元数据一致。实质性或有风险的改动，需用代表性的触发与非触发提示以及实际结果作为证据。运行改动过的脚本；措辞测试不等于行为证明。
使用方式
资料未提供具体调用命令、安装步骤或运行界面，仅以规范条文与一张 Mermaid 流程图的形式呈现，可作为编写或复核 SKILL.md 技能包时的对照清单。
适用场景
适用于需要创建、修改或审查 SKILL.md 技能包的工作，尤其是需要控制令牌用量、明确触发条件与加载层级、并将条件化内容下沉到 references 的场景。
限制
资料未说明支持的平台、是否收费、价格、具体执行环境或效果数据，这些内容暂未提供。