Eine SKILL.md-Datei ist das Herzstück jedes Claude Skill - eine Markdown-Datei, die mit einem kurzen YAML-Header (Name und Beschreibung) beginnt und von den Anweisungen gefolgt wird, die Claude befolgen soll. Die Beschreibung teilt Claude mit, wann der Skill verwendet werden soll; der Hauptteil erklärt, wie.
Wenn du den term schon einmal gesehen und dich gefragt hast, was eigentlich darin steht, findest du hier den Aufbau einer SKILL.md, warum jeder Teil wichtig ist und wie man eine funktionierende Datei schreibt.
Was ist SKILL.md?
Ein Claude Skill ist ein Ordner, und SKILL.md ist die erforderliche Datei in seinem Stammverzeichnis. Sie ist in einfachem Markdown verfasst und lässt sich daher in jedem Texteditor öffnen. Claude liest sie, um eine Fähigkeit zu erlernen - die Schritte, Regeln und Best Practices für eine bestimmte Art von Aufgabe. Optionale Ergänzungen (Vorlagen, Skripte, Referenzdateien) können im selben Ordner danebenliegen, aber die SKILL.md ist die eine Datei, die jeder Skill haben muss.
Möchtest du eine gut abgegrenzte SKILL.md sehen, statt eine von Grund auf neu zu erstellen? Yuris Frontmatter und Anweisungen sind bereits geschrieben und getestet, um Fehler, Sicherheitslücken und Performance-Probleme bei einem Review zu erkennen.
Yuri - AI-Skill für Code-Reviews anzeigen →Die beiden Teile einer SKILL.md
1. Der Frontmatter (Metadaten)
Ganz oben befindet sich ein kleiner YAML-Block zwischen den Markierungen ---. Er enthält die wichtigsten Metadaten - mindestens einen Namen und eine Beschreibung:
---
name: weekly-report
description: Formatiert rohe Notizen zu unserem standardmäßigen Wochenbericht. Verwende dies, wenn der Benutzer nach einem Wochenupdate oder Statusbericht fragt oder darum bittet, „die Woche zusammenzufassen“.
---Dieser Block ist etwas Besonderes: Wenn eine Sitzung beginnt, lädt Claude nur den Namen und die Beschreibung jedes installierten Skills vor - nicht die gesamte Datei. Das hält das Kontextfenster übersichtlich und ist der Grund, warum die Beschreibung so viel Arbeit leistet.
2. Der Hauptteil (Anweisungen)
Unterhalb des Frontmatters schreibst du in normalem Markdown, was Claude tatsächlich tun soll - idealerweise als klare, nummerierte Schritte mit Regeln oder Beispielen:
## Schritte
1. Gruppiere die Notizen unter „Erfolge“, „In Bearbeitung“ und „Blockaden“.
2. Beschränke jeden Aufzählungspunkt auf einen Satz im Präteritum.
3. Beende den Text mit einer einzeiligen Zusammenfassung „Nächste Woche“.
4. Erfinde niemals Kennzahlen, die nicht in den Notizen stehen.Warum die Beschreibung die wichtigste Zeile ist
Das Auslösen hängt vollständig von der Beschreibung ab. Während du arbeitest, vergleicht Claude deine Anfrage mit der Beschreibung jedes Skills und lädt die vollständige Datei nur, wenn sie passt. Eine vage Beschreibung („hilft bei Berichten“) wird nur selten ausgelöst. Eine konkrete Beschreibung („verwende ihn, wenn der Nutzer nach einem wöchentlichen Update oder Statusbericht fragt“) wird zuverlässig ausgelöst. Wenn du dir eine Regel merken möchtest, dann diese: Schreibe die Beschreibung dafür, wann der Skill verwendet werden soll, nicht nur dafür, was er ist.
Wie Claude die Datei verwendet
- Beim Start: Claude liest den Namen und die Beschreibung jedes Skills.
-
Während der Aufgabe: Wenn deine Anfrage zu einer Beschreibung passt, lädt Claude die vollständige
SKILL.mddieses Skills sowie alle angehängten Ressourcen. - Dann: Claude folgt den Anweisungen im Hauptteil, um die Aufgabe zu erledigen.
Dieser Ansatz, den Skill „nur bei Bedarf zu laden“, wird als progressive Offenlegung bezeichnet. Dadurch kannst du viele Skills installieren, ohne den Kontext des Modells aufzublähen.
Eine gute SKILL.md schreiben
- Formuliere die Beschreibung präzise. Gib klar an, wann der Skill ausgelöst werden soll.
- Halte die erste Version klein. Fünf bis zehn Zeilen mit klaren Schritten sind besser als ein ausuferndes Dokument.
- Sei konkret. Nummerierte Schritte, klare Regeln und ein kurzes Beispiel.
- Teste ihn mit echten Aufgaben. Erweitere ihn nur dort, wo Claude Fehler macht.
Musst du selbst einen schreiben?
Nein. Eigene Skills zu schreiben, ist großartig für Workflows, die nur für dich einzigartig sind. Wenn du jedoch einfach das Ergebnis möchtest, enthalten fertige Skills bereits eine ausgearbeitete und getestete SKILL.md. Durchsuche die KissMySkills-Bibliothek mit über 1.000 Skills, prompt-Paketen und Agents oder die Sammlung Claude Code Skills. Möchtest du zuerst einen Skill in Aktion sehen? Probiere einen kostenlosen Generator aus oder hol dir einen kostenlosen Skill.
Nicht jede SKILL.md ist für Programmierer gedacht - Ryans Frontmatter und Anweisungen sind für Vorstandsunterlagen, Rundschreiben an alle Mitarbeitenden und Briefings für Führungskräfte geschrieben; Bearbeitung ist nicht erforderlich.
Ryan - AI-Skill „Stabschef“ ansehen →Häufig gestellte Fragen
Ist SKILL.md einfach nur Markdown?
Ja - es handelt sich um eine gewöhnliche Markdown-Datei mit einem YAML-Frontmatter-Block am Anfang. Sie lässt sich in jedem Texteditor öffnen, spezielle Software ist nicht erforderlich.
Was ist in einer SKILL.md erforderlich?
Mindestens ein Frontmatter-Block mit einem Namen und einer Beschreibung. Der Anweisungstext macht das Skill nützlich, aber die Metadaten sorgen dafür, dass es gefunden und ausgelöst werden kann.
Wo gehört die Datei SKILL.md hin?
Im Stammverzeichnis des Skill-Ordners. In Claude Code befinden sich Skills unter ~/.claude/skills/<name>/ für den persönlichen Gebrauch oder .claude/skills/<name>/ innerhalb eines Projekts im SKILL.md im Stammverzeichnis des Ordners.
Kann ich den Inhalt einer SKILL.md in ChatGPT oder Gemini verwenden?
Ja. Die Anweisungen sind portabel - füge den Inhalt in die benutzerdefinierten Anweisungen von ChatGPT oder Gemini ein, um dasselbe Verhalten zu erhalten. Die automatische Auslösung über Frontmatter ist eine Funktion von Claude.
Zusammenfassung:
Wenn du das Schreiben von YAML-Frontmatter lieber überspringen möchtest, ist Yuri - Code-Reviewer eine gute Wahl für Entwickler, und Ryan - Stabschef deckt Texte für Führungskräfte und Geschäftszwecke ab. Alle funktionieren in Claude, ChatGPT und jedem AI-Chat - ohne Programmierkenntnisse und mit einer 30-tägigen Geld-zurück-Garantie.
Mit einem funktionierenden Beispiel beginnen
Der schnellste Weg, SKILL.md zu verstehen, ist, eine gute Datei zu lesen. Hol dir ein kostenloses Skill, öffne die Datei und sieh dir die Frontmatter-plus-Schritte-Struktur in Aktion an - anschließend lies in drei Minuten, wie du es installierst.