2026 Hermes Agent Skills Advanced Guide: GEPA, Skill Bundles & Tap Publishing

ca. 18 Min. Lesezeit · MACCOME

Zielgruppe: Teams, die Hermes Agent bereits installiert haben (Install-Runbook), aber Skills nicht triggern, Bundles ignorieren oder GEPA nicht einordnen koennen.Ergebnis: vollstaendige SKILL.md-Spezifikation, Conditional Activation, Tap-Publishing, GEPA+DSPy-Evolution und Hub-Repos — inkl. DSGVO-Hinweisen fuer ~/.hermes/skills/.Struktur: sechs Skill-Fallen, Konzepttabelle, Progressive Disclosure, Bundles, Hub, 8 Schritte Tap, GEPA-Pipeline, Authoring-Tipps, Blog-Case-Study, FAQ.

Sechs Skill-Fallen: warum Hermes trotz Installation nicht „smarter“ wird

Anfang 2026 ueberschritt Hermes Agent 160.000 GitHub Stars. Das Versprechen lautet the agent that grows with you — technisch traegt das Skills-System, nicht groessere Modelle. Wer nur Prompts wiederholt, verpasst prozedurales Gedaechtnis. Typische Engpaesse:

  1. Skills mit Memory verwechseln: MEMORY.md speichert Fakten; Skills speichern Prozeduren und laden on-demand — unterschiedliche Token-Profile.
  2. description als Zusammenfassung: Level-0-Routing scheitert; Agent laedt Skill nie oder zur falschen Zeit.
  3. Keine Bundles: drei Skills manuell pro Session statt einem /backend-dev-Kommando.
  4. Conditional Activation ignoriert: kostenpflichtige und Fallback-Tools gleichzeitig im Prompt — Token-Verschwendung.
  5. Skills nicht versioniert: GEPA-PRs und Team-Taps ohne Git — Rollback unmoeglich; DSGVO-Audit fehlt Nachvollziehbarkeit.
  6. Ephemerer Host: Skill-Compounding (~38 % Token-Einsparung laut 30-Tage-Bericht) bricht ab, wenn ~/.hermes/ bei Container-Neustart verschwindet.

Dieser Guide ueberspringt Installation und geht direkt in SKILL.md, Bundles, Tap, GEPA und Plugin-Namespace — alles auf Basis von agentskills.io.

Skills vs. Memory vs. Prompts: Entscheidungsmatrix

Dimension Prompt Memory Skill
Persistenz nur aktuelle Session sessionuebergreifend sessionuebergreifend
Ladezeitpunkt immer im Kontext jede Session injiziert on-demand (Progressive Disclosure)
Token vor Aktivierung volle Kosten klein, stabil Null (nur name+description in Level 0)
Inhaltstyp beliebige Anweisung User-Praferenzen, Fakten Prozedur (Schritt-fuer-Schritt)
Teilbarkeit schwierig privat als Tap veroeffentlichbar

Merksatz: Prompt = Haftnotiz; Memory = Notizbuch; Skill = SOP-Handbuch. Architektur-Hintergrund: drei Schichten Memory.

SKILL.md im Detail: agentskills.io und Progressive Disclosure

Alle Hermes-Skills folgen dem offenen Standard — portabel zu Claude Code, Cursor, OpenCode. Pfad: ~/.hermes/skills/<kategorie>/<name>/SKILL.md.

Verzeichnisstruktur

text
~/.hermes/skills/
└── devops/
    └── github-pr-workflow/
        ├── SKILL.md              # Kern, empfohlen ≤500 Zeilen
        ├── references/
        │   └── chunking.md       # Level 2: bei Bedarf
        ├── templates/
        │   └── pr-template.md
        └── scripts/
            └── validate.sh       # Ausfuehrbar, Output ins Kontext
Level Inhalt Trigger Token
0 name + description Session-Start, alle Skills ~3.000 gesamt
1 voller SKILL.md-Body /skill-name oder LLM-Match Dateigroesse
2 references/, scripts/ waehrend Ausfuehrung pro Datei
markdown
---
name: github-code-review
description: |
  Use when reviewing a pull request, checking code quality,
  security issues, or style violations. Handles GitHub PR URLs
  and local git diff. Do NOT use for writing new code.
version: 1.0.0
metadata:
  hermes:
    tags: [devops, code-review]
    requires_toolsets: [terminal]
    fallback_for_tools: [web_search]
---

# GitHub Code Review

## Procedure
1. Fetch PR diff via `gh pr diff`
2. Check security checklist in references/security.md
3. Post structured review comment

## Common Pitfalls
- Rate limit 403: add `--rate-limit 100`
- Large diffs: load references/chunking.md

Skill Bundles: ein Slash-Befehl fuer ganze Workflows

Bundles (2026) buendeln mehrere Skills in ~/.hermes/skill-bundles/<slug>.yaml. /backend-dev laedt alle gelisteten Skills gleichzeitig.

Prioritaet: Bundle schlaegt gleichnamigen Einzel-Skill. Fehlende Skills werden uebersprungen (Hinweis beim Laden). Bundles aendern nicht den System-Prompt — Prompt-Cache bleibt gueltig.

yaml
name: backend-dev
description: |
  Full backend feature workflow — code review, TDD, PR management.
skills:
  - github-code-review
  - test-driven-development
  - github-pr-workflow
instruction: |
  Always write failing tests first.
  Never push directly to main.

# CLI: hermes bundles create backend-dev \
#   --skills github-code-review,test-driven-development,github-pr-workflow

Conditional Activation: Wenn/Dann fuer Tool-Sets

Unter metadata.hermes steuern vier Felder Sichtbarkeit nach verfuegbaren Tools:

  • requires_toolsets / requires_tools: Skill versteckt, wenn genannte Sets/Tools fehlen.
  • fallback_for_toolsets / fallback_for_tools: Skill versteckt, wenn Primaer-Tool vorhanden ist — typisch DuckDuckGo als Fallback ohne web_search.

Wenn FIRECRAWL_KEY gesetzt ist, verschwindet der DuckDuckGo-Fallback automatisch — messbare Token-Einsparung ohne manuelles Umschalten.

Skills Hub, Taps und Open-Source-Repositories

Installation:

bash
hermes skills install official/research/arxiv
hermes skills install github:openai/skills/k8s
hermes skills tap add github:your-org/your-skills-tap
hermes skills tap update
hermes skills tap list
Repository Fokus Hinweis
NousResearch/hermes-agent Offizielle Skills Autoritative Quelle
hermeshub Community-Registry Prompt-Injection-Scan
awesome-hermes-skills Produktions-Skills MLOps, Deep Research
ai-agent-skills 191 Skills, 28 Kategorien Hermes / Claude / Cursor

Acht Schritte: eigenen Skill Tap veroeffentlichen

  1. GitHub-Repo anlegen mit Ordnern pro Kategorie (mlops/, research/).
  2. SKILL.md pro Skill mit agentskills.io-konformem Frontmatter; skills-ref validate lokal.
  3. skills.sh.json (optional) fuer Hub-Gruppierung definieren.
  4. README mit Install-Anweisung und Lizenz (MIT empfohlen).
  5. Tap registrieren: hermes skills tap add github:org/repo; bei Private: --token $GH_TOKEN.
  6. Team-Onboarding: ein Befehl pro Entwickler; Skills unter ~/.hermes/skills/ pruefen.
  7. Git-Versionierung: cd ~/.hermes/skills && git init fuer Audit-Trail (DSGVO Art. 30).
  8. Update-Zyklus: hermes skills tap update; nach Aenderungen /reset oder --now.

DSGVO bei Team-Taps: Skills koennen interne Prozesse, Kundennamen oder API-Muster enthalten. Private Repos + AVV mit LLM-Anbietern; keine personenbezogenen Daten in oeffentlichen Taps. Auf geteilten VPS ohne Mandantentrennung verletzt Art. 32 — dedizierte Instanz empfohlen.

GEPA + DSPy: Skills ohne Modell-Fine-Tuning evolvieren

GEPA (Genetic-Pareto Prompt Evolution), ICLR 2026 Oral, optimiert SKILL.md-Text aus Ausfuehrungstrajektorien — keine Gewichts-Aenderung. Projekt: hermes-agent-self-evolution. Kosten: ca. 2–10 USD pro Lauf (nur API).

Fuenf Stufen: (1) Trajektorien aus SQLite, (2) reflexive Fehleranalyse, (3) 10–20 SKILL.md-Varianten, (4) Pareto-Bewertung (Erfolg × Token × Latenz), (5) PR mit manuellem Review.

bash
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

Vier Guardrails: pytest 100 %, Skill ≤15 KB, Prompt-Cache-Kompatibilitaet, semantische Drift-Pruefung. Roadmap: Phase 1 Skills (live), Phase 2–5 Tool-Beschreibungen, System-Prompts, Tool-Code, Vollautomatik (geplant).

Cross-Agent: --trace-dirs ~/.claude/traces,~/.hermes/sessions fuer gemischte Evaluationsquellen.

Plugin-Skills und Authoring-Best-Practices

Plugins nutzen Namespace plugin:skill — opt-in, nicht in Default-skills_list. Aufruf: skill_view("superpowers:writing-plans").

  • description: „Use when…“ plus explizite Ausschluesse — nicht „Helps with code.“
  • Common Pitfalls: konkrete Fehlermodi + Fix — Qualitaetsmerkmal fuer GEPA.
  • Groesse: <500 Zeilen in SKILL.md; >15 KB blockiert GEPA; Split nach references/.
  • skill_manage: Agent kann patchen/erstellen; agent_writes_require_approval: true in config.yaml fuer DSGVO-konforme Freigabe.

Praxis: blog-workflow Bundle

Beispiel-Bundle fuer Tech-Content-Teams:

yaml
name: blog-workflow
description: Full tech blog writing workflow.
skills:
  - seo-keyword-research
  - outline-generator
  - code-example-validator
  - bilingual-checker
instruction: |
  Research SEO keywords before writing.
  All code examples must be runnable.

Drei harte Kennzahlen (2026-06)

  • GitHub Stars Hermes Agent: 160.000+ (Nous Research, Anfang 2026) — Skills-System als Wachstumstreiber, nicht Modellgroesse.
  • Level-0-Overhead: alle Skill-Metadaten zusammen ~3.000 Token pro Session — Grund fuer praezise description-Felder.
  • Skill-Compounding: 3→19 Skills, ~38 % weniger Token auf Wiederhol-Tasks (30-Tage-Feldbericht) — nur bei 24/7-Host mit persistentem ~/.hermes/.

Ressourcen

Abschluss: Prozeduren skalieren, Uptime externalisieren

Mit SKILL.md, Bundles, Conditional Activation und optional GEPA bauen Sie reproduzierbare Agent-Workflows ohne Modell-Fine-Tuning. Grenzen der Alternativen: (a) reine Prompts ohne Persistenz; (b) geteilte VPS ohne isoliertes ~/.hermes/ (DSGVO Art. 32); (c) Laptop-Sleep bricht Gateway und Skill-Lernkurve.

Fuer Teams mit GEPA-Laeufen, Team-Taps und launchd-Gateway ist ein dedizierter Mac Mini M4-Knoten mit FileVault und fester Monatsgebuehr die stabilste Basis. Details: Mietpreise, Betrieb: Hilfe-FAQ.

FAQ

Skills vs. MCP bei Hermes?

Skills = prozedurales Wissen; MCP = Tool-Schnittstellen. Ein Skill beschreibt, wann und wie MCP-Tools aufgerufen werden — sie ersetzen sich nicht.

Warum laedt Hermes alte Skill-Version?

Aenderungen gelten erst nach /reset oder Install mit --now (invalidiert Prompt Cache). In Produktion: Git-Tag + dokumentierter Rollout.

GEPA-evolvierte Skills sicher nutzen?

Vier Guardrails plus manuelles PR-Review. Personenbezogene Trajektorien in sessiondb erfordern DSGVO-Loeschkonzept vor GEPA-Lauf.

Wo Hermes Skills 24/7 betreiben?

Skill-Compounding und Tap-Sync brauchen persistente Platte und Uptime. Vergleichen Sie Region und RAM auf der Mac Mini Mietpreise-Seite; Betriebsfragen: Hilfe-FAQ.