使用技能系统
基于 Nous Research 官方 Skills System 文档，帮助新手理解 Hermes skill 解决什么问题、何时使用、如何安全安装。
Hermes 的 skill 是按需加载的知识文档和工作流包。官方把它设计成 progressive disclosure：平时只在索引里保留名称和描述，真正需要时才加载完整 SKILL.md 或某个引用文件。
新手可以先把 skill 理解成“可复用的任务说明书”，不是插件市场里的万能能力。
先理解它解决什么问题
普通 prompt 适合一次性任务。Skill 适合会反复出现、步骤明确、容易出错、需要沉淀经验的任务。
例如：
- 每次发 PR 都要按同一套流程检查。
- 每次部署 Kubernetes 都要遵守团队约定。
- 每次做图、查资料、写计划都希望 Agent 先读固定规则。
Skill 的价值不是让 Agent “更聪明”，而是减少每次重新解释流程的成本。
技能放在哪里
官方说明：本地 skill 的主目录是 ~/.hermes/skills/，这是 primary directory 和 source of truth。首次安装时，Hermes 会复制 bundled skills；Hub 安装和 agent 创建的 skill 也会进入这里。
你也可以配置 external skill directories，让 Hermes 扫描外部目录。它们适合共享团队 skill 或跨工具共用 skill，但默认是只读扫描；agent 创建或修改 skill 时，仍然写回 ~/.hermes/skills/。
同名 skill 同时存在时，本地版本优先。
怎么使用 skill
安装后的 skill 会自动变成 slash command。你可以直接输入 /plan ...、/github-pr-workflow ...，也可以只输入 skill 名，让 Hermes 先加载说明再追问你的目标。
新手第一次使用 skill 时，不要急着安装很多。先问 Hermes 当前有哪些 skill，再挑一个低风险的只读 skill 测试。
可以按这个顺序：
- 先查看已有 skill。
- 选一个不需要密钥、不改文件的 skill。
- 让它解释会做什么。
- 再让它执行一个小任务。
- 看输出是否符合 skill 的目标。
什么是渐进加载
Progressive disclosure 的意思是：Agent 不会一开始把所有 skill 全文塞进上下文。
官方加载层级可以这样理解：
- Level 0：只看 skill 列表和描述。
- Level 1：加载某个 skill 的主文档。
- Level 2：只加载这个 skill 里的某个 reference、template 或 script 说明。
这对新手的启发是：不要把所有材料都塞进 SKILL.md。主文件只写触发条件、步骤和验收；长资料放到 references/，模板放到 templates/，脚本放到 scripts/。
什么时候该安装新 skill
适合安装：
- 你已经知道这个任务会重复做。
- skill 来源可信，或者你愿意先审查。
- 它的权限、依赖和密钥需求说得清楚。
- 它能给出可验证产出。
不适合安装：
- 只是一次性好奇。
- 来源不明，但要求执行脚本或读取敏感目录。
- 你还没理解 Hermes 的 toolset 和 terminal backend。
- skill 的描述很泛，只说“提升效率”但没有步骤和验收。
新手常见坑
- 把 skill 当成魔法插件，安装后不读说明。
SKILL.md写成长篇资料库，导致真正步骤反而不清楚。- 让 skill 直接索要密钥，而不是用官方的 secure setup 机制。
- 在消息平台聊天里输入密钥。
- 不区分 bundled、official optional、community、URL 直装来源。
- 忽略安全扫描结果，看到
--force就直接强装。
怎么判断 skill 是好的
一个可用 skill 至少应该回答清楚：
- 什么时候该用它。
- 它会做哪些步骤。
- 它需要哪些工具、密钥或平台。
- 失败时常见原因是什么。
- 完成后怎么验证。
如果这些问题答不出来，先不要把它放进日常工作流。
官方资料
- Hermes Agent: Skills System
- Hermes Agent: Bundled Skills Catalog
- Hermes Agent: Official Optional Skills Catalog
- Hermes Agent GitHub
最近更新：2026年5月4日