2026 Hermes Agent Skills 応用完全ガイド：
SKILL.md から GEPA 自己進化と Mac クラウド実践

2026 年初頭に Nous Research が Hermes Agent を公開してから 2 か月で GitHub Star は 16 万を超えました。中核メッセージは "the agent that grows with you" で、使うほど Agent があなたに合わせて成長します。その土台が Skills（スキル）システムです。標準化され、進化可能で、セッションをまたいで残る手続き型メモリであり、使い捨て Prompt ではありません。本稿は Hermes 入門済みの開発者向けに、SKILL.md 形式、Skill Bundles、条件付きアクティベーション、Tap 公開、GEPA+DSPy 自己進化、Plugin スキルとオープンソースエコシステムを体系的に扱います。仕様フィールドは Hermes および agentskills.io 公式ドキュメントを正とします。レンタル料金は 料金ページをご確認ください。

[ SECTION_01 ] // PAIN_MAP Hermes Agent のスキルシステムを単独で深掘りする価値はあるか？

• Token 暴走：SOP 全文をシステム Prompt に詰め込むと毎ターン Token を消費します。Skills の段階的ロードならアクティベート前は本文コストがゼロです。
• セッション跨ぎの忘却：通常 Prompt は当該会話のみ有効です。Skills と Memory は永続しますが、Skills は「何を覚えるか」ではなく「どう実行するか」を教えます。
• ワークフロー分散：PR レビュー、TDD、デプロイ確認が複数会話に散らばります。Skill Bundles なら 1 本のスラッシュコマンドで一式を同時ロードできます。
• 環境認識の欠如：有料 web_search があるのに DuckDuckGo 代替スキルまで載せるとコンテキストを無駄にします。条件付きアクティベーションでツール可用性に応じて表示を切り替えられます。
• スキル品質の停滞：SKILL.md を書き終えた後に更新しないケースが多いです。GEPA は実行トレースからスキル本文を自動進化させ、モデル重みは触りません。
• チーム共有の困難：スキルが個人ディレクトリに散在します。Tap リポジトリと hermes skills tap add で全員が同一ソースを購読できます。
• MCP との混同：Skills は手続き知識のドキュメント、MCP はツール API です。前者がフローを、後者が能力を与え、相互補完です。

応用を進める五つの問い：段階的ロードで Token をどう抑えるか？条件アクティベーションの設定は？Bundles を一発起動する方法は？GEPA でスキルをどう改善するか？コミュニティ Tap はどれを購読すべきか？以下で順に解説します。

[ SECTION_02 ] // MATRIX Hermes Skills と Memory、通常 Prompt の違いは何か？

覚え方：Prompt = 付箋（当該会話のみ）、Memory = ノート（永久メモ、常に手元）、Skill = SOP マニュアル（手順化フロー、必要時に開く）。

[ SECTION_03 ] // STRUCTURE SKILL.md 形式の詳解と Progressive Disclosure 三層ロード

すべての Hermes Skills は agentskills.io オープン標準に従い、Hermes、Claude Code、Cursor 間で移植できます。推奨ディレクトリ構成は次のとおりです。

SKILL.md              メインファイル、500 行以内推奨
references/           API ドキュメント、例（必要時ロード）
templates/            再利用テンプレート
scripts/              Agent が直接実行するスクリプト

---
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]
    requires_toolsets: [terminal]
    fallback_for_toolsets: [web]
---

Progressive Disclosure 三層ロードが Token 制御の要です。

本文には Overview、When to Use、Procedure、Common Pitfalls、Verification Checklist を含めます。執筆の要点は description が Level 0 の唯一のルーティング情報であることです。「何か」より「いつ使うか」を明確に書き、Use when... で始め、1024 文字以内に収めます。name は小文字とハイフンのみ、64 文字以内です。

[ SECTION_04 ] // WORKFLOW Skill Bundles と条件付きアクティベーション：一コマンドで完全ワークフロー

Skill Bundles（2026 新機能）は複数スキルをスラッシュコマンドに束ね、/bundle-name 実行時に列挙スキルを同時ロードします。ファイルは ~/.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.

応用例：research-session は arxiv、deep-research、plan、excalidraw を束ね、mlops-deploy は vllm、llama-cpp、github-pr-workflow、systematic-debugging を束ねます。Bundle ルール：単体 Skill と同名なら Bundle 優先、未インストールスキルはスキップして通知、システム Prompt を変更しないため Prompt Cache に優しいです。CLI クイック作成：

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

条件付きアクティベーション（Conditional Activation）は metadata.hermes 下で設定し、ツール可用性に応じてスキルを自動表示・非表示にします。

• requires_toolsets / requires_tools：列挙ツールが存在しないときスキルを非表示にします。
• fallback_for_toolsets / fallback_for_tools：列挙ツールが存在するときスキルを非表示にします（フォールバック用途）。

典型例：FIRECRAWL_KEY または BRAVE_SEARCH_KEY 設定後、有料 web_search が有効になると duckduckgo-search スキルは fallback_for_tools: [web_search] により自動で消えます。API 不可時は代替が浮上します。プラットフォーム感知には requires_toolsets: [messaging] と platforms: [telegram, discord] を使い、hermes skills TUI で CLI、Telegram、Discord ごとに個別トグルできます。

[ SECTION_05 ] // ECOSYSTEM Skills Hub、オープンソースエコシステム、Skill Tap の公開

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

Skill Tap 公開：GitHub リポジトリをスキルソースにし、メンバーが hermes skills tap add github:your-org/your-skills-tap で購読します。プライベート倉庫は --token $GH_TOKEN を付け、hermes skills tap update で更新を取得します。任意で skills.sh.json で Hub カテゴリ表示を制御します。~/.hermes/skills/ を Git 管理してデバイス間同期し、同期後は hermes skills reset で組み込みスキルを再構築します。agentskills.io 標準によりベンダーロックインを避け、skills-ref validate ./my-skill で形式検証できます。

以下は仕様とエコシステム入口です。上流更新後にリンクを開き直して確認してください。

Hermes Agent Skills システムドキュメント

Creating Skills 開発者ガイド

agentskills.io オープン標準仕様

hermes-agent-self-evolution（GEPA ツールリポジトリ）

[ SECTION_06 ] // EVOLUTION GEPA + DSPy：モデル重みを触らず Skills を自動進化

GEPA（Genetic-Pareto Prompt Evolution）は 2026 ICLR Oral 成果で、hermes-agent-self-evolution に統合されています。実行トレース分析から変異生成、多目的パレート最適化を経て SKILL.md 本文そのものを改善し、モデル重みは変更しません。1 回の最適化はおおよそ $2–10（純 API、GPU 不要）です。

五段階フロー：① 実行トレース収集（SQLite 全推論トレース）→ ② 反省型失敗分析（実行可能な副情報生成）→ ③ 標的変異（失敗点向け 10–20 個の SKILL.md 変異）→ ④ 多目的パレート評価（成功率 × Token 効率 × 速度）→ ⑤ 人手 PR レビュー（最良変異を本番反映）。

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

四つの安全ガードレール：全テスト 100% 合格、Skills ≤15KB・ツール説明 ≤500 文字、Prompt Cache 非破壊、意味保持チェックで原目的から逸脱しないこと。公式ロードマップ：Phase 1 Skill ファイル（実装済み）→ Phase 2 ツール説明 → Phase 3 システム Prompt → Phase 4 ツール実装コード → Phase 5 全自動ループ。agentskills.io 準拠のため Claude Code や Gemini CLI トレースを混合入力できます：--eval-source mixed --trace-dirs ~/.claude/traces,~/.hermes/sessions。

[ SECTION_07 ] // ADVANCED Plugin スキル、応用執筆、ブログワークフロー実践

Plugin-Bundled Skills は plugin:skill 名前空間でロードされ、既定 skills_list には出ず、ユーザー明示呼び出し時のみアクティベートします。同一 Plugin 内スキルは相互認識可能です。Plugin の plugin.yaml で skills パスを宣言します。

エンジニア視点の応用要点：

• description がアクティベーション精度を決める：「Helps with code」ではなく「Use when reviewing a pull request...Do NOT use for writing new code」と書きます。
• Pitfalls が品質の分水嶺：具体的失敗パターン、根因、実行可能な修正（CSS selector 脆弱性、GitHub API レート制限、大 diff Token 溢れなど）を含めます。
• スクリプト化：Procedure で scripts/extract_schema.py を参照し、失敗時は references/manual-extract.md をロードします。
• サイズ制御：500 行未満は SKILL.md に集約、500–1000 行は references へ、15KB 超は分割必須（GEPA 制限）。
• skill_manage：Agent は action='patch'|'create' で動的保守可能。config.yaml の agent_writes_require_approval: true で人手承認ゲートを有効化します。

ブログワークフロー事例：blog-workflow Bundle を作り、seo-keyword-research、outline-generator、code-example-validator、bilingual-checker、publish-to-platform を束ねます。instruction では SEO 調査先行、コード実行確認、日英バイリンガル見出し生成を要求します。Skill 変更後は当該セッションに反映されないため /reset またはインストール時 --now（Prompt Cache 無効化）が必要です。

FAQ 抜粋：Skills はフローを、MCP はツール API を担います。GEPA 変異は四ガードレールと人手 PR review を経ても diff 逐次確認を推奨します。SKILL.md を ~/.claude/skills/ にコピーするか kevinnft/ai-agent-skills で一括インストールすれば多端末利用できます。description は LLM マッチ精度のため英語または日英併記を推奨します。

[ SECTION_08 ] // RUNBOOK Hermes Skills 応用八段階チェックリストと引用可能パラメータ

1. Hermes と公式スキルをインストール：hermes skills install official/research/arxiv 等を実行し、~/.hermes/skills/ 構成を確認します。
2. 初めての SKILL.md を執筆：name、description（Use when...）必須、本文に Procedure と Pitfalls。skills-ref validate で検証します。
3. Skill Bundle を作成：~/.hermes/skill-bundles/ に YAML を置くか hermes bundles create を使い、/bundle-name 同時ロードをテストします。
4. 条件アクティベーションを設定：metadata.hermes に requires / fallback ルールを追加し、API Key 切替で表示ロジックを検証します。
5. コミュニティ Tap を購読：hermes skills tap add github:ChuckSRQ/awesome-hermes-skills、tap update で同期します。
6. チーム Tap を公開：GitHub リポジトリ + skills.sh.json を用意し、メンバーが tap add。プライベート倉庫は Token を設定します。
7. GEPA 進化を実行：hermes-agent-self-evolution を clone し、evolve_skill --eval-source sessiondb を走らせ、生成 PR をレビューします。
8. リモート Mac 7×24 常駐：~/.hermes/ を専有 Apple Silicon ノードへデプロイし、Gateway とスキルディレクトリを Git 同期。ノート PC スリープによるトレース収集中断を避けます。

• Level 0 メタデータオーバーヘッド：全スキル name+description 合計おおよそ 3K token（Hermes ドキュメント口径、現行版で再確認）。
• GEPA 1 回コスト：おおよそ $2–10 純 API、GPU 不要（NousResearch self-evolution プロジェクト記載）。
• GEPA サイズガードレール：Skill ファイル ≤15KB、ツール説明 ≤500 文字。
• frontmatter 制限：name ≤64 文字、description ≤1024 文字、SKILL.md 本文 500 行以内推奨。
• クロスプラットフォーム標準：agentskills.io スキルは Hermes、Claude Code、Cursor、OpenCode で再利用可能。

Hermes Skills と GEPA 進化には長期オンライン、トレース継続書き込み、macOS ネイティブツールチェーンが必要です。代替案の弱点：個人 MacBook はフタ閉じスリープで sessiondb 収集が途切れます。Linux VPS は Xcode / Metal 関連スキルスクリプトを実行できません。共有仮想 Mac はマルチテナント競合で進化評価が不安定です。iOS CI/CD、Telegram Gateway、AI Agent 自己進化の本番では、NOVAKVM Mac Mini M4 / M4 Pro クラウドベアメタルが専有 Apple Silicon、六地域ノード、日 / 週 / 月の弾性レンタルを提供します。Skill が「どうやるか」を定義し、リモートノードが「いつでも実行可能」を担保します。詳細は 料金ページと ヘルプセンターをご覧ください。