Ich wollte eine Funktion zu OpenClaw hinzufügen, die es nicht gab: einen Hacker News Digest, der die Top-Geschichten jeden Morgen zusammenfasst und sie in meinen Slack postet. Eine solche Funktion existierte nicht als Skill. Also habe ich einen gebaut.
Beim ersten Mal dauerte es vier Stunden, einschließlich zwei Stunden, in denen ich die Skill-Spezifikation falsch gelesen habe. Der zweite Skill, den ich baute, benötigte 45 Minuten. Beim fünften konnte ich einen in 30 Minuten erstellen. Hier ist der Prozess, ohne all die Fehler, die ich unterwegs gemacht habe.
Was ein Skill eigentlich ist
Ein Skill ist ein Ordner mit Anweisungen und optionalen Skripten. Mindestens enthält er eine SKILL.md-Datei — ein Markdown-Dokument, das OpenClaw sagt, was der Skill macht, wann er aktiviert werden soll und wie er zu verwenden ist.
Das ist wirklich alles. Keine Kompilierung. Kein Paketregister. Kein Build-System. Ein Skill ist ein Dokument, das OpenClaw liest, wenn es eine bestimmte Aufgabe ausführen muss.
Der einfachste mögliche Skill:
Ein Ordner namens daily-hn-digest, der eine einzige Datei SKILL.md enthält, mit Anweisungen wie: „Wenn der Benutzer nach einem Hacker News Digest fragt, benutze das web_search-Tool, um die aktuellen Top-Geschichten auf Hacker News zu finden, fasse jede in 2-3 Sätzen zusammen und formatiere das Ergebnis als Aufzählungsliste.“
Das funktioniert. Der Agent liest die Anweisungen, befolgt sie und produziert einen Hacker News Digest. Kein Code erforderlich.
Komplexität hinzufügen, wenn man sie braucht
Der grundlegende Skill behandelt einfache Fälle. Für komplexere Workflows fügst du hinzu:
Referenzdateien. Mein Hacker News Skill enthält einen refs/-Ordner mit Beispielausgaben — der dem Agenten zeigt, wie ein guter Digest aussieht. Das verbessert die Konsistenz erheblich. Anstelle von „fasse Geschichten zusammen“ sieht der Agent „hier ist, wie eine gute Zusammenfassung aussieht — halte dich an dieses Format.“
Skripte. Einige Skills enthalten Shell-Skripte oder Python-Skripte für Aufgaben, die die KI nicht direkt erledigen kann. Mein Digest-Skill enthält ein Skript, das die Hacker News API abruft (schneller und zuverlässiger als Web-Scraping). Die Skill-Anweisungen sagen dem Agenten, das Skript auszuführen und dessen Ausgabe zu verarbeiten.
Konfiguration. Skills können aus Konfigurationsdateien lesen. Mein Digest-Skill hat eine config.yaml, die angibt, wie viele Geschichten einbezogen werden sollen (Standard: 10), welche Kategorien priorisiert werden sollen und welches Ausgabeformat (Slack, E-Mail oder reiner Text).
Die Struktur, die funktioniert
Nachdem ich etwa ein Dutzend Skills gebaut habe, hier ist die Ordnerstruktur, auf die ich mich festgelegt habe:
my-skill/
├── SKILL.md — Hauptanweisungen (erforderlich)
├── refs/ — Beispielhafte Eingaben und Ausgaben (optional)
├── scripts/ — Hilfsskripte (optional)
└── config.yaml — Konfiguration (optional)
SKILL.md ist die wichtigste Datei. Sie sollte Folgendes enthalten:
1. Eine klare Beschreibung dessen, was der Skill macht
2. Wann der Skill aktiviert werden soll (Auslösebedingungen)
3. Schritt-für-Schritt-Anweisungen für den Workflow
4. Anleitungen zur Fehlerbehebung
5. Beispiele für gute Ausgaben
Die Qualität deiner SKILL.md bestimmt direkt die Qualität des Skills. Eine vage SKILL.md erzeugt inkonsistente Ergebnisse. Eine präzise SKILL.md liefert zuverlässige Ergebnisse.
Gute Anweisungen schreiben
Die größte Lektion, die ich gelernt habe: Schreibe SKILL.md, als würdest du einen neuen Mitarbeiter schulen, nicht wie wenn du Dokumentation schreibst.
Schlecht: „Rufe Hacker News-Geschichten ab und fasse sie zusammen.“
Gut: „Rufe die Top 10 Geschichten von der Hacker News API mit dem Skript unter scripts/fetch-hn.sh ab. Schreibe für jede Geschichte eine 2-3-sätzige Zusammenfassung, die Folgendes abdeckt: was passiert ist, warum es wichtig ist und die Reaktion der Community (wenn bemerkenswert). Formatiere als nummerierte Liste mit dem Titel der Geschichte als Link.“
Die gute Version beseitigt Mehrdeutigkeit. Der Agent weiß genau, was zu tun ist, welches Format zu verwenden ist und welche Informationen einzuschließen sind. Kein Raum für kreative Interpretation, wo du es nicht willst.
Fehlermodi einbeziehen. „Wenn die Hacker News API nicht erreichbar ist, benutze web_search als Fallback. Wenn weniger als 5 Geschichten verfügbar sind, vermerke dies in der Ausgabe und fahre mit dem fort, was verfügbar ist. Erfinde keine Geschichten.“
Grenzen festlegen. „Führe keine Editorials durch. Füge keine Meinungen zu den Geschichten hinzu. Lass keine Geschichten aus, weil sie unbedeutend erscheinen. Präsentiere alle Top-Geschichten neutral.“
Deinen Skill testen
Der Testprozess ist einfach: Installiere den Skill, löse ihn aus und überprüfe die Ausgabe.
Für meinen Hacker News Skill:
1. Kopiere den Ordner in das Skills-Verzeichnis
2. Starte OpenClaw neu (oder warte, bis es den neuen Skill erkennt)
3. Tippe „Gib mir einen Hacker News Digest“
4. Überprüfe die Ausgabe anhand der Erwartungen
5. Passe SKILL.md basierend darauf an, was schiefgelaufen ist
In der Regel durchlaufe ich 3-4 Revisionen, bevor ich zufrieden bin. Häufige Probleme: der Agent überspringt Schritte (füge genauere Anweisungen hinzu), inkonsistente Formatierung (füge ein Beispiel für die Ausgabe hinzu) oder Informationen, die du nicht wolltest (füge explizite Grenzen hinzu).
Veröffentlichung und Teilen
Sobald dein Skill funktioniert, kannst du ihn über ClawHub teilen — dem Marktplatz für Community-Skills. Lade deinen Skill-Ordner hoch, füge eine Beschreibung hinzu, und andere Benutzer können ihn mit einem einzigen Befehl installieren.
Vor der Veröffentlichung solltest du deinen Skill aufräumen: Entferne persönliche Konfigurationen, füge ein README mit Installationsanweisungen hinzu und teste es auf einer frischen OpenClaw-Installation, um sicherzustellen, dass es nicht von deiner lokalen Umgebung abhängt.
Die besten Community-Skills sind fokussiert (sie machen eine Sache gut), gut dokumentiert (klare SKILL.md) und solide (sie gehen elegant mit Fehlern um). Die schlechtesten sind vage („benutze KI, um Zeug zu machen“), schlecht dokumentiert oder anfällig.
Meine Lieblingsbenutzerdefinierten Skills
Über den Hacker News Digest hinaus sind hier die benutzerdefinierten Skills, die ich täglich nutze:
Meeting-Vorbereitung. Vor einem Meeting sage ich „Vorbereitung für meinen Termin um 14 Uhr mit [Kunde].“ Der Skill zieht die letzten E-Mails, Projektupdates und offenen Punkte in Bezug auf diesen Kunden und erstellt ein einseitiges Briefing.
Code-Review-Assistent. Wenn ich Code pushe, überprüft der Skill ihn anhand der Codierungsstandards unseres Teams (dokumentiert in einer Referenzdatei) und postet Kommentare in unserem Teamkanal.
Wöchentlicher Retro-Generator. Jeden Freitag sammelt der Skill, was ich in dieser Woche erreicht habe (aus GitHub-Commits, Slack-Nachrichten und Aufgabenabschlüssen) und entwirft eine wöchentliche Zusammenfassung.
Jeder dieser Skills dauerte etwa eine Stunde, um ihn zu erstellen. Jeder spart 15-30 Minuten pro Nutzung. Der ROI ist offensichtlich.
🕒 Published: