Claude Code Skills — Wissen, das nur dann auftaucht, wenn es gebraucht wird
Kurz gesagt: Ein Skill ist ein Ordner mit einer Textdatei. Sein ganzer Trick besteht darin, dass fast nichts davon dauerhaft mitgeschleppt wird — und genau das macht ihn zum stärksten Werkzeug, das Claude Code hat.
Das Problem, das Skills lösen
Jedes Team, das ernsthaft mit Claude Code arbeitet, landet nach ein paar Wochen an derselben Stelle: Die Projektanweisung wird immer länger. Erst kommt die Codeformatierung dazu, dann die Freigaberegeln, dann drei Absätze zum Umgang mit der Datenbank, dann die Sonderfälle beim Rechnungslauf.
Das Problem daran ist nicht die Länge an sich. Es ist, dass diese Anweisung bei jeder einzelnen Anfrage komplett mitgeschickt wird — auch bei der, in der es nur um einen Tippfehler geht. Sie zahlen die Rechnungsregeln also auch dann, wenn Sie gar keine Rechnung schreiben. Und je voller die Anweisung, desto weniger genau wird jede einzelne Regel befolgt.
Ein Skill dreht das um: Dauerhaft sichtbar ist nur eine Zeile Beschreibung. Der ausführliche Teil wird erst gelesen, wenn die Aufgabe wirklich dazu passt.
Wie ein Skill aussieht
Ein Ordner, darin eine Datei SKILL.md. Oben ein kleiner Kopfteil mit Name und Beschreibung, darunter der eigentliche Text — in normalem Deutsch, keine Programmiersprache:
---
name: rechnung-schreiben
description: Nimm diesen Skill, wenn eine Rechnung erstellt,
geprüft oder storniert werden soll.
---
# Rechnung schreiben
## Vorher prüfen
- Steht eine gültige USt-IdNr. beim Kunden?
- Ist die Leistung abgenommen? Ohne Abnahme keine Rechnung.
## Ablauf
1. Nummer aus dem Zähler ziehen — nie selbst vergeben.
2. Entwurf erzeugen, aber **nicht** versenden.
3. Versand macht ein Mensch. Immer.
## Was schon schiefging
Am 14.03. lief eine Rechnung zweimal raus, weil der Zähler
nach einem Abbruch nicht zurückgesetzt war. Seitdem prüft
Schritt 1 zuerst, ob die Nummer schon vergeben ist.
Mehr ist es nicht. Kein Code, keine Konfiguration, keine besondere Syntax — eine Datei, die ein neuer Kollege lesen und verstehen könnte.
Woran eigene Skills scheitern
Wir bauen und pflegen im eigenen Betrieb über vierzig davon. Die Fehler, die wir dabei selbst gemacht haben, wiederholen sich bei anderen fast eins zu eins:
Die vier häufigsten Fehler
- Die Beschreibung sagt, was der Skill kann. Sie muss sagen, wann er zu nehmen ist. Das ist die einzige Zeile, die dauerhaft sichtbar ist — sie ist der Auslöser, nicht die Inhaltsangabe.
- Ein großer Skill für alles. Der wird entweder ständig geladen oder nie. Lieber acht kleine mit klaren Auslösern.
- Nur die Regel, nicht der Grund. Eine Regel ohne Begründung wird beim ersten Sonderfall überstimmt. Eine mit Begründung hält.
- Einmal geschrieben, nie angefasst. Ein Skill, der einen Vorfall nicht aufnimmt, lässt denselben Fehler ein zweites Mal zu.
Was zuverlässig funktioniert
- Den Auslöser wörtlich benennen. „Nimm diesen Skill, wenn …“ — genau so.
- Vorfälle hineinschreiben. Was einmal schiefging, gehört als Absatz hinein, mit Datum. Das ist der Teil, der später am meisten wert ist.
- Grenzen festhalten. Was der Skill ausdrücklich nicht tun darf, ist oft wichtiger als das, was er tut.
- Nach jedem Vorfall nachziehen. Ein Satz genügt — aber er muss hinein.
Der Zusammenhang mit den Kosten
Skills sind kein reines Ordnungsthema. Was Sie dauerhaft mitschicken, zahlen Sie bei jeder Anfrage erneut — und eine Projektanweisung, die auf mehrere tausend Zeichen angewachsen ist, schlägt in jeder einzelnen Anfrage zu Buche, auch in der kleinsten.
Wenn dieselben Regeln stattdessen in Skills liegen, bleibt dauerhaft nur die Beschreibungszeile stehen. Der Rest kommt nur dann dazu, wenn er wirklich gebraucht wird. Das ist derselbe Hebel, den wir auf der Preisseite ausführlicher beschreiben: Nicht der Tarif entscheidet über die Rechnung, sondern was bei jedem Aufruf unnötig mitreist.
Die Faustregel: Alles, was immer gilt, gehört in die Projektanweisung. Alles, was manchmal gilt, gehört in einen Skill. Wer diese Trennung einmal sauber zieht, gewinnt beides — kürzere Anfragen und Regeln, die zuverlässiger befolgt werden.
Fertige Skills und eigene
Es gibt vorgefertigte Skills für verbreitete Aufgaben — Tabellen, Präsentationen, Textdokumente, PDF. Die nimmt man einfach. Der Wert für ein Unternehmen liegt aber woanders: in den Abläufen, die nur bei Ihnen so laufen. Wie eine Freigabe bei Ihnen aussieht. Welche Prüfung vor dem Versand stattfindet. Warum eine bestimmte Sache seit letztem März anders gemacht wird.
Das steht in keiner Anleitung im Netz und lässt sich nicht zukaufen. Es entsteht dadurch, dass jemand nach jedem Vorfall einen Absatz nachträgt.
Häufige Fragen
Skills für Ihr Team aufbauen lassen →
Sie haben Abläufe, die immer gleich laufen?
Dann lohnt sich ein Skill dafür. Schreiben Sie uns, welcher Ablauf bei Ihnen am häufigsten wiederkehrt — wir sagen Ihnen, ob er sich lohnt und wie er zugeschnitten gehört.