Hermes Agent 技能：安裝技能與建立自己的技能

技能是為代理程式儲存的指示：你只要描述一次如何執行某項工作，之後呼叫 /skill-name 時，Hermes 就會套用這些指示，不必一再說明。現成技能只需一個命令即可安裝；你也可以用兩種方式建立自己的技能：手動撰寫 SKILL.md，或使用 /learn。

如果你還沒有安裝 Hermes，請先閱讀這個代理程式是什麼，以及如何安裝，再開始使用技能。

Hermes Agent 中的技能是什麼？#

你可以在傳給代理程式的訊息中撰寫提示。技能則儲存在獨立檔案中，Hermes 能在未來的工作中使用其中的指示。代理程式可以取得技能名稱和說明清單，並在技能與任務相關時載入完整內容。這能節省上下文空間：不必一次載入所有指示。

技能本身不會賦予代理程式新工具或存取權；它只會說明如何使用代理程式原本就能使用的工具。與外部服務的新整合由 MCP 負責，這是另一個主題。如果任務需要精確的程式邏輯、特殊授權或事件串流處理，就需要代理程式工具，光靠技能並不足夠。

如果標準任務的現成技能指示符合需求，而且來源已確認，就選用現成技能。如果你需要保留自己的操作順序、限制和輸出格式，就自行撰寫技能。如果你已經有資料，或已完成某個流程而不想手動撰寫檔案，就使用 /learn。

這種格式是開放的，且與 Agent Skills 規格相容，因此其他目錄中的技能通常不必更改格式，就能在 Hermes 中使用；不過，特定技能可能需要自己的工具或金鑰。如果你願意，也可以分享自己的技能。

已安裝哪些技能？技能存放在哪裡？#

資料夾的結構如下：

~/.hermes/skills/
├── research/
│   └── arxiv/
│       ├── SKILL.md
│       └── scripts/
├── productivity/
│   └── pdf/
│       ├── SKILL.md
│       └── references/
└── .hub/

SKILL.md 是唯一必備的檔案。其他內容依需求新增：較長的資料放在 references/，輔助程式放在 scripts/，範本和檔案則放在 templates/ 與 assets/。

內建目錄收錄了日常工作所需的技能，例如尋找 GIF、操作 PDF、試算表、YouTube、GitHub 和筆記。完整清單及說明請見內建技能目錄頁面。每次執行 hermes update 時，Hermes 也會更新內建技能，同時保留你對它們所做的修改。

如何從目錄安裝現成技能？#

1. 搜尋目錄

   hermes skills search pdf
   

   搜尋會涵蓋所有已連線的來源。若要不加篩選地查看完整目錄，請執行 hermes skills browse。

2. 查看技能卡片

   hermes skills inspect skills-sh/anthropics/skills/pdf
   

   卡片會顯示說明、來源和信任等級。尚未閱讀卡片前，不要安裝別人的技能。

3. 安裝技能

   hermes skills install skills-sh/anthropics/skills/pdf
   

   Hermes 會下載 SKILL.md 及其相關檔案、執行安全檢查，並將所有內容放入 ~/.hermes/skills/。技能會立即以 /pdf 命令供你使用。如果技能需要額外工具或金鑰，SKILL.md 會列出相關需求，Hermes 也會在安裝時告知你。

安全檢查會尋找試圖將資料傳送到外部、注入給代理程式的指示，以及可能刪除或損壞檔案的命令。來源的信任等級各不相同：

如果檢查發出警告，你可以加上 --force 旗標繼續安裝，但請先閱讀檢查發現的風險。「危險」判定無法略過。檢查本身不能保證安全：第一次執行別人的技能之前，請先閱讀其指示和相關命令。

如何從 GitHub 或連結安裝技能？#

有三種安裝方式：

# 1. GitHub 儲存庫中的特定技能（儲存庫內的路徑接在名稱後面）
hermes skills install anthropics/skills/skills/pdf

# 2. 任何網站上 SKILL.md 的直接連結（在聊天中分享這項技能）
hermes skills install '<OFFICIAL_URL>'

# 3. 將整個儲存庫連結為來源（替換成你的擁有者名稱與儲存庫名稱）
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

使用直接連結時，Hermes 會下載 SKILL.md，以及其中提及的服務子資料夾中的檔案；不會下載網站上無關的檔案。連結會記錄為來源，之後執行 hermes skills update 時，Hermes 會從同一個網址更新技能。

除了 GitHub 之外，也可以連結外部技能目錄。你可以使用相同的 hermes skills search 命令搜尋其中的技能，並指定來源。

安裝後如何使用技能？#

在終端機中輸入 hermes ... 命令；在與代理程式的聊天中輸入 /skill-name 呼叫技能（可在同一個終端機、網頁介面或即時通訊軟體中使用）：

/gif-search funny cats
/github-pr-workflow create a PR for the authorization rewrite

如果輸入 /skill-name 時沒有附上任務，Hermes 會載入指示並詢問你要它做什麼。一行最多可呼叫五項技能；其餘文字會成為任務內容：

/github-pr-workflow /test-driven-development close issue 123 and open a PR

如果你經常使用某些組合，可以使用技能組合包；在 Hermes 的術語中，這稱為 bundles。執行 hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development，即可將多項技能整合成一個簡短的 /backend-dev 命令。這種組合包會充當別名；其中的技能必須先安裝。

如果 gateway 已連線，Telegram 也能使用斜線命令；設定方式請見如何將 Hermes Agent 連線到 Telegram。你也可以用手機執行技能。

如何建立自己的技能：SKILL.md 要寫什麼？#

你可以複製以下技能，再依自己的需求調整：

---
name: weekly-review
description: Weekly review: what got done, what stalled, plan for next week
version: 1.0.0
metadata:
  hermes:
    tags: [planning, review]
---

# Weekly review

## When to Use
When the user asks to review the week or put together a plan for the next one.

## Procedure
1. Get the week's task list from the file the user provided, or ask them for it.
2. Sort the tasks into three groups: done, stalled, and new.
3. Name three priorities for the coming week.

## Pitfalls
- Don't invent tasks that aren't in the original list.

## Verification
Ask the user to confirm that the tasks are correctly sorted into “done,” “stalled,” and “new.”

三個連字號之間的標頭是中繼資料。主要欄位是 name（使用拉丁字母並以連字號分隔，呼叫技能命令時會用到）和 description。代理程式會根據 description 欄位，判斷這項技能是否適合目前的任務，以及是否應該載入。如果 description 太籠統，需要這項技能時它可能不會載入。

標頭之後是指示區段。When to Use 說明何時載入技能；Procedure 提供操作步驟；Pitfalls 列出代理程式常犯的錯誤以及避免方法；Verification 說明如何檢查結果。如果指示很長，請將主要內容移至 references/ 中的檔案；這些檔案只會在需要時載入，輔助程式則放在 scripts/。

如果技能需要 API 金鑰，請在標頭中使用 required_environment_variables 宣告變數名稱；不要將金鑰本身寫入檔案。Hermes 會在本機終端機第一次呼叫時詢問一次金鑰值，之後便會自動提供（在即時通訊軟體中，Hermes 會提示你在本機設定金鑰）。platforms、config、blueprint 等欄位請參閱官方文件頁面建立技能。

檔案準備好後，依照下列步驟操作：

1. 建立技能資料夾

   mkdir -p ~/.hermes/skills/weekly-review
   

   資料夾名稱要與標頭中的 name 欄位相同。

2. 儲存 SKILL.md

   在資料夾中建立名為 SKILL.md 的檔案並寫入指示。你可以使用上面的範例，再依任務需求改寫。

3. 呼叫技能並檢查

   輸入 /weekly-review，請代理程式回顧你這一週的情況。如果它按照指示中的步驟執行，表示技能正常運作。

如何使用 /learn 從現有資料建立技能？#

/learn documentation for the demo API in ~/projects/example-docs, especially the section on authentication
/learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
/learn how I just published a site to hosting

如果你剛和代理程式完成複雜流程，可以趁所有步驟還留在對話中時，請它用 /learn 將流程存成技能。下次 Hermes 就會依照現成指示重複操作。

書籍、規格或文件檔案集等大型來源無法全部放進單一檔案。Hermes 會建立精簡的 SKILL.md，附上主題索引，並將細節移至 references/。這些檔案在代理程式為回答問題而載入前，不會佔用上下文。對同一主題再次呼叫 /learn 時，內容會附加至現有技能，而不是建立重複項目。

如何確認技能是否正常運作？#

hermes chat --toolsets skills -q "review my week using the weekly-review skill: done - report and calls, stalled - hosting payment"

這是文件建議的測試方式：執行技能，確認代理程式是否遵循指示。如果沒有，請檢查三種可能原因。第一，資料夾名稱或標頭中的 name 可能與你呼叫的名稱不一致。第二，description 可能沒有清楚說明何時該使用技能；請改用任務本身會出現的詞語撰寫 description。第三，資料夾可能不在 ~/.hermes/skills/ 中，因此 Hermes 找不到。請注意，--toolsets skills 旗標會限制測試使用的工具集：它可以顯示代理程式如何遵循指示，但不會檢查技能的相依項目，例如外部程式。

在終端機中執行 hermes skills list，即可查看目前安裝的項目。

如何更新和移除技能？#

hermes skills check      # 來源中的變更內容
hermes skills update     # 下載新版本
hermes skills uninstall pdf   # 從 hub 移除技能

若要移除手動建立的技能，請刪除 ~/.hermes/skills/ 中對應的資料夾。如果你自訂了別人的技能，update 會保留現有內容：Hermes 會比較雜湊值，並略過已變更的檔案，以免覆寫你的修改。若要還原 hub 技能的原始版本，請使用 hermes skills update name --force；若要還原內建技能，請使用 hermes skills reset name --restore。這兩個命令都會覆寫你的修改，請先儲存自己的版本。

如果你不需要內建技能，而且它們讓清單變得雜亂，可以執行 hermes skills opt-out，讓更新時不再加入內建技能。opt-out --remove 命令也會移除你尚未修改的內建技能。

技能無法安裝或運作時該怎麼辦？#

Hermes 會從 Git 儲存庫內的 .hermes/skills/ 和 .agents/skills/ 資料夾尋找技能。載入前，你必須將儲存庫標記為受信任，因為這些檔案包含代理程式會遵循的指示。完成後，來自該儲存庫的技能只會在該儲存庫中運作，並接受相同的安全檢查。將儲存庫標記為受信任只需執行一次。

第一步該做什麼？#

接下來可閱讀如何將 Hermes Agent 連線到 Telegram，以便從手機呼叫技能；如果你想安排定時技能，也可閱讀如何讓代理程式在伺服器上全天候執行。若你正在選擇代理程式，請參閱OpenClaw 或 Hermes Agent比較。