Claude Code Glossar
SKILL.md
SKILL.md ist eine Markdown-Datei, die das Verhalten eines Claude Code Skills definiert und YAML-Frontmatter sowie Markdown-Anweisungen enthält.
Auch genannt: SKILL.md file, skill file, what is a SKILL.md
Eine SKILL.md ist eine Markdown-Datei, die die grundlegende Einheit für einen Claude Code Skill darstellt. Sie besteht aus zwei verschiedenen Teilen: YAML-Frontmatter, eingeschlossen in ----Markierungen, und Markdown-Inhalt, der die Anweisungen liefert, denen Claude bei der Ausführung des Skills folgt.
Die Datei SKILL.md befindet sich in einer bestimmten Verzeichnisstruktur. Für persönliche Skills, die in allen Ihren Projekten verfügbar sind, befindet sie sich unter ~/.claude/skills/<skill-name>/SKILL.md. Für projektspezifische Skills lautet der Pfad .claude/skills/<skill-name>/SKILL.md. Wenn der Skill Teil eines Plugins ist, befindet er sich unter <plugin>/skills/<skill-name>/SKILL.md.
Der Verzeichnisname, der die Datei SKILL.md enthält, bestimmt den Befehl, den Sie zum Aufrufen des Skills über einen Slash-Befehl verwenden (z. B. /skill-name). Das Feld name im YAML-Frontmatter legt jedoch die Anzeigebezeichnung fest, die in den Skill-Listen erscheint. Eine Ausnahme bilden SKILL.md-Dateien im Plugin-Root-Verzeichnis, bei denen das Feld name direkt den Befehlsnamen bestimmt, da kein dediziertes Skill-Verzeichnis vorhanden ist, aus dem er abgeleitet werden könnte.
Über die SKILL.md-Datei selbst hinaus kann das Skill-Verzeichnis zusätzliche Dateien wie Referenzdokumentationen oder Skripte enthalten. Diese ergänzenden Dateien werden von Claude Code erst geladen, wenn sie während des Betriebs des Skills benötigt werden. Claude Code überwacht diese Skill-Verzeichnisse aktiv. Folglich werden Änderungen an einer SKILL.md-Datei oder das Hinzufügen neuer Dateien innerhalb der aktuellen Sitzung wirksam, ohne dass ein Neustart erforderlich ist. Das Erstellen eines Top-Level-Skills-Verzeichnisses, das zu Beginn der Sitzung nicht existierte, erfordert jedoch einen Neustart, damit Claude Code es erkennt.
Claude Code Skills folgen dem offenen Standard Agent Skills, was Interoperabilität und einen konsistenten Ansatz für die Skill-Entwicklung fördert. Anleitungen zur Erstellung gut strukturierter Skill-Dateien finden Sie unter Authoring Skills.