Hermes Agent Skills 上級ガイド：SKILL.md・GEPA 自己進化・Skill Bundles ワークフロー（2026）
Hermes Agent の入門は済んだが、Skill が増えるほど Token 爆発・重複手順・進化サイクルが回らない——そんな進階ユーザーとチーム技術責任者向けの実践ガイドです。agentskills.io 標準の SKILL.md、条件付きアクティベーション、Skill Bundles、GEPA+DSPy 自己進化、Tap 公開までを概念比較表・五段 Runbook・FAQ 付きで解説し、Mac クラウド 7×24 で Skill 資産を本番運用する判断材料を提供します。
目次
1. なぜ Skills だけ深掘りするのか
2026 年初頭、Nous Research の Hermes Agent は GitHub で 16 万 Star を突破。The agent that grows with you の核心は大きなモデルではなく、標準化・進化可能・セッション横断の手続き的メモリ＝Skills にあります。本記事は入門を飛ばし、Progressive Disclosure による Token 制御、Bundle 一括起動、GEPA による Skill テキスト進化、コミュニティ Tap までを一気通貫で扱います。
痛点：Skill が増えるほど起きる三つの壁
- Token コストの雪だるま：全 Skill を毎回コンテキストに載せると Level 0 だけでも約 3K Token。description の精度不足で不要な Level 1 ロードが連鎖する。
- 手順の散逸と重複：Prompt や Memory に手順を書き散らすと、チーム間でバージョンが割れ、Cron や IM チャネルごとに挙動がぶれる。
- 進化サイクルが回らない：ノート PC や断続的 VPS では実行軌跡が溜まらず、GEPA の sessiondb 評価が空振り。Gateway が止まると skill_manage の自動パッチも届かない。
引用データ（2026-06）：GEPA 1 回の最適化は API のみで約 $2–10（GPU 不要）；Skill サイズ上限 15KB；公式 Gateway は 20+ IM チャネルと 7 種ターミナルバックエンドに対応。
2. Skills ≠ Memory ≠ Prompts
| 次元 | 通常 Prompt | Memory | Skills |
|---|---|---|---|
| 永続性 | 当該会話のみ | セッション横断・永続 | セッション横断・永続 |
| ロードタイミング | 毎回コンテキストに入る | 毎セッション自動注入 | オンデマンド（差異の核心） |
| Token コスト | 毎回消費 | 小さく安定 | 活性化前はゼロ |
| 内容タイプ | 任意の意図記述 | ユーザー嗜好・事実 | 手続き的ステップ |
| 保守 | ユーザー手動 | Agent 自動 | ユーザー + Agent |
| 共有可能性 | 困難 | プライベート | Tap として公開可 |
覚え方：Prompt＝付箋、Memory＝ノート、Skill＝SOP マニュアル（必要なときだけ開く）。
3. SKILL.md 形式の深掘り
全 Skill は agentskills.io オープン標準に準拠。Hermes・Claude Code・Cursor で移植可能です。
---
name: my-skill
description: |
Use when the user needs to [...].
version: 1.0.0
metadata:
hermes:
tags: [devops, automation]
requires_toolsets: [terminal]
---
# My Skill Title
## Procedure
1. ステップ一（正確なコマンドを含む）
## Common Pitfalls
- 失敗モードと修正
Progressive Disclosure 三層ロード
| レベル | 内容 | トリガー | Token |
|---|---|---|---|
| Level 0 | name + description | 毎セッション開始（全 Skill） | 合計 ~3K |
| Level 1 | SKILL.md 全文 | /skill-name または LLM 判断 | ファイル長に依存 |
| Level 2 | references/ scripts/ | 実行中に LLM が判断 | ファイル単位 |
description は「何か」より「いつ使うか」を書く。500 行超は references/ へ分割。
4. Skill Bundles：一コマンドで工作流全体
Bundle は ~/.hermes/skill-bundles/<slug>.yaml に置く軽量 YAML。/bundle-name で列挙 Skill を同時ロードします。
name: backend-dev description: Full backend feature workflow. skills: - github-code-review - test-driven-development - github-pr-workflow instruction: | Always write failing tests first. Never push directly to main.
同名の Bundle と単体 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"
5. 条件付きアクティベーション
metadata.hermes でツール可用性に応じ Skill を自動表示/非表示。
| フィールド | 動作 |
|---|---|
| requires_toolsets | 列挙ツールセットが無いと非表示 |
| requires_tools | 列挙ツールが無いと非表示 |
| fallback_for_toolsets | 列挙ツールセットがあると非表示（代替） |
| fallback_for_tools | 列挙ツールがあると非表示 |
例：有料 web_search があるとき DuckDuckGo Skill を隠し、API 切れ時だけ fallback として浮上——Token とコストを両立。
6. Skills Hub とオープンソース生態
hermes skills install official/research/arxiv hermes skills tap add github:my-org/my-skills hermes skills tap update
| リポジトリ | 概要 | ハイライト |
|---|---|---|
| ChuckSRQ/awesome-hermes-skills | 本番向け厳選 | Deep Research・MLOps・Apple 連携 |
| amanning3390/hermeshub | コミュニティ登録センター | プロンプト注入スキャン付き |
| kevinnft/ai-agent-skills | 191 Skill・28 カテゴリ | Hermes / Claude / Cursor 横断 |
| NousResearch/hermes-agent | 公式 | 内蔵 Skill と規範の正典 |
7. Skill Tap の公開
GitHub リポジトリを Tap にするとチーム全体が hermes skills tap add github:your-org/your-skills-tap で購読。私有 Tap は --token $GH_TOKEN。個人 Skill は ~/.hermes/skills/ を Git 管理し、デバイス間で git pull && hermes skills reset。
8. GEPA + DSPy 自己進化
GEPA（Genetic-Pareto Prompt Evolution）は ICLR 2026 Oral。hermes-agent-self-evolution でモデル重みを触らず SKILL.md テキストだけを改善します。
- SQLite 実行軌跡の収集
- LLM による失敗の「なぜ」分析
- 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
| フェーズ | 対象 | エンジン | 状態 |
|---|---|---|---|
| Phase 1 | SKILL.md | DSPy + GEPA | ✅ 実装済 |
| Phase 2 | ツール説明 | DSPy + GEPA | 計画中 |
| Phase 3–5 | システムプロンプト・コード・全自動 | 各種 | ロードマップ |
四つのガードレール：全 pytest 通過・15KB 上限・Prompt Cache 互換・意味ドリフト検査。
9. Plugin スキル
プラグインは plugin:skill 名前空間で Opt-in ロード。デフォルト skills_list を汚さず、兄弟 Skill を横断提示できます。
skill_view("superpowers:writing-plans")
10. 上級作成テクニック
- description：「Helps with code」は曖昧。「PR レビュー時にセキュリティとスタイルを検査」と条件を明示。
- Pitfalls：失敗モード・根因・修正手順の三つセットが品質の分水嶺。
- scripts/：Agent が直接実行できるシェル/Python を同梱し、失敗時は references/ へフォールバック。
| Skill サイズ | 推奨 |
|---|---|
| < 500 行 | SKILL.md に集約 |
| 500–1000 行 | references/ へ分割 |
| > 15KB | GEPA 上限超過——必ず分割 |
skill_manage(action='patch', ...) で Agent が自己メンテ。本番では agent_writes_require_approval: true を推奨。
11. 技術ブログ工作流の実例
# ~/.hermes/skill-bundles/blog-workflow.yaml name: blog-workflow skills: - seo-keyword-research - outline-generator - code-example-validator instruction: | Always research SEO keywords before writing. Ensure all code examples are tested.
seo-keyword-research Skill は requires_toolsets: [web] を付け、日本語・英語のロングテールを別々に調査する Procedure を持たせます。VPSMAC 多言語ブログ運用と相性が良いパターンです。
12. 五段 Runbook：Skill 体系を Mac クラウドで本番化
ステップ 1：VPSMAC で M4 16GB/32GB ノードを選び、SSH 接続。curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash と hermes setup。ステップ 2：hermes skills install official/... と Tap 購読でベースライン構築。ステップ 3：~/.hermes/skills/ に SKILL.md を作成し skills-ref validate で検証。ステップ 4：Bundle YAML と条件付きアクティベーションを設定し、Telegram/CLI でスモーク。ステップ 5：hermes gateway install で launchd 常駐、~/.hermes を暗号化バックアップ、必要なら GEPA で sessiondb 進化。退租前にディスク消去。
13. FAQ とリソース
Skills と MCP の違いは？ Skill は手順書、MCP はツール接続——補完関係。編集が反映されない？ /reset または --now。Claude Code で再利用？ ~/.claude/skills/ へコピー、または kevinnft/ai-agent-skills の横断インストール。
公式：Skills ドキュメント、GEPA リポジトリ、agentskills.io。関連記事：3 層メモリと Mac mini 月次レンタル、Cursor Agent Skill 完全ガイド。
ローカルノート PC・断続的 Linux VPS・WSL2 でも Skill は書けますが、実行軌跡の欠落・Gateway 停止・macOS 非ネイティブが GEPA 進化と 7×24 IM 応答を阻みます。Skill 資産をチーム共有しつつ Cron と Tap 更新を回すなら、月次課金の Mac クラウド専用ノードが長期コストと運用のバランスに優れます。VPSMAC Apple Silicon Mac クラウドなら固定月額・SSH ベアメタル・launchd テンプレ・退租擦除で、Skill 改良に集中できます。