
Claude Skills Tutorial: Bauen Sie Ihre erste SKILL.md in 10 Minuten (2026)
Skills sind das wichtigste Claude Code Feature, das Sie wahrscheinlich noch nicht nutzen. Eine Claude Skill ist ein Ordner mit einer SKILL.md-Datei, die Claude automatisch lädt, sobald Ihr Prompt zur Beschreibung passt — kein Prompts-Kopieren, kein aufgeblähtes CLAUDE.md, kein Merken von Vorlagen. Wir haben 4 Skills im .claude/skills/agent/-Ordner dieses Repos veröffentlicht, und mit Skills 2.0 sowie dem Anthropic Marketplace, der Anfang 2026 erschien, hat das Format endlich seinen Höhepunkt erreicht. Hier ist das Muster, das nach den Fallstricken wirklich funktioniert.
Wichtigste Erkenntnisse
- Eine Claude Skill ist ein Ordner mit einer
SKILL.md-Datei mit YAML-Frontmatter, die Claude automatisch lädt, wenn sie relevant ist.- Skills befinden sich in
~/.claude/skills/(persönlich) oder.claude/skills/(Projekt) — Claude scannt beim Start beide.- Verwenden Sie Skills für wiederholbare Workflows; MCP für Live-Externes-Daten; Subagents für mehrstufige Planung; Hooks für deterministische Ereignisse.
- Der schnellste Weg zur ersten Skill: Claude bitten, seine eigene
skill-creator-Skill aufzurufen — sie schreibt die SKILL.md für Sie.
Was sind Claude Skills?
Eine Claude Skill ist ein Ordner mit einer SKILL.md-Datei mit YAML-Frontmatter (name, description, optionale allowed-tools), die Claude Code automatisch in den Kontext lädt, wenn Ihr Prompt zur Beschreibung passt. Skills bündeln wiederverwendbare Workflows — wie /commit oder /explain-code — ohne Ihren System-Prompt aufzublähen.
Laut den offiziellen Anthropic-Docs hat jeder Skill-Ordner drei Dinge: eine obligatorische SKILL.md, optionale gebündelte Skripte (von einem Python-Helfer bis zu einer JSON-Konfiguration) und optionale Referenz-Docs, die zusammen mit dem Body geladen werden. Das war's. Kein Build-Schritt, keine Installation, kein Manifest.
Der clevere Teil ist die progressive Offenlegung. Beim Start scannt Claude nur das description-Feld jeder Skill. Der Body — Anweisungen, Beispiele, Tool-Call-Muster — bleibt auf der Festplatte, bis Ihr Prompt tatsächlich passt. Sie können also 50 Skills installiert haben und zahlen null Token-Kosten, bis eine ausgelöst wird.
Stellen Sie sich Skills wie Kochbuch-Rezepte vor, zu denen Claude greift, wenn es die richtigen Zutaten in Ihrem Prompt sieht. Eine Skill ist ein Ordner, den Claude bei Bedarf liest — kein Prompt, den Sie sich merken müssen. Das ist die ganze Idee.
Eine minimale SKILL.md sieht so aus:
---
name: Summarize file
description: Use when the user asks for a 3-sentence summary of a file or function.
---
Read the file at $ARGUMENTS. Summarize purpose, key dependencies, and the
single most surprising thing about it. Three sentences max.Zehn Zeilen. Echte Skill. Bereit zum Auslösen.
Schnellstart: Bauen Sie Ihre erste Skill in 10 Minuten
Um Ihre erste Claude Skill in 10 Minuten zu bauen: (1) ~/.claude/skills/explain-code/ erstellen, (2) eine SKILL.md-Datei mit name, description und dem Workflow-Body hinzufügen, (3) Claude Code neu starten, damit es das neue Verzeichnis scannt, (4) mit einem Prompt auslösen, der zur Beschreibung passt.
Hier ist der vollständige Ablauf.
Schritt 1: Verzeichnis erstellen
mkdir -p ~/.claude/skills/explain-codePersönliche Skills (nur für Sie) kommen unter ~/.claude/skills/. Projekt-Skills (über Git mit Ihrem Team geteilt) kommen unter .claude/skills/ im Repo-Stammverzeichnis. Wählen Sie persönlich für tägliche Workflows; wählen Sie Projekt, wenn jeder Mitwirkende im Repo sie erben soll.
Schritt 2: SKILL.md schreiben
Legen Sie diese Datei unter ~/.claude/skills/explain-code/SKILL.md ab:
---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
---
You are explaining code to a developer who is new to this codebase.
1. Read the file or snippet at $ARGUMENTS.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies or side effects.
5. End with one question the reader should ask before changing this code.Das ist die gesamte Skill. Das Frontmatter ist der Vertrag; der Body ist das Playbook.
Schritt 3: Claude Code neu starten
Live-Discovery ist ein Skills-2.0-Feature — ältere Claude-Code-Versionen brauchen einen Neustart, um das neue Verzeichnis zu erkennen. Wenn Sie nicht sicher sind, welche Version Sie haben, kostet ein Neustart nichts.
Schritt 4: Auslösen
Öffnen Sie ein Projekt und geben Sie ein:
walk me through what auth/middleware.ts doesClaude vergleicht Ihren Prompt mit dem description-Feld, findet explain-code und lädt den SKILL.md-Body lautlos in den Kontext. Sie sehen "Using skill: explain-code" im Tool-Log. Fertig.
Profi-Tipp: Keine Lust, die Datei selbst zu schreiben? Öffnen Sie Claude Code und sagen Sie:
Use the skill-creator skill to scaffold an explain-code skill for me.Die gebündelteskill-creatorvon Anthropic ist eine Meta-Skill, die Sie interviewt, sinnvolleallowed-toolswählt und die SKILL.md in den richtigen Ordner schreibt. Der schnellste Weg zur ersten Skill, Punkt.
Das ist das 10-Minuten-Versprechen — fünf Minuten Tippen, ein Neustart, ein Test-Prompt.

Innerhalb von SKILL.md: Die Frontmatter-Referenz
Das SKILL.md-Frontmatter ist YAML in ----Trennzeichen eingebettet. Zwei Felder sind Pflicht: name (≤64 Zeichen, wird als Slash-Befehlsname verwendet) und description (der Trigger-Text, den Claude mit Ihrem Prompt abgleicht). Optionale Felder steuern den Tool-Zugriff, den Modell-Aufruf, Datei-Globs und den Ausführungskontext.
Hier ist die vollständige Referenz aus der Anthropic Skills-Dokumentation:
| Feld | Pflicht? | Typ | Wann verwenden |
|---|---|---|---|
name | ja | string ≤64 Zeichen | immer — wird zum Slash-Befehlsnamen |
description | ja | string ≤1024 Zeichen | immer — Claude scannt dies, um zu entscheiden, ob die Skill passt |
allowed-tools | nein | Array von Tool-Mustern | die Skill auf bestimmte Tools sperren (z. B. Bash(git *), Read, Grep) |
disable-model-invocation | nein | boolean | die Skill nur per Benutzer-Aufruf nutzbar machen (Slash-Befehl, nie automatisch ausgelöst) |
user-invocable | nein | boolean | eine Skill markieren, die als /skill-name in der Slash-Befehlspalette erscheinen soll |
argument-hint | nein | string | dem Benutzer einen Hinweis geben, was $ARGUMENTS enthalten soll |
model | nein | string | die Skill an ein bestimmtes Modell binden (z. B. claude-opus-4-7) |
context | nein | default oder fork | (Skills 2.0) die Skill in einem verzweigten Kontextfenster ausführen, damit es den Haupt-Thread nicht verunreinigt |
globs | nein | Array von Glob-Mustern | die Skill automatisch vorschlagen, wenn Dateien, die den Globs entsprechen, im Fokus sind |
references | nein | Array von Dateipfaden | Referenz-Docs bündeln, die mit dem Skill-Body geladen werden |
bundled-files | nein | Array von Dateipfaden | Skripte bündeln, die die Skill ausführen kann |
tags | nein | Array von Strings | Skills in Marketplace-Listings organisieren |
Die Zeile context: fork verdient einen Hinweis. Es ist ein Skills-2.0-Primitiv, das die Skill in einem isolierten Kontextfenster ausführt — nützlich für lang laufende Recherche-Skills oder alles, das viele Zwischen-Token erzeugt, die Sie nicht in Ihren Haupt-Thread einbluten lassen wollen. Wenn das neu für Sie ist, erklärt unser Context-Engineering-Leitfaden die Abwägungen.
Ein maximalistisches SKILL.md-Frontmatter mit allen Feldern belegt:
---
name: Deploy preview
description: Use when the user wants to deploy a preview build of the current branch to staging.
allowed-tools: ["Bash(git status:*)", "Bash(npm run build:*)", "Bash(vercel:*)"]
disable-model-invocation: true
user-invocable: true
argument-hint: <branch-name or 'current'>
model: claude-opus-4-7
context: fork
globs: ["package.json", "vercel.json"]
references: ["./deploy-runbook.md"]
bundled-files: ["./scripts/preflight.sh"]
tags: ["deploy", "vercel", "preview"]
---Profi-Tipp: Der häufigste Fehler in der
description: Sie für Menschen schreiben. Schreiben Sie sie für Claude — konkrete Trigger-Phrasen, kein Marketing-Text. Schlecht: "Eine leistungsstarke Git-Automatisierungs-Skill." Gut: "Use when the user wants to commit changes, write a commit message, or open a PR."
Zwei echte Skills von Anfang bis Ende
Zwei Skill-Muster decken 80 % der realen Anwendungsfälle ab: (1) eine benutzeraufrufbare /commit-Skill mit disable-model-invocation: true und allowed-tools: Bash(git *) für deterministische Aktionen; (2) eine automatisch aufgerufene /explain-code-Skill mit Standard-Frontmatter, die Claude auslöst, wenn Prompts zur Beschreibung passen.
Die meisten Tutorials zeigen Ausschnitte. Hier sind zwei vollständige Dateien, die Sie heute in ~/.claude/skills/ kopieren können.
Die /commit-Skill (benutzeraufrufbar)
---
name: Commit
description: Use when the user wants to stage and commit code changes with an AI-written conventional-commit message.
disable-model-invocation: true
user-invocable: true
allowed-tools:
- "Bash(git status:*)"
- "Bash(git diff:*)"
- "Bash(git add:*)"
- "Bash(git commit:*)"
---
1. Run `git status` and `git diff` to see what's staged and unstaged.
2. Group changes into one logical commit. If there are multiple unrelated
changes, ask the user which to include.
3. Draft a Conventional Commits message: `type(scope): subject` (≤72 chars),
blank line, body explaining *why*, not *what*.
4. Show the message to the user. Ask "Commit this?" Wait for explicit yes.
5. On confirmation, run `git add` for the included files and `git commit -m`.
6. Print the resulting commit hash.Test-Prompt: /commit
Was passiert: Claude prüft den Git-Status, entwirft eine Nachricht, bittet Sie um Bestätigung und führt git commit erst dann aus. disable-model-invocation: true bedeutet, dass sie niemals automatisch bei einem vagen "save my changes"-Prompt auslöst — sie läuft nur, wenn Sie /commit eingeben. Die allowed-tools-Whitelist sperrt sie auf Git-Unterbefehle; sie kann physisch kein rm -rf ausführen oder an Remote pushen. Das ist eine, die wir live in unserem eigenen Pipeline einsetzen.
Für deterministische Aktionen nach dem Commit (Lint ausführen, Typen neu generieren, einen Slack-Webhook anpingen) greifen Sie stattdessen zu Claude Code Hooks — Skills sind probabilistisch, Hooks lösen jedes Mal aus.
Die /explain-code-Skill (modellaufrufbar)
---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
argument-hint: <file path or pasted snippet>
model: claude-opus-4-7
---
1. Read the file or snippet at $ARGUMENTS. If $ARGUMENTS is empty, ask
the user which file to explain.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies, side effects, or hidden assumptions.
5. End with one question the reader should ask before modifying this code.Test-Prompt: walk me through what auth/middleware.ts does
Was passiert: Beachten Sie, dass der Benutzer nicht /explain-code eingegeben hat. Claude gleicht "walk me through" mit dem description-Feld ab, findet die Skill und ruft sie automatisch auf. Das ist die Magie — die description übernimmt das Routing. Das Feld model: claude-opus-4-7 bindet diese Skill an Opus, egal welches Modell Sie als Standard eingestellt haben, damit tiefe Code-Walkthroughs immer das leistungsfähigere Modell bekommen. (Mehr zum Betreiben von Claude Code mit verschiedenen Modellen.)
Warum zwei Muster? Skill Nr. 1 ist benutzeraufrufbar und auf bestimmte Tools beschränkt — vorhersehbar, sicher, perfekt für Git oder Deployments. Skill Nr. 2 ist automatisch aufrufbar und offen — die Magie von Skills, aber vertrauen Sie Ihrem
description-Feld. Benutzeraufrufbare Skills geben Ihnen Vorhersehbarkeit; modellaufrufbare Skills geben Ihnen Magie. Wählen Sie pro Skill, nicht pro Repo.
Weitere echte Beispiel-Skills finden Sie im offiziellen anthropics/skills-Repo und der community-gepflegten awesome-claude-skills-Liste.
Skills vs. MCP vs. Subagents vs. Hooks: Wann was verwenden
Verwenden Sie Skills für wiederverwendbare Workflows, die Claude automatisch auslösen oder Sie als Slash-Befehle aufrufen sollen. Verwenden Sie MCP-Server, wenn Sie Live-Externe-Daten brauchen (Datenbanken, APIs, Dateisysteme außerhalb des Arbeitsverzeichnisses). Verwenden Sie Subagents für mehrstufige Pläne, die Claude an einen neuen Kontext delegieren soll. Verwenden Sie Hooks für deterministische Ereignisse (pre-commit, post-tool-use), die immer auslösen müssen — niemals probabilistisch.
Kurz gesagt: Skills sind Workflows, Model Context Protocol ist Daten, Subagents sind Pläne, Hooks sind Ereignisse. Jedes lebt auf einer anderen Schicht von Claude Code, und die falsche Schicht ist das falsche Werkzeug. Laut Anthropics eigenem Skills explained-Beitrag ist das das Konzept, das Sie verinnerlichen sollen.
| Frage | Skills | MCP | Subagents | Hooks |
|---|---|---|---|---|
| Ausgelöst durch | Prompt-Match oder /slash-cmd | Modell entscheidet, ein Tool aufzurufen | Modell delegiert eine Aufgabe | Claude Code Ereignis (pre-tool-use, post-edit) |
| Befindet sich in | .claude/skills/ | externer Server (stdio oder SSE) | .claude/agents/ | settings.json hooks-Block |
| Am besten für | wiederverwendbare Workflows, Prompt-Templates mit Logik | Live-Daten, Drittanbieter-APIs, Dateisystemzugriff über cwd hinaus | mehrstufige Planung, parallele Arbeit, isolierte Kontexte | deterministische Ereignisse, die immer auslösen müssen |
| Determinismus | probabilistisch (Claude entscheidet) | probabilistisch (Claude entscheidet) | probabilistisch (Claude entscheidet) | deterministisch (löst immer aus) |
| Token-Kosten | niedrig (nur description wird beim Scan geladen) | mittel-hoch (Tool-Definitionen + Antworten) | hoch (frischer Kontext pro Delegation) | keine (Out-of-Band Shell-Ausführung) |
| Wann NICHT verwenden | Live-Daten, deterministische Ereignisse | statische Workflows, Prompt-Logik | einmalige deterministische Aktionen | verzweigte Logik, alles Probabilistische |
Sie komponieren sich. Eine Skill kann ein MCP-Tool über allowed-tools aufrufen. Ein Hook kann auslösen, nachdem eine Skill abgeschlossen ist. Ein Subagent kann Skills verwenden, auf die er Zugriff hat. Das klarste Denkmodell: Wählen Sie zuerst die richtige Schicht, dann lassen Sie sie stapeln. Skills sind das Context-Engineering-Primitiv, nach dem Sie greifen, wenn Sie einen Workflow wollen, den Claude wählen kann; Sie automatisieren mit Hooks, wenn Sie etwas wollen, das Claude nicht überspringen kann.
Die schlimmste Art, jede zu missbrauchen: Skills für Live-Daten (MCP verwenden); MCP für einmalige Prompt-Templates (Skills verwenden); Subagents für deterministische Datei-Edits (Hooks verwenden); Hooks für verzweigte Logik (Skills verwenden). Skills sind Workflows, MCP ist Daten, Subagents sind Pläne, Hooks sind Ereignisse. Wählen Sie nach der Schicht, nicht nach dem Schlagwort.
Wo Skills leben: Persönlich, Projekt, Plugin, Enterprise
Claude Skills werden in vier Bereichen installiert: persönlich (~/.claude/skills/, nur Sie), Projekt (.claude/skills/ im Repo-Stammverzeichnis, Ihr Team über Git), Plugin (über den Anthropic Marketplace oder eine beliebige Plugin-URL verteilt) und Enterprise (von der IT über MDM/Admin-Policy gepusht). Claude scannt beim Start alle vier.
| Bereich | Pfad | Teilen | Am besten für |
|---|---|---|---|
| Persönlich | ~/.claude/skills/ | nicht geteilt | Ihre eigenen täglichen Workflows (commit, review, PR-write) |
| Projekt | .claude/skills/ (Repo-Stammverzeichnis) | Git, jeder Mitwirkende im Repo | Team-Konventionen, codebase-spezifische Muster |
| Plugin | installiert via /plugin install <url> | Anthropic Marketplace oder URL | repo-übergreifende Wiederverwendung, Verteilung an die Community |
| Enterprise | von Org-Admin gepusht (verwaltete Einstellungen) | org-weit durchgesetzt | compliance-mandatierte Workflows, sicherheitsgeverriegelte Tools |
| Gebündelt (eingebaut) | wird mit Claude Code ausgeliefert | n/a | Doc-Skills (pdf, docx, pptx, xlsx), /debug, /simplify |
Die gebündelten Doc-Skills sind leicht zu vergessen — Claude Code wird bereits mit pdf, docx, pptx und xlsx-Skills ausgeliefert, plus einer kleinen Bibliothek von /debug, /simplify und ähnlichen Built-ins. (Das Schwester-Tool Claude Design wird mit eigenen gebündelten Workflow-Skills für die Design-Generierung ausgeliefert; gleiches Modell, andere Domäne.)
Wann liefern Sie über Plugin statt über Projekt? Plugins gewinnen, wenn der gleiche Workflow mehreren Repos nützt — eine /release-Skill, die Sie über fünf Client-Codebases hinweg verwenden, gehört in ein Plugin, nicht in das .claude/skills/ jedes Repos kopiert. Projekt-Skills gewinnen für codebase-spezifische Konventionen (das PR-Template Ihres Teams, Ihr benutzerdefinierter Test-Runner). Der Anthropic Marketplace und /plugin install von jeder URL machen Plugins zur richtigen Antwort für repo-übergreifende Wiederverwendung. Laut den Plugin-Docs werden Entdeckung und Updates automatisch gehandhabt.

Fortgeschrittene Muster: $ARGUMENTS, dynamische Shell-Injektion, context: fork
Drei fortgeschrittene Skill-Muster sind am wichtigsten: $ARGUMENTS ermöglicht es Benutzern, Parameter an benutzeraufrufbare Skills zu übergeben (/translate $ARGUMENTS); dynamische Shell-Injektion (mit allowed-tools: Bash(...)) lässt eine Skill Skripte ausführen und Ausgaben in den Kontext einleiten; und context: fork (Skills 2.0) führt die Skill in einem isolierten Kontextfenster aus. Anthropics Complete Guide Whitepaper ist die kanonische Referenz für context: fork ab Mai 2026.
$ARGUMENTS für parametrisierte Skills
---
name: Translate
description: Translate the most recent message into the target language.
user-invocable: true
argument-hint: <target-language, e.g. spanish, japanese, brazilian portuguese>
---
Translate the user's previous message into $ARGUMENTS. Preserve tone,
preserve markdown formatting, return only the translation.Test-Prompt: /translate spanish. Claude ersetzt spanish zur Laufzeit durch $ARGUMENTS. Sauberste Möglichkeit, eine Skill vielseitig zu machen, ohne Varianten zu schreiben.
Dynamische Shell-Injektion via allowed-tools
---
name: Review last commit
description: Use when the user wants a code review of the last git commit.
allowed-tools: ["Bash(git diff HEAD~1:*)", "Bash(git log -1:*)"]
---
Run `git diff HEAD~1` and `git log -1`. Review the diff for bugs, security
issues, and style violations. Output a 5-bullet review.Die Skill führt Shell-Befehle aus, leitet den Diff in den Kontext ein und rezensiert ihn. Sperren Sie allowed-tools auf spezifische Befehle (Bash(git diff HEAD~1:*)), niemals auf nacktes Bash — die nackte Bash-Berechtigung ist die Sicherheits-Eigentor-Version dieses Musters.
context: fork (Skills 2.0)
---
name: Deep research
description: Use when the user wants a multi-source research summary on a topic.
context: fork
---
Research the topic in $ARGUMENTS using available web tools. Produce a
2-page summary with citations. Do not pollute the main thread.Forking gibt der Skill ihr eigenes Kontextfenster, sodass die 50.000 Token an Zwischen-Recherche-Notizen nicht in Ihre Hauptsitzung einbluten. Nützlich für lange Recherchen, große Refactoring-Planung oder alles, das viele wegwerfbare Token erzeugt. Nur Skills 2.0 — ältere Claude-Code-Versionen ignorieren das Feld.
Fehlerbehebung: Warum Ihre Skill nicht auslöst
Skills lösen meist aus einem von vier Gründen nicht aus: (1) die description ist zu generisch, damit Claude sie gegen Ihren Prompt abgleichen kann, (2) das Verzeichnis ist im falschen Pfad (.claude/skills/ nicht claude/skills/), (3) Claude Code wurde nach dem Hinzufügen der Skill nicht neu gestartet (nur pre-Skills-2.0), oder (4) der Skill-Name kollidiert mit einer gebündelten oder höherprioritären Skill. Laut den am häufigsten gegoogelten Fehlermodi im Claude Code GitHub Issues Tracker decken diese vier ~95 % der "Warum funktioniert das nicht"-Meldungen ab.
Fehlermodus 1: "Meine Skill erscheint überhaupt nicht"
Die häufigste Ursache ist ein falscher Pfad — .claude/skills/ (mit dem Punkt) vs. claude/skills/ (kein Punkt) ist ein Tippfehler, den wir alle um 1 Uhr nachts gemacht haben. Führen Sie ls -la ~/.claude/skills/ aus, um zu bestätigen, dass das Verzeichnis mit dem Punkt existiert. Wenn es da ist und Claude es immer noch nicht sieht, starten Sie Claude Code einmal neu. Pre-Skills-2.0-Versionen scannen nur beim Start.
Fehlermodus 2: "Claude ruft meine Skill nicht automatisch auf"
Das description-Feld ist zu vage oder für Menschen, nicht für Claude geschrieben. Schreiben Sie es mit konkreten Trigger-Phrasen neu, die widerspiegeln, wie Benutzer Anfragen tatsächlich formulieren. Nach dem Bauen von 4 Skills für dieses Repo war der Fallstrick, den ich selbst hatte, Beschreibungen wie "A helpful skill for SEO" zu hinterlassen. Nutzlos. Neuschreiben zu: "Use when the user wants to add JSON-LD schema, meta tags, or SEO frontmatter to a Markdown post." Die Auslösegenauigkeit stieg von ~30 % auf ~95 %. Auslösegenauigkeit steht oder fällt mit dem description-Feld. Schreiben Sie es für Claude, nicht für Ihren Lebenslauf.
Fehlermodus 3: "Die Beschreibung wurde in der Slash-Befehlspalette abgeschnitten"
Entweder Ihre description ist über 1024 Zeichen oder Ihr name ist über 64 Zeichen. Beide haben harte Grenzen. Lösung: Teilen Sie die Skill in zwei engere Skills auf, oder verschieben Sie das lange Detail in den SKILL.md-Body. Das Frontmatter dient dem Routing, nicht der Dokumentation.
Fehlermodus 4: "Live-Änderungserkennung funktioniert nicht"
Pre-Skills-2.0 Claude Code erfordert einen vollständigen Neustart nach jeder SKILL.md-Bearbeitung. Wenn Sie an einer Skill iterieren und Ihre Änderungen nicht übernommen werden, sind Sie wahrscheinlich auf einem älteren Build. Entweder upgraden Sie auf eine Claude-Code-Version, die Skills 2.0 (Live-Discovery) enthält, oder gewöhnen Sie sich an, nach jedem Speichern neu zu starten. Lästig, aber günstig.
Skills jenseits von Claude: Der offene Agent Skills Standard
Ja — Skills sind ein offener Standard. Der Agent Skills Standard unter agentskills.io definiert das SKILL.md-Format unabhängig von einem Anbieter. OpenAIs Codex CLI und ChatGPT Desktop haben den Standard im Dezember 2025 übernommen; dieselbe SKILL.md, die Sie für Claude Code schreiben, läuft in Codex mit geringfügigen Frontmatter-Anpassungen.
Hier ist die Cross-Tool-Support-Matrix ab Mai 2026: Claude Code hat volle Agent Skills-Unterstützung (die Referenzimplementierung). OpenAIs Codex CLI hat volle Unterstützung. ChatGPT Desktop hat teilweise Unterstützung — name, description und Body funktionieren, aber allowed-tools-Parität ist noch nicht da. Gemini CLI hat früh 2026 Unterstützung angekündigt, hatte sie aber zum Zeitpunkt dieses Schreibens noch nicht ausgeliefert. Cursor ist der Außenseiter — es verwendet sein eigenes Cursor Rules-Format und liest SKILL.md nicht nativ, obwohl Community-Shims existieren.
Was Sie heute schreiben sollten, damit Ihre Skills das Jahr überstehen: Halten Sie name und description sauber und tool-agnostisch. Isolieren Sie anbieter-spezifisches Frontmatter hinter einem Namensraum (claude: oder codex:), wenn Sie cross-tool gehen. Die portable Oberfläche — name, description, body, $ARGUMENTS — funktioniert überall; fortgeschrittene Felder wie context: fork sind Claude-spezifisch, bis andere Anbieter Äquivalente liefern. Anthropic treibt auch tiefere Marketplace-Integration voran, laut der geleakten Claude Code Roadmap, also wird die Portabilität nur einfacher.
Die drei Orte, an denen Sie Beispiel-Skills finden: anthropics/skills (offiziell), awesome-claude-skills (Community) und agentskills.io (die Spezifikationsseite des Standards). Skills sind keine Claude-Funktion mehr. Sie sind ein offener Standard, den Claude zuerst ausgeliefert hat.
FAQ
Was ist der Unterschied zwischen einer Claude Skill und einem MCP-Server?
Eine Claude Skill ist eine SKILL.md-Datei mit Workflow-Anweisungen, die Claude lädt, wenn Ihr Prompt zur Beschreibung passt. Ein MCP-Server ist ein separater Prozess, den Claude aufruft, um Live-Daten zu holen (Datenbanken, APIs, Dateisysteme außerhalb des Arbeitsverzeichnisses). Verwenden Sie Skills für Workflows; MCP für Daten. Sie komponieren sich — Skills können MCP-Tools aufrufen.
Sind Claude Skills kostenlos?
Ja — Skills ist ein eingebautes Claude-Code-Feature, kein Aufpreis. Sie zahlen nur für die Modell-Token, die verbraucht werden, wenn eine Skill läuft. Skills aus dem Anthropic Marketplace können kostenpflichtig sein (heute selten), aber das offizielle anthropics/skills-Repo und Community-Awesome-Listen sind alle frei zu kopieren und zu verwenden.
Wo werden Claude Skills installiert?
Persönliche Skills kommen in ~/.claude/skills/{skill-name}/, Projekt-Skills in .claude/skills/{skill-name}/ im Repo-Stammverzeichnis. Plugin-Skills werden via /plugin install <url> installiert und leben in Ihrem Plugin-Verzeichnis. Enterprise-Skills werden von der IT Ihrer Organisation über verwaltete Einstellungen gepusht. Claude Code scannt beim Start alle vier Bereiche.
Wie erstelle ich eine Claude Skill von Grund auf?
Erstellen Sie einen Ordner unter ~/.claude/skills/, fügen Sie eine SKILL.md-Datei mit YAML-Frontmatter (name, description) gefolgt von den Workflow-Anweisungen hinzu und starten Sie Claude Code neu. Der schnellste Weg: Öffnen Sie Claude Code und bitten Sie es, die gebündelte skill-creator-Skill aufzurufen — sie scaffoldet die SKILL.md für Sie in unter einer Minute.
Warum löst meine Claude Skill nicht aus?
Vier häufigste Ursachen: (1) Die description ist zu vage, damit Claude sie mit Ihrem Prompt abgleichen kann — schreiben Sie mit konkreten Trigger-Phrasen neu; (2) die Skill ist im falschen Pfad (.claude/skills/ nicht claude/skills/); (3) Claude Code braucht einen Neustart auf pre-Skills-2.0-Versionen; (4) der Skill-Name kollidiert mit einer gebündelten Skill. Überprüfen Sie mit ls -la ~/.claude/skills/.
Können ChatGPT oder Cursor Claude Skills verwenden?
ChatGPT Desktop und Codex CLI unterstützen denselben Agent Skills Standard wie Claude — dieselbe SKILL.md läuft in beiden mit geringfügigen Frontmatter-Änderungen. Cursor verwendet sein eigenes Cursor Rules-Format und liest SKILL.md nicht nativ. Gemini CLI hat früh 2026 Unterstützung angekündigt, hatte sie aber ab Mai 2026 noch nicht ausgeliefert.
Was ist die skill-creator-Skill?
skill-creator ist eine Meta-Skill, die im anthropics/skills-Repo gebündelt ist und Claude dabei hilft, neue SKILL.md-Dateien für Sie zu schreiben. Sagen Sie Claude, was die Skill tun soll; skill-creator interviewt Sie für die Beschreibung, wählt sinnvolle allowed-tools und schreibt die SKILL.md in den richtigen Ordner. Schnellst mögliches Scaffolding.
Was macht disable-model-invocation?
disable-model-invocation: true im Frontmatter Ihrer Skill zu setzen verhindert, dass Claude die Skill automatisch basierend auf Prompt-Matching auslöst. Die Skill wird nur per Benutzer-Aufruf nutzbar — sie erscheint in der Slash-Befehlspalette als /skill-name und läuft nur, wenn explizit aufgerufen. Verwenden Sie es für destruktive oder deterministische Aktionen wie /commit oder /deploy.
Bauen Sie ein paar Skills, liefern Sie sie in einem Projekt aus und sehen Sie, was hängen bleibt. Wenn Ihr Team über mehrere Repos hinweg auf den Fallstrick-Haufen "Skill löst nicht aus" stößt und Sie ein zweites Augenpaar auf Ihr .claude/skills/-Setup wollen, melden Sie sich — wir gehen das gerne gemeinsam durch.