2026 Hermes Agent Skills
上級ガイド

SKILL.md · Bundles · 条件付きアクティベーション · GEPA 自己進化 · Tap 公開

2026 Hermes Agent Skills 上級ガイド
2026 年初頭に Nous Research が公開した Hermes Agent は、公開からわずか 2 か月で GitHub Star が 16 万超に達しました。コアコンセプトは "the agent that grows with you"——その土台にあるのが、標準化・進化可能・セッションをまたいで持続する Skills スキルシステムです。Hermes は導入済みなのに「Skill と Memory の区別がつかない」「Token が焼ける」「複雑なワークフローを一つずつ起動している」という方へ、本記事では上級者向けの完全ルートを示します。① Skills ≠ Prompts ≠ Memory の本質的差異;② agentskills.io 標準に基づく SKILL.md と三層 Progressive Disclosure;③ Skill Bundles と条件付きアクティベーション;④ GEPA + DSPy による Skill 自動進化;⑤ Tap 公開とオープンソース生態系。対比マトリクス、六ステップ Runbook、ブログワークフロー事例、FAQ を含みます。
01

Hermes Agent Skills を単独で深掘りする価値

従来の「使い捨て Prompt」と異なり、Hermes の Skill 体系は標準化・進化可能・セッションをまたいで持続するプロシージャルメモリです。入門はインストール完全ガイド、記憶機構は三層メモリ解説を参照してください。本記事では上級領域に直接入ります。

01

Token コストの暴走:すべての SOP をシステム Prompt に書き込むと、毎セッション全量ロードされます。Skills の Progressive Disclosure はアクティベーション前ゼロ消費です。

02

ワークフローの断片化:コードレビュー、TDD、PR 管理を /skill-name で個別起動する手間。Skill Bundles なら一コマンドで一式を同時ロードできます。

03

環境認識の欠如:有料 web_search と無料 DuckDuckGo が同時にプロンプトに現れる問題。条件付きアクティベーションでツール可用性に応じて Skill を自動表示・非表示にします。

04

Skill 品質の停滞:手書き Skill は完成後に固定化しがちです。GEPA(Genetic-Pareto Prompt Evolution、ICLR 2026 Oral)は実行トレースを分析して SKILL.md テキストを改善し、モデル重みのファインチューニングは不要です。

05

チーム共有の困難:Skill が個人ディレクトリに散在する問題。Tap リポジトリと hermes skills tap add でリポジトリ全体をワンクリック購読できます。

観点通常の PromptMemory(記憶)Skills(スキル)
持続性現在の会話のみセッションをまたぎ、永続セッションをまたぎ、永続
ロードタイミング毎回コンテキストに含まれる毎セッション自動注入オンデマンドロード
Token コスト毎回消費小さく安定アクティベーション前ゼロ消費
内容の種類任意の意図記述ユーザー嗜好・事実手順的ステップ
保守者ユーザー手動Agent 自動ユーザー + Agent 双方
共有可能性不便プライベートコミュニティ Tap として公開可能

覚え方:Prompt = 付箋;Memory = メモ帳;Skill = SOP マニュアル——必要なときだけ開き、不要なときはコンテキストを占有しません。

02

SKILL.md 形式の詳解と Progressive Disclosure

すべての Hermes Skills は agentskills.io オープン標準に準拠し、Agent 間の移植性を確保します(Hermes、Claude Code、Cursor で共用可能)。skills-ref validate ./my-skill で形式の妥当性を検証できます。

SKILL.md
---
name: my-skill
description: |
  Use when the user needs to [...].
  Handles [...] and [...].
version: 1.0.0
license: MIT
compatibility: Requires git, docker
allowed-tools: Bash(git:*) Read
metadata:
  hermes:
    tags: [devops, automation]
    category: software-development
    related_skills: [github-pr-workflow, test-driven-development]
    requires_toolsets: [terminal]
    fallback_for_toolsets: [web]
---

# My Skill Title

## Overview
## When to Use
## Procedure
## Common Pitfalls
## Verification Checklist

推奨ディレクトリ構成:

ディレクトリ
~/.hermes/skills/
└── my-category/
    └── my-skill/
        ├── SKILL.md              # コア手順、500 行以下を推奨
        ├── references/           # API リファレンス、オンデマンドロード
        ├── templates/            # 再利用可能なテンプレート
        └── scripts/              # Agent が直接実行できるスクリプト
ロード階層内容トリガーToken コスト
Level 0name + descriptionセッション開始時、全 Skill約 3K(全 Skill 合計)
Level 1SKILL.md 全文ユーザーが /skill-name または LLM が必要性を判断ファイル長に依存
Level 2references/ scripts/ ファイルLLM が実行時に必要性を判断オンデマンド、単一ファイル単位

執筆のコツ:description は Level 0 の唯一の情報源であり、LLM はこれをもとに完全な Skill をロードするか決めます。「何であるか」より「いつ使うか」を明確に書くことが重要です。Use when... で始め、1024 文字以内を推奨します。

03

Skill Bundles と条件付きアクティベーション

Skill Bundles は Hermes 2026 の新機能です。軽量 YAML で複数 Skill を一つのスラッシュコマンドにまとめ、/bundle-name 実行時に列挙された Skill を同時ロードします。配置先:~/.hermes/skill-bundles/<slug>.yaml

backend-dev.yaml
name: backend-dev
description: |
  Full backend feature workflow — code review, TDD, and PR management.
skills:
  - github-code-review
  - test-driven-development
  - github-pr-workflow
instruction: |
  Always write failing tests first before implementation.
  Never push directly to main.

Bundle の優先順位:Bundle と単一 Skill が同名の場合Bundle が優先されます。未インストールの Skill はスキップされエラーになりません。Bundle はシステムプロンプトを変更しないため、Prompt Cache の無効化も起きません。CLI での迅速作成:

bash
hermes bundles create backend-dev \
  --skills github-code-review,test-driven-development,github-pr-workflow \
  --instruction "Always write failing tests first"

条件付きアクティベーション(Conditional Activation)は、現在のセッションで利用可能なツールに応じて Skill を自動表示・非表示にします。metadata.hermes 配下で設定します:

フィールド動作ロジック
requires_toolsets列挙したツールセットが存在しない場合、この Skill を非表示にする
requires_tools列挙したツールが存在しない場合、この Skill を非表示にする
fallback_for_toolsets列挙したツールセットが存在する場合、この Skill を非表示にする(フォールバック)
fallback_for_tools列挙したツールが存在する場合、この Skill を非表示にする(フォールバック)

典型シナリオ:FIRECRAWL_KEY / BRAVE_SEARCH_KEY を設定すると有料 web_search がアクティブになり、DuckDuckGo Skill は fallback_for_tools: [web_search] によりプロンプトから自動的に消えます。API 不可時にはフォールバックが自動的に浮上します。プラットフォーム認識の例:requires_toolsets: [messaging] + platforms: [telegram, discord]hermes skills TUI でプラットフォームごとに Skill のオン・オフを切り替えられます。

04

Skills Hub、Tap 公開、GEPA 自己進化と上級執筆

公式インストールチャネル:

bash
hermes skills install official/research/arxiv
hermes skills install https://example.com/SKILL.md --name my-skill
hermes skills install github:openai/skills/k8s
hermes skills tap add github:my-org/my-skills
hermes skills tap update
hermes skills tap list
リポジトリハイライトStars
awesome-hermes-skills本番級コレクション、Deep Research、MLOps、Apple 連携67
hermeshubコミュニティ登録センター、プロンプト注入の安全スキャン166
ai-agent-skills191 Skill、28 カテゴリ、Hermes/Claude/Cursor 横断10
hermes-agent公式の権威ソース、執筆規約を含む

チーム Tap の公開:GitHub リポジトリを作成し、skills.sh.json で Hub カテゴリを制御します。チームメンバーは hermes skills tap add github:your-org/your-skills-tap を実行します。プライベートリポジトリには --token $GH_TOKEN を付与してください。~/.hermes/skills/ を Git でバージョン管理し、デバイス間同期を実現することを推奨します。

GEPA + DSPy 自己進化hermes-agent-self-evolution):モデル重みをファインチューニングせず、実行トレースの分析・変異生成・多目的パレート最適化で Skill テキストを改善します。1 回の最適化は約 $2–10(API のみ、GPU 不要)。五段階の流れ:① 実行トレース収集(SQLite);② 反省的失敗分析;③ ターゲット変異(10–20 個の SKILL.md 変体);④ 多目的パレート評価(成功率 × Token 効率 × 速度);⑤ 人手による PR レビュー。

bash
export HERMES_AGENT_PATH=~/.hermes
python -m evolution.skills.evolve_skill \
    --skill github-code-review \
    --iterations 10 \
    --eval-source sessiondb

python -m evolution.skills.evolve_skill \
    --skill github-code-review \
    --iterations 10 \
    --eval-source mixed \
    --trace-dirs ~/.claude/traces,~/.hermes/sessions

四つの安全ガードレール:全量 pytest 100% 合格;Skill ≤ 15KB;Prompt Cache 互換;意味保持チェック。公式進化ロードマップ:Phase 1 Skill ファイル(実装済み)→ Phase 2 ツール記述 → Phase 3 システムプロンプト → Phase 4 ツール実装コード → Phase 5 全自動ループ。

Plugin Skillplugin:skill 名前空間でロードされ、デフォルトの skills_list には表示されません。ユーザーが明示的に呼び出したときのみアクティブになり、プラグイン内 Skill は相互参照できます。上級執筆の要点:description にトリガー条件を明記;Common Pitfalls に具体的な失敗パターンと修復手順;大きな Skill は references/ に分割(500 行超は分割推奨、15KB 超は GEPA 制限に抵触);skill_manage ツールで Agent が Skill を動的に保守でき、config.yamlagent_writes_require_approval: true で人手承認ゲートを有効化できます。

01

Hermes をインストールして検証:hermes doctor を通過し、Gateway を 7×24 稼働させます(インストールガイド参照)。

02

最初の SKILL.md を執筆:agentskills.io 標準に従い、descriptionUse when... で始め、本文に Procedure と Pitfalls を含めます。

03

Skill Bundle を作成:hermes bundles create または ~/.hermes/skill-bundles/ に YAML を手書きします。

04

条件付きアクティベーションを設定:metadata.hermesrequires_toolsets / fallback_for_tools を追加します。

05

コミュニティ Tap を購読:hermes skills tap add github:... を実行し、定期的に tap update します。

06

任意で GEPA 進化:self-evolution リポジトリをクローンし、sessiondb トレースで evolve_skill を実行、PR を人手レビュー後にマージします。

05

ブログワークフロー実践事例と引用可能な技術データ

blog-workflow Bundle の構築例:seo-keyword-researchoutline-generatorcode-example-validatorbilingual-checkerpublish-to-platform をパッケージ化し、instruction では SEO キーワード調査を先行、コードの実行可能性を確認、日英バイリンガルタイトルを生成するよう指定します。カスタム seo-keyword-research Skill は metadata.hermesrequires_toolsets: [web] を設定し、Procedure で日本語ロングテール(「X 使い方」「X チュートリアル」)と英語ロングテール(「how to X」「X vs Y」)およびプラットフォームのトレンドクロス検証をカバーします。

A

Level 0 全 Skill オーバーヘッド:3K tokens(全 Skill の name+description 合計)。SOP 全量注入と比較して桁違いに節約できます。

B

GEPA 1 回の最適化コスト:$2–10 の API 呼び出し、GPU 不要。毎回 10–20 個の変体をパレート選別します。

C

Skill サイズのハード制限:GEPA ガードレールは Skill ≤ 15KB、ツール記述 ≤ 500 文字を要求します。SKILL.md は 500 行以下を推奨し、1000 行超は強く分割を推奨します。

注意:Skill の変更は現在のセッションに反映されません。/reset またはインストール時の --now(Prompt Cache が無効化されます)が必要です。description は英語または日英バイリンガルを推奨します。基盤 LLM は英語 description のマッチ精度が高い傾向があります。

ノート PC のフタ閉じ、x86 VPS に macOS パスがない、ローカルディスクにバージョン管理がない——これらのホスト構成は Skill の複利と GEPA トレース蓄積を中断します。7×24 Gateway、Skill 自己進化、デバイス間同期が必要な本番環境では、MESHLAUNCH の Mac Mini M4 クラウド裸機レンタルが最適解となることが多いです。専有 Apple Silicon、launchd ネイティブデーモン、日/週/月の柔軟契約で、Hermes 公式 macOS パスとの親和性が最も高いです。関連資料:Hermes 公式ドキュメントGEPA アルゴリズムDSPy フレームワーク。見積もりは料金ページ、デプロイ支援はヘルプセンターをご覧ください。

よくある質問

Skills はプロシージャル知識ドキュメント(Agent に手順を教える)であり、MCP はツールインターフェース(Agent に追加のツール呼び出し能力を与える)です。両者は補完関係にあります。MCP がデータベースアクセスを提供し、Skill がマイグレーションの正しい実行方法を教えます。詳細はMCP Server 開発ガイドを参照してください。

Skill の変更は現在のセッションには反映されません。/reset で新セッションを開始するか、インストール時に --now を付けて強制リフレッシュしてください(Prompt Cache が無効化され、より多くの Token を消費します)。

四つのガードレールで保護されます:全量 pytest 合格、Skill サイズ ≤ 15KB、Prompt Cache 互換、意味保持チェック。各 PR の diff を人手でレビューしてからマージすることを強く推奨します。本番ホスト選定は料金ページヘルプセンターを参照してください。