Claude Code Skills: Wie SKILL.md funktioniert und wo Skills geladen werden

Claude Code Skills sind Ordner mit einer Datei namens SKILL.md. Die Datei enthält YAML-Frontmatter, das angibt, wann der Skill anwendbar ist, und einen Markdown-Hauptteil mit den Anweisungen. Claude Code behält die Beschreibung jedes Skills im Kontext, lädt den vollständigen Hauptteil erst bei Verwendung des Skills und lässt Sie jeden Skill selbst durch Eingabe von /skill-name ausführen.^[1] Eigene Slash-Befehle funktionieren inzwischen genauso: .claude/commands/deploy.md und .claude/skills/deploy/SKILL.md erstellen beide /deploy, und die alten Befehlsdateien funktionieren weiterhin.^[1]

Anthropics Empfehlung dazu, wann Sie einen Skill schreiben sollten, ist praxisnah. Erstellen Sie einen Skill, wenn Sie immer wieder dieselbe Checkliste oder Vorgehensweise in den Chat kopieren oder wenn ein Abschnitt in CLAUDE.md zu einer Verfahrensanweisung statt einer Sachinformation geworden ist. CLAUDE.md wird in jeder Sitzung geladen; der Hauptteil eines Skills verbraucht fast nichts, bis der Skill ausgeführt wird.^[1]

Ein minimaler Claude Code Skill

Ein Skill benötigt ein Verzeichnis und eine Datei. Dieser erstellt Release Notes aus den letzten Commits. Speichern Sie ihn unter ~/.claude/skills/release-notes/SKILL.md:

---
description: Drafts release notes from recent git commits. Use when the user asks for release notes, a changelog entry, or what shipped.
disable-model-invocation: true
---

## Recent commits

!`git log --oneline -30`

## Instructions

Group the commits above into Added, Changed and Fixed. Write one line per change in plain language. Skip merge commits.

Der Verzeichnisname wird zum Befehl, Sie führen den Skill also mit /release-notes aus. Die Zeile !`...` bindet Kontext dynamisch ein: Claude Code führt den Befehl aus und fügt dessen Ausgabe in den Skill ein, bevor Claude ihn liest. So beruhen die Release Notes auf Ihrer tatsächlichen Historie.^[1] disable-model-invocation: true verhindert, dass Claude den Skill selbstständig startet. Das eignet sich für alles, was Sie selbst auslösen möchten.

Wo Claude Code Skills geladen werden

Der gewählte Ordner bestimmt, wer den Skill erhält:^[1]

Speicherort	Pfad	Wer den Skill erhält
Persönlich	`~/.claude/skills/<name>/SKILL.md`	Sie, in jedem Projekt auf diesem Rechner
Projekt	`.claude/skills/<name>/SKILL.md`	Alle, die im Repository arbeiten, sobald der Skill committed ist
Verschachtelt	`<subdir>/.claude/skills/<name>/SKILL.md`	Sitzungen, die in diesem Ordner oder darunter gestartet werden
Plugin	`<plugin>/skills/<name>/SKILL.md`	Alle mit aktiviertem Plugin, als `/plugin-name:skill-name`
Unternehmen	Verzeichnis für verwaltete Einstellungen	Alle Nutzer, für die die Organisation den Skill bereitstellt
claude.ai-Konto	Im Konto aktivierte Skills	Sitzungen, die mit diesem Konto angemeldet sind

Zwei Namen sind reserviert. Claude Code verwendet ~/.claude/skills/synced/ für von claude.ai heruntergeladene Skills und überspringt einen von Ihnen erstellten Skill mit diesem Ordnernamen. Außerhalb eines Plugins wird ein Ordner namens anthropic-skills oder mit dem Anfang anthropic-skills: nicht geladen.^[1]

Was das Frontmatter steuert

Jedes Feld ist optional, und Anthropic empfiehlt nur description. Claude Code ignoriert falsch geschriebene Feldnamen ohne Fehlermeldung. Kopieren Sie die Namen daher exakt.^[1] Diese Felder beeinflussen das Verhalten am stärksten:

description dient Claude als Grundlage für die Entscheidung, den Skill zu verwenden. Nennen Sie den wichtigsten Anwendungsfall zuerst: Zusammen mit when_to_use wird das Feld in der Skill-Liste nach 1,536 Zeichen abgeschnitten.
disable-model-invocation: true macht den Skill ausschließlich manuell aufrufbar. Auch seine Beschreibung verlässt den Kontext, sodass er nichts verbraucht, bis Sie ihn eingeben.
user-invocable: false bewirkt das Gegenteil: Nur Claude kann ihn laden, und er verschwindet aus dem /-Menü. Anthropic empfiehlt dies für Hintergrundwissen, etwa zur Funktionsweise eines Altsystems.
allowed-tools genehmigt Tools vorab für den Turn, in dem der Skill ausgeführt wird. Die Genehmigung endet mit Ihrer nächsten Nachricht.
paths begrenzt das automatische Laden auf passende Dateien, und context: fork führt den Skill in einem Subagenten aus.

model und effort ändern das Modell und die Reasoning-Stufe für den Rest des Turns, ohne die Änderung in Ihren Einstellungen zu speichern.^[1]

Wie viel Kontext ein Skill verbraucht

Anthropic beschreibt drei Stufen. Name und Beschreibung jedes Skills werden beim Start geladen, etwa 100 Tokens pro Skill. Der Hauptteil von SKILL.md wird geladen, wenn der Skill ausgelöst wird; Anthropics Tabelle setzt diese Stufe bei unter 5,000 Tokens an. Mitgelieferte Dateien verbrauchen nichts, bis Claude sie liest, und der Code eines Skripts gelangt nie in den Kontext, nur seine Ausgabe.^[2]

Sobald ein Skill ausgeführt wird, bleibt sein Inhalt als eine Nachricht in der Konversation, und Claude Code liest die Datei in späteren Turns nicht erneut. Nach der automatischen Kontextkomprimierung fügt Claude Code die jüngste Ausführung jedes Skills erneut an. Dabei bleiben die ersten 5,000 Tokens jedes Skills innerhalb eines gemeinsamen Budgets von 25,000 Tokens erhalten, die neuesten zuerst. Wenn Sie viele Skills in einer langen Sitzung verwendet haben, können die ältesten herausfallen.^[1] Schreiben Sie Regeln, die für die gesamte Aufgabe gelten müssen, als dauerhafte Anweisungen an den Anfang der Datei.

Claude Skills außerhalb von Claude Code

Dasselbe Format funktioniert auf anderen Claude-Oberflächen, jeweils mit anderen Regeln:^[2]

claude.ai bietet Anthropics vorgefertigte Skills für PowerPoint-, Excel-, Word- und PDF-Dateien, die ohne Einrichtung aktiv sind. Eigene Skills werden als ZIP-Dateien unter Settings > Features hochgeladen, in den Tarifen Pro, Max, Ultra, Team und Enterprise mit aktivierter Codeausführung. Jeder Upload ist nur für einen Nutzer zugänglich.
Die Claude API nimmt eine skill_id im Parameter container zusammen mit dem Codeausführungs-Tool entgegen. Vorgefertigte IDs sind pptx, xlsx, docx und pdf; eigene Skills werden über die Endpunkte unter /v1/skills verwaltet und im gesamten Workspace geteilt.
Claude Code unterstützt eigene Skills, aber nicht die vorgefertigten Dokument-Skills.

Anthropics Dokumentation widerspricht sich beim Thema Synchronisierung. Der Überblick zu Agent Skills besagt, dass eigene Skills nicht zwischen Oberflächen synchronisiert werden und dass Claude Code Skills sowohl von claude.ai als auch von der API getrennt sind.^[2] Die neuere Claude-Code-Seite nennt im claude.ai-Konto aktivierte Skills als Ladequelle für Terminalsitzungen, die mit diesem Konto angemeldet sind. Sie werden nach ~/.claude/skills/synced/ heruntergeladen.^[1] Wenn Sie sich auf diese Synchronisierung verlassen, prüfen Sie, ob der Skill im /-Menü erscheint, bevor Sie einen Workflow darauf aufbauen.

Die Übertragung eines Claude Code Skills auf claude.ai oder die Skills API erfordert Sorgfalt. Diese Wege akzeptieren nur sechs Frontmatter-Felder aus dem offenen Agent-Skills-Standard: name, description, license, compatibility, metadata und allowed-tools. Jedes weitere Feld wie disable-model-invocation oder argument-hint lässt den Upload mit dem Fehler „Unexpected key(s)“ scheitern, statt ignoriert zu werden. Funktionen, die es nur in Claude Code gibt, etwa die Einbindung über !`command`, werden dort nicht ausgeführt.^[1]^[3] Beim Release-Notes-Beispiel oben müssten beide entfernt werden.

Skills anderer Autoren installieren

Ein Skill kann Claude anweisen, Befehle auszuführen und Tools aufzurufen. Daher empfiehlt Anthropic, Skills nur aus vertrauenswürdigen Quellen zu verwenden und ihre Installation wie eine Softwareinstallation zu behandeln. Lesen Sie jede Datei im Ordner, nicht nur SKILL.md: Skripte, Bilder und Referenzdateien können alle Anweisungen enthalten. Skills, die Inhalte von externen URLs abrufen, bergen ein zusätzliches Risiko, weil sich die abgerufene Seite nach Ihrer Prüfung ändern kann.^[2]

FAQ

Sind Claude Code Skills dasselbe wie Slash-Befehle?

Beides wurde zusammengeführt. Eine Befehlsdatei unter .claude/commands/ und ein Skill-Ordner mit demselben Namen erstellen denselben Befehl /name. Skills ergänzen unterstützende Dateien, automatisches Laden und die Steuerung des Aufrufs.^[1]

Kann Claude Code die PowerPoint- und Excel-Skills verwenden?

Nein. Anthropics vorgefertigte Dokument-Skills funktionieren auf claude.ai und über die API, sind aber in Claude Code nicht verfügbar. Claude Code bringt eigene integrierte Skills mit, etwa /code-review, /debug und /claude-api.^[1]^[2]

Warum ignoriert Claude meinen Skill?

Prüfen Sie zuerst die Beschreibung: Zusammen mit when_to_use ist sie alles, was Claude vor seiner Entscheidung sieht. Prüfen Sie dann, ob das öffnende --- in der ersten Zeile der Datei steht. Andernfalls behandelt Claude Code das Frontmatter als einfachen Text, und bei einem YAML-Fehler wird der Skill ohne gesetzte Felder geladen.^[1]

Claude Code Skills mit eigenem Modellzugang ausführen

Persönliche und projektbezogene Skills sind Dateien auf Ihrem Rechner, die der Claude-Code-Client liest. Wenn Sie Claude Code statt über ein Claude-Abonnement über ein Gateway verwenden, behandelt reAPIs Claude-Code-Leitfaden die Basis-URL, den Schlüsseltyp und die akzeptierten Claude-Modell-IDs. Die Seite zu Claude Sonnet 5.5 zeigt die aktuellen Tarife. Von claude.ai synchronisierte Skills setzen die Anmeldung mit diesem Konto voraus. Bewahren Sie die Claude Code Skills, die Sie überall benötigen, daher in persönlichen oder projektbezogenen Ordnern auf.

Quellen

Anthropic. Extend Claude with skills (Claude Code documentation). Abgerufen am 4. November 2026 von code.claude.com/docs/en/skills
Anthropic. Agent Skills overview. Abgerufen am 4. November 2026 von platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
Agent Skills. Agent Skills open standard. Abgerufen am 4. November 2026 von agentskills.io