Hermes Agent Skills – Fortgeschrittene Anleitung: SKILL.md, GEPA-Selbstevolution & Skill Bundles (2026)
Hermes-Einstieg geschafft, aber mehr Skills bedeuten Token-Explosion, doppelte Ablaeufe und stockende Evolution. Dieser Leitfaden fuer Fortgeschrittene und Team-Leads deckt agentskills.io-SKILL.md, bedingte Aktivierung, Skill Bundles, GEPA+DSPy-Selbstevolution und Tap-Publishing ab — mit Vergleichstabellen, 5-Schritte-Runbook und FAQ fuer Mac-Cloud-7x24-Betrieb.
Inhaltsverzeichnis
- 1. Warum Skills ein eigenes Deep Dive verdienen
- 2. Skills ≠ Memory ≠ Prompts
- 3. SKILL.md im Detail
- 4. Skill Bundles
- 5. Bedingte Aktivierung
- 6. Skills Hub und Open Source
- 7. Skill Tap veroeffentlichen
- 8. GEPA + DSPy Selbstevolution
- 9. Plugin-Skills
- 10. Fortgeschrittene Autoren-Tipps
- 11. Praxis: Tech-Blog-Workflow
- 12. 5-Schritte-Runbook
- 13. FAQ und Ressourcen
1. Warum Skills ein eigenes Deep Dive verdienen
Anfang 2026 durchbrach Hermes Agent 160k GitHub-Stars. The agent that grows with you basiert nicht auf groesseren Modellen, sondern auf standardisierter, evolvierbarer, sessionsuebergreifender prozeduraler Erinnerung = Skills. Progressive Disclosure, Bundle-Trigger, GEPA-Textevolution und Community-Taps in einem Durchgang.
Schmerzpunkte: drei Waende bei wachsender Skill-Bibliothek
- Token-Schneelawine: Level 0 allein kostet ~3K Tokens. Ungenaue descriptions loesen unnoetige Level-1-Loads aus.
- Verstreute Ablaeufe: Prompts und Memory duplizieren Schritte; Teams und Kanaele divergieren; Cron und IM verhalten sich inkonsistent.
- Evolution stockt: Auf Laptops oder intermittierenden VPS fehlen Ausfuehrungsspuren; GEPA sessiondb evaluiert ins Leere; Gateway-Ausfaelle blockieren skill_manage-Patches.
Hard Facts (2026-06): GEPA-Lauf ~$2–10 (nur API, keine GPU); Skill-Limit 15KB; Gateway mit 20+ IM-Kanaelen und 7 Terminal-Backends.
2. Skills ≠ Memory ≠ Prompts
| Dimension | Prompt | Memory | Skills |
|---|---|---|---|
| Persistenz | nur aktuelle Session | sessionsuebergreifend | sessionsuebergreifend |
| Ladezeitpunkt | immer im Kontext | jede Session auto | on demand |
| Token-Kosten | jederzeit | klein, stabil | null vor Aktivierung |
| Inhalt | beliebige Absicht | Praeferenzen/Fakten | prozedurale Schritte |
| Pflege | manuell | Agent-auto | User + Agent |
| Teilen | schwierig | privat | als Tap publizierbar |
Merksatz: Prompt = Haftnotiz, Memory = Notizbuch, Skill = SOP-Handbuch.
3. SKILL.md im Detail
Alle Skills folgen agentskills.io — portabel zwischen Hermes, Claude Code und 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. Schritt mit exakten Befehlen
## Common Pitfalls
- Fehlermuster und Fix
Progressive Disclosure (3 Stufen)
| Stufe | Inhalt | Trigger | Tokens |
|---|---|---|---|
| Level 0 | name + description | Sessionstart (alle Skills) | ~3K gesamt |
| Level 1 | volles SKILL.md | /skill-name oder LLM | dateigroesse |
| Level 2 | references/ scripts/ | bei Ausfuehrung | pro Datei |
description: wann nutzen, nicht nur was. Ab 500 Zeilen nach references/ auslagern.
4. Skill Bundles: ein Befehl, ganzer Workflow
Bundle unter ~/.hermes/skill-bundles/<slug>.yaml. /bundle-name laedt alle Skills parallel.
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 schlaegt gleichnamigen Einzel-Skill. Fehlende Skills werden uebersprungen. Kein System-Prompt-Rewrite — Prompt-Cache-freundlich.
hermes bundles create backend-dev \ --skills github-code-review,test-driven-development,github-pr-workflow \ --instruction "Always write failing tests first"
5. Bedingte Aktivierung
metadata.hermes steuert Sichtbarkeit nach Tool-Verfuegbarkeit.
| Feld | Logik |
|---|---|
| requires_toolsets | versteckt wenn Toolset fehlt |
| requires_tools | versteckt wenn Tool fehlt |
| fallback_for_toolsets | versteckt wenn Toolset vorhanden (Fallback) |
| fallback_for_tools | versteckt wenn Tool vorhanden |
Beispiel: bezahltes web_search aktiviert — DuckDuckGo-Skill verschwindet; bei API-Ausfall taucht Fallback auf.
6. Skills Hub und Open Source
hermes skills install official/research/arxiv hermes skills tap add github:my-org/my-skills hermes skills tap update
| Repo | Beschreibung | Highlight |
|---|---|---|
| ChuckSRQ/awesome-hermes-skills | Produktions-Kuratierung | Deep Research, MLOps, Apple |
| amanning3390/hermeshub | Community-Registry | Prompt-Injection-Scan |
| kevinnft/ai-agent-skills | 191 Skills, 28 Kategorien | Hermes/Claude/Cursor |
| NousResearch/hermes-agent | Offiziell | Referenz und Builtin-Skills |
7. Skill Tap veroeffentlichen
GitHub-Repo als Tap: hermes skills tap add github:your-org/your-skills-tap. Private Taps mit --token $GH_TOKEN. Persoenliche Skills unter ~/.hermes/skills/ per Git syncen: git pull && hermes skills reset.
8. GEPA + DSPy Selbstevolution
GEPA (Genetic-Pareto Prompt Evolution), ICLR 2026 Oral, in hermes-agent-self-evolution — verbessert SKILL.md ohne Modellgewichte.
- SQLite-Trajektorien sammeln
- LLM-Analyse des Warum bei Fehlern
- 10–20 SKILL.md-Varianten
- Pareto: Erfolg × Token × Geschwindigkeit
- PR mit manueller Freigabe
export HERMES_AGENT_PATH=~/.hermes
python -m evolution.skills.evolve_skill \
--skill github-code-review \
--iterations 10 \
--eval-source sessiondb
| Phase | Ziel | Engine | Status |
|---|---|---|---|
| Phase 1 | SKILL.md | DSPy + GEPA | fertig |
| Phase 2 | Tool-Beschreibungen | DSPy + GEPA | geplant |
| Phase 3–5 | System-Prompt, Code, Vollauto | verschieden | Roadmap |
Vier Guardrails: volle pytest, 15KB, Cache-Kompatibilitaet, Semantik-Drift-Check.
9. Plugin-Skills
Plugins nutzen plugin:skill als Opt-in-Namespace ohne skills_list-Rauschen.
skill_view("superpowers:writing-plans")
10. Fortgeschrittene Autoren-Tipps
- description: „Helps with code“ ist zu vage — Trigger explizit formulieren.
- Pitfalls: Fehlermuster, Ursache, Fix — Qualitaetsgrenze.
- scripts/: ausfuehrbare Skripte; bei Fehler references/ laden.
| Groesse | Empfehlung |
|---|---|
| < 500 Zeilen | alles in SKILL.md |
| 500–1000 | references/ nutzen |
| > 15KB | GEPA-Limit — zwingend splitten |
skill_manage(action='patch', ...) fuer Agent-Self-Service. Produktion: agent_writes_require_approval: true.
11. Praxis: Tech-Blog-Workflow
# ~/.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 mit requires_toolsets: [web] und getrennten DE/EN-Longtails — passt zu VPSMAC-Mehrsprachen-Blogs.
12. 5-Schritte-Runbook: Skills in der Mac-Cloud produktivieren
Schritt 1: VPSMAC M4 16/32GB waehlen, SSH, curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash, hermes setup. Schritt 2: hermes skills install und Taps. Schritt 3: SKILL.md unter ~/.hermes/skills/, skills-ref validate. Schritt 4: Bundles und bedingte Aktivierung, Smoke via Telegram/CLI. Schritt 5: hermes gateway install (launchd), verschlüsseltes Backup von ~/.hermes, optional GEPA sessiondb; vor Kuendigung Festplatte loeschen.
13. FAQ und Ressourcen
Skills vs. MCP? Skills = Anleitung, MCP = Werkzeug — komplementaer. Alte Version? /reset oder --now. Claude Code? nach ~/.claude/skills/ kopieren oder kevinnft/ai-agent-skills.
Docs: Skills Guide, GEPA Repo, agentskills.io.
Laptop, intermittierender Linux-VPS und WSL2 reichen zum Schreiben, aber fehlende Trajektorien, Gateway-Ausfaelle und kein natives macOS bremsen GEPA und 7x24-IM. Fuer Team-Taps, Cron und Evolution ist ein dedizierter Mac-Cloud-Knoten mit Monatsabo die stabilere Langzeitwahl. VPSMAC Apple-Silicon-Mac-Cloud buendelt Festpreis, Bare-Metal-SSH, launchd-Templates und Loeschung vor Vertragsende — Fokus auf Skills statt Hardware.