Was ist eine SKILL.md-Datei? (Aufbau eines Claude Skills)

Eine SKILL.md-Datei ist das Herzstück jeder Claude Skill – eine Markdown-Datei, die mit einem kurzen YAML-Header (ein Name und eine Beschreibung) beginnt und von den Anweisungen gefolgt wird, denen Claude folgen soll. Die Beschreibung sagt Claude, wann die Skill verwendet werden soll; der Hauptteil erklärt, wie.

Wenn Sie den Begriff schon einmal gehört und sich gefragt haben, was tatsächlich darin steckt, hier die Anatomie einer SKILL.md, warum jeder Teil wichtig ist und wie man eine schreibt, die funktioniert.

Was SKILL.md ist

Eine Claude Skill ist ein Ordner, und SKILL.md ist die erforderliche Datei im Stammverzeichnis. Es ist einfaches Markdown, das in jedem Texteditor geöffnet werden kann. Claude liest sie, um eine Fähigkeit zu erlernen – die Schritte, Regeln und bewährten Verfahren für eine bestimmte Aufgabe. Optionale Extras (Vorlagen, Skripte, Referenzdateien) können im selben Ordner liegen, aber die SKILL.md ist die eine Datei, die jede Skill haben muss.

Die zwei Teile einer SKILL.md

1. Das Frontmatter (Metadaten)

Ganz oben befindet sich ein kleiner YAML-Block zwischen ----Markierungen. Er enthält die wesentlichen Metadaten – mindestens ein Name und eine Beschreibung:

---
name: weekly-report
description: Formatiert Rohnotizen in unseren Standard-Wochenbericht. Verwenden, wenn der Nutzer nach einem Wochenupdate, Statusbericht oder einer "Zusammenfassung der Woche" fragt.
---

Dieser Block ist besonders: Wenn eine Sitzung startet, lädt Claude nur den Namen und die Beschreibung jeder installierten Skill vor – nicht die ganze Datei. Das hält das Kontextfenster schlank und erklärt, warum die Beschreibung so viel leisten muss.

2. Der Hauptteil (Anweisungen)

Unter dem Frontmatter, im normalen Markdown, schreiben Sie, was Claude tatsächlich tun soll – idealerweise als klare, nummerierte Schritte mit Regeln oder Beispielen:

## Schritte
1. Gruppiere die Notizen unter Erfolge, In Arbeit und Blockaden.
2. Halte jeden Punkt auf einen Satz, in der Vergangenheitsform.
3. Beende mit einer einzeiligen "Nächste Woche"-Zusammenfassung.
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 Sie arbeiten, vergleicht Claude Ihre Anfrage mit der Beschreibung jeder Skill und lädt die vollständige Datei nur, wenn sie übereinstimmt. Eine vage Beschreibung („hilft bei Berichten“) löst selten aus. Eine spezifische („verwenden, wenn der Nutzer nach einem Wochenupdate oder Statusbericht fragt“) löst zuverlässig aus. Wenn Sie sich eine Regel merken, dann diese: schreiben Sie die Beschreibung für wann die Skill verwendet werden soll, nicht nur was sie ist.

Wie Claude die Datei verwendet

• Beim Start: Claude liest den Namen und die Beschreibung jeder Skill.
• Während der Aufgabe: Wenn Ihre Anfrage mit einer Beschreibung übereinstimmt, lädt Claude die vollständige SKILL.md dieser Skill (und alle angehängten Ressourcen).
• Dann: Claude folgt den Anweisungen im Hauptteil, um die Arbeit zu erledigen.

Dieser „nur bei Bedarf laden“-Ansatz heißt progressive Offenlegung und ermöglicht es, viele Skills installiert zu haben, ohne das Kontextfenster des Modells zu überladen.

Eine gute SKILL.md schreiben

1. Die Beschreibung präzise formulieren. Geben Sie klar an, wann die Skill ausgelöst werden soll.
2. Die erste Version klein halten. Fünf bis zehn klare Schritte sind besser als ein umfangreiches Dokument.
3. Konkrete Anweisungen geben. Nummerierte Schritte, explizite Regeln, ein kurzes Beispiel.
4. Mit echten Aufgaben testen. Nur erweitern, wenn Claude etwas nicht richtig macht.

Muss man selbst eine schreiben?

Nein. Eigene Skills zu schreiben ist großartig für individuelle Workflows, aber wenn Sie nur das Ergebnis wollen, kommen fertige Skills mit bereits erstellter und getesteter SKILL.md. Durchstöbern Sie die KissMySkills-Bibliothek mit über 300 Skills, Prompt-Paketen und Agenten oder die Claude Code Skills-Sammlung. Möchten Sie eine Skill zuerst in Aktion sehen? Probieren Sie einen kostenlosen Generator oder laden Sie eine kostenlose Skill herunter.

Häufig gestellte Fragen

Ist SKILL.md nur Markdown?

Ja – es ist eine Standard-Markdown-Datei mit einem YAML-Frontmatter-Block oben. Sie lässt sich in jedem Texteditor öffnen, es wird keine spezielle Software benötigt.

Was ist in einer SKILL.md erforderlich?

Mindestens ein Frontmatter-Block mit Name und Beschreibung. Der Hauptteil mit Anweisungen macht die Skill nützlich, aber die Metadaten sorgen dafür, dass sie gefunden und ausgelöst werden kann.

Wo kommt die SKILL.md-Datei hin?

Ins Stammverzeichnis des Skill-Ordners. In Claude Code liegen Skills für den persönlichen Gebrauch in ~/.claude/skills/<name>/ oder innerhalb eines Projekts in .claude/skills/<name>/, mit der SKILL.md im Ordnerstamm.

Kann ich den Inhalt einer SKILL.md in ChatGPT oder Gemini verwenden?

Ja. Die Anweisungen sind portabel – fügen Sie den Hauptteil in die benutzerdefinierten Anweisungen von ChatGPT oder Gemini ein, um dasselbe Verhalten zu erzielen. Das automatische Auslösen über das Frontmatter ist eine Claude-Funktion.

Beginnen Sie mit einem funktionierenden Beispiel

Der schnellste Weg, SKILL.md zu verstehen, ist, eine gute Datei zu lesen. Laden Sie eine kostenlose Skill herunter, öffnen Sie die Datei und sehen Sie die Struktur aus Frontmatter und Schritten in Aktion – und lesen Sie dann, wie man sie in drei Minuten installiert.