Hermes Agentのスキル：既成スキルのインストールと独自スキルの作成

スキルとは、エージェント向けに保存しておく指示です。一度タスクの実行方法を記述しておけば、以後は /skill-name を呼び出すとHermesがその指示を適用するため、何度も説明する必要はありません。既成のスキルは1つのコマンドでインストールでき、自分のスキルは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またはリンクからスキルをインストールする#

インストール方法は3つあります。

# 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を実行すると、同じアドレスからスキルが更新されます。

GitHubに加えて、外部のスキルカタログも接続できます。ソースを指定すれば、同じhermes skills searchコマンドでこれらのカタログからスキルを検索できます。

インストールしたスキルを使う#

hermes ...コマンドはターミナルに入力し、/skill-nameの呼び出しはエージェントとのチャットに入力します（同じターミナル、ウェブインターフェース、メッセンジャーのいずれでも使えます）。

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

タスクを付けずに/skill-nameを入力すると、Hermesは指示を読み込み、何をしてほしいかを尋ねます。1行で最大5つのスキルを呼び出せます。残りのテキストがタスクになります。

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

定期的に使う組み合わせには、Hermesの用語でバンドルと呼ばれるスキルバンドルがあります。hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-developmentを実行すると、複数のスキルを短い/backend-devコマンドにまとめられます。バンドルはエイリアスとして機能し、含めるスキルは事前にインストールしておく必要があります。

ゲートウェイに接続していれば、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はローカルターミナルで初めて呼び出したときに一度だけ値を尋ね、その後は自動的に渡します（メッセンジャーでは、ローカルでキーを設定するよう促されます）。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が手順を繰り返します。

本、仕様書、ドキュメントのアーカイブなど、大きな資料は1つのファイルには収まりません。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"

これはドキュメントが推奨するテストです。スキルを実行し、エージェントが指示に従うかを確認します。従わない場合は、考えられる原因を3つ確認してください。1つ目は、フォルダー名またはヘッダーのnameが、呼び出した名前と一致していない可能性です。2つ目は、スキルを使う場面が明確に伝わらないdescriptionになっている可能性です。タスクで使う言葉を使ってdescriptionを書き直してください。3つ目は、フォルダーが~/.hermes/skills/にないため、Hermesが見つけられない可能性です。--toolsets skillsフラグはテストで使うツールセットを制限する点に注意してください。指示に従うかは確認できますが、外部プログラムなど、スキルの依存関係までは確認できません。

ターミナルでhermes skills listを実行すると、インストール済みのスキルが正確に表示されます。

スキルはAIクローンの一部です。タスクの進め方を一度記録しておけば、エージェントは催促されなくても繰り返せます。「AIクローン＋セカンドブレイン＋コンテキストエンジニアリング」を組み合わせることで、自分の仕事の進め方とタスクのコンテキストをエージェントに伝えやすくなります。

スキルを更新・削除する#

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に接続する方法と、スケジュールしたスキルを使いたい場合のサーバー上でエージェントを24時間稼働させる方法です。エージェントを選ぶ場合は、OpenClawとHermes Agentの比較を参照してください。