Wie Claude Code Skills wirklich funktionieren

Wer zum ersten Mal von “Claude Code Skills” hört, denkt oft an einen aufgehübschten System-Prompt — eine längere, sauberer formulierte Version der Anweisungen, die man sonst oben in den Chat einfügt. Dieses Bild trifft es nicht, und der Unterschied ist praktisch relevant.

Ein Skill ist ein Ordner, kein Absatz

Ein Skill ist ein Verzeichnis auf der Festplatte: eine SKILL.md-Datei mit Name und Beschreibung im Frontmatter, dazu optional Referenzdateien, Skripte oder Vorlagen, die für die Aufgabe gebraucht werden. Claude Code liest beim Start nur das Frontmatter aller installierten Skills — Name und ein kurzes Auslösekriterium. Der eigentliche Inhalt eines Skills wird erst geladen, wenn Claude entscheidet, dass die aktuelle Aufgabe zu diesem Kriterium passt.

Genau das ändert die Denkweise: Man kann fünfzig Skills installieren, ohne den Kontext-Preis für fünfzig Skills zu zahlen. Der Frontmatter-Index kostet pro Skill nur wenige Token. Die eigentlichen Anweisungen — etwa eine 2.000 Wörter lange Checkliste oder ein Python-Skript für eine deterministische Aufgabe — werden nur geladen, wenn sie relevant sind, und auch nur für die Skills, die tatsächlich gegriffen haben.

Warum das mehr zählt als der Prompt selbst

Ein System-Prompt wird bei jeder einzelnen Anfrage geladen, egal ob er zur aktuellen Aufgabe passt oder nicht. Ein Skill wird nur dann geladen, wenn das Modell selbst entscheidet, dass die Aufgabe zum Auslösekriterium passt. Das bedeutet konkret:

• Man kann enge, klar festgelegte Abläufe hinterlegen — “so machen wir hier Datenbank-Migrationen”, “genau diese Checkliste für ein Security-Review” —, ohne jede unbeteiligte Unterhaltung mit unnötigem Kontext zu belasten.
• Skills können echten Code mitbringen (ein Validierungsskript, einen Linter, eine Datentransformation), den Claude ausführt statt ihn von Grund auf zu erschließen — das ist zuverlässiger bei allem mit einer eindeutig richtigen Antwort.
• Weil das Auslösen von einer geschriebenen Beschreibung abhängt, liegt es bei einem Skill, der nie greift, meist an der Beschreibung — nicht am Modell. Die Lösung ist dann, das Auslösekriterium neu zu formulieren, nicht die Anweisungen selbst.

Die praktische Konsequenz

Wer Claude Code in jeder Session denselben Ablauf erneut erklärt, hat genau den Fall vor sich, den ein Skill übernehmen sollte. Einmal aufschreiben, mit einem klaren Namen und einer Beschreibung versehen, wann er greift — und die “Nochmal-erklären”-Steuer entfällt für jede neue Unterhaltung.