Hermes Agent Skills 指南背景

Skills · Agent Skills System

Teach.
Then Reuse.

将重复流程写成 Skill，按需加载、执行与验证。

Nous Research
Docs checked 2026-06

01 / Overview

Skill 是按需加载的操作知识。

What it is

不是模型训练，也不是普通聊天记录。

Skill 是一组可复用的 Markdown 指令，描述何时触发、如何执行、使用哪些工具、如何处理错误以及怎样验证结果。

Source of truth

~/.hermes/skills/

内置 Skill、Hub 安装的 Skill、Hermes 自动生成的 Skill 和手写 Skill 都集中在这个目录。Hermes 可以读取、修改和删除它们。

Discovery

先看索引

会话开始时只加载 Skill 名称和简短描述，不会把全部正文塞进上下文。

Load

需要时展开

匹配任务后加载对应 SKILL.md；引用资料和脚本只在需要时继续读取。

Reuse

自动成为命令

已安装的 Skill 会变成斜杠命令，例如 /plan 或 /my-workflow。

02 / Install

先安装 Hermes，再初始化模型与工具。

Linux · macOS · WSL2

命令行安装

Install Hermes Agent
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows PowerShell

原生 Windows 安装

Install on Windows
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Setup

使用 Nous Portal 完成最快初始化

Portal setup
hermes setup --portal

也可以配置 OpenRouter、OpenAI、NVIDIA NIM 或其它支持的模型提供方。Skill 与模型提供方相互独立，更换模型通常不需要改写 Skill。

03 / Use

查看、搜索并调用已安装 Skill。

List

列出当前 Skill

List skills
hermes skills list

在聊天会话中也可以输入 /skills。

Search

按关键词搜索

Search skills
/skills search docker
/skills search research
Invoke

Skill 名称就是命令。

Run installed skills
/plan 设计一个静态网站上线方案
/github-pr-workflow 为认证模块创建 PR
/excalidraw

不带参数调用时，Hermes 会先加载 Skill，再询问具体任务。也可以直接用自然语言要求 Hermes 使用某个 Skill。

04 / Create

两种创建方式：让 Hermes 学，或手工编写。

Learn from sources

/learn

把文档、网页或已经明确的工作方法交给 Hermes，它会收集资料并生成符合项目规范的 Skill。

Learn a reusable workflow
/learn 根据团队部署文档创建 production-deploy skill
Manual authoring

手工创建目录

Create skill folder
mkdir -p ~/.hermes/skills/my-workflow
touch ~/.hermes/skills/my-workflow/SKILL.md
Minimal SKILL.md

保持描述短，步骤具体，验证明确。

SKILL.md example
---
name: deploy-static-site
description: Deploy and verify a static Nginx site
version: 1.0.0
---

# Deploy Static Site

## When to use
Use when publishing an existing static site to an Nginx server.

## Procedure
1. Inspect the project and identify the build output.
2. Validate HTML, CSS, images, and internal links.
3. Copy files to the configured web root.
4. Run `nginx -t` before reloading Nginx.
5. Verify the public URL and HTTPS response.

## Safety
- Never overwrite an unknown web root without inspecting it.
- Never expose secrets or private configuration.

## Verification
- Nginx configuration test passes.
- The public page returns HTTP 200.
- Local assets load without 404 errors.
Recommended tree

复杂 Skill 再增加辅助目录。

Skill directory layout
~/.hermes/skills/deploy-static-site/
├── SKILL.md
├── references/
│   └── nginx-layout.md
├── templates/
│   └── release-checklist.md
├── scripts/
│   └── verify-site.sh
└── assets/
    └── nginx-example.conf
05 / Hub

从官方、可信仓库或社区安装 Skill。

Common commands
目的命令
浏览官方可选 Skillhermes skills browse --source official
搜索 skills.shhermes skills search react --source skills-sh
检查安装详情hermes skills inspect SOURCE/SKILL
安装官方 Skillhermes skills install official/research/arxiv
安装单个 URLhermes skills install https://example.com/SKILL.md --name my-skill
检查更新hermes skills check
更新已安装 Skillhermes skills update
卸载hermes skills uninstall my-skill
Custom tap

订阅团队 Skill 仓库

Add a GitHub tap
hermes skills tap add my-org/hermes-skills
hermes skills search deploy
hermes skills install my-org/hermes-skills/deploy-runbook
Publish

发布自己的 Skill

Publish to GitHub
hermes skills publish skills/my-skill \
  --to github \
  --repo owner/repo
06 / Security

Skill 是可执行操作知识，安装前必须审查。

Scanner

第三方 Skill 会接受安全扫描。

Hermes 会检查数据外传、提示注入、破坏性命令和供应链风险。社区来源默认采用更严格的信任策略。

Audit

重新扫描所有 Hub Skill

Security audit
hermes skills audit
Review

安装前检查这些内容

  • 是否读取 SSH 密钥、浏览器数据或环境变量
  • 是否把文件、日志或密钥发送到外部服务
  • 是否包含删除、覆盖、提权或远程下载命令
  • 脚本依赖是否固定版本，仓库维护者是否可信
Force

--force 不是万能绕过。

它只能覆盖部分 caution 或 warn 级别策略；被判定为 dangerous 的 Skill 仍不能强制安装。使用前应先人工阅读源码。

Restore

恢复被修改的内置 Skill

Restore bundled skill
hermes skills reset google-workspace --restore

--restore 会删除本地修改并恢复当前内置版本。只清除修改标记而保留当前文件时，不加该参数。

Hermes Agent 与 Skills 系统仍在快速更新。本页依据 2026 年 6 月 24 日的官方文档整理；实际使用前可运行 hermes update 并重新查看对应命令的帮助信息。