Hermes-Agent-Skills: Einen eigenen Skill installieren und erstellen

Ein Skill ist eine gespeicherte Anweisung für einen Agenten: Du beschreibst einmal, wie eine Aufgabe ausgeführt werden soll, und von da an wendet Hermes sie an, wenn du /skill-name aufrufst, ohne dass du sie wiederholt erklären musst. Einen fertigen Skill kannst du mit einem Befehl installieren, und du kannst auf zwei Arten einen eigenen erstellen: SKILL.md manuell schreiben oder /learn verwenden.

Wenn du Hermes noch nicht installiert hast, beginne mit der Anleitung was dieser Agent ist und wie du ihn installierst und gehe dann zu den Skills über.

Was ist ein Skill in Hermes Agent?#

Du schreibst dem Agenten eine Anweisung in einer Nachricht. Ein Skill wird in einer separaten Datei gespeichert, und Hermes kann diese Anweisung bei zukünftigen Aufgaben verwenden. Der Agent hat Zugriff auf eine Liste mit Namen und Beschreibungen und lädt den vollständigen Skilltext, wenn er für die Aufgabe relevant ist. Das spart Platz im Kontext: Es werden nicht alle Anweisungen auf einmal geladen.

Ein Skill allein gibt dem Agenten keine neuen Tools oder Zugriffsmöglichkeiten; er beschreibt, wie die bereits vorhandenen Tools zu verwenden sind. Eine neue Integration mit einem externen Dienst wird über MCP umgesetzt, das ein separates Thema ist. Wenn eine Aufgabe präzise Programmlogik, eine besondere Autorisierung oder die Verarbeitung von Ereignisströmen erfordert, braucht sie Agenten-Tools; ein Skill allein reicht nicht aus.

Wähle für eine Standardaufgabe einen fertigen Skill, wenn seine Anweisungen passen und seine Quelle geprüft wurde. Schreibe einen eigenen, wenn du deine bestimmte Abfolge von Aktionen, Einschränkungen und dein Ausgabeformat festhalten möchtest. Verwende /learn, wenn du bereits Material hast oder einen Prozess abgeschlossen hast und die Datei nicht manuell schreiben möchtest.

Das Format ist offen und mit der Agent Skills-Spezifikation kompatibel. Daher funktionieren Skills aus anderen Katalogen in der Regel ohne Formatänderungen in Hermes, auch wenn ein bestimmter Skill eigene Tools oder Schlüssel voraussetzen kann. Du kannst deinen eigenen Skill auch teilen, wenn du möchtest.

Welche Skills sind bereits installiert, und wo werden sie gespeichert?#

Der Ordner ist so organisiert:

~/.hermes/skills/
├── research/
│   └── arxiv/
│       ├── SKILL.md
│       └── scripts/
├── productivity/
│   └── pdf/
│       ├── SKILL.md
│       └── references/
└── .hub/

SKILL.md ist die einzige erforderliche Datei. Alles Weitere wird nach Bedarf hinzugefügt: references/ für längere Materialien, scripts/ für Hilfsprogramme sowie templates/ und assets/ für Vorlagen und Dateien.

Der integrierte Katalog enthält Skills für alltägliche Aufgaben: GIFs finden, mit PDFs, Tabellen, YouTube, GitHub und Notizen arbeiten. Die vollständige Liste mit Beschreibungen findest du auf der Seite Katalog integrierter Skills. Bei jedem hermes update aktualisiert Hermes auch die integrierten Skills und bewahrt dabei deine Änderungen daran.

Wie installierst du einen fertigen Skill aus dem Katalog?#

1. Den Katalog durchsuchen

   hermes skills search pdf
   

   Die Suche umfasst alle verbundenen Quellen. Den vollständigen Katalog ohne Filter kannst du mit hermes skills browse anzeigen.

2. Die Infoseite des Skills ansehen

   hermes skills inspect skills-sh/anthropics/skills/pdf
   

   Die Infoseite zeigt Beschreibung, Quelle und Vertrauensstufe. Installiere keinen Skill von jemand anderem, ohne seine Infoseite gelesen zu haben.

3. Installieren

   hermes skills install skills-sh/anthropics/skills/pdf
   

   Hermes lädt SKILL.md und die zugehörigen Dateien herunter, führt eine Sicherheitsprüfung durch und legt alles unter ~/.hermes/skills/ ab. Der Skill ist sofort als Befehl /pdf verfügbar. Wenn der Skill zusätzliche Tools oder Schlüssel benötigt, sind sie in seiner SKILL.md aufgeführt, und Hermes weist dich während der Installation darauf hin.

Bei der Sicherheitsprüfung wird nach Versuchen gesucht, Daten nach außen zu senden, Anweisungen für den Agenten einzuschleusen und Befehlen, die Dateien löschen oder beschädigen könnten. Die Quellen haben unterschiedliche Vertrauensstufen:

Wenn die Prüfung eine Warnung ausgibt, kannst du die Installation mit der Option --force fortsetzen, aber lies zuerst, welches Risiko gefunden wurde. Ein Urteil „gefährlich“ lässt sich nicht umgehen. Die Prüfung selbst garantiert keine Sicherheit: Lies die Anweisungen und zugehörigen Befehle, bevor du den Skill einer anderen Person zum ersten Mal ausführst.

Wie installierst du einen Skill von GitHub oder über einen Link?#

Drei Installationsmöglichkeiten:

# 1. Ein bestimmter Skill aus einem GitHub-Repository (der Pfad im Repository folgt auf seinen Namen)
hermes skills install anthropics/skills/skills/pdf

# 2. Ein direkter Link zu einer SKILL.md auf einer beliebigen Website (teile diesen Skill in einem Chat)
hermes skills install '<OFFICIAL_URL>'

# 3. Ein ganzes Repository als Quelle verbinden (ersetze owner und Repository durch deine Angaben)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

Bei einem direkten Link lädt Hermes SKILL.md und nur die darin erwähnten Dateien aus den Dienst-Unterordnern herunter. Nicht zugehörige Dateien der Website werden nicht heruntergeladen. Der Link wird als Quelle gespeichert, und hermes skills update aktualisiert den Skill später von derselben Adresse.

Neben GitHub sind auch externe Skill-Kataloge angebunden. Skills aus diesen Katalogen findest du mit demselben Befehl hermes skills search, indem du die Quelle angibst.

Wie verwendest du einen Skill nach der Installation?#

Gib hermes ...-Befehle im Terminal ein und /skill-name-Aufrufe in einem Chat mit dem Agenten (im selben Terminal, in der Weboberfläche oder in einem Messenger):

/gif-search funny cats
/github-pr-workflow create a PR for the authorization rewrite

Wenn du /skill-name ohne Aufgabe eingibst, lädt Hermes die Anweisungen und fragt, was der Agent tun soll. Du kannst mehrere Skills in einer Zeile aufrufen, bis zu fünf; der übrige Text wird zur Aufgabe:

/github-pr-workflow /test-driven-development close issue 123 and open a PR

Für regelmäßig verwendete Kombinationen gibt es Skill-Bündel, die in der Hermes-Terminologie Bundles heißen: hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development gruppiert mehrere Skills unter einem kurzen Befehl /backend-dev. Ein solches Bundle dient als Alias; die darin enthaltenen Skills müssen vorher installiert werden.

Slash-Befehle funktionieren auch in Telegram, wenn das Gateway verbunden ist. Die Einrichtung wird in der Anleitung Hermes Agent mit Telegram verbinden beschrieben. So kannst du Skills bequem von deinem Smartphone aus ausführen.

Wie erstellst du einen eigenen Skill: Was gehört in die SKILL.md?#

Du kannst diesen Skill kopieren und für dich anpassen:

---
name: weekly-review
description: Weekly review: what got done, what stalled, plan for next week
version: 1.0.0
metadata:
  hermes:
    tags: [planning, review]
---

# Weekly review

## When to Use
When the user asks to review the week or put together a plan for the next one.

## Procedure
1. Get the week's task list from the file the user provided, or ask them for it.
2. Sort the tasks into three groups: done, stalled, and new.
3. Name three priorities for the coming week.

## Pitfalls
- Don't invent tasks that aren't in the original list.

## Verification
Ask the user to confirm that the tasks are correctly sorted into “done,” “stalled,” and “new.”

Der Kopfteil zwischen den drei Bindestrichen ist Metadaten. Die wichtigsten Felder sind name (in lateinischen Buchstaben, durch Bindestriche getrennt und für den Aufruf des Skills als Befehl verwendet) und description. Der Agent verwendet das Beschreibungsfeld, um zu entscheiden, ob der Skill zur aktuellen Aufgabe passt und geladen werden sollte. Ist die Beschreibung vage, wird der Skill möglicherweise nicht geladen, wenn er gebraucht wird.

Auf den Kopfteil folgen Abschnitte mit Anweisungen. When to Use legt fest, wann der Skill geladen wird. Procedure enthält die Schritte. Pitfalls behandelt häufige Fehler des Agenten und wie sie vermieden werden können. Verification erklärt, wie das Ergebnis überprüft wird. Wenn die Anweisungen lang sind, verschiebe den Hauptinhalt in Dateien unter references/; sie werden nur geladen, wenn sie gebraucht werden. Hilfsprogramme gehören in scripts/.

Wenn ein Skill einen API-Schlüssel benötigt, deklariere ihn im Kopfteil mit required_environment_variables; füge den Schlüssel selbst nicht in die Datei ein, sondern deklariere nur den Variablennamen. Bei der ersten Verwendung in einem lokalen Terminal fragt Hermes einmal nach dem Wert und stellt ihn anschließend automatisch bereit (in Messengern wirst du aufgefordert, den Schlüssel lokal zu konfigurieren). Die Felder platforms, config, blueprint und weitere werden auf der offiziellen Dokumentationsseite Skills erstellen beschrieben.

Sobald die Datei fertig ist, gehe wie folgt vor:

1. Den Skill-Ordner erstellen

   mkdir -p ~/.hermes/skills/weekly-review
   

   Der Ordnername entspricht dem Feld name im Kopfteil.

2. SKILL.md speichern

   Lege eine Datei namens SKILL.md mit deinen Anweisungen im Ordner ab. Du kannst das Beispiel oben verwenden und für deine Aufgabe umschreiben.

3. Den Skill aufrufen und prüfen

   Gib /weekly-review ein und bitte den Agenten, deine Woche zu überprüfen. Wenn er die Schritte aus deinen Anweisungen befolgt, funktioniert der Skill.

Wie erstellst du mit /learn einen Skill aus vorhandenem Material?#

/learn documentation for the demo API in ~/projects/example-docs, especially the section on authentication
/learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
/learn how I just published a site to hosting

Wenn du gerade mit dem Agenten einen komplizierten Prozess abgeschlossen hast, bitte /learn, ihn als Skill zu speichern, solange alle Schritte noch im Gespräch stehen. Beim nächsten Mal wiederholt Hermes den Ablauf anhand der fertigen Anweisungen.

Eine große Quelle wie ein Buch, eine Spezifikation oder ein Dokumentenarchiv passt nicht in eine einzelne Datei. Hermes erstellt dann eine kompakte SKILL.md mit einer Themenübersicht und verschiebt die Einzelheiten nach references/. Diese Dateien beanspruchen keinen Platz im Kontext, bis der Agent sie lädt, um eine Frage zu beantworten. Wenn du /learn erneut zum selben Thema aufrufst, ergänzt es den bestehenden Skill, anstatt ein Duplikat zu erstellen.

Wie prüfst du, ob ein Skill funktioniert?#

hermes chat --toolsets skills -q "review my week using the weekly-review skill: done - report and calls, stalled - hosting payment"

Das ist die in der Dokumentation empfohlene Prüfung: Führe den Skill aus und überprüfe, ob der Agent deine Anweisungen befolgt. Wenn nicht, prüfe drei mögliche Ursachen. Erstens stimmen möglicherweise der Ordnername oder das Feld name im Kopfteil nicht mit dem Namen überein, den du aufrufst. Zweitens ist die Beschreibung möglicherweise so formuliert, dass nicht klar wird, wann der Skill verwendet werden soll; formuliere die Beschreibung mit den Worten der Aufgabe neu. Drittens befindet sich der Ordner möglicherweise nicht unter ~/.hermes/skills/, sodass Hermes ihn nicht sehen kann. Beachte, dass die Option --toolsets skills die für die Prüfung verfügbaren Tools beschränkt: Sie zeigt, wie der Agent mit der Anweisung arbeitet, prüft aber nicht die Abhängigkeiten des Skills, etwa externe Programme.

hermes skills list im Terminal zeigt genau an, was installiert ist.

Skills sind Teil eines KI-Klons: Sie halten einmalig fest, wie du eine Aufgabe ausführst, damit der Agent sie ohne Erinnerungen wiederholen kann. Die Kombination umfasst KI-Klon + Zweites Gehirn + Kontext-Engineering. Damit kannst du dem Agenten deine Arbeitsweise und den Aufgabenkontext vermitteln.

Wie aktualisierst und entfernst du Skills?#

hermes skills check      # was sich an den Quellen geändert hat
hermes skills update     # neue Versionen herunterladen
hermes skills uninstall pdf   # einen Skill aus dem Hub entfernen

Um einen manuell erstellten Skill zu entfernen, lösche seinen Ordner unter ~/.hermes/skills/. Wenn du den Skill einer anderen Person angepasst hast, lässt update ihn unverändert: Hermes vergleicht Hashes und überspringt geänderte Dateien, damit deine Arbeit nicht überschrieben wird. Um das Original eines Skills aus dem Hub wiederherzustellen, verwende hermes skills update name --force; für einen integrierten Skill verwende hermes skills reset name --restore. Beide Befehle überschreiben deine Änderungen. Speichere daher zuerst deine Version.

Wenn du die integrierten Skills nicht brauchst und sie die Liste füllen, deaktiviert hermes skills opt-out ihre Ergänzung bei Aktualisierungen. Der Befehl opt-out --remove entfernt außerdem die Skills, die du nicht geändert hast.

Was kannst du tun, wenn sich ein Skill nicht installieren oder verwenden lässt?#

Hermes findet Skills in den Ordnern .hermes/skills/ und .agents/skills/ innerhalb eines Git-Repositorys. Bevor Hermes sie lädt, musst du das Repository als vertrauenswürdig markieren: Diese Dateien enthalten Anweisungen, denen der Agent folgen wird. Danach funktionieren die Repository-Skills nur innerhalb dieses Repositorys und durchlaufen dieselbe Sicherheitsprüfung. Du musst das Repository nur einmal als vertrauenswürdig markieren.

Was solltest du zuerst tun?#

Als Nächstes zu diesem Thema: Hermes Agent mit Telegram verbinden, damit du Skills von deinem Smartphone aus aufrufen kannst, und einen Agenten rund um die Uhr auf einem Server betreiben, wenn du zeitgesteuerte Skills verwenden möchtest. Wenn du einen Agenten auswählst, lies den Vergleich OpenClaw oder Hermes Agent.