Hermes Agent Skills 上級ガイド 2026：SKILL.md・バンドル・GEPA 自己進化

2026 年初頭、Nous Research が Hermes Agent を公開。2 か月で GitHub Star 16 万——AI Agent 分野で最速クラスの成長です。哲学は 「the agent that grows with you」。その成長エンジンが Skills です。

ワンショット Prompt と異なり、Hermes Skills は標準化・進化可能・セッション跨ぎの手続き記憶。インストール入門は省略し、トークン制御の Progressive Disclosure、環境感知の Conditional Activation、ワンコマンドの Skill Bundles、DSPy + GEPA による自動改善、そして Tap できる OSS スキル倉庫まで踏み込みます。

• トークン漏れ：毎セッション SOP 全文をコンテキストに載せ、タスク選定前にコストを燃やす。Skills はオンデマンド設計——常駐 Prompt 化は設計意図に反します。
• description が曖昧：「コードを手伝う」だけでは無関係場面でもロード。description は Level 0 の唯一のフィルタです。
• ワークフロー未梱包：セッション開始ごとに code review / TDD / PR / デバッグ / デプロイと五つのスラッシュコマンド——Bundle 一発で済むはずです。
• 編集が反映されない：セッション中の SKILL.md 変更は /reset か --now まで効きません（--now は Prompt Cache 無効化でコスト増）。
• Skills と MCP の混同：MCP はツール、Skills は使い方の手順書。MCP だけでは DB 移行の playbook がありません。

似た三層、挙動は別物。最初の SKILL.md の前にこの表を確認してください。

覚え方：Prompt = 付箋（今回限り）、Memory = ノート（常に手元）、Skill = SOP マニュアル（必要時に開く）。

Hermes Skills は agentskills.io 準拠——Hermes / Claude Code / Cursor 間で移植可能。公開前に skills-ref validate ./my-skill を実行。

---
name: my-skill
description: |
  Use when the user needs to [...].
  Handles [...] and [...].
version: 1.0.0
metadata:
  hermes:
    tags: [devops, automation]
    requires_toolsets: [terminal]
    fallback_for_toolsets: [web]
---

# My Skill Title

## Overview
目的と存在理由。

## When to Use
- Use for: [具体シナリオ]
- Don't use for: [除外]

## Procedure
1. ステップ（正確なコマンド含む）
2. ...

## Common Pitfalls
1. 失敗パターン + 修正

## Verification Checklist
- [ ] チェックポイント

├── SKILL.md              # コア（≤500 行推奨）
├── references/
│   └── api-docs.md       # オンデマンド
├── templates/
└── scripts/
    └── setup.sh

Progressive Disclosure——トークン制御の要：

description は Level 0 の全情報。「何か」より「いつ使うか」を明確に——LLM がフルロードを決めます。

2026 年追加の Bundles はまだ過小評価されています。軽量 YAML が複数 Skill を一つのスラッシュコマンドに。/bundle-name で listed skills が同時ロードされます。

配置：~/.hermes/skill-bundles/<slug>.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.

name: research-session
skills:
  - arxiv
  - deep-research
  - plan
  - excalidraw
instruction: |
  Start every session by checking recent papers on the topic.

優先規則：同名 Skill より Bundle 優先。未インストール Skill は警告付きスキップ。Bundle はシステムプロンプトを変えないため Prompt Cache 有効。

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

セッション内のツール可用性に応じ Skill が自動表示／非表示。metadata.hermes で設定：

metadata:
  hermes:
    requires_toolsets: [web]
    requires_tools: [web_search]
    fallback_for_toolsets: [browser]
    fallback_for_tools: [browser_navigate]

無料／有料検索の切替：DuckDuckGo Skill に fallback_for_tools: [web_search]。FIRECRAWL_KEY 等で有料 web_search が有効になると DuckDuckGo はプロンプトから消え、トークン節約。API 不可時はフォールバックが浮上。

プラットフォーム感知：requires_toolsets: [messaging] と platforms: [telegram, discord]。hermes skills TUI で CLI / Telegram / Discord ごとに個別トグル可能。

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

agentskills.io によりスキル資産は単一ホストにロックされません。

引用データ 1：2026 年初頭 2 か月で Hermes Agent GitHub Star 160,000 突破。

引用データ 2：Level 0 カタログ（全 name + description）合計約 3K トークン。

引用データ 3：GEPA 1 回の最適化コスト約 $2–10（API のみ、GPU 不要）。

GitHub リポジトリを Tap にすれば、チーム全体がスキルセットを購読できます。

my-skills-tap/
├── skills.sh.json
├── mlops/
│   └── vllm-deploy/SKILL.md
├── research/
│   └── paper-summarizer/SKILL.md
└── README.md

hermes skills tap add github:your-org/your-skills-tap
hermes skills tap add github:your-org/private-skills --token $GH_TOKEN
hermes skills tap update
hermes skills tap list

バージョン管理：~/.hermes/skills/ を Git 管理しデバイス間同期。git pull 後は hermes skills reset で内蔵 Skill を再構築。

GEPA（Genetic-Pareto Prompt Evolution） は ICLR 2026 Oral。hermes-agent-self-evolution に統合。モデル重みではなく Skill テキストを、実行トレース分析・変異生成・多目的パレート最適化で改善します。

五段階パイプライン：

1. Stage 1 トレース収集：SQLite から推論トレース（ツール呼び出し、分岐、エラー）を読取。
2. Stage 2 反射的失敗分析：「失敗した」ではなくなぜ失敗したかを LLM が構造化。
3. Stage 3 標的変異：根因に対し 10–20 個の SKILL.md 変異体を生成。
4. Stage 4 多目的パレート評価：成功率 × トークン効率 × 速度を同時最適化。
5. Stage 5 人間レビュー PR：最良変異体を PR 化、承認後にデプロイ。

git clone https://github.com/NousResearch/hermes-agent-self-evolution
cd hermes-agent-self-evolution && pip install -r requirements.txt
export HERMES_AGENT_PATH=~/.hermes

python -m evolution.skills.evolve_skill \
    --skill github-code-review \
    --iterations 10 \
    --eval-source sessiondb

四つのガードレール：

• pytest tests/ -q 100% パス
• Skills ≤ 15KB、ツール説明 ≤ 500 文字
• Prompt Cache 互換（セッション途中の破壊的変更禁止）
• 意味保全（コア目的からのドリフト禁止）

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

プラグインは plugin:skill 名前空間で Skills を梱包：

• デフォルト skills_list に出ない（システムプロンプトノイズ削減）
• 明示呼び出し時のみ激活（Opt-in）
• 同一プラグイン内 Skills は相互認識

name: my-hermes-plugin
skills:
  - name: writing-plans
    path: skills/writing-plans/SKILL.md
  - name: editing
    path: skills/editing/SKILL.md

description の精度が激活精度を決めます。曖昧な「Helps with code.」は避け、PR レビュー時のみ、GitHub URL と git diff を扱う、新規コード執筆には使わない——と書く。

Pitfalls 節が良 Skill と卓越 Skill の分水嶺：具体失敗、根因、修正手順。

skill_manage で Agent が Skill を patch / create。config.yaml で skills.agent_writes_require_approval: true を推奨。

name: blog-workflow
description: Full tech blog writing workflow.
skills:
  - seo-keyword-research
  - outline-generator
  - code-example-validator
  - bilingual-checker
  - publish-to-platform
instruction: |
  Always research SEO keywords before writing.
  Ensure all code examples are tested and runnable.

セッション開始で /blog-workflow。キーワード調査、骨子、コード検証、多言語タイトル案を本文執筆前に完了させます。

1. 01
   Hermes とベースライン Skills：インストールガイドに従い導入。公式 Tap とコミュニティ倉庫（hermes skills tap add github:ChuckSRQ/awesome-hermes-skills）を追加。hermes skills list で Level 0 が約 3K トークン以内か確認。
2. 02
   専用クラウド Mac をプロビジョン：NUKCLOUD コンソールで 16 GB+（GEPA と並行セッションなら 32 GB）。料金ページの時間課金で Skills 執筆パイロットに最適。
3. 03
   SKILL.md 執筆と検証：~/.hermes/skills/ に agentskills.io 準拠で作成。skills-ref validate ./my-skill。500 行超は references/ へ分割。
4. 04
   Bundles と Conditional Activation：反復ワークフロー用 YAML Bundle。fallback_for_tools で無料／有料ツール切替。/bundle-name でスモークテスト。
5. 05
   Tap 公開と GEPA 実行：GitHub Tap を push；メンバーは hermes skills tap add。hermes-agent-self-evolution を clone し --eval-source sessiondb で 1 Skill 進化（予算 $2–10/回）。PR diff を人間レビュー。
6. 06
   常駐化と月額固定：~/.hermes/skills/ を Git 管理；launchd で Hermes ゲートウェイ / Telegram Bot を 7×24。注文ページでスペック固定。Cursor Skills、本番 Runbookと併読。

ノート PC 運用ではフタ閉じスリープで Telegram セッション切断、共有 VPS の帯域ジッターで長 Agent ループ中断、セッション中 Skill 編集による Prompt Cache 無効化が頻発します。GEPA 進化と夜間 Agent には常時起動・安定ネットワークが必要です。本番 Skills ラボとチーム Tap には NUKCLOUD 多地域ベアメタル Mac / クラウド Mac のテナント分離とスペック弾力性が適合——料金ページで時間課金パイロット後、カタログ安定時に月額へ移行。

• Hermes Agent 公式ドキュメント
• Skills システムリファレンス
• Creating Skills 開発者ガイド
• agentskills.io オープン標準
• hermes-agent-self-evolution
• awesome-hermes-skills
• gepa-ai/gepa
• stanfordnlp/dspy
• Dev.to：自己改善 Agent の解剖
• YouTube：Skill Bundles 解説