Skills 系统是 Hermes Agent 的核心差异化特性——它是唯一内置学习循环的智能体，能够创建技能、在使用中改进技能，并在会话之间保持知识。

技能是什么

Skills 是一组定义智能体行为的指令和工具，它们可以：

• 自动化工作流程 — 封装常见任务模式
• 跨会话学习 — 保存和复用成功的解决方案
• 与社区共享 — 发布和安装他人创建的技能
• 自我改进 — 在使用中不断完善

更多内容参考 Skills 教程：https://www.runoob.com/ai-agent/skills-agent.html。

技能 vs 记忆

经验法则：如果你会把它写进参考文档，它就是技能；如果你会把它贴在便利贴上，它就是记忆。

技能目录结构

所有技能都存放在 ~/.hermes/skills/ 目录——这是唯一的数据源。

初次安装时，内置技能会从仓库复制到此目录。通过 Hub 安装的技能和 Agent 自动创建的技能也保存在这里。

~/.hermes/skills/
├── mlops/                     # 分类目录
│   ├── axolotl/
│   │   ├── SKILL.md           # 主指令文件（必须）
│   │   ├── references/        # 补充文档（按需加载）
│   │   ├── templates/         # 输出模板
│   │   ├── scripts/           # 辅助脚本
│   │   └── assets/            # 附属资源
│   └── vllm/
│       └── SKILL.md
├── devops/
│   └── deploy-k8s/            # Agent 自动创建的技能
│       ├── SKILL.md
│       └── references/
├── .hub/                      # Skills Hub 状态
│   ├── lock.json
│   ├── quarantine/            # 安全隔离区
│   └── audit.log
└── .bundled_manifest          # 记录内置技能版本

每个技能目录的必须文件只有 SKILL.md，其余子目录都是可选的。

Agent 可以修改或删除任何技能——无论是内置的、从 Hub 安装的，还是自己创建的。

渐进式披露：Token 高效加载机制

技能系统最聪明的设计之一是渐进式披露——Agent 不会一次性把所有技能内容塞进上下文，而是分三层按需加载。

Level 0: skills_list()              → [{name, description, category}, ...]
                                       会话启动时加载，约 3,000 tokens
                                       ↓ 只有需要用某个技能时，才继续
Level 1: skill_view(name)           → 完整 SKILL.md 内容 + 元数据
                                       ↓ 只有需要参考文档时，才继续
Level 2: skill_view(name, path)     → 技能内的特定 references/ 文件

这个设计的实际意义非常直接：

• 你安装了 50 个技能，但本次会话只用了 1 个——只有那 1 个的完整内容会占用 Token
• Level 0 的技能列表（约 3,000 tokens）在每次会话启动时固定加载，让 Agent 知道有哪些技能可以用
• 其余内容在 Agent 判断需要时才加载，不用不花

渐进式披露是技能系统区别于把所有文档塞进系统提示词的关键设计。它保证了技能数量可以无限增长，而每次会话的 Token 成本基本恒定。

内置技能一览

Hermes 安装时自带大量内置技能，可以直接使用。

命令行中启动 hermes：

hermes

使用 以下命令查看技能相关命令：

/skills

以下命令可以在会话中查看所有技能:

/skills browse

hermes 直接在命令行中查看:

hermes skills list

桌面版直接点击左侧的技能与工具菜单查看：

技能分类

内置技能按功能分类存放在子目录中：

可选技能（不默认安装）

可选技能随 hermes-agent 一起发布，存放在 optional-skills/ 下，但默认不激活，需要显式安装。

这类技能通常需要额外依赖或是小众用途：

使用技能

技能有两种触发方式：斜杠命令直接调用和自然语言自动触发。

斜杠命令直接调用

每个已安装的技能都自动成为一个斜杠命令。

在任何平台（CLI、Telegram、Discord 等）中直接使用：

内置的 plan 技能是个好例子：运行 /plan [请求] 后，技能指令会告诉 Hermes 先检查上下文，再生成 Markdown 格式的实现计划并保存到 .hermes/plans/，而不是直接执行任务。

自然语言触发

也可以通过自然对话触发技能，Hermes 会通过 skill_view 工具自动加载：

Agent 会识别出需要 arxiv 技能，自动加载后执行。

关键字搜索技能

从 Hub 安装技能

除了内置技能，你还可以从 agentskills.io 社区 Hub 安装第三方技能。

命令行安装

安装后发生了什么：

1. 技能目录被复制到 ~/.hermes/skills/
2. 出现在 skills_list 输出中
3. 可以作为斜杠命令使用

已安装的技能在新会话中生效。如果想在当前会话立即使用，用 /reset 开启新会话，或加 --now 参数立即刷新提示缓存（会多消耗一些 Token）。

验证安装

从 GitHub 仓库添加技能源

/learn 命令：一键从源生成技能

/learn 是将你已知的东西——或一堆参考资料——快速转化为可复用技能的捷径，无需手写 SKILL.md。

它是开放式的：指向任何你能描述的内容，Agent 用它已有的工具收集材料，然后按照标准创作规范生成技能。

/learn 的工作原理

整个过程分为三步：

1. Agent 使用已有工具收集源材料（读取文件、抓取网页、分析当前对话）
2. 按照官方 Skill 创作标准起草 SKILL.md（含 ≤60 字符描述、标准章节顺序、Hermes 工具框架、不编造命令）
3. 通过 skill_manage 工具保存——如果开启了 write_approval，会先请求审批

/learn 在 CLI、消息网关、TUI 和 Dashboard 中均可使用，行为完全一致。Dashboard 的 Skills 页面还提供了图形化的Learn a skill面板，包含目录、URL 和自由文本三个输入框。

Agent 自动创建技能

这是 Hermes 技能系统最独特的部分：Hermes 通过将可复用的流程保存为技能来从经验中学习。

当它解决了一个复杂问题、发现了一个工作流程或被纠正后，它可以将这些知识持久化为技能文档，在未来的会话中加载。

技能随时间积累，让 Agent 越来越擅长处理你的特定任务和环境。

触发时机

完成一个复杂任务（通常涉及 5 步以上工具调用）后，Hermes 可能主动提议：

我注意到我们刚才走完了一个完整的 Docker 多阶段构建流程。
要不要我把这个工作流程保存为技能，下次可以直接复用？

手动要求 Agent 创建技能

你也可以在任何时候主动要求：

控制技能写入权限

默认情况下 Agent 可以自由创建和修改技能。

开启审批模式后，Agent 每次要创建或修改技能时会先请求你的确认：

开启 write_approval 后，你可以预览 Agent 要写入的技能内容再决定是否批准。这是一个重要的安全边界——技能文件无签名溯源信息，无法区分Agent 自己写的和手动放入目录的。

SKILL.md 格式详解

技能就是带有 YAML 前置元数据的 Markdown 文件。

以下是完整格式规范，包含所有可选和必填字段：

字段限制

条件激活：智能显隐机制

技能可以根据当前会话中可用的工具自动显示或隐藏，无需手动管理。

这在多环境部署中非常实用——同一个技能列表在不同环境中自动适配。

实际案例：内置的 duckduckgo-search 技能使用了 fallback_for_toolsets: [web]。

当你配置了 Firecrawl API Key（web 工具集可用）时，这个技能自动隐藏，Agent 直接使用 web_search。

当 API Key 缺失（web 工具集不可用）时，DuckDuckGo 技能自动浮现作为备用方案。

技能包（Skill Bundle）：组合加载

技能包是将多个技能组合在一个斜杠命令下的 YAML 文件。

运行 /<bundle-name> 时，包中列出的所有技能同时加载——适用于某项任务总是需要同一套技能的场景。

创建技能包

使用时：

Agent 会同时加载三个技能，并将重构认证中间件作为用户指令附加进来。

技能包文件格式

技能包存放在 ~/.hermes/skill-bundles/<slug>.yaml：

平台级技能管理

不同平台可以启用不同的技能子集。

例如，开发相关的技能没必要在 Telegram 上出现：

这会打开一个交互式 TUI，让你在每个平台（CLI、Telegram、Discord 等）上分别启用或禁用技能。

手动创建技能：五分钟上手

技能只是带有 YAML 前置元数据的 Markdown 文件。

创建一个技能只需不到五分钟，无需注册，放入 ~/.hermes/skills/ 即可使用。

步骤一：创建目录

步骤二：写 SKILL.md

步骤三（可选）：添加参考文件

步骤四：测试

技能的安全注意事项

写入审批门控

技能文件无签名溯源信息——无法区分Agent 自己写的和手动放入目录的。

写入审批机制与 pending/ 目录管理是关键的安全边界。

开启审批后，write_approval: true 会让所有技能写入操作（包括 Agent 发起的自动创建）暂存为待审批状态，你审核后再决定是否允许写入。

安全扫描

技能内容在加载前会经过威胁扫描，检测提示词注入、后门安装指令等恶意模式。

匹配到威胁模式的内容会被替换为 [BLOCKED: ...] 占位符，阻止其到达模型——文件本身不会被删除，只有威胁内容被屏蔽。

从 Hub 安装时的注意事项

技能更新与维护

检查与更新

重置内置技能

如果你修改了内置技能想恢复原版：

卸载 Hub 技能

卸载只能移除通过 Hub 安装的技能，内置技能无法卸载（但可以通过 hermes skills opt-out 停止接收更新）。

发布技能到 Skills Hub

如果你创建了一个有价值的技能，可以发布到 agentskills.io 与社区共享：

Blueprint：技能 + 定时任务

技能可以声明调度计划，变成一个可共享的自动化蓝图：

安装了这个技能后，运行 /suggestions 可以看到 Hermes 自动提议创建对应的定时任务：

外部技能目录

如果你在 Hermes 之外维护技能——例如多个 AI 工具共享的 ~/.agents/skills/ 目录——可以让 Hermes 同时扫描这些目录。

路径支持 ~ 展开和 ${VAR} 环境变量替换。

重要规则：

• 本地目录（~/.hermes/skills/）优先——同名技能时，本地版本覆盖外部版本
• 外部目录不是写保护边界：如果 Hermes 进程有写入权限，Agent 可以修改外部目录中的技能

常用命令速查

创建自定义技能

技能存储在 ~/.hermes/skills/ 目录中。每个技能是一个包含 skill.md 的目录：

~/.hermes/skills/
└── my-custom-skill/
    └── skill.md

技能格式

---
name: my-custom-skill
description: 一个有用的技能描述
version: 1.0.0
author: your-username
tags: [utility, example]
---

# 技能指令

您是一个专业的[角色]，擅长[领域]...

## 核心能力

1. 能力 A
2. 能力 B
3. 能力 C

## 使用示例

### 示例 1
[描述]

### 示例 2
[描述]

技能元数据

技能命令参考