Eine SKILL.md-Datei bildet das Herzstück jedes Claude Skills - eine Markdown-Datei, die mit einem kurzen YAML-Header (einem Namen und einer Beschreibung) beginnt und anschließend die Anweisungen enthält, die Claude befolgen soll. Die Beschreibung teilt Claude mit, wann der Skill verwendet werden soll; der Hauptteil erklärt, wie.
Wenn du den Begriff schon gesehen und dich gefragt hast, was tatsächlich darin enthalten ist, 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 dessen Stammverzeichnis. Sie besteht aus einfachem Markdown und lässt sich 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 daneben liegen, aber die SKILL.md ist die eine Datei, die jeder Skill haben muss.
Du möchtest eine gut abgegrenzte SKILL.md sehen, statt eine von Grund auf neu zu erstellen? Yuris Frontmatter und Anweisungen sind bereits geschrieben und getestet, um in einem Review Fehler, Sicherheitslücken und Performance-Probleme zu erkennen.
Yuri - AI-Skill für Code-Reviews ansehen →Die zwei Teile einer SKILL.md
1. Das 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 wöchentlichen Update 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 schlank und ist der Grund, warum die Beschreibung so viel wichtige 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 allen Regeln oder Beispielen:
## Schritte
1. Gruppiere die Notizen unter „Erfolge“, „In Bearbeitung“ und „Blocker“.
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 diesen Skill, wenn der Nutzer nach einem wöchentlichen Update oder Statusbericht fragt“) wird zuverlässig ausgelöst. Wenn du dir nur eine Regel merkst, dann diese: Schreibe die Beschreibung dafür, wann der Skill verwendet werden soll, nicht nur dafür, was er ist.
So verwendet Claude die Datei
- 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 zugehörigen Ressourcen). - Danach: Claude befolgt die Anweisungen im Hauptteil, um die Aufgabe zu erledigen.
Dieser Ansatz, bei dem die Datei „nur bei Bedarf geladen“ wird, heißt progressive Offenlegung. Er ermöglicht es dir, viele Skills zu 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, 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 einzigartig auf dich zugeschnitten sind. Wenn du jedoch einfach nur das Ergebnis möchtest, enthalten fertige Skills bereits eine erstellte 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 sehen, wie einer davon in Aktion funktioniert? 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 Vorstandsmappen, Rundschreiben an alle Mitarbeitenden und Briefings für Führungskräfte verfasst, ohne dass Bearbeitung erforderlich ist.
Ryan - Chief of Staff AI Skill ansehen →Häufig gestellte Fragen
Ist SKILL.md einfach nur Markdown?
Ja - es handelt sich um eine standardmäßige 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 kommt die SKILL.md-Datei hin?
Im Stammverzeichnis des Skill-Ordners. In Claude Code befinden sich Skills unter ~/.claude/skills/<name>/ für die persönliche Nutzung oder .claude/skills/<name>/ in einem Projekt im Verzeichnis 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 erzielen. Die automatische Auslösung über Frontmatter ist eine Claude-Funktion.
Zusammenfassung:
Wenn du das YAML-Frontmatter lieber nicht selbst schreiben möchtest, ist Yuri - Code Reviewer eine gute Wahl für Entwickler, und Ryan - Chief of Staff deckt Texte für Führungskräfte und Unternehmen ab. Alle funktionieren in Claude, ChatGPT und jedem AI-Chat ohne Programmieraufwand und mit einer 30-Tage-Geld-zurück-Garantie.
Mit einem funktionierenden Beispiel beginnen
Der schnellste Weg, SKILL.md zu verstehen, besteht darin, eine gute Datei zu lesen. Hol dir ein kostenloses Skill, öffne die Datei und sieh dir die Struktur aus Frontmatter und Schritten in Aktion an - anschließend erfährst du in drei Minuten, wie du es installierst.
