Was ist ein Agent Skill? Nützliche Skills richtig schreiben

KI-Agenten mit Fähigkeiten auszustatten, ist zur Mode geworden, und der Markt ist voll mit Hunderten von „Skills“. Ein schlecht geschriebener Skill ändert entweder gar nichts oder bläht den Kontext auf und macht die Arbeit schlechter. In diesem Artikel zeige ich Ihnen die Muster, die wirklich einen Unterschied machen, wie man einen guten Skill schreibt und welche Sicherheitsprüfung Sie vor der Installation durchführen sollten.

Dieser Artikel fasst das Video This New Hermes Agent Skill is Insane von Jack Roberts zusammen und erweitert es. Darin sagt Roberts, er habe Hunderte Skills für Hermes Agent getestet, die meisten für nutzlos befunden, und stellt dreizehn vor, die herausstechen. Die Muster hier stammen aus dieser Liste; die Testmethode und die Unterscheidung zwischen Skill und Regeldatei sind Ergänzungen dieses Beitrags.

Falls Sie Hermes Agent noch nie eingerichtet haben, beginnen Sie mit Was ist Hermes Agent und wie installiert man ihn.

Was ist ein Agent Skill?

Ein Agent Skill ist ein Paket von Anweisungen, das einem KI-Agenten beibringt, wie eine bestimmte Aufgabe zu erledigen ist. Es verändert nicht das Modell selbst; es funktioniert als Anweisungsdatei, die bei Bedarf greift. Den Unterschied zwischen dem Modell und dem Werkzeug, das es ausführt, erläutere ich im Beitrag Was ist ein AI-Harness und worin unterscheidet es sich vom Modell.

Der Nutzen liegt darin: Das Modell rät nicht jedes Mal neu, sondern folgt einem schriftlich festgehaltenen Verfahren. Sobald Sie eine Aufgabe einmal richtig gut hinbekommen haben, gießen Sie dieses Verfahren in einen Skill und erhalten von da an jedes Mal dieselbe Qualität.

Stellen Sie sich den Agenten als sehr klugen Praktikanten vor, der die Arbeit gerade erst kennenlernt. An Intelligenz fehlt es nicht; was fehlt, ist das Wissen darüber, wie Sie arbeiten. Genau diese Lücke füllt ein Skill.

Die Anatomie eines Skills

Eine gute Fähigkeit besteht aus vier Teilen, und jeder Teil hat eine eigene Aufgabe:

• Name: kurz und sagt, was der Skill tut. Der Agent sieht ihn in der Liste.
• Auslösebeschreibung: ein, zwei Sätze darüber, wann die Fähigkeit greifen soll. In der Praxis ist das der entscheidendste Teil.
• Verfahren: die Arbeitsschritte. Als Regelliste, ohne ausufernde Begründungen.
• Referenzen: lange Tabellen, Beispiele, Vorlagen. Sie gehören nicht in die Hauptdatei, sondern werden separat gehalten und nur bei Bedarf gelesen.

Den zweiten Punkt möchte ich extra hervorheben, denn genau daran scheitern die meisten nutzlosen Skills.

Wie schreibt man eine Auslösebeschreibung?

Der Agent entscheidet anhand der Beschreibung, welche Fähigkeit er aufruft. Egal wie gut das Verfahren ist — wenn die Beschreibung vage bleibt, greift die Fähigkeit nie. Oder sie greift an der falschen Stelle.

Zwei Beispiele:

• Schwach: „Hilft beim Schreiben.“
• Gut: „Wird verwendet, um Blogtext-Entwürfe, Überschriften und Meta-Beschreibungen zu erzeugen. Wird nicht verwendet, um vorhandenen Text zu überarbeiten.“

Das zweite nennt sowohl den Anwendungsbereich als auch das, was außerhalb liegt. Eine negative Grenze zu formulieren, ist die billigste Methode gegen Fehlauslösungen.

Vor der Installation: die Sicherheitsprüfung

Dieser Teil wird übersprungen, und das sollte er nicht. Ein Skill ist Text, der Ihrem Agenten Anweisungen gibt. Wenn Sie einen aus dem Internet geladenen Text akzeptieren, ohne gelesen zu haben, was er Ihrem Agenten sagt, reißen Sie eine ernste Lücke auf.

Der erste Skill im Video übernimmt genau diese Aufgabe: Er prüft einen neuen Skill vor der Installation, recherchiert Alternativen und lässt ihn dann zu, fragt nach oder stellt ihn unter Quarantäne. Dieselbe Prüfung können Sie auch von Hand machen. Machen Sie vor der Installation mindestens das:

• Auf Prompt Injection prüfen. Enthält der Skill Anweisungen, die den Agenten von seiner eigentlichen Aufgabe ablenken, ihn zum Abfluss von Daten verleiten oder Freigabeschritte umgehen?
• Was fordert er an? Dateizugriff, Netzwerkanfragen, Verbindungen zu externen Diensten — was davon und warum?
• Alternativen ansehen. Gibt es einen einfacheren oder besser gepflegten Skill, der dasselbe leistet?
• Im Zweifel in Quarantäne. Testen Sie ihn nicht direkt in Ihrer Hauptumgebung, sondern in einem separaten Arbeitsbereich.

Kurz gesagt: Behandeln Sie einen Skill wie eine Bibliotheksabhängigkeit. Wenn Sie kein beliebiges Paket in Ihre Codebasis aufnehmen, dann fügen Sie Ihrem Agenten auch keine beliebigen Anweisungen hinzu.

Skill-Muster, die wirklich funktionieren

Unter Hunderten gibt es ein paar Muster mit bleibendem Wert. Ihnen allen ist gemeinsam, dass sie eine natürliche Schwäche des Modells ausgleichen. Die drei folgenden Muster zeigt das Video mit Beispielen aus Matt Pococks quelloffener Skill-Sammlung (grill-me, handoff und teach). Derselbe Ansatz gilt auch beim Design; beschrieben habe ich ihn in den sieben Stufen des KI-Designs.

Klärende Rückfragen

Der teuerste Fehler von Agenten ist, einen halb verstandenen Auftrag schnell zu erledigen. Dieses Muster kehrt das um: Bevor die Arbeit beginnt, stellt der Agent Ihnen Fragen. Für wen, unter welcher Einschränkung, woran wird Erfolg gemessen?

Einfach, aber mit großer Wirkung. Wenn Sie sagen „Ich denke über eine neue Geschäftsidee nach, frag mich dazu aus“, legen die Rückfragen meistens genau die Schwachstelle der Idee offen, ohne dass Sie es kommen sehen.

Das Übergabedokument

Beim Wechsel von einem Agenten zum nächsten oder von einer Sitzung zur folgenden müssen Sie jedes Mal alles von vorn erklären. Dieses Muster gießt die Arbeit in ein strukturiertes Dokument: aktueller Stand, getroffene Entscheidungen, nächste Schritte, empfohlene Werkzeuge und sensible Informationen, auf die zu achten ist.

Bei länger laufenden Arbeiten ist der Wert enorm. Statt den Kontext einer Arbeitswoche in zwei Absätzen zusammenzufassen, bekommen Sie ein Dokument, das sich tatsächlich übergeben lässt.

Der Lehrmodus

Die meisten stellen dem Agenten eine Frage, bekommen eine Antwort von einem Absatz und belassen es dabei. Dieses Muster macht aus der Interaktion eine Unterrichtsstunde: Zuerst wird das Ziel geklärt (warum lernst du das?), dann wird ein Thema nach dem anderen erklärt, und am Ende wird geprüft, was hängen geblieben ist.

Der Unterschied liegt hier: Wissen, das an kein Ziel geknüpft ist, wird vergessen. Auf die Frage „Wie wachse ich auf Instagram?“ eine an Ihrem Ziel ausgerichtete Lektion zu bekommen statt einer allgemeinen Liste, führt zu einem völlig anderen Ergebnis.

Wie schreibt man einen guten Skill?

Der wertvollste Skill ist das Regelwerk, mit dem Sie andere Skills gut schreiben. Auch das Video stellt einen Skill vor, der Skills schreibt (Skill Creator); seine Prinzipien lassen sich so zusammenfassen:

• Eine Aufgabe, ein Skill. Je größer der Anwendungsbereich einer Fähigkeit wird, desto unklarer wird, wann sie greifen soll — und desto häufiger ruft das Modell sie an der falschen Stelle auf.
• Kürzen Sie die Beschreibung. Die Definition eines Skills wird in jeder Runde im Kontext mitgeschleppt. Jedes überflüssige Wort kostet dauerhaft.
• Details erst auf Abruf laden. Vergraben Sie lange Referenzen nicht in der Hauptdatei, sondern legen Sie sie in eigene Dateien und lassen Sie sie nur bei Bedarf lesen.
• Schreiben Sie Regeln, keine Geschichten. Eine Liste mit „Du machst Folgendes“ funktioniert besser als seitenweise Begründung.
• Seien Sie direktiv. Modelle sind probabilistisch; manchmal rufen sie die richtige Fähigkeit nicht von selbst auf. Sagen Sie bei kritischen Aufgaben ausdrücklich, welcher Skill zu benutzen ist.

Der letzte Punkt wird oft missverstanden. Der Agent findet die richtige Fähigkeit meistens selbst — aber „meistens“ ist für Produktivarbeit keine ausreichende Garantie.

Wie testen Sie einen Skill?

Es genügt nicht, die geschriebene Fähigkeit zu installieren und zu sagen „läuft wohl“. Sie muss drei Tests bestehen:

1. Auslösetest. Fordern Sie die Aufgabe an, ohne den Skill beim Namen zu nennen, nur über ihre Beschreibung. Greift er? Wenn nicht, ist die Beschreibung zu schwach.
2. Fehlauslösetest. Fordern Sie eine Aufgabe an, die außerhalb des Bereichs liegt, aber ähnlich aussieht. Der Skill darf nicht greifen. Tut er es doch, ist der Bereich zu weit gefasst.
3. Wiederholungstest. Führen Sie dieselbe Anfrage dreimal in getrennten Sitzungen aus. Liegen die drei Ergebnisse nah beieinander? Wenn nicht, ist das Verfahren nicht bestimmt genug.

Der dritte Test ist der aufschlussreichste. Die Existenzberechtigung einer Fähigkeit ist ja gerade die Wiederholbarkeit; liefert sie drei verschiedene Ergebnisse, tut sie ihre Arbeit nicht. Das Gegenstück dieses Konsistenzproblems auf der Designseite habe ich in der Kritiker-Schleife beschrieben.

Achten Sie beim Testen nicht darauf, was das Modell tut, sondern warum es was tut. Eine Fähigkeit, die auf dem falschen Weg zum richtigen Ergebnis kommt, bricht, sobald sich die Eingabe ein wenig ändert.

Skill-Wildwuchs: die eigentliche Gefahr

Mit der Zeit sammeln sich Dutzende Fähigkeiten an, und ab einem gewissen Punkt wird das System langsamer und der Agent beginnt, die falsche Fähigkeit aufzurufen. Das nennt man Skill-Wildwuchs (Skill Bloat).

Zwei Regeln beugen dem vor:

1. Fragen Sie sich, bevor Sie einen neuen Skill schreiben: Ist es richtiger, einen bestehenden zu erweitern, oder einen neuen anzulegen? In den meisten Fällen ist Erweitern die bessere Wahl.
2. Regelmäßig ausmisten. Löschen Sie jede Fähigkeit, die seit drei Monaten kein einziges Mal gegriffen hat. Löschen lässt sich rückgängig machen, Unordnung nicht.

Skill, Regeldatei oder einfacher Prompt?

Die drei werden durcheinandergebracht, und die falsche Wahl kostet Zeit. Die Unterscheidung:

• Einfacher Prompt — wenn die Aufgabe einmalig ist. Wenn das Aufschreiben des Verfahrens länger dauert als die Arbeit selbst, hören Sie dort auf.
• Regeldatei (die Anweisungen im Projektstamm, die in jeder Sitzung gelten) — wenn die Einschränkung immer gilt. Ihr Codestil, Ihre sprachlichen Vorlieben, Verzeichnisse, die niemand anfassen darf. Das wird nicht ausgelöst, das ist dauerhaft aktiv.
• Skill — wenn die Aufgabe wiederkehrt, aber nicht immer gilt. Verfahren, die nur dann greifen sollen, wenn genau diese Aufgabe ansteht.

Der häufigste Fehler ist, eine dauerhaft geltende Regel in einen Skill zu packen. Solange dieser Skill nicht ausgelöst wird, wird die Regel ignoriert, und Sie verstehen nicht, warum sie nicht angewendet wird.

Der umgekehrte Fall kommt auch vor: Ein langes Verfahren, das nur gelegentlich gebraucht wird, landet in der Regeldatei und belegt Kontext auch in allen Runden, in denen es nie zum Einsatz kommt.

Den Agenten dauerhaft am Laufen halten

Die stärksten Eigenschaften eines Agenten ergeben sich daraus, dass er auch arbeitet, wenn Sie nicht davorsitzen: auf eine eingehende Nachricht antworten, eine geplante Aufgabe ausführen, einen langen Auftrag im Hintergrund abschließen.

Sobald Sie Ihren Laptop zuklappen, steht das alles still. Wenn Sie also wirklich einen durchgehend laufenden Aufbau wollen, müssen Sie den Agenten statt auf Ihrem eigenen Rechner auf einem dauerhaft erreichbaren Server betreiben. Im Video läuft dieser Aufbau auf einem kleinen virtuellen Server (VPS), und ein Server dieser Größe soll dafür genügen.

Eine Warnung: Einem dauerhaft laufenden Agenten geben Sie API-Schlüssel und Zugriff auf Dienste. Definieren Sie ein Ausgabenlimit, halten Sie die Berechtigungen eng und führen Sie ein Protokoll, in dem Sie sehen können, was er tut.

Kurz gefasst

Skills einzurichten ist keine Sammelleidenschaft. Der Wert liegt nicht in der Anzahl, sondern darin, Ihre wiederkehrenden Aufgaben in schriftliche Verfahren zu übersetzen, jede installierte Fähigkeit gelesen zu haben und die zu löschen, die ihren Zweck nicht erfüllt. Ein konkretes Beispiel dafür, wie man wiederkehrende Produktionsarbeit in ein Verfahren überführt, finden Sie im Artikel über das Automatisieren von Datengrafiken und Icons. Wenige, gut geschriebene Fähigkeiten heben Ihren Agenten tatsächlich auf ein anderes Niveau.

Häufig gestellte Fragen

Was ist der Unterschied zwischen einem Skill und einem Prompt?

Ein Prompt ist eine einmalige Anfrage; ein Skill ist das schriftliche Verfahren für eine wiederkehrende Aufgabe. Wenn Sie denselben Prompt zum dritten Mal tippen, ist das die Stelle, die in einen Skill gehört.

Wie viele Skills sollte ich installieren?

Die Anzahl ist kein Ziel. Als Faustregel funktionieren wenige, klar definierte Fähigkeiten besser als viele unscharfe; misten Sie ungenutzte regelmäßig aus.

Soll ich Skills selbst schreiben oder fertige installieren?

Fangen Sie mit fertigen an und passen Sie sie an Ihre eigene Arbeit an. Installieren Sie aber keinen einzigen, ohne den Inhalt gelesen zu haben — das ist sowohl eine Sicherheits- als auch eine Qualitätsfrage.

Muss man programmieren können, um Skills zu schreiben?

Meistens nicht. Die meisten Fähigkeiten bestehen aus reinem Anweisungstext. Programmierkenntnisse helfen Ihnen, die Schritte zu überprüfen, die ein Skill ausführt; das ist ein Vorteil, aber keine Voraussetzung.

Quelle

• Jack Roberts, This New Hermes Agent Skill is Insane (YouTube, August 2026). Der Skill zur Sicherheitsprüfung, das klärende Nachfragen, das Übergabedokument, der Lehrmodus, die Prinzipien zum Schreiben von Skills und der Betrieb des Agenten auf einem Server beruhen auf diesem Video.
• Matt Pocock, mattpocock/skills (GitHub): die Quelle der Skills grill-me, handoff und teach.