📋 目次

01 · なぜ Hermes Agent の Skill 体系を単独で深掘りするのか

2026 年初頭、Nous Research が Hermes Agent を公開してからわずか二か月で GitHub Star は 16 万超に達し、オープンソース Agent 分野で最も急成長しているプロジェクトの一つとなりました。最大の魅力はモデルサイズではなく、「the agent that grows with you」——使うほど理解が深まる Agent——という設計思想です。その根幹を担うのが Skill（スキル）システム です。

従来の「一度きりの Prompt」とは異なり、Hermes の Skill は標準化され、進化可能で、セッションをまたいで持続する手続き型メモリとして機能します。本稿では基本インストール（Hermes インストール完全ガイドを参照）を前提に、上級領域へ踏み込みます。漸進ロードによる Token コスト管理、環境を感知する条件付き有効化、Bundle による複合工作流、GEPA による Skill の自動改善まで、実務で使える知識を網羅します。

02 · 三つの痛点：「Hermes を入れた」だけでは Skill を使いこなせない

Token コストの暴走：SOP をすべてシステム Prompt に書き込むと、毎セッション数千 Token を消費します。Progressive Disclosure を使わない場合、50 個の Skill 全文がコンテキストを圧迫し、応答品質も低下します。
Skill 有効化の精度不足：description が曖昧だと、無関係な場面で Skill が誤ロードされたり、必要な Skill が見つからなかったりします。条件付き有効化がないと、無料ツールと有料ツールの切り替えを手動で行う必要があります。
チーム知識の蓄積と進化ができない：個人 Prompt はバージョン管理やチーム配布が困難です。GEPA のような仕組みがなければ、実行ログから SKILL.md を自動改善する道もありません。

03 · 核心概念：Skills ≠ Prompts、Skills ≠ Memory

観点	通常 Prompt	Memory（記憶）	Skills（スキル）
持続性	現在の会話のみ	セッション跨ぎ・永続	セッション跨ぎ・永続
ロードタイミング	毎回コンテキストに含まれる	セッション開始時に自動注入	必要時のみ
Token コスト	毎回消費	小さく安定	有効化前はゼロ
内容の種類	任意の意図記述	ユーザー嗜好・事実	手続き的ステップ
共有可能性	困難	プライベート	Tap として公開可能

覚え方：Prompt は付箋（その場限り）、Memory はノート（常に手元）、Skill は SOP マニュアル（必要なときだけ開く）——というイメージです。Hermes は Skill を ~/.hermes/skills/ に永続化し、Level 0 の description だけを常時保持することで、数十個の Skill を持ちながらも Token 消費を約 3K に抑えます。

04 · SKILL.md 形式の詳解（agentskills.io オープン標準）

Hermes の Skill は agentskills.io オープン標準に準拠しており、Hermes・Claude Code・Cursor 間で移植可能です。日本の開発チームが Cursor で書いた Skill を Hermes Gateway にそのまま持ち込める点も、標準化の恩恵です。

---
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

重要フィールド：name は必須、小文字とハイフンのみ、64 文字以内。description は必須、1024 文字以内で、「Use when...」で始めることを推奨します——これが Level 0 ルーティングの唯一の情報源です。metadata.hermes には条件付き有効化や分類タグを記述します。

Skill ディレクトリ構造（モジュール設計）

~/.hermes/skills/
└── my-category/
    └── my-skill/
        ├── SKILL.md              # メインファイル（500 行以内推奨）
        ├── references/           # API 参考（オンデマンドロード）
        ├── templates/            # 再利用テンプレート
        └── scripts/              # Agent が直接実行するスクリプト

長い API 仕様やサンプルコードは references/ に分離し、本体 SKILL.md は手順と判断基準に集中させるのが定石です。GEPA 自己進化の上限は 15KB であるため、肥大化した Skill は早めに分割してください。

05 · Progressive Disclosure：三層ロード機構

Token 制御の要は、Hermes が Skill 全文を一度にコンテキストへ載せない点にあります。50 Skill 環境でも Level 0 だけなら合計約 3,000 Token で済み、実際の作業開始後に必要分だけ Level 1・2 が追加されます。

ロード層	内容	トリガー	Token コスト
Level 0	name + description	セッション開始時	全 Skill 合計 ~3K
Level 1	SKILL.md 全文	/skill-name または LLM 判断	ファイル長に依存
Level 2	references/ scripts/	実行時に LLM 判断	必要ファイルのみ

執筆のコツ：description では「何であるか」より「いつ使うか」を明確に書きます。500 行を超える参考資料は references/ へ移し、Prompt Cache の効率も維持してください。

06 · Skill Bundles：一コマンドで完整工作流を起動

Skill Bundles は Hermes 2026 の強力な追加機能です。Bundle は軽量 YAML で、複数 Skill をひとつのスラッシュコマンドに束ねます。/bundle-name 実行時、列挙された Skill が同時にロードされ、instruction フィールドで横断的なルールを追加できます。

配置場所：~/.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.

Bundle 優先ルール：同名 Skill と Bundle がある場合は 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"

応用例として、AI 研究員工作流（arxiv + deep-research + plan + excalidraw）や MLOps デプロイ（vllm + llama-cpp + github-pr-workflow + systematic-debugging）など、横断タスクを Bundle 化するチームが増えています。

07 · 条件付き有効化：環境を感知する Skill

Skill は現在のセッションで利用可能なツールに応じて自動的に表示・非表示を切り替えられます。metadata.hermes 配下で次のフィールドを設定します。

フィールド	動作
`requires_toolsets`	列挙ツールセットが無い場合 Skill を非表示
`requires_tools`	列挙ツールが無い場合 Skill を非表示
`fallback_for_toolsets`	列挙ツールセットがある場合 Skill を非表示（代替）
`fallback_for_tools`	列挙ツールがある場合 Skill を非表示（代替）

典型シナリオ：DuckDuckGo 検索 Skill に fallback_for_tools: [web_search] を設定すると、FIRECRAWL_KEY や BRAVE_SEARCH_KEY がある環境では有料 web_search が優先され、DuckDuckGo は自動的に隠れます。API 障害時には逆に無料 Skill が浮上し、Token とコストの両方を最適化できます。

08 · Skills Hub とオープンソースエコシステム

公式インストール経路：

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

リポジトリ	特徴	Stars
ChuckSRQ/awesome-hermes-skills	本番向け合集、Deep Research・MLOps 含む	67+
amanning3390/hermeshub	コミュニティ登録、Prompt 注入検知	166+
kevinnft/ai-agent-skills	191 Skill、Hermes/Claude/Cursor 横断	10+
NousResearch/hermes-agent	公式権威ソース	160k+

skills-ref validate ./my-skill で形式準拠を検証できます。Skill 資産は特定プラットフォームに縛られず、Cursor の Agent Skill ガイドで培った SKILL.md を Hermes へ持ち込む運用も現実的です。

09 · 自前 Skill Tap の公開：チームとコミュニティへの配布

GitHub リポジトリを Tap として登録すれば、チーム全体が Skill セットを購読できます。

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 により同期することです。プライベート Tap には GitHub Token を渡し、社内 SOP を安全に配布できます。

10 · Self-Evolving Skills：GEPA + DSPy による自動進化

GEPA（Genetic-Pareto Prompt Evolution） は 2026 年 ICLR Oral 採択の研究成果で、hermes-agent-self-evolution に統合されています。モデル重みを fine-tune せず、実行トレースを分析して SKILL.md テキスト自体を改善するアプローチです。1 回あたり約 $2–10（API のみ、GPU 不要）で試せます。

五段階の進化フロー：① 実行トレース収集（SQLite）→ ② 反省型失敗分析 → ③ 標的変異（10–20 個の SKILL.md 変体）→ ④ 多目的パレート評価（成功率 × Token 効率 × 速度）→ ⑤ 人手 PR レビュー後に本番反映。

git clone https://github.com/NousResearch/hermes-agent-self-evolution
export HERMES_AGENT_PATH=~/.hermes
python -m evolution.skills.evolve_skill \
    --skill github-code-review \
    --iterations 10 \
    --eval-source sessiondb

四つの安全ガードレール：全テストスイート 100% 合格、Skill ≤ 15KB・ツール説明 ≤ 500 文字、Prompt キャッシュ互換、意味保持チェック。公式ロードマップでは Phase 1（SKILL.md）が実装済みで、Phase 2–5 はツール説明・システム Prompt・ツール実装コード・全自動ループをカバーします。

実験的に、Claude Code や Gemini CLI のトレースを混合入力することも可能です（--eval-source mixed --trace-dirs ~/.claude/traces,~/.hermes/sessions）。日本語 Skill でも進化対象になりますが、description は英語または日英併記にしておくと LLM のルーティング精度が安定します。

11 · Plugin Skill：Hermes の境界を拡張する

プラグインは Skill を名前空間（plugin:skill）にまとめ、デフォルトの skills_list には表示しません。ユーザーが明示的に呼び出したときだけ有効化される Opt-in 設計です。

skill_view("superpowers:writing-plans")

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

社内専用 Skill や実験中の Skill を Plugin 化しておけば、一般ユーザーへの誤公開を防ぎつつ、パワーユーザー向けに高度な手順を提供できます。

12 · スキル執筆の上級テクニック（エンジニア視点）

description が有効化精度を決める：トリガー条件と除外シナリオを明記し、「Helps with code」のような曖昧表現を避けます。
Pitfalls が品質の分水嶺：GitHub API レート制限、大きな diff による Token 溢れなど、具体的な失敗パターンと修復手順を書きます。
スクリプト化：Procedure で scripts/ を参照し、失敗時は references/manual-extract.md へフォールバックします。
サイズ管理：500 行未満は SKILL.md に集約、500–1000 行は references へ分割、15KB 超は GEPA 上限のため必ず分割します。
skill_manage：Agent は skill_manage(action='patch'| 'create') で Skill を動的更新できます。config.yaml で agent_writes_require_approval: true を有効にし、無承認書き込みを防ぎましょう。

13 · 実践例：技術ブログ工作流 Skill

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.

カスタム seo-keyword-research Skill は執筆前に日英キーワード行列（主語 3–5 個 + ロングテール 10–15 個）を出力し、Zenn トレンド、Dev.to、HN を横断参照します。MacDate のような多言語ブログ運用では、Bundle と Tap を組み合わせて執筆 SOP をチーム全体に配布する構成が効果的です。

14 · よくある質問 FAQ

Q: Skills と MCP の違いは？
Skills は「Agent に手順を教える」手続き知識、MCP は「Agent に道具を渡す」ツールインターフェースです。両者は補完関係にあり、MCP Server 構築は別途 MCP 構築ガイドを参照してください。

Q: Skill を更新したのに Agent が旧版を使うのはなぜ？
現在のセッションには反映されません。/reset するか、インストール時に --now を付けてください（Prompt Cache は無効化されます）。

Q: GEPA で進化した Skill は安全か？
四つのガードレールと人手 PR レビューがありますが、diff は必ず目視確認してください。

Q: Claude Code で再利用できるか？
SKILL.md を ~/.claude/skills/ にコピーするか、kevinnft/ai-agent-skills で多端末インストールできます。

Q: 日本語 Skill は Token 効率に影響するか？
日本語 1 文字あたり約 1–1.5 Token で、英語と大差ありません。ただし description は英語または日英併記を推奨します。

15 · レンタル Mac で Hermes Skills を隔離試行（五手順）

Linux VPS や Windows でも Hermes Gateway は動きますが、Apple エコシステム向けスクリプト、Xcode 関連 Skill、Keychain 操作は本物の macOS が必要です。Skills・Bundles・GEPA パイプラインを捨てられるレンタル Macで試し、問題なければ月次契約へ移行するのが安全です。

Apple Silicon ノードをレンタル：Mac mini M4 以上、Homebrew 同梱 macOS を選び SSH 接続。料金は M シリーズ算力料金を参照してください。
Hermes をインストールし doctor を実行：公式スクリプトで導入、hermes doctor で Gateway とツールセットを検証します。
公式 Skill + カスタム Tap を導入：hermes skills install と hermes skills tap add で Level 0/1 ロードと Token 消費を計測します。
Bundle を作成して工作流試行：YAML Bundle を書き、複数 Skill 同時ロードが instruction どおり動くか確認します。
記録して解放：ターミナル出力と session トレース（GEPA 用）を保存し、問題なければレンタルを終了して課金を止めます。

Linux VPS は軽量 Gateway と純 API 呼び出しには向きますが、macOS 専用 Skill・Apple 署名チェーン・ローカル Keychain 権限は再現できません。個人ノート PC を 7×24 常駐させると散热・電気代・本番機汚染のリスクが増えます。日次レンタル Mac なら本番同等の Apple Silicon 環境を低コストで確保でき、誤設定による API 請求暴走や徹夜トラブルシュートより安上がりです。長期常駐を検討する場合は Hermes ハードウェア選定記事で月次レンタルと自前購入を比較してください。