# Hermes Agentのスキル：既成スキルのインストールと独自スキルの作成 > ディレクトリとGitHub、SKILL.md形式、/learn、Hermes Agentのスキルの確認・更新・削除について、コマンド例をすべて掲載します。 Source: https://ailoot.ai/blog/ja/hermes-agent-skills/ Canonical: https://ailoot.ai/blog/ja/hermes-agent-skills/ Language: ja Publisher: Ailoot (https://ailoot.ai/) Translation: guide-117 Revision: sha256-35a97fbba509d2363be3602f1a9ae5d8f99be7ee91e9ce9b6da3deada5e731fe スキルとは、エージェント向けに保存しておく指示です。一度タスクの実行方法を記述しておけば、以後は `/skill-name` を呼び出すとHermesがその指示を適用するため、何度も説明する必要はありません。既成のスキルは1つのコマンドでインストールでき、自分のスキルはSKILL.mdを手作業で書くか、`/learn`を使って作成できます。 Hermesをまだインストールしていない場合は、まず[このエージェントとは何か、インストール方法](https://ailoot.ai/blog/ja/hermes-agent-install-setup/)のガイドを読み、それからスキルに進んでください。
Ailootの使い方については、[ドキュメント](https://ailoot.ai/docs/)に実践的な手順が掲載されています。
## Hermes Agentのスキルとは？
重要なポイント スキルはエージェント向けの指示を記したファイルです。何をするか、どのコマンドを使うか、何に注意するか、よくあるミスは何かを記述します。`~/.hermes/skills/`フォルダーにSKILL.mdファイルとして保存し、必要に応じて関連ファイルも一緒に置きます。インストールすると、エージェントとのどのチャットでも自動的に`/name`コマンドとして使えるようになります。
エージェントへのメッセージにプロンプトを書きます。スキルは別のファイルに保存されるため、Hermesは今後のタスクでもその指示を利用できます。エージェントはスキル名と説明の一覧にアクセスでき、タスクに関係があるときにスキルの全文を読み込みます。すべての指示を一度に読み込まないため、コンテキストを節約できます。 スキルだけでエージェントに新しいツールやアクセス権が加わるわけではありません。スキルは、すでに利用できるツールの使い方を説明するものです。外部サービスとの新しい連携にはMCPを使いますが、これは別の話題です。正確なプログラムロジック、特別な認可、イベントストリームの処理が必要なタスクにはエージェントツールが必要で、スキルだけでは足りません。 標準的なタスクなら、指示が目的に合い、提供元を確認できた既成スキルを選びましょう。自分の手順、制約、出力形式を維持したい場合は、独自のスキルを作成します。すでに資料がある場合や、手順を完了していて、ファイルを手作業で書きたくない場合は`/learn`を使います。

スキルは、エージェントが必要なときだけ読み込む情報を含むドキュメントです。

— Hermes Agentのドキュメント（英語から翻訳）, https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
この形式は公開されており、[Agent Skills仕様](https://agentskills.io/specification)に準拠しています。そのため、他のカタログのスキルも通常は形式を変更せずHermesで使えます。ただし、個々のスキルによっては専用のツールやキーが必要なことがあります。自分のスキルを共有することもできます。 ## インストール済みのスキルと保存場所を確認する
重要なポイント 既定では、スキルは`~/.hermes/skills/`フォルダーにカテゴリ別のサブフォルダーを作って保存されます（標準以外のプロファイルを使っている場合やHERMES_HOME変数を設定している場合は、パスが異なります。`hermes config path`で確認できます）。インストール後のHermesには、arXivの検索からGitHubやドキュメントの操作まで、数十種類の組み込みスキルが含まれています。`hermes skills list`コマンドで一覧を表示できます。チャットでエージェントに、どのスキルを使えるか尋ねることもできます。
フォルダーは次のような構成です。 ``` ~/.hermes/skills/ ├── research/ │ └── arxiv/ │ ├── SKILL.md │ └── scripts/ ├── productivity/ │ └── pdf/ │ ├── SKILL.md │ └── references/ └── .hub/ ``` 必須ファイルはSKILL.mdだけです。それ以外は必要に応じて追加します。長い資料には`references/`、補助プログラムには`scripts/`、テンプレートやファイルには`templates/`と`assets/`を使います。 組み込みカタログには、GIFの検索、PDF、スプレッドシート、YouTube、GitHub、メモの操作など、日常的なタスク向けのスキルが含まれています。説明付きの完全な一覧は[組み込みスキルカタログ](https://hermes-agent.nousresearch.com/docs/reference/skills-catalog)のページにあります。`hermes update`を実行するたびに、Hermesは組み込みスキルも更新しますが、変更した内容は保持されます。 ## カタログから既成スキルをインストールする
重要なポイント `hermes skills browse`でカタログを開き、`hermes skills search`で必要なスキルを探し、`hermes skills inspect`でスキルのカードを確認してから、`hermes skills install`でインストールします。どのスキルもインストール前にセキュリティチェックを受けます。公式スキルでは、サードパーティの提供元に関する警告は表示されません。
1. ### カタログを検索する ```bash hermes skills search pdf ``` 検索は接続済みのすべてのソースを対象に行われます。絞り込みなしでカタログ全体を見るには、`hermes skills browse`を実行します。 2. ### スキルのカードを確認する ```bash hermes skills inspect skills-sh/anthropics/skills/pdf ``` カードには説明、提供元、信頼レベルが表示されます。カードを読まずに他の人のスキルをインストールしないでください。 3. ### インストールする ```bash hermes skills install skills-sh/anthropics/skills/pdf ``` HermesはSKILL.mdと関連ファイルをダウンロードし、セキュリティチェックを実行して、すべてを`~/.hermes/skills/`に配置します。スキルはすぐに`/pdf`コマンドとして使えるようになります。追加のツールやキーが必要な場合は、SKILL.mdに記載されています。Hermesはインストール時にもそのことを知らせます。 セキュリティチェックでは、外部へのデータ送信を試みる指示、エージェントに注入された指示、ファイルを削除または破損するおそれのあるコマンドを探します。提供元には次のような信頼レベルがあります。 | レベル | スキルの提供元 | インストール時の動作 | |----|----|----| | 組み込み | Hermesに同梱 | すでに配置済み。インストール不要 | | 公式 | Hermesリポジトリのoptional-skillsフォルダー | サードパーティの提供元に関する警告なしでインストール：`hermes skills install official/security/1password` | | 信頼済み | openai/skills、anthropics/skills、huggingface/skills、NVIDIA/skillsの各リポジトリ | より厳格でないチェック | | その他 | カタログ、他の人のGitHubリポジトリ、直接リンク | 警告と完全なチェック | チェックで警告が出た場合は、`--force`フラグを付けてインストールを続行できます。ただし、先に検出されたリスクを読んでください。「危険」という判定は回避できません。チェックだけで安全が保証されるわけではありません。他の人のスキルを初めて実行する前に、指示と関連コマンドを読んでください。 ## GitHubまたはリンクからスキルをインストールする
重要なポイント GitHubからスキルをインストールするには`hermes skills install owner/repository/path`を使います。SKILL.mdファイルへの直接リンクも使えます。Hermesは関連ファイルもダウンロードします。`hermes skills tap add`で独自のスキルソースを接続すると、他のカタログと同じように利用できます。
インストール方法は3つあります。 ```bash # 1. GitHubリポジトリ内の特定のスキル（リポジトリ内のパスは名前の後に指定） hermes skills install anthropics/skills/skills/pdf # 2. 任意のサイトにあるSKILL.mdへの直接リンク（このスキルをチャットで共有） hermes skills install '' # 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`コマンドでこれらのカタログからスキルを検索できます。
注意 GitHubでは、認証されていないリクエストは1時間あたり60件に制限されます。インストールまたは検索中にレート制限のエラーが出た場合は、`~/.hermes/.env`ファイルに`GITHUB_TOKEN`を追加してください。制限が1時間あたり5000件に増えます。
## インストールしたスキルを使う
重要なポイント インストールしたスキルは自動的にコマンドになります。`/skill-name`に続けて、同じ行にタスクを入力してください。別途有効化する必要はありません。ターミナル、ウェブインターフェース、ゲートウェイ経由のメッセンジャーで使えます。1つのメッセージで最大5つのスキルを呼び出せます。よく使う組み合わせを1つのコマンドにまとめることもできます。
`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に接続する方法](https://ailoot.ai/blog/ja/hermes-agent-telegram-setup/)のガイドで説明しています。スマートフォンからスキルを実行するのにも便利です。 ## 自分のスキルを作る方法：SKILL.mdに書く内容
重要なポイント 自分のスキルは`~/.hermes/skills/`内のフォルダーに作成します。必須ファイルはSKILL.mdだけです。短いヘッダーに名前と説明を記し、その後に使用する場面、手順、よくある間違い、確認方法などのセクションを設けます。通常のテキストで書けるため、プログラミングは不要です。簡単なスキルなら、フォルダー1つとファイル1つで十分です。

スキルはHermes Agentに新しい機能を加える主要な方法です。ツールより簡単に作成でき、エージェントのコードを変更する必要がなく、コミュニティと共有できます。

— Hermes Agentのドキュメント（英語から翻訳）, https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills
このスキルをコピーして、自分用に変更できます。 ```markdown --- 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/`に置きます。
ヒント よくあるケースをファイルの先頭に、まれなケースを末尾に書きます。Hermesはスキルを上から順に読み込むため、この順序でコンテキストを節約できます。
スキルにAPIキーが必要な場合は、キーそのものをファイルに書かず、`required_environment_variables`を使ってヘッダーに環境変数名を宣言します。Hermesはローカルターミナルで初めて呼び出したときに一度だけ値を尋ね、その後は自動的に渡します（メッセンジャーでは、ローカルでキーを設定するよう促されます）。`platforms`、`config`、`blueprint`などのフィールドについては、公式ドキュメントの[スキルの作成](https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills)のページで説明されています。 ファイルの準備ができたら、次の手順に進みます。 1. ### スキルフォルダーを作成する ```bash mkdir -p ~/.hermes/skills/weekly-review ``` フォルダー名はヘッダーの`name`フィールドと同じにします。 2. ### SKILL.mdを保存する 指示を書いた`SKILL.md`という名前のファイルをフォルダー内に保存します。上の例を使い、自分のタスクに合わせて書き換えることもできます。 3. ### スキルを呼び出して確認する `/weekly-review`を入力し、エージェントに自分の週を振り返るよう頼みます。指示に書いた手順に従えば、スキルは機能しています。 ## 既存の資料から/learnでスキルを作成する
重要なポイント `/learn`コマンドは、既存の資料からスキルを作成します。ドキュメントのフォルダー、ページへのリンク、メモ、または手順の口頭説明を渡すと、Hermesが一般的な規約に沿ってSKILL.mdを書き、確認できる状態にします。本や大きなアーカイブを渡すと、トピック別のファイルを分けたスキルが作成されます。
``` /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`を実行し、タスクリストを使って1週間を振り返るよう頼むなど、そのスキルに関係するリクエストを入力して確認します。エージェントが指示どおりにタスクを分類すれば、スキルは機能しています。いつもどおりの応答なら、ファイル名、ヘッダーのdescription、フォルダーの場所を確認してください。
```bash 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 name`はスキルを削除します。他の人のスキルに加えた編集は、更新時にも保持されます。Hermesは変更されたファイルをスキップします。元に戻すには、hubから取得したスキルなら`hermes skills update name --force`を、組み込みスキルなら`hermes skills reset name --restore`を使います。
```bash 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`コマンドを使うと、変更していない組み込みスキルも削除されます。 ## スキルをインストールできない、または使えない場合
重要なポイント よくある原因は3つです。GitHubの1時間あたり60件というリクエスト制限、セキュリティチェックによるインストールのブロック、ファイルの配置場所の誤りです。レート制限に達した場合は`GITHUB_TOKEN`を追加してください。チェックでブロックされた場合は判定内容を読んでください。Hermesがスキルを見つけられない場合は、`~/.hermes/skills/`に配置されているか確認してください。
| 症状 | 原因 | 対処方法 | |----|----|----| | 検索またはインストール中にレート制限エラーが出る | トークンがない場合、GitHubのリクエスト上限は1時間あたり60件 | `~/.hermes/.env`に`GITHUB_TOKEN`を追加する | | インストールがブロックされる | チェックでスキルのコードにリスクが見つかった | インストール時にチェック結果を読む。インストール済みのスキルを再チェックするには`hermes skills audit`を実行する。警告なら`--force`で続行できる。「危険」という判定なら続行できない | | スキルはインストールされたが、`/name`が機能しない | 名前が一致していないか、フォルダーの場所が間違っている | `hermes skills list`を実行し、`~/.hermes/skills/`フォルダーを確認する | | スキルが一覧に表示されない | SKILL.mdにプラットフォームまたは必須ツールの制限がある | SKILL.mdを開き、`platforms`と`requires_*`フィールドを確認する | | 更新後も新しいスキルのバージョンが取得されない | ローカルでファイルを変更しており、Hermesが編集を保持している | 元のバージョンが必要なら、hubのスキルでは`update name --force`を、組み込みスキルでは`reset --restore`を使う。自分のバージョンを優先するなら何もしない | | 別のリポジトリのスキルが読み込まれない | リポジトリを信頼済みとして設定する必要がある | リポジトリ内で`hermes skills trust`を実行する | HermesはGitリポジトリ内の`.hermes/skills/`と`.agents/skills/`フォルダーからスキルを見つけます。読み込ませる前に、リポジトリを信頼済みとして設定する必要があります。これらのファイルにはエージェントが従う指示が含まれているためです。その後、リポジトリのスキルはそのリポジトリ内でのみ使え、同じセキュリティチェックを受けます。リポジトリを信頼済みに設定するのは一度だけで構いません。 ## 最初にすること
重要なポイント カタログから既成スキルを1つインストールしてみましょう。コマンド1つでインストールできます。次に、何度も繰り返している指示を`/learn`に渡し、実際の仕事のタスクで結果を確認してください。
次に読む記事は、スマートフォンからスキルを呼び出せるようにする[Hermes AgentをTelegramに接続する方法](https://ailoot.ai/blog/ja/hermes-agent-telegram-setup/)と、スケジュールしたスキルを使いたい場合の[サーバー上でエージェントを24時間稼働させる方法](https://ailoot.ai/blog/ja/hermes-agent-vps-24-7/)です。エージェントを選ぶ場合は、[OpenClawとHermes Agentの比較](https://ailoot.ai/blog/ja/openclaw-vs-hermes-agent/)を参照してください。
### 出典 - [Hermes Agentドキュメント](https://hermes-agent.nousresearch.com/docs/) - [Skills System - スキルの仕組み](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) - [Creating Skills - 独自スキルの書き方](https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills) - [組み込みスキルカタログ](https://hermes-agent.nousresearch.com/docs/reference/skills-catalog) - [公式オプションスキル](https://hermes-agent.nousresearch.com/docs/reference/optional-skills-catalog) - [Hermes AgentのGitHubリポジトリ](https://github.com/NousResearch/hermes-agent) - [Open Agent Skills標準](https://agentskills.io/specification)
[Ailoot](https://ailoot.ai/)について、さらにご覧いただけます。
## Hermes Agentのスキル：既成スキルのインストールと独自スキルの作成：よくある質問 ### 導入したスキルがスラッシュコマンドに出ない場合は？ インストール済み一覧、SKILL.mdというファイル名、nameフィールド、有効なプロファイルのskillsフォルダーを確認します。プラットフォーム、必須ツール、リポジトリの信頼設定で読み込みが止まる場合もあります。 ### スキルだけの簡易テストで、すべての依存関係も検証できますか？ いいえ。指示を読み込み、従えるかを確かめるテストです。必須ツール、プログラム、キーは別に確認し、全手順を使う前に、範囲を限定した実際の成果を1つ検証してください。 ## Ailoot · 企業とそのプロジェクト群 Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。 企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。 Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。