一套可直接套用的技能评审四步清单——触发、结构、引导、精简，帮你走出 Skill Hell。
Building Great Agent Skills: The Missing Manual
全片 21 分钟·真正值得盯屏约 1 分钟·1 个必看点
- 0:00 – 2:00听
Skill Hell：为什么需要一份评审清单
开场点出现状：技能随手可得却良莠难辨，组织不知如何把 SOP 变成 agent 可执行的技能。提出四步共享检查清单：触发、结构、引导、精简。
不解决“如何评判与编写”的标准问题，就拿不到技能带来的红利。
纯口头铺陈问题与框架总览，无需要看的画面，适合当播客听。▶ 跳到 0:00 - 2:00 – 7:00略
触发设计：用户调用 vs 模型调用
拆解技能被调用的两种方式，并给出核心心智模型：description 是常驻上下文的“指针”，指向可按需加载的更多上下文；用 disable model invocation: true 去掉指针即变为仅限用户调用。
选用户调用型可直接消除触发不可预测的问题；保留模型调用则必须用 eval 验证触发时机。
此段有全片唯一被标记值得看的画面（约 355s 的指针示意），扫一眼幻灯片有助于建立心智模型，其余部分听讲即可。▶ 跳到 2:00 - 7:00 – 10:40听
内部结构：步骤 + 参考材料
提出技能只由两种单元组成——步骤（流程）和参考材料（支撑信息），并以 2PRD 技能为例演示“先定三个步骤、再配两份参考”的从零编写法。
从零写技能的顺序是：先定步骤，再为每个步骤配参考材料。
以口头讲解方法论和案例为主，章节未标记有依赖画面的内容。▶ 跳到 7:00 - 10:40 – 14:03听
分支分析：让主 skill.md 尽可能小
给出精简主文件的具体判据：所有分支都用到的材料留在主文件，仅单一分支用到的移到技能文件夹内独立 markdown，主文件只留一句“需要时去读这个文件”的指针。
用分支分析决定内容去留，是控制 skill.md 体积的核心手法。
规则性论述，逻辑清晰靠听即可跟上，无演示画面。▶ 跳到 10:40 - 14:03 – 17:30听
引导：leading words 与 legwork 不足
解释“agent 不照我说的做”多因缺少 leading words——能压缩大量含义的特定词（如 vertical slice），效果可在推理轨迹中直接验证；对“某一步敷衍了事”的问题，解法是拆成独立技能并隐藏后续目标。
leading words 的效果可以在推理轨迹里观察验证，这是调技能最直接的反馈回路。
以 Plan Mode 等口头案例论述为主，价值在论证过程而非画面。▶ 跳到 14:03 - 17:30 – 20:42听
四类失败模式与方法自举收尾
指出巨型技能是症状而非病因：违反 DRY、“沉积物”堆积、no-op 段落各有对策（单一事实来源、归位删除、删除测试）；最后把整套方法编码为可直接使用的 “Writing Great Skills” 技能。
怀疑某段落无用就删掉测试——行为不变即为 no-op，可以永久删除。
失败模式清单与收尾均为口头总结，听完即可带走可执行的检查项。▶ 跳到 17:30