Lehren aus der Entwicklung von Claude Code: Wie wir Skills einsetzen

Fähigkeiten (Skills) sind zu einem der am häufigsten genutzten Erweiterungspunkte in Claude Code geworden. Sie sind flexibel, einfach zu erstellen und leicht zu verteilen.

Aber diese Flexibilität macht es auch schwer zu wissen, was am besten funktioniert. Welche Arten von Skills lohnen sich? Was ist das Geheimnis eines guten Skills? Wann teilt man sie mit anderen?

Wir bei Anthropic nutzen Skills in Claude Code intensiv – mit Hunderten von Skills im aktiven Einsatz. Dies sind die Lektionen, die wir über den Einsatz von Skills gelernt haben, um unsere Entwicklung zu beschleunigen.

Was sind Skills?

Wenn du neu bei Skills bist, empfehle ich dir, unsere Dokumentation zu lesen oder unseren neuesten Kurs auf Skilljar über Agent Skills anzusehen. Dieser Beitrag setzt voraus, dass du bereits mit Skills vertraut bist.

Ein häufiges Missverständnis über Skills ist, dass sie „nur Markdown-Dateien“ seien. Der interessanteste Aspekt von Skills ist jedoch, dass sie nicht nur Textdateien sind. Sie sind Ordner, die Skripte, Assets, Daten usw. enthalten können, die der Agent entdecken, durchsuchen und manipulieren kann.

In Claude Code haben Skills außerdem eine Vielzahl von Konfigurationsoptionen, einschließlich der Registrierung dynamischer Hooks.

Wir haben festgestellt, dass einige der interessantesten Skills in Claude Code diese Konfigurationsoptionen und die Ordnerstruktur auf kreative Weise nutzen.

Arten von Skills

Nachdem wir alle unsere Skills katalogisiert hatten, stellten wir fest, dass sie sich in einige wiederkehrende Kategorien gruppieren ließen. Die besten Skills passen sauber in eine Kategorie; die verwirrenderen überspannen mehrere. Dies ist keine definitive Liste, aber eine gute Möglichkeit, darüber nachzudenken, ob dir in deinem Unternehmen etwas fehlt.

1. Bibliotheks- & API-Referenzen

Skills, die erklären, wie man eine Bibliothek, ein CLI oder SDKs korrekt verwendet. Dies können sowohl für interne Bibliotheken als auch für gängige Bibliotheken sein, mit denen Claude Code manchmal Probleme hat. Diese Skills enthalten oft einen Ordner mit Referenz-Code-Snippets und eine Liste von Fallstricken, die Claude beim Schreiben eines Skripts vermeiden sollte.

Beispiele:

• billing-lib – deine interne Abrechnungsbibliothek: Randfälle, Stolperfallen usw.
• internal-platform-cli – jeder Unterbefehl deines internen CLI-Wrappers mit Beispielen, wann sie verwendet werden
• frontend-design – macht Claude besser in deinem Designsystem

2. Produktverifizierung

Skills, die beschreiben, wie man testet oder verifiziert, ob dein Code funktioniert. Diese werden oft mit einem externen Tool wie Playwright, tmux usw. zur Verifizierung kombiniert.

Verifizierungs-Skills sind äußerst nützlich, um die Korrektheit der Ausgabe von Claude sicherzustellen. Es kann sich lohnen, einen Ingenieur eine Woche lang nur damit zu beschäftigen, deine Verifizierungs-Skills exzellent zu machen.

Ziehe Techniken in Betracht, bei denen Claude ein Video seiner Ausgabe aufzeichnet, damit du genau sehen kannst, was getestet wurde, oder programmatische Zustandsprüfungen bei jedem Schritt erzwingst. Dies wird oft durch die Einbindung verschiedener Skripte in den Skill erreicht.

Beispiele:

• signup-flow-driver – durchläuft Registrierung → E-Mail-Verifizierung → Onboarding in einem Headless-Browser, mit Hooks zur Zustandsprüfung bei jedem Schritt
• checkout-verifier – steuert die Checkout-Oberfläche mit Stripe-Testkarten, verifiziert, dass die Rechnung tatsächlich im richtigen Zustand landet
• tmux-cli-driver – für interaktive CLI-Tests, bei denen das zu Verifizierende ein TTY benötigt

3. Datenabruf & -analyse

Skills, die eine Verbindung zu deinen Daten- und Monitoring-Stacks herstellen. Diese Skills können Bibliotheken zum Abrufen deiner Daten mit Anmeldedaten, spezifische Dashboard-IDs usw. sowie Anleitungen für gängige Workflows oder Methoden zum Datenabruf enthalten.

Beispiele:

• funnel-query – „Welche Events verknüpfe ich, um Registrierung → Aktivierung → Bezahlt zu sehen?“ sowie die Tabelle, die die kanonische user_id enthält
• cohort-compare – vergleicht die Retention oder Conversion zweier Kohorten, markiert statistisch signifikante Abweichungen, verlinkt zu den Segmentdefinitionen
• grafana – Datenquellen-UIDs, Clusternamen, Problem → Dashboard-Nachschlagetabelle

4. Geschäftsprozesse & Team-Automatisierung

Skills, die wiederkehrende Arbeitsabläufe in einem einzigen Befehl automatisieren. Diese Skills bestehen normalerweise aus recht einfachen Anweisungen, können aber komplexere Abhängigkeiten von anderen Skills oder MCPs haben. Bei diesen Skills kann das Speichern früherer Ergebnisse in Protokolldateien dem Modell helfen, konsistent zu bleiben und über frühere Ausführungen des Workflows zu reflektieren.

Beispiele:

• standup-post – aggregiert deinen Ticket-Tracker, GitHub-Aktivität und vorherige Slack-Daten → formatiertes Standup, nur mit Änderungen
• create-<ticket-system>-ticket – erzwingt Schema (gültige Enum-Werte, Pflichtfelder) plus Workflow nach der Erstellung (Reviewer benachrichtigen, in Slack verlinken)
• weekly-recap – gemergte PRs + abgeschlossene Tickets + Deployments → formatierter Rückblick

5. Code-Gerüste & Vorlagen

Skills, die Framework-Boilerplate für eine bestimmte Funktion in der Codebasis generieren. Du kannst diese Skills mit Skripten kombinieren, die komponierbar sind. Sie sind besonders nützlich, wenn dein Gerüst Anforderungen in natürlicher Sprache hat, die nicht vollständig durch Code abgedeckt werden können.

Beispiele:

• new-<framework>-workflow – erstellt ein neues Service/Workflow/Handler mit deinen Annotationen
• new-migration – deine Migrationsdatei-Vorlage plus häufige Fallstricke
• create-app – neue interne App mit deiner Auth-, Logging- und Deploy-Konfiguration vorverdrahtet

6. Code-Qualität & Review

Skills, die die Code-Qualität innerhalb deines Unternehmens durchsetzen und bei der Code-Überprüfung helfen. Diese können deterministische Skripte oder Tools für maximale Robustheit enthalten. Du möchtest diese Skills möglicherweise automatisch als Teil von Hooks oder innerhalb einer GitHub Action ausführen.

• adversarial-review – erzeugt einen Subagenten mit frischem Blick zur Kritik, implementiert Korrekturen, iteriert, bis die Befunde nur noch Kleinigkeiten sind
• code-style – erzwingt Code-Stil, insbesondere Stile, die Claude standardmäßig nicht gut beherrscht.
• testing-practices – Anweisungen zum Schreiben von Tests und was getestet werden soll.

7. CI/CD & Deployment

Skills, die dir helfen, Code innerhalb deiner Codebasis abzurufen, zu pushen und bereitzustellen. Diese Skills können auf andere Skills verweisen, um Daten zu sammeln.

Beispiele:

• babysit-pr – überwacht einen PR → wiederholt fehlerhafte CI → löst Merge-Konflikte → aktiviert Auto-Merge
• deploy-<service> – Build → Smoke-Test → schrittweiser Traffic-Rollout mit Fehlerratenvergleich → automatischer Rollback bei Regression
• cherry-pick-prod – isolierter Worktree → Cherry-Pick → Konfliktlösung → PR mit Vorlage

8. Runbooks

Skills, die ein Symptom (wie einen Slack-Thread, einen Alert oder eine Fehlersignatur) aufnehmen, eine Multi-Tool-Untersuchung durchführen und einen strukturierten Bericht erstellen.

Beispiele:

• <service>-debugging – ordnet Symptome → Tools → Abfragemuster für deine Dienste mit dem höchsten Traffic zu
• oncall-runner – ruft den Alert ab → überprüft die üblichen Verdächtigen → formatiert einen Befund
• log-correlator – zieht bei einer gegebenen Request-ID die passenden Logs aus jedem System, das sie möglicherweise berührt hat

9. Infrastrukturoperationen

Skills, die routinemäßige Wartungs- und Betriebsabläufe durchführen – einige davon beinhalten destruktive Aktionen, die von Schutzmaßnahmen profitieren. Sie erleichtern es Ingenieuren, Best Practices bei kritischen Operationen zu befolgen.

Beispiele:

• <resource>-orphans – findet verwaiste Pods/Volumes → postet in Slack → Wartezeit → Benutzer bestätigt → kaskadierende Bereinigung
• dependency-management – der Workflow deines Unternehmens zur Abhängigkeitsfreigabe
• cost-investigation – „Warum ist unsere Speicher-/Egress-Rechnung in die Höhe geschossen?“ mit den spezifischen Buckets und Abfragemustern

Tipps zum Erstellen von Skills

Sobald du dich für den zu erstellenden Skill entschieden hast, wie schreibst du ihn? Dies sind einige der Best Practices, Tipps und Tricks, die wir gefunden haben.

Wir haben kürzlich auch den Skill Creator veröffentlicht, um die Erstellung von Skills in Claude Code zu erleichtern.

Sag nicht das Offensichtliche

Claude Code weiß viel über deine Codebasis, und Claude weiß viel über das Programmieren, einschließlich vieler Standardmeinungen. Wenn du einen Skill veröffentlichst, der hauptsächlich Wissen betrifft, versuche dich auf Informationen zu konzentrieren, die Claude aus seiner normalen Denkweise herausbringen.

Der Frontend-Design-Skill ist ein großartiges Beispiel – er wurde von einem der Ingenieure bei Anthropic erstellt, indem er mit Kunden iterierte, um Claudes Designgeschmack zu verbessern und klassische Muster wie die Inter-Schriftart und lila Farbverläufe zu vermeiden.

Erstelle einen Abschnitt für Fallstricke

Der Inhalt mit der höchsten Signalwirkung in jedem Skill ist der Abschnitt „Fallstricke“. Diese Abschnitte sollten aus häufigen Fehlerpunkten aufgebaut werden, auf die Claude bei der Verwendung deines Skills stößt. Idealerweise wirst du deinen Skill im Laufe der Zeit aktualisieren, um diese Fallstricke zu erfassen.

Nutze das Dateisystem & progressive Offenlegung

Wie bereits gesagt, ist ein Skill ein Ordner, nicht nur eine Markdown-Datei. Du solltest das gesamte Dateisystem als eine Form des Kontext-Engineerings und der progressiven Offenlegung betrachten. Sage Claude, welche Dateien sich in deinem Skill befinden, und es wird sie zu geeigneten Zeitpunkten lesen.

Die einfachste Form der progressiven Offenlegung besteht darin, auf andere Markdown-Dateien zu verweisen, die Claude verwenden soll. Du könntest beispielsweise detaillierte Funktionssignaturen und Nutzungsbeispiele in references/api.md aufteilen.

Ein weiteres Beispiel: Wenn dein Endprodukt eine Markdown-Datei ist, könntest du eine Vorlagendatei dafür in assets/ ablegen, die kopiert und verwendet werden kann.

Du kannst Ordner mit Referenzen, Skripten, Beispielen usw. haben, die Claude helfen, effektiver zu arbeiten.

Vermeide es, Claude einzuschränken

Claude wird im Allgemeinen versuchen, sich an deine Anweisungen zu halten, und da Skills so wiederverwendbar sind, solltest du darauf achten, in deinen Anweisungen nicht zu spezifisch zu sein. Gib Claude die Informationen, die es braucht, aber gib ihm die Flexibilität, sich an die Situation anzupassen. Zum Beispiel:

Denke über das Setup nach

Manche Skills müssen möglicherweise mit Kontext vom Benutzer eingerichtet werden. Wenn du beispielsweise einen Skill erstellst, der dein Standup in Slack postet, möchtest du vielleicht, dass Claude fragt, in welchen Slack-Kanal es gepostet werden soll.

Ein gutes Muster hierfür ist, diese Setup-Informationen in einer config.json-Datei im Skill-Verzeichnis zu speichern, wie im obigen Beispiel. Wenn die Konfiguration nicht eingerichtet ist, kann der Agent den Benutzer nach den Informationen fragen.

Wenn du möchtest, dass der Agent strukturierte Multiple-Choice-Fragen präsentiert, kannst du Claude anweisen, das Tool AskUserQuestion zu verwenden.

Das Beschreibungsfeld ist für das Modell

Wenn Claude Code eine Sitzung startet, erstellt es eine Auflistung jedes verfügbaren Skills mit seiner Beschreibung. Diese Auflistung durchsucht Claude, um zu entscheiden: „Gibt es einen Skill für diese Anfrage?“ Das bedeutet, dass das Beschreibungsfeld keine Zusammenfassung ist – es ist eine Beschreibung, wann dieser Skill ausgelöst werden soll.

Speicher & Datenspeicherung

Einige Skills können eine Form von Speicher enthalten, indem sie Daten in sich speichern. Du könntest Daten in etwas so Einfachem wie einer append-only Text-Protokolldatei oder JSON-Dateien oder so Komplexem wie einer SQLite-Datenbank speichern.

Zum Beispiel könnte ein Standup-Post-Skill eine standups.log mit jedem von ihm geschriebenen Beitrag führen. Wenn du es das nächste Mal ausführst, liest Claude seine eigene Historie und kann erkennen, was sich seit gestern geändert hat.

Im Skill-Verzeichnis gespeicherte Daten können gelöscht werden, wenn du den Skill aktualisierst. Daher solltest du diese Daten in einem stabilen Ordner speichern. Derzeit stellen wir ${CLAUDE_PLUGIN_DATA} als stabilen Ordner pro Plugin zum Speichern von Daten zur Verfügung.

Skripte speichern & Code generieren

Eines der mächtigsten Werkzeuge, die du Claude geben kannst, ist Code. Wenn du Claude Skripte und Bibliotheken gibst, kann es seine Züge für die Komposition nutzen, um zu entscheiden, was als Nächstes zu tun ist, anstatt Boilerplate zu rekonstruieren.

Zum Beispiel könntest du in deinem Data-Science-Skill eine Bibliothek von Funktionen haben, um Daten aus deiner Eventquelle abzurufen. Damit Claude komplexe Analysen durchführen kann, könntest du ihm eine Reihe von Hilfsfunktionen wie folgt geben:

Claude kann dann spontan Skripte generieren, um diese Funktionalität zu kombinieren und erweiterte Analysen für Eingabeaufforderungen wie „Was ist am Dienstag passiert?“ durchzuführen.

On-Demand-Hooks

Skills können Hooks enthalten, die nur aktiviert werden, wenn der Skill aufgerufen wird, und für die Dauer der Sitzung bestehen bleiben. Verwende dies für stärker meinungsbasierte Hooks, die du nicht ständig ausführen möchtest, die aber manchmal extrem nützlich sind.

Zum Beispiel:

• /careful – blockiert rm -rf, DROP TABLE, force-push, kubectl delete über einen PreToolUse-Matcher auf Bash. Du willst das nur, wenn du weißt, dass du die Produktion berührst – wenn es immer eingeschaltet wäre, würde es dich wahnsinnig machen.
• /freeze – blockiert jede Bearbeitung/Änderung, die nicht in einem bestimmten Verzeichnis stattfindet. Nützlich beim Debuggen: „Ich möchte Logs hinzufügen, aber ich ‚repariere‘ ständig versehentlich etwas Unzusammenhängendes“

Skills verteilen

Einer der größten Vorteile von Skills ist, dass du sie mit dem Rest deines Teams teilen kannst.

Es gibt zwei Möglichkeiten, Skills mit anderen zu teilen:

• Skills in deinem Repository (unter ./.claude/skills) einchecken
• ein Plugin erstellen und einen Claude-Code-Plugin-Marktplatz haben, auf dem Benutzer Plugins hochladen und installieren können (lese mehr in der Dokumentation

Für kleinere Teams, die an relativ wenigen Repos arbeiten, funktioniert das Einchecken von Skills in die Repos gut. Aber jeder eingecheckte Skill fügt dem Kontext des Modells ein wenig hinzu. Wenn du skalierst, ermöglicht ein interner Plugin-Marktplatz die Verteilung von Skills, und dein Team kann entscheiden, welche es installieren möchte.

Verwalten eines Marktplatzes

Wie entscheidest du, welche Skills in einen Marktplatz aufgenommen werden? Wie reichen Leute sie ein?

Wir haben kein zentrales Team, das entscheidet; stattdessen versuchen wir, die nützlichsten Skills organisch zu identifizieren. Wenn du einen Skill hast, den Leute ausprobieren sollen, kannst du ihn in einen Sandbox-Ordner auf GitHub hochladen und in Slack oder anderen Foren darauf verweisen.

Sobald ein Skill Anklang gefunden hat (was der Skill-Eigentümer selbst entscheidet), kann der Eigentümer einen PR stellen, um ihn in den Marktplatz zu verschieben.

Ein Wort der Warnung: Es kann recht einfach sein, schlechte oder redundante Skills zu erstellen. Daher ist es wichtig, vor der Veröffentlichung eine Methode zur Kuratierung zu haben.

Skills kombinieren

Du möchtest vielleicht Skills haben, die voneinander abhängen. Zum Beispiel könntest du einen Datei-Upload-Skill haben, der eine Datei hochlädt, und einen CSV-Generierungs-Skill, der eine CSV erstellt und sie hochlädt. Diese Art der Abhängigkeitsverwaltung ist noch nicht nativ in Marktplätze oder Skills integriert, aber du kannst einfach andere Skills beim Namen nennen, und das Modell wird sie aufrufen, wenn sie installiert sind.

Skills messen

Um zu verstehen, wie ein Skill funktioniert, verwenden wir einen PreToolUse-Hook, der es uns ermöglicht, die Skill-Nutzung innerhalb des Unternehmens zu protokollieren (Beispielcode hier). So können wir Skills finden, die beliebt sind oder im Vergleich zu unseren Erwartungen zu wenig ausgelöst werden.

Fazit

Skills sind unglaublich leistungsstarke, flexible Werkzeuge für Agenten, aber es ist noch früh, und wir alle lernen noch, wie man sie am besten einsetzt.

Betrachte dies eher als eine Sammlung nützlicher Tipps, die wir als wirksam empfunden haben, denn als einen definitiven Leitfaden. Der beste Weg, Skills zu verstehen, ist, anzufangen, zu experimentieren und zu sehen, was für dich funktioniert. Die meisten unserer Skills begannen als ein paar Zeilen und eine einzige Stolperfalle und wurden besser, weil Leute immer wieder hinzufügten, wenn Claude auf neue Randfälle stieß.

Ich hoffe, das war hilfreich. Lass mich wissen, wenn du Fragen hast.