Claude Code Skills: Was sie sind, gute Beispiele und die besten Use Cases (2026)

Was sind Claude Code Skills?

Wer mit Claude Code arbeitet, kennt das Muster: Man tippt zum dritten Mal dieselbe Checkliste in den Chat. "Bevor du committest, prüfe X, Y, Z." "So sieht bei uns ein neuer API-Endpoint aus." "Hier ist unser Frontmatter-Schema." Genau dieses Wiederholen lösen Skills.

Ein Skill ist eine Fähigkeit, die du Claude einmal beibringst und die danach jederzeit verfügbar ist. Technisch ist es nichts weiter als ein Ordner mit einer Datei namens SKILL.md: ein bisschen YAML-Frontmatter, das beschreibt wann der Skill genutzt werden soll, und darunter die Anweisungen, die Claude befolgt, wenn er greift. Optional kommen Skripte, Vorlagen oder Referenzdokumente dazu, die im selben Ordner liegen.

Anthropic hat dabei die früheren Custom Commands in Skills aufgehen lassen - eine Datei unter .claude/commands/deploy.md und ein Skill unter .claude/skills/deploy/SKILL.md erzeugen beide das Kommando /deploy. Skills sind aber mächtiger, weil sie einen ganzen Ordner mit Begleitmaterial mitbringen und von Claude bei Bedarf automatisch geladen werden können. Die Skills folgen dem offenen Agent-Skills-Standard, der auch über Claude Code hinaus funktioniert - du bist also nicht an einen einzigen Anbieter gekettet.

Skills vs. CLAUDE.md, Slash Commands, Subagents und MCP

Bevor wir tiefer einsteigen: Skills sind nur eines von mehreren Werkzeugen, mit denen man Claude Code erweitert. Sie zu verwechseln ist der häufigste Fehler. Hier die ehrliche Abgrenzung.

Die wichtigste Trennlinie verläuft zwischen CLAUDE.md und Skill. CLAUDE.md ist für Dinge, die Claude immer wissen muss - jeder Buchstabe wird in jeder Anfrage mitgeladen. Ein Skill ist für Dinge, die Claude gelegentlich braucht. Sobald ein Abschnitt deiner CLAUDE.md vom Fakt zum Verfahren wird ("So deployst du", "So legst du einen Artikel an"), gehört er in einen Skill.

Der Unterschied zu MCP-Servern ist ebenso klar: Ein Skill ist Wissen plus Anweisung in einer Textdatei und nutzt die Werkzeuge, die Claude ohnehin hat. Ein MCP-Server bringt neue Werkzeuge mit, weil er ein externes System anbindet. Brauchst du eine Datenbankabfrage oder einen Slack-Post, ist das MCP. Brauchst du ein wiederholbares Verfahren mit deinen Hausregeln, ist das ein Skill.

So ist ein Skill aufgebaut: die SKILL.md

Schauen wir uns das offizielle Einstiegsbeispiel an - ein Skill, der die uncommitteten Änderungen im Git-Repo zusammenfasst und Riskantes markiert. Du legst den Ordner an:

mkdir -p ~/.claude/skills/summarize-changes

Und schreibst die SKILL.md:

---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in two or three bullet points, then list any
risks you notice such as missing error handling, hardcoded values, or tests
that need updating. If the diff is empty, say there are no uncommitted changes.

Drei Dinge passieren hier, die das ganze Skill-Konzept erklären:

1. Die description ist das Herzstück. An ihr entscheidet Claude, ob ein Skill zur aktuellen Aufgabe passt. Sie ist die einzige empfohlene Pflichtangabe - alles andere ist optional. Fragst du "Was habe ich geändert?", matcht Claude die Beschreibung und lädt den Skill von selbst.
2. Der Ordnername wird zum Kommando. Der Ordner heißt summarize-changes, also rufst du den Skill auch direkt mit /summarize-changes auf.
3. Die Zeile !`git diff HEAD` ist dynamische Kontext-Injektion. Claude Code führt den Befehl aus, bevor Claude den Skill sieht, und ersetzt die Zeile durch die Ausgabe. Claude bekommt also den echten Diff schon mitgeliefert - nicht den Befehl.

Die wichtigsten Frontmatter-Felder

Alle Felder sind optional, nur description ist empfohlen. Die in der Praxis relevanten:

Progressive Disclosure: warum Skills den Kontext schonen

Das ist das eigentlich clevere Prinzip - und der Grund, warum Skills besser skalieren als eine immer länger werdende CLAUDE.md. Information lädt in Stufen:

• Stufe 1 - die Beschreibung liegt ab Session-Start im Kontext. Pro Skill nur eine knappe Zeile. So weiß Claude, was verfügbar ist, ohne nennenswert Kontext zu verbrennen.
• Stufe 2 - der SKILL.md-Body lädt erst, wenn der Skill tatsächlich aufgerufen wird.
• Stufe 3 - Begleitdateien und Skripte liegen auf der Festplatte. Eine 2.000-Zeilen-API-Referenz im selben Ordner kostet null Kontext, solange Claude sie nicht öffnet. Skripte werden sogar ausgeführt, nicht geladen - der Code landet nie im Kontext, nur die Ausgabe.

Praktisch heißt das: Du kannst umfangreiche Referenzen, Datensätze und Beispielsammlungen bündeln, ohne dass sie dich etwas kosten. Verweise dafür einfach aus der SKILL.md auf die Datei, damit Claude weiß, was drinsteht und wann er sie öffnen soll:

## Weiterführende Ressourcen
- Vollständige API-Details: siehe [reference.md](reference.md)
- Anwendungsbeispiele: siehe [examples.md](examples.md)

Die vier Ebenen: persönlich, Projekt, Plugin, Enterprise

Wo ein Skill liegt, bestimmt, wer ihn nutzen kann:

Für Teams ist die Projekt-Ebene der entscheidende Hebel. Checkst du .claude/skills/ ins Repository ein, hat jeder im Team - und jeder KI-Agent, der im Repo arbeitet - sofort dieselben Verfahren. Euer Deployment-Ablauf, eure Code-Konventionen, eure DSGVO-Checkliste werden so zu geteiltem, versioniertem Hauswissen statt Tribal Knowledge in den Köpfen einzelner Entwickler. Genau dieses Muster nutzt übrigens SaaS-Welt selbst: Verfahren wie "neuen Artikel anlegen" oder "Newsletter erstellen" liegen als Projekt-Skills im Repo.

Bei Namenskonflikten gilt eine klare Reihenfolge: Enterprise schlägt Persönlich, Persönlich schlägt Projekt. Plugin-Skills bekommen mit plugin-name:skill-name einen eigenen Namensraum und können deshalb gar nicht kollidieren.

Wie Skills aufgerufen werden

Es gibt zwei Wege, und der Unterschied ist wichtig:

• Automatisch durch Claude. Passt deine Aufgabe zur description, lädt Claude den Skill von selbst. "Fass meine Änderungen zusammen" aktiviert den summarize-changes-Skill, ohne dass du das Kommando kennen musst. Das ist der Normalfall für Wissens- und Referenz-Skills.
• Direkt durch dich mit /skill-name. Funktioniert immer, ohne Beschreibungs-Matching. Der richtige Weg für alles mit Nebenwirkungen.

Genau hier kommt disable-model-invocation: true ins Spiel. Setzt du es, kann nur noch der Mensch den Skill auslösen - Claude entscheidet nicht mehr selbst, zu deployen, nur weil der Code fertig aussieht. Für /deploy, /commit oder /send-slack-message ist das Pflicht.

Die besten Use Cases

Ein Skill lohnt sich überall dort, wo ein Verfahren wiederholbar ist und Hauswissen trägt. Die wertvollsten Muster aus der Praxis:

1. Hausstandard für Code-Reviews. Eure Anti-Patterns, Pflicht-Checks, Sicherheitsregeln in einem /review-Skill. Statt sie bei jedem Pull Request neu zu erklären, matcht Claude "review diesen Code" und zieht eure Standards.

2. Boilerplate nach Hausmuster. Ein calculator-scaffolder, der eine neue Komponente exakt nach eurer Projektstruktur erzeugt - inklusive Validierungs- und Styling-Patterns. Das eliminiert genau die Inkonsistenzen, die entstehen, wenn jeder Entwickler "ungefähr" das Muster trifft.

3. Dokument-Workflows. PDF-Extraktion, Rechnungsdaten auslesen, Excel-Reports bauen - mit gebündelten Skripten, die deterministisch laufen. Der Skript-Code kostet keinen Kontext, nur das Ergebnis zählt.

4. Mehrstufige Ops-Abläufe. Deployment-Checkliste, Release-Prozess, Datenmigration. Mit disable-model-invocation: true, damit nichts versehentlich ausgelöst wird.

5. DSGVO- und Compliance-Audits (der DACH-Klassiker). Ein dsgvo-audit-Skill mit eurer Prüf-Checkliste: AVV vorhanden? Wo liegen die Server? Welche Subprozessoren? SCCs als Transfermechanismus? Beim Onboarding eines neuen Tools führt Claude die Liste konsistent ab - statt dass jeder die DSGVO-Prüfung anders macht. Genau die Art repetitiver Compliance-Arbeit, die in DACH-Teams Zeit frisst.

6. Content nach Redaktionsstandard. Frontmatter-Schema, Tonalität, interne Verlinkungsregeln - so produziert ein KI-gestützter Workflow Artikel, die wirklich nach eurer Marke klingen statt nach generischem KI-Output.

7. Visuelle Ausgaben aus Skripten. Skills können Skripte in jeder Sprache bündeln - etwa ein Python-Skript, das eine interaktive HTML-Visualisierung eures Codebase-Baums erzeugt. Claude orchestriert, das Skript erledigt die Arbeit.

Wann KEIN Skill das richtige Werkzeug ist

Genauso wichtig wie die Use Cases ist die Gegenfrage. Kein Skill, sondern:

• CLAUDE.md, wenn Claude die Info immer präsent haben muss - Build-Befehle, Projektkonventionen, "nutze pnpm". Kleiner, dauerhafter Fakt statt Verfahren.
• Ein Subagent, wenn du Kontext-Isolation oder Parallelität brauchst. Eine Recherche, die dutzende Dateien liest, aber nur das Fazit zurückgeben soll, gehört in einen eigenen Kontext - nicht in einen Skill.
• Ein MCP-Server, wenn ein externer Dienst angebunden werden muss. Authentifizierung, Datenbankverbindung, eine API, die sich ständig ändert - das pflegt der MCP-Betreiber, nicht du.
• Ein Hook, wenn etwas garantiert bei jedem Event passieren muss. "Linte nach jeder Änderung" ist keine Bitte, die Claude abwägen soll, sondern eine deterministische Regel.

Die Eselsbrücke: Immer präsent → CLAUDE.md. Wiederverwendbares Wissen bei Bedarf → Skill. Isolierte Arbeit → Subagent. Externer Dienst → MCP. Muss bei jedem Event passieren → Hook.

DSGVO und Sicherheit: was DACH-Teams beachten müssen

Hier liegt der Punkt, den englischsprachige Tutorials überspringen. Zwei Aspekte sind für DACH-Teams relevant.

Datenschutz. Die SKILL.md-Dateien liegen lokal in deinem Repo - daran ändert sich nichts. Aber sobald ein Skill ausgeführt wird, fließt sein Inhalt zusammen mit dem mitgegebenen Code- und Projektkontext an Anthropics Server in den USA. Das ist dieselbe DSGVO-Frage wie bei Claude Code generell: Es braucht einen AVV mit Anthropic und interne Regeln, welcher Code und welche Daten überhaupt verarbeitet werden dürfen. Ein Skill verschiebt diese Grenze nicht - er macht nur die Verfahren reproduzierbar, die sie respektieren müssen.

Lieferketten-Sicherheit. Das ist der unterschätzte Teil. Ein eingecheckter Projekt-Skill kann sich über allowed-tools weitreichende Werkzeug-Freigaben selbst gewähren und Skripte bündeln, die mit Claudes Rechten laufen. Klonst du ein fremdes Repository und vertraust dem Workspace, vertraust du auch dessen Skills.

Kosten und Verfügbarkeit

Die Skills selbst kosten nichts extra - sie sind Teil von Claude Code. Was du brauchst, ist ein Zugang zu Claude Code, und der ist an Anthropics Abo-Stufen gekoppelt. Die wichtigste Frage dabei ist nicht "Pro oder Max?", sondern wie viel Nutzungsvolumen dein Team braucht: Jede Stufe hebt das Limit, bevor Claude Code dich ausbremst.

Alternativ läuft Claude Code auch direkt über die Anthropic API mit nutzungsbasierter Abrechnung pro Token - sinnvoll, wenn die Nutzung stark schwankt oder du sie pro Projekt abrechnen willst.

Über Claude Code hinaus gibt es Agent Skills auch in den Claude-Apps und über die API (dort mit vorgefertigten Skills für PDF, Word, Excel und PowerPoint). Wichtig zu wissen: Eigene Skills synchronisieren nicht automatisch zwischen den Oberflächen - ein Skill aus Claude Code ist nicht automatisch in der Claude-App verfügbar.

Fazit: das fehlende Bindeglied zwischen Chat und System

Skills schließen eine konkrete Lücke. Vibe Coding zeigt, was ein Mensch mit einem KI-Agenten ad hoc bauen kann. CLAUDE.md hält die Konventionen. MCP bindet die Außenwelt an. Skills sind das Stück dazwischen: das wiederholbare Hauswissen, das ein Team einmal sauber definiert und danach konsistent anwendet - egal ob Mensch oder Agent gerade tippt.

Für DACH-SaaS-Teams ist gerade das interessant. Die Arbeit, die hier am meisten frisst - DSGVO-Audits, Compliance-Checks, Redaktionsstandards, immer gleiche Onboarding-Schritte - ist genau die Art von repetitivem Verfahren, für die Skills gemacht sind. Wer schon mit Claude Code arbeitet und noch keine Projekt-Skills im Repo hat, lässt den größten Hebel liegen. Mein Rat: Nimm die eine Checkliste, die du diese Woche zum dritten Mal in den Chat getippt hast, und mach einen Skill draus. Das ist die ganze Einstiegshürde.

Wer tiefer in das Thema autonomer Agenten einsteigen will, findet im Guide zu Agentic AI den größeren Kontext - Skills sind ein Baustein dieser Entwicklung, nicht ihr Endpunkt.

Häufige Fragen zu Claude Code Skills

Was sind Claude Code Skills?

Skills sind wiederverwendbare Fähigkeiten, die du Claude Code per SKILL.md-Datei beibringst. Eine SKILL.md enthält Anweisungen, eine Beschreibung (wann der Skill genutzt werden soll) und optional Skripte oder Referenzdateien. Claude lädt einen Skill automatisch, wenn deine Aufgabe zur Beschreibung passt, oder du rufst ihn direkt mit /skill-name auf.

Was ist der Unterschied zwischen einem Skill und CLAUDE.md?

CLAUDE.md wird in jeder Session vollständig geladen und ist für dauerhafte Fakten und Konventionen gedacht. Ein Skill lädt seinen Inhalt erst, wenn er gebraucht wird - lange Checklisten und Referenzmaterial kosten also fast keinen Kontext, solange sie nicht aktiv sind. Faustregel: dauerhafte Regel in CLAUDE.md, wiederholbares Verfahren als Skill.

Sind Claude Code Skills DSGVO-konform nutzbar?

Die SKILL.md-Dateien selbst liegen lokal in deinem Repository. Sobald ein Skill aber ausgeführt wird, gehen die mitgegebenen Code- und Kontextdaten an Anthropics Server (USA) - dieselbe DSGVO-Frage wie bei Claude Code generell. Für den professionellen Einsatz braucht es einen AVV mit Anthropic und interne Regeln, welche Daten verarbeitet werden dürfen.

Brauche ich ein bezahltes Abo für Skills?

Skills sind Teil von Claude Code und kosten nicht extra. Du brauchst aber einen Claude-Code-Zugang - entweder über ein Pro- oder Max-Abo (ab ca. 20 USD/Monat) oder über die Anthropic API mit nutzungsbasierter Abrechnung. Die Skills selbst sind in jedem dieser Wege enthalten.

Wie unterscheiden sich Skills von MCP-Servern?

Ein Skill ist Wissen plus Anweisungen in einer Textdatei - er nutzt die Werkzeuge, die Claude ohnehin hat. Ein MCP-Server bindet externe Dienste an (Datenbank, Slack, CRM) und stellt neue Werkzeuge bereit. Skills sind ideal für wiederholbare Verfahren und Hauswissen, MCP für Integrationen mit Drittsystemen.