06 · Skills 系统
基于官方 Hermes Skills 教程，面向新手讲清 skill、本地正本、渐进加载、slash command、Hub 安装和 agent-managed skills。
Hermes 的 skill 是可复用能力包。它可以包含说明文档、流程、脚本、模板、参考资料和资源文件。
核心不是“保存提示词”，而是把稳定工作流变成可调用能力。
先理解：skill 解决什么问题
一次性任务不需要 skill。反复出现、步骤稳定、需要材料和验证的任务，才值得沉淀成 skill。
Skill 让 Hermes 在需要时加载某个工作流，而不是每次都把全部资料塞进上下文。
安装后的 skill 可以变成 slash command。它从文档变成了操作入口。
怎么判断什么时候做 skill
适合做 skill：跨项目重复出现，有明确触发条件，有稳定步骤，有验证方法，需要模板、脚本或参考资料。
不适合做 skill：一次性任务、还没跑通过的流程、只有一句提示词、强依赖当前项目私有上下文。
如果一个流程你已经成功跑过两三次，并且每次都要复制同一批步骤，就可以考虑做 skill。
本地正本在哪里
本地 skill 正本在 ~/.hermes/skills/。SKILL.md 是入口，大材料应该放到 references、templates、scripts 或 assets，不要全部塞进主文档。
同名 skill 同时存在时，本地版本优先。外部 skill 可以参考和安装，但本地目录才是你真正能长期维护的写入正本。
Progressive disclosure 怎么理解
Hermes skills 使用渐进加载：先看 skill 名称和描述，再加载 SKILL.md，最后按需加载 reference、template、script。
这样做是为了节省上下文。一个 skill 可以很大，但平时不会把所有材料都塞进 prompt。
新手写 skill 时，要让 SKILL.md 足够短，负责说明何时使用和怎么开始；把长材料放到子目录。
Hub 和本地怎么配合
Hub 适合发现、检查和安装外部 skills。
本地 skills 适合你自己的稳定工作流。
安装外部 skill 后，先 inspect，再试小任务，再决定是否复制或改造成自己的本地版本。不要把不理解的 skill 直接用于高权限任务。
Agent-managed skills 要治理
Hermes 允许 agent 自己创建、修改或删除本地 skill。这是自我改进入口，也有风险。
建议只让跑过的成功流程沉淀。小修用 patch，不要整份重写。skill 里不要硬编码密钥。删除或重命名前先确认有没有其他流程依赖。
新手常见坑
- 把一句 prompt 包成 skill：没有复用价值。
SKILL.md太长：渐进加载失去意义。- 没写触发条件：Hermes 不知道何时调用。
- 没写验证方法：流程是否成功无法判断。
- 外部 skill 不审查就安装使用。
- 让 agent 随便重写本地 skill。
怎么验收
你能说清这个 skill 解决什么重复任务。
你能用 slash command 调用它。
你能确认 SKILL.md 只放入口说明，长材料放在子目录。
你能跑一个真实小任务，并看到它按预期步骤执行。
你能说明这个 skill 是否包含脚本、模板、外部依赖或凭据要求。