Was eine Claude Skill laut Anthropics eigenem Leitfaden wirklich funktionsfähig macht

Ein Skill ist ein Ordner, den Claude während einer Aufgabe öffnen kann: eine Datei namens SKILL.md sowie optional Skripte und Referenzmaterial. Das Versprechen dahinter: Claude zahlt nur für das, was tatsächlich genutzt wird. Der Großteil eines Skills bleibt außerhalb des Kontextfensters, bis im Gespräch etwas auftaucht, das ihn erfordert. Anthropics eigener Leitfaden zur Erstellung widmet der Frage, was aus einem Skill herausgehalten werden sollte, mehr Raum als der Frage, was hineingehört. Die Grundzüge dieser Empfehlungen verdienen es, direkt übernommen zu werden.

Das Beschreibungsfeld entscheidet alles

Bevor Claude einen Skill öffnet, sieht es nur eines: das Feld description im YAML-Frontmatter, das auf 1.024 Zeichen begrenzt ist. Anthropics Vorgaben sind konkret: Die Beschreibung soll in der dritten Person formuliert sein („Verarbeitet Excel-Dateien …“, nicht „Ich kann Ihnen helfen …“) und sowohl angeben, was der Skill leistet, als auch, wann er eingesetzt werden sollte. Da potenziell mehr als hundert Skills gleichzeitig verfügbar sind, wird dieser Satz zum Auswahlkriterium: Claude entscheidet allein anhand der Beschreibung zwischen den Kandidaten. Ist sie vage, wird der Skill stillschweigend nie ausgewählt, ohne dass eine Fehlermeldung den Grund verrät.

Das Feld name ist kürzer, unterliegt aber eigenen Regeln: höchstens 64 Zeichen, ausschließlich Kleinbuchstaben, Zahlen und Bindestriche; zudem darf es weder „claude“ noch „anthropic“ enthalten. Anthropic empfiehlt Namen in Form substantivierter Tätigkeiten (processing-pdfs, analyzing-spreadsheets) statt nichtssagender Bezeichnungen (helper, utils).

Drei Ebenen, drei Kostenstufen

Skills werden stufenweise geladen. Das Kostenmodell erklärt, weshalb das Format so aufgebaut ist:

Diese Struktur erklärt zugleich die Größenbeschränkungen: Anthropic empfiehlt, den Inhalt der SKILL.md auf weniger als 5.000 Token und weniger als 500 Zeilen zu begrenzen. Alles darüber hinaus sollte in eine separate Datei ausgelagert und verlinkt werden. Kosten entstehen erst, wenn Claude sie öffnet.

Referenzen nur eine Ebene tief verschachteln

Eine Datei, die Claude nur teilweise liest, ist schlechter als eine, die es überhaupt nicht liest. Anthropics Leitfaden warnt davor, dass Claude eine tief verschachtelte Kette von Referenzen womöglich nur überfliegt, praktisch etwa mit einem Befehl wie head -100, statt sie vollständig zu lesen. Alles, was mehr als einen Link von der SKILL.md entfernt ist, läuft daher Gefahr, nur unvollständig erfasst zu werden. Referenzdateien mit mehr als 100 Zeilen sollten am Anfang ein Inhaltsverzeichnis enthalten. So erkennt Claude selbst bei nur teilweiser Lektüre den gesamten Umfang des verfügbaren Materials.

Anweisungen auf mögliche Fehlerquellen abstimmen

Nicht jeder Skill benötigt dieselbe Art von Anleitung. Anthropic beschreibt dies als „Freiheitsgrade“: Eine Aufgabe, die viel Urteilsvermögen verlangt, etwa das Zusammenfassen eines Dokuments oder das Verfassen einer E-Mail, lässt sich in einer flexiblen Sprache mit großen Freiheitsgraden beschreiben. Ein fehleranfälliger oder zwingend konsistent auszuführender Vorgang, beispielsweise eine Datenbankmigration oder eine bestimmte Abfolge von API-Aufrufen, sollte dagegen durch ein exaktes Skript mit geringen Freiheitsgraden festgelegt werden. Werden solche heiklen Fälle lediglich in lockerer Prosa beschrieben, versagen Skills häufig, ohne dass dies unmittelbar auffällt.

Erst die Ausgangslage testen, dann den Aufsatz schreiben

Die empfohlene Reihenfolge wird leicht übersprungen, was sich ebenso leicht rächt: Führen Sie mit Claude mindestens drei reale Testszenarien durch, bevor Sie eine umfangreiche Dokumentation verfassen. Nur so wissen Sie, was Claude ohne den Skill tatsächlich falsch macht. Andernfalls lösen Sie womöglich seitenlang ein Problem, das gar nicht bestand. Anthropic empfiehlt außerdem, den fertigen Skill mit jedem Modell zu testen, mit dem er eingesetzt werden soll. Haiku, Sonnet und Opus verhalten sich nicht identisch; Anweisungen, die für Opus knapp genug sind, können für Haiku zu lückenhaft ausfallen.

Wie die Installation von Software behandeln

Anthropic formuliert es unmissverständlich: Verwenden Sie nur Skills, die Sie selbst erstellt haben oder die direkt von Anthropic stammen. Ein Skill kann Claude dazu anweisen, ein Werkzeug zu missbrauchen oder Daten auszuschleusen. Es gibt keine Sandbox, die einen nicht vertrauenswürdigen Skill standardmäßig sicher macht. Ein Ordner mit Markdown-Dateien und Skripten, die Sie nicht selbst geschrieben haben, bleibt Code, dessen Ausführung Sie einem Agenten gestatten wollen.

Prüfen Sie das Datum. Anthropics eigenes Dokument zu bewährten Verfahren warnt davor, zeitabhängige Formulierungen wie „vor August 2025 X verwenden“ fest einzubauen. Inhalte von Skills werden nicht automatisch aktualisiert, und dieselbe Vorsicht gilt für diesen Artikel. Lesen Sie die verlinkte Dokumentation direkt, falls sich die oben beschriebenen Details zur Verfügbarkeit inzwischen geändert haben.