Der dritte Chat beginnt wieder mit derselben Erklärung: Welche Angaben gehören in das Briefing, welche Begriffe benutzt das Team und was soll bei einer Lücke passieren? Wiederholung ist ein guter Hinweis darauf, dass du eine Arbeitsweise schriftlich festhalten kannst. Ein Skill macht daraus eine wiederverwendbare Anweisung, die du gezielt anwendest und weiterpflegst.
Für Claude Code beschreibt die offizielle Skills-Dokumentation eine SKILL.md mit Metadaten und Anweisungen. Sie kann bei einer passenden Aufgabe oder ausdrücklich genutzt werden. Das verändert die Anweisung für die Arbeit, nicht die trainierten Modellgewichte. Die folgenden Dateien sind ein eigener illustrativer Entwurf, kein Bericht über einen ausgeführten Lauf.
Erst die Entscheidung, dann die Datei
Unser Beispiel ist ein monatlicher Reparaturabend. Aus Organisationsnotizen soll ein internes Briefing entstehen. Darin brauchen die Helfer bestätigte Rahmenbedingungen, Aufgaben und offene Entscheidungen. Das ist ein kleinerer Auftrag als die gesamte Veranstaltung zu planen.
Schreibe vorab einen Eingabevertrag auf. Jede Angabe braucht einen Wert und einen Status. „Beginn 18 Uhr, bestätigt“ unterscheidet sich von „Beginn 18 Uhr, Vorschlag“. Die KI soll den Unterschied erhalten. Fehlt der Ort, ist das eine offene Frage; eine gut klingende Ersatzadresse würde den Auftrag verletzen.
Die SKILL.md knapp und eindeutig halten
Eine mögliche projektbezogene Ablage ist .claude/skills/reparaturbrief/. Darin kann folgende eigene Arbeitsanweisung liegen. Die Metadaten erklären, wann sie gebraucht wird; der Text darunter beschreibt, was sie liefern soll.
---
name: reparaturbrief
description: Erstellt interne Briefings für Reparaturabende aus Organisationsnotizen.
---
Erfasse bestätigte Angaben und Vorschläge getrennt.
Erfinde keine Orte, Termine, Namen oder Zusagen.
Bei Widersprüchen: beide Angaben nennen und eine Rückfrage formulieren.
Ausgabe:
1. Bestätigter Rahmen
2. Aufgaben mit bestätigter Zuständigkeit
3. Offene Entscheidungen mit Bezug zur Eingabe
4. Nächster AbstimmungsschrittEine Beschreibung wie „hilft bei allem rund um Organisation“ wäre weniger aussagekräftig. Sie lässt schwer erkennen, wo der Skill passt und wann eine andere Arbeitsweise angemessen ist. Eine klare Grenze erleichtert auch die spätere Pflege.
Eine Musterübergabe mit einer echten Lücke
Verwende künstliche Notizen: Der Raum ist bestätigt, der Beginn noch vorgeschlagen, und Material wird erst bestellt, wenn das Budget freigegeben ist. Nenne diese Bedingungen direkt. Eine erwartbare Ausgabe darf eine Aufgabe „Budget klären“ enthalten. „Material bestellt“ wäre dagegen eine neue, unbelegte Behauptung.
Ein hilfreicher Zusatzauftrag lautet: „Gib bei jeder offenen Entscheidung an, welche Eingabestelle sie auslöst.“ Dadurch entsteht eine Verbindung zwischen Lücke und Quelle. Der Skill muss nicht den gesamten Ursprungstext wiederholen; er soll die strittige Angabe auffindbar machen.
Bewahre einen Stilwunsch getrennt von den fachlichen Regeln auf. Ein Beispiel für kurze Aufgabenbeschreibungen kann als unterstützende Datei dienen. Häufig wechselnde Veranstaltungsdaten gehören dagegen in den jeweiligen Auftrag. So veraltet die allgemeine Anweisung nicht mit dem nächsten Termin.
Drei Fälle zeigen unterschiedliche Schwächen
Beim ersten Fall lieferst du vollständige, widerspruchsfreie Angaben. Beim zweiten fehlt der Termin und zwei Budgetnotizen widersprechen sich. Beim dritten fragst du nach etwas Fachfremdem, etwa einer Reiseplanung. Du betrachtest damit Aufbau, Umgang mit Unsicherheit und Einsatzgrenze getrennt.
Notiere zu jedem Fall, was unbedingt erhalten bleiben muss. Beurteile eine Antwort zuerst daran und erst danach an ihrem Stil. Eine elegante Formulierung gleicht einen erfundenen Termin nicht aus. Ebenso ist eine Rückfrage kein Fehler, wenn genau diese Entscheidung in der Eingabe fehlt.
Eine kleine Arbeitsanweisung pflegen
Wenn ein Problem wiederkehrt, ändere eine konkrete Regel und wiederhole die bisherigen Fälle. Ergänze einen neuen Fall, der beim Schreiben der Änderung noch nicht bekannt war. So erkennst du eher, ob die Regel nur ein einzelnes Beispiel nachbildet.
Halte Anlass und Stand der Änderung fest. Das braucht zunächst keine große Infrastruktur. Ein kurzer Vermerk wie „Budgetbedingungen müssen in der Aufgabenliste erhalten bleiben“ ist nachvollziehbarer als eine komplette Neufassung ohne Grund. Ein Skill lohnt sich dann, wenn seine Regeln die nächste echte Übergabe verständlicher machen.
Quellen und Dokumentationsstand: 25. Oktober 2026.
