Hermes Agent Skills: продвинутое руководство 2026 — SKILL.md, бандлы и GEPA

В начале 2026 NousResearch выпустил Hermes Agent. За два месяца — 160 000 звёзд GitHub, один из самых быстрорастущих open-source проектов в пространстве AI-агентов. Главная идея — не большая модель, а философия: «the agent that grows with you».

Техническая основа этого роста — система Skills. В отличие от одноразовых промптов, skills Hermes — стандартизированная, эволюционирующая, межсессионная процедурная память. Материал пропускает базовую установку и уходит в глубину: Progressive Disclosure для контроля токенов, Conditional Activation для контекстного поведения, Skill Bundles для workflow одной командой, DSPy + GEPA для автоулучшения skills и лучшие open-source репозитории skills для прямого tap.

• Утечка токенов через eager loading: загрузка полных SOP в каждую сессию сжигает контекст до выбора задачи. Skills созданы для загрузки по требованию.
• Размытые description, неверная активация: «Помогает с кодом» загружается вне темы. Точность поля description — ваш Level-0 фильтр.
• Нет упаковки workflow: команда вручную вызывает пять slash-команд — вместо одного Bundle для review, TDD, PR и debug.
• Устаревшие skills после правок: изменение SKILL.md mid-session не применяется — нужен /reset или --now, что инвалидирует prompt cache.
• Путаница Skills и MCP: MCP даёт инструменты; Skills учат, как их использовать. Без Skills агент вызывает DB MCP без playbook миграции.

Три слоя контекста выглядят похоже, но ведут себя по-разному. Используйте эту матрицу перед написанием первой SKILL.md.

Мнемоника: Prompt = стикер (только эта сессия). Memory = блокнот (всегда под рукой). Skill = SOP-руководство (открывается по необходимости).

Все Skills Hermes следуют открытому стандарту agentskills.io — переносимы между Hermes, Claude Code, Cursor и OpenCode. Валидируйте через skills-ref validate ./my-skill перед публикацией.

---
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
Что делает skill и зачем он существует.

## When to Use
- Use for: [конкретные сценарии]
- Don't use for: [исключённые сценарии]

## Procedure
1. Шаг один (точные команды)
2. Шаг два
3. Шаг три

## Common Pitfalls
1. Режим сбоя + fix
2. Обработка edge cases

## Verification Checklist
- [ ] Контрольная точка 1
- [ ] Контрольная точка 2

Структура каталога для модульных skills:

├── SKILL.md              # Ядро шагов (цель ≤500 строк)
├── references/
│   ├── api-docs.md       # Загрузка по требованию
│   └── examples.md
├── templates/
│   └── config.yaml
└── scripts/
    └── setup.sh          # Исполняется агентом

Progressive Disclosure — ядро контроля токенов. Три уровня загрузки:

Поле description — вся информация Level 0. Пишите когда использовать яснее, чем что это — LLM решает по нему, загружать ли полный skill.

Skill Bundles — функция Hermes 2026, которую пока недооценивают. Bundle — лёгкий YAML-файл, упаковывающий несколько skills в одну slash-команду. /bundle-name загружает все перечисленные skills одновременно.

Расположение: ~/.hermes/skill-bundles/<slug>.yaml

name: backend-dev
description: |
  Full backend feature workflow — code review, TDD, and PR management.
  Use at the start of any new backend feature session.
skills:
  - github-code-review
  - test-driven-development
  - github-pr-workflow
instruction: |
  Always write failing tests first before implementation.
  Open PRs with co-author tags for pair-programming sessions.
  Never push directly to main.

Bundle research-session:

name: research-session
description: Load all research tools at once for deep-dive sessions.
skills:
  - arxiv
  - deep-research
  - plan
  - excalidraw
instruction: |
  Start every session by checking recent papers on the topic.
  Create an Excalidraw diagram for any architecture discussed.

MLOps deploy pipeline:

name: mlops-deploy
description: Model deployment pipeline with monitoring setup.
skills:
  - vllm
  - llama-cpp
  - github-pr-workflow
  - systematic-debugging
instruction: |
  Always run inference benchmarks before and after deployment.
  Document model quantization settings in PR description.

Правила приоритета: Bundle побеждает одноимённый Skill. Отсутствующие skills пропускаются с предупреждением, без ошибки. Bundles не меняют system prompt — prompt cache остаётся валидным.

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

Skills могут автоматически показываться или скрываться в зависимости от доступных инструментов в сессии. Настройка под metadata.hermes:

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

Переключение бесплатный / платный поиск: skill DuckDuckGo задаёт fallback_for_tools: [web_search]. При FIRECRAWL_KEY или BRAVE_SEARCH_KEY активируется платный web_search — DuckDuckGo исчезает из prompt и экономит токены. Без API fallback появляется автоматически.

Platform-aware skills: requires_toolsets: [messaging] с platforms: [telegram, discord]. TUI hermes skills позволяет включать/выключать skill отдельно для 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 означает: skills не привязаны к одному хосту. Community-активы переносятся с вами.

GitHub-репозиторий как Tap позволяет всей команде — или сообществу — подписаться на ваш набор skills.

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

{
  "groupings": [
    {
      "title": "MLOps & Model Deployment",
      "skills": ["vllm-deploy", "model-benchmark"]
    },
    {
      "title": "AI Research Workflows",
      "skills": ["paper-summarizer", "citation-finder"]
    }
  ]
}

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

Version control: отслеживайте ~/.hermes/skills/ в Git для sync между устройствами. После git pull выполните hermes skills reset для пересборки built-ins.

GEPA (Genetic-Pareto Prompt Evolution) — работа Oral ICLR 2026, интегрированная в hermes-agent-self-evolution. Улучшает текст skills — не веса модели — через анализ execution traces, генерацию вариантов и multi-objective Pareto-оптимизацию.

Стоимость: примерно $2–10 за run оптимизации (только API-вызовы, без GPU).

Пайплайн эволюции в пять этапов:

1. Этап 1 — Сбор traces: чтение полных reasoning traces из SQLite (tool calls, ветвления, ошибки).
2. Этап 2 — Рефлексивный анализ сбоев: LLM генерирует actionable side information — не «упало», а почему.
3. Этап 3 — Таргетированная мутация: генерация 10–20 вариантов SKILL.md под root causes.
4. Этап 4 — Multi-objective Pareto evaluation: одновременная оптимизация success rate × token efficiency × speed.
5. Этап 5 — Human review 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 synthetic

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

Четыре guardrails перед любым PR:

• Полный test suite: pytest tests/ -q должен пройти на 100 %
• Лимит размера: Skills ≤ 15 KB, описания tools ≤ 500 символов
• Совместимость prompt cache: без mid-session правок, инвалидирующих cache
• Семантическое сохранение: эволюционированный текст не должен уходить от core purpose

Cross-host traces: так как Skills следуют agentskills.io, можно подавать в GEPA traces Claude Code или Gemini CLI:

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

Плагины namespacят skills как plugin:skill:

• Skills не попадают в default skills_list (меньше шума в system prompt)
• Активация только по явному вызову пользователя (opt-in)
• Sibling skills внутри плагина взаимно видимы

skill_view("superpowers:writing-plans")

Ответ агента включает sibling skills: «This plugin also includes: superpowers:editing, superpowers:research».

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

Точность description управляет активацией:

description: Helps with code.

description: |
  Use when reviewing a pull request, checking for code quality issues,
  security vulnerabilities, or style violations. Handles GitHub PR URLs
  and local git diff output. Do NOT use for writing new code.

Раздел Pitfalls отделяет хорошие skills от отличных: конкретные failure modes, root-cause analysis, actionable fixes — не generic warnings.

Scripts дают skills реальную исполняемость. Ссылайтесь на scripts/extract_schema.py в Procedure; при сбое загружайте references/manual-extract.md как fallback.

skill_manage позволяет агенту патчить или создавать skills программно. Approval gate в config.yaml: skills.agent_writes_require_approval: true.

Цель: полный стек ассистента для написания tech blog на Hermes.

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.
  Generate both Chinese and English title options.

---
name: seo-keyword-research
description: |
  Use when planning a technical blog post. Researches search volume,
  competition, and related queries for Chinese and English audiences.
metadata:
  hermes:
    requires_toolsets: [web]
    tags: [seo, blogging, content]
---

## Procedure
1. Identify primary topic from user or context
2. Chinese long-tail: "X 怎么用", "X 教程", "X 最佳实践"
3. English long-tail: "X tutorial", "how to X", "X vs Y"
4. Cross-reference platform trends (掘金, Dev.to, HN)
5. Output keyword matrix: 3-5 primary + 10-15 long-tail per language

/blog-workflow в начале сессии: агент исследует keywords, строит outlines, валидирует code samples и готовит bilingual titles до первого абзаца.

1. 01
   Установить Hermes и baseline skills: следуйте нашему руководству по установке. Добавьте official Taps и минимум один community repo (hermes skills tap add github:ChuckSRQ/awesome-hermes-skills). Проверьте через hermes skills list, что Level-0 каталог остаётся под ~3K tokens.
2. 02
   Provision dedicated cloud Mac: откройте консоль NUKCLOUD и выберите tier 16 GB+ (32 GB при параллельной GEPA-эволюции). Почасовая оплата на странице цен подходит для pilot skill authoring.
3. 03
   Authoring и валидация SKILL.md: создайте skills под ~/.hermes/skills/ по agentskills.io. Запустите skills-ref validate ./my-skill. Пишите точные description; файлы длиннее 500 строк выносите в references/.
4. 04
   Упаковать Bundles и Conditional Activation: добавьте YAML bundles для recurring workflows. Настройте fallback_for_tools для free/paid tool swap. Smoke-test через /bundle-name; missing skills должны warn без crash.
5. 05
   Опубликовать team Tap и запустить GEPA evolution: push skills в GitHub Tap; команда выполняет hermes skills tap add. Клонируйте hermes-agent-self-evolution, задайте HERMES_AGENT_PATH, evolve один skill с --eval-source sessiondb (бюджет $2–10 за run). Review PR diffs перед merge.
6. 06
   Daemonize и зафиксировать capacity: track ~/.hermes/skills/ в Git; используйте launchd для 24/7 Hermes gateway или Telegram bot. Зафиксируйте tier на странице заказа. Параллельно: паттерны Cursor Skills, если команда разделяет IDE и terminal agents.

Hermes skills на laptop упираются в sleep при закрытой крышке, убивающий Telegram-сессии; jitter bandwidth на shared VPS, ломающий long agent loops; и invalidation prompt cache при mid-flight edits. GEPA evolution и overnight agent runs требуют машину, которая не засыпает. Для production skills lab и team Taps NUKCLOUD multi-region bare-metal Mac / cloud Mac nodes дают tenant isolation и spec elasticity — стартуйте почасово, переходите на fixed monthly, когда каталог skills стабилизируется.

Официальная документация:

• Hermes Agent docs
• Hermes Agent docs (китайский)
• Справочник системы Skills
• Creating Skills developer guide
• Открытый стандарт agentskills.io

Open-source репозитории:

• NousResearch/hermes-agent
• hermes-agent-self-evolution
• awesome-hermes-skills
• hermeshub
• ai-agent-skills
• gepa-ai/gepa
• stanfordnlp/dspy

Community content:

• SegmentFault: практический гайд Hermes Agent
• Hermes Chinese site — custom skills
• Dev.to: anatomy of a self-improving agent
• YouTube: Hermes crash course (GEPA & scaling)
• YouTube: Skill Bundles deep dive