Claude Code Skills: Eigene KI-Fähigkeiten bauen und nutzen

Wenn du Claude Code im Alltag nutzt, kennst du das: Bestimmte Anweisungen tippst du immer wieder. „Halte dich an unseren Commit-Stil“, „schreibe Tests nach diesem Muster“, „formatiere die API-Response so“. Genau hier kommen Claude Code Skills ins Spiel. Ein Skill bündelt eine wiederverwendbare Fähigkeit, die Claude bei Bedarf automatisch lädt, ohne dass du sie jedes Mal neu erklären musst. In diesem Artikel zeige ich dir, was Claude Code Skills genau sind, wie das clevere Prinzip der Progressive Disclosure dahinter funktioniert, wie sie sich von Slash-Commands, Subagenten, Plugins und MCP unterscheiden und wie du in wenigen Minuten deinen ersten eigenen Skill baust.

Was sind Skills in Claude Code?

Ein Skill ist im Kern eine Anleitung in Textform, die in einer SKILL.md liegt. Diese Datei beschreibt, was die Fähigkeit kann, wann sie zum Einsatz kommt und welche Schritte Claude befolgen soll. Optional kannst du Skripte, Templates oder weitere Dateien dazulegen, auf die der Skill zugreift.

Das Clevere daran: Claude lädt einen Skill nicht stur bei jeder Anfrage, sondern erst, wenn er für die aktuelle Aufgabe relevant ist. In der SKILL.md beschreibst du im Frontmatter, wofür der Skill gut ist, und Claude entscheidet selbst, ob er ihn heranzieht. So bleibt dein Kontextfenster schlank, und trotzdem hast du eine wachsende Bibliothek an spezialisiertem Wissen parat. Egal ob du mit Opus 4.8, Sonnet 4.6 oder Haiku 4.5 arbeitest, das Prinzip bleibt identisch.

Du kannst dir einen Skill wie ein Rezept vorstellen: Es liegt im Regal, und sobald gekocht werden soll, greift Claude danach. Das macht Skills zum idealen Werkzeug für wiederkehrende, klar umrissene Aufgaben.

Anthropic hat das Feature im Oktober 2025 vorgestellt – ursprünglich als kleine Verbesserung für einzelne Aufgaben gedacht. Die Idee schlug aber so ein, dass Skills inzwischen über Claudes komplettes Ökosystem hinweg funktionieren: in Claude Code, in der Web-App auf claude.ai und über die API. Du baust einen Skill also einmal und nutzt ihn überall. Das Schöne: Du brauchst dafür nicht mehr als einen Ordner und eine Markdown-Datei.

Progressive Disclosure: warum Skills dein Kontextfenster nicht zumüllen

Klingt ein Skill für dich erst mal wie „noch mehr Text, den Claude lesen muss“? Das muss aber gar nicht sein! Genau hier steckt der eigentliche Geniestreich: ein Mechanismus namens Progressive Disclosure (zu Deutsch etwa „schrittweise Offenlegung“).

Die Grundidee ist einfach. Claude lädt nicht den kompletten Skill-Inhalt in den Kontext, sondern arbeitet sich in drei Stufen vor – und zwar nur so tief, wie es die Aufgabe wirklich verlangt. Laut dem offiziellen Agent-Skills-Standard läuft das so ab:

• Discovery (Entdecken): Beim Start liest Claude nur den Namen und die Beschreibung jedes Skills. Gerade genug, um zu wissen, dass es ihn überhaupt gibt.
• Activation (Aktivieren): Passt eine Aufgabe zur Beschreibung, lädt Claude die vollständige SKILL.md nach.
• Execution (Ausführen): Erst wenn ein Detail gebraucht wird, greift Claude auf zusätzliche Dateien zu oder führt ein hinterlegtes Skript aus.

Warum ist das so wichtig? Weil dein Kontextfenster endlich ist – und je voller es ist, desto schlechter die Antworten. In der Discovery-Phase kostet ein Skill nur eine Handvoll Tokens. Messungen an Anthropics offiziellen Skills zeigen einen Median von rund 80 Tokens pro Skill – ein Bruchteil dessen, was die komplette Anleitung verbrauchen würde. Du kannst also Dutzende Skills bereithalten, ohne dass Claude träge oder teuer wird. Der volle Inhalt landet nur dann im Kontext, wenn er gebraucht wird.

Genau das ist der Unterschied zu einer riesigen CLAUDE.md, die immer komplett mitläuft. Skills sind wie ein gut sortiertes Regal: Claude sieht die Etiketten, greift aber nur nach dem Buch, das er gerade braucht.

Claude Code Skills vs. Slash-Commands, Subagenten, Plugins und MCP

Bei den ganzen Begriffen kann man schnell den Überblick verlieren. Klingt ganz schön kompliziert? Ist es nicht. Die Konzepte ergänzen sich, lösen aber unterschiedliche Probleme. Hier die wichtigsten vier im Vergleich:

• Skills sind Wissen und Anleitungen. Sie sagen Claude wie etwas gemacht wird. Ein Skill startet keinen eigenen Prozess, sondern wird in den laufenden Kontext geladen.
• Slash-Commands sind manuelle Shortcuts. Du tippst /befehl und löst eine feste Vorlage aus. Sie werden nie automatisch erkannt und eignen sich für ganz einfache, immer gleiche Handgriffe.
• Subagenten sind eigenständige Helfer mit eigenem Kontextfenster. Sie übernehmen abgegrenzte Teilaufgaben (etwa eine Recherche oder ein Code-Review) und liefern dir ein Ergebnis zurück. Subagenten delegieren Arbeit, Skills beschreiben Arbeit.
• Plugins sind das Verpackungsformat. Ein Plugin kann mehrere Skills, Subagenten, Slash-Commands und Hooks bündeln und über einen Marketplace teilbar machen. Wenn du dein Setup mit anderen teilen willst, ist ein Plugin der Weg.
• MCP (Model Context Protocol) ist die Anbindung an die Außenwelt. Darüber greift Claude auf echte Tools, Datenbanken und APIs zu – etwa GitHub, eine Postgres-Datenbank oder den Browser.

Ein schönes Bild dafür: MCP ist die Leitung, Skills sind das Handbuch. MCP liefert die Daten und den Zugang, der Skill liefert das Know-how, wie man damit umgeht. Anthropic selbst zieht denselben Vergleich zwischen Skills und MCP.

Kurz gesagt: Ein Skill ist die kleinste Einheit, Slash-Commands sind manuelle Abkürzungen, Subagenten sind eigenständige Worker, Plugins sind die Distributionsschicht drumherum, und MCP ist die Brücke zu externen Systemen. Die meisten Profi-Setups kombinieren am Ende mehrere davon. Aber keine Sorge: Für den Anfang reicht ein einziger Skill völlig.

Skills nutzen und verwalten mit /skills

Den zentralen Überblick bekommst du über den Slash-Command /skills. Tippst du /skills in Claude Code, siehst du, welche Skills aktuell verfügbar sind und kannst sie verwalten. Das ist dein Startpunkt, um zu prüfen, was Claude gerade zur Verfügung steht.

Du musst einen Skill in der Regel nicht manuell aufrufen. Claude erkennt anhand der Beschreibung, wann ein Skill passt, und zieht ihn automatisch heran. Wenn du also einen Skill für „Conventional Commits“ angelegt hast und Claude einen Commit erstellen soll, lädt er die passende Anleitung von selbst. Über /skills kannst du diesen Bestand jederzeit einsehen.

Wo Skills liegen können

Claude schaut an mehreren Orten nach – und das ergibt eine klare Rangordnung, von persönlich bis teamweit:

• Persönlich: unter ~/.claude/skills/<name>/. Diese Skills stehen dir in jedem Projekt zur Verfügung.
• Projekt-spezifisch: unter .claude/skills/<name>/ direkt im Repo. Commitest du den Ordner, hat jeder im Team automatisch dieselben Skills.
• Über Plugins: als geteiltes Paket aus einem Marketplace.
• Organisationsweit: in den Team- und Enterprise-Plänen können Admins Skills zentral verwalten und an alle ausrollen.

Fertige Skills installieren

Du musst nicht bei null anfangen. Anthropic pflegt ein offizielles Skills-Repository auf GitHub, das du als Marketplace einbinden kannst. Zwei Befehle reichen:

# 1. Offizielles Repo als Marketplace hinzufügen
/plugin marketplace add anthropics/skills

# 2. Dokumenten-Skills installieren (PDF, Excel, Word, PPTX)
/plugin install document-skills@anthropic-agent-skills

Danach kann Claude zum Beispiel Excel-Reports mit Formeln bauen, Word-Dokumente erzeugen oder PDFs auslesen – ganz ohne dass du ihm das jedes Mal erklärst. Praktischer Bonus: Änderungen an einer SKILL.md wirken sofort, ein Neustart ist nicht nötig.

Einen eigenen Skill bauen

Jetzt wird’s praktisch. Ein Skill lebt in einem eigenen Ordner mit einer SKILL.md als Herzstück. So sieht eine minimale Struktur aus:

.claude/
  skills/
    conventional-commits/
      SKILL.md
      examples.md      (optional)

Sobald dein Skill wächst, kannst du ihn sauber aufteilen. Eine ausgereiftere Struktur sieht typischerweise so aus:

mein-skill/
├── SKILL.md          # Pflicht: Frontmatter + Anleitung
├── scripts/          # optional: ausführbare Skripte
├── references/       # optional: Details, die nur bei Bedarf geladen werden
└── assets/           # optional: Templates, Vorlagen

Wichtig ist nur: Die SKILL.md muss direkt im Skill-Ordner liegen, nicht in einem Unterordner.

Die SKILL.md beginnt mit einem kurzen Info-Block ganz oben (in der Fachsprache „Frontmatter“ genannt). Darin stehen ein Name und eine Beschreibung – darunter folgt die eigentliche Anleitung in einfachem Text. Genau über die Beschreibung entscheidet Claude, wann der Skill geladen wird, also formuliere sie konkret.

---
name: conventional-commits
description: Schreibt Commit-Messages im Conventional-Commits-Stil.
  Nutze diesen Skill, wenn ein Git-Commit erstellt werden soll.
---

# Conventional Commits

Wenn du einen Commit erstellst, halte dich an dieses Format:

    <type>(<scope>): <kurze Beschreibung>

## Erlaubte Types
- feat: neue Funktion
- fix: Bugfix
- docs: nur Dokumentation
- refactor: Code-Umbau ohne Verhaltensänderung
- test: Tests hinzufügen oder anpassen

## Regeln
- Beschreibung im Imperativ, klein, ohne Punkt am Ende.
- Maximal 72 Zeichen in der ersten Zeile.
- Body nur bei nicht-trivialen Änderungen.

Mehr braucht es für den Start nicht. Lege den Ordner an, speichere die SKILL.md, prüfe mit /skills, ob der Skill auftaucht, und ab dann nutzt Claude ihn automatisch.

Die wichtigsten Frontmatter-Felder

Zwei Felder sind Pflicht, der Rest ist Kür. Hier die, die du wirklich kennen solltest:

• name (Pflicht): der eindeutige Name. Maximal 64 Zeichen, nur Kleinbuchstaben, Zahlen und Bindestriche – und keine reservierten Wörter wie „claude“ oder „anthropic“.
• description (Pflicht): der wichtigste Trigger überhaupt. Sie darf bis zu 1.024 Zeichen lang sein und sollte klar sagen, was der Skill tut und wann Claude ihn nutzen soll.
• disable-model-invocation: verhindert den automatischen Aufruf. Sinnvoll bei riskanten Aktionen wie einem Deploy, die du lieber manuell auslöst.
• allowed-tools / disallowed-tools: legen fest, welche Werkzeuge der Skill nutzen darf. Gut für die Sicherheit.

Ein netter Trick für Fortgeschrittene: Mit der !-Syntax kannst du in der SKILL.md sogar Befehle ausführen und deren Ausgabe direkt einbauen. !`git diff HEAD` injiziert zum Beispiel die aktuellen Änderungen, bevor Claude sie zusammenfasst. So bekommt dein Skill dynamischen Kontext, statt nur statischer Anweisungen.

Nützliche Skill-Beispiele

Skills lohnen sich übrigens nicht nur fürs Programmieren, sondern für jede wiederkehrende Aufgabe. Ein paar praxiserprobte Ideen:

• Dein Schreibstil: wie ein Blogartikel oder Newsletter bei dir aufgebaut ist (Tonalität, Struktur, Länge), damit Entwürfe sofort passen.
• Standard-Dokumente: dein Format für Angebote, Rechnungen oder E-Mail-Antworten an Kunden.
• Commit-Regeln (für Entwickler): wie oben gezeigt, plus ein Muster für aussagekräftige Beschreibungen von Code-Änderungen.
• Test-Vorgaben (für Entwickler): wie deine Tests aufgebaut sein sollen und welche Fälle immer geprüft werden.
• Onboarding-Schritte: ein Skill, der die Schritte zum Aufsetzen eines Projekts kennt und neue Mitstreiter durchführt.

Faustregel: Alles, was du mehr als zweimal erklärst, ist ein Kandidat für einen Skill.

Damit das nicht abstrakt bleibt, hier ein Beispiel, das für alle spannend ist, die mit WordPress arbeiten. Ich selbst hab damit die besten Erfahrungen gemacht: ein kleiner Blog-Formatter, der jeden Rohtext automatisch in eine saubere, SEO-freundliche Struktur bringt.

---
name: blog-formatter
description: Formatiert Blog-Artikel für WordPress. Optimiert Struktur,
  SEO, Lesbarkeit und Heading-Hierarchie. Nutzen bei "Formatiere diesen
  Blogpost" oder "Mache das WordPress-tauglich".
---

# WordPress Blog Formatter

## Aufgabe
Nimm den bereitgestellten Text und liefere eine optimierte Version zurück.

## Regeln
1. Struktur: H2/H3 logisch gegliedert, niemals ein zweites H1 im Body.
2. SEO: Keyword in den ersten 100 Wörtern, Meta-Description-Vorschlag am Ende.
3. Lesbarkeit: kurze Absätze, Aufzählungen wo sinnvoll, Fettung für Schlüsselbegriffe.
4. Sprache: aktiv, direkte Ansprache, sauberes Deutsch.
5. Am Ende: Alt-Text-Vorschläge für Bilder und Ideen für interne Verlinkung.

Einmal angelegt, formatiert Claude ab sofort jeden Entwurf nach genau diesem Muster. Du tippst die Regeln nie wieder ab.

Best Practices für Claude Code Skills

• Eine Fähigkeit pro Skill. Ein Skill, der zehn Dinge gleichzeitig kann, wird selten zuverlässig geladen. Halte den Fokus eng.
• Schreibe eine präzise description. Sie ist der Trigger. Nenne klar, wann der Skill gilt („wenn ein Commit erstellt wird“, „beim Schreiben von Tests“).
• Halte die SKILL.md kurz. Anthropic empfiehlt als Richtwert rund 500 Zeilen bzw. 5.000 Tokens. Lange Erklärungen lagerst du in zusätzliche Dateien aus, auf die der Skill bei Bedarf verweist.
• Nutze konkrete Beispiele. Ein gutes Vorher-Nachher sagt mehr als drei Absätze Theorie.
• Schreib handlungsorientiert. Nicht „sei gründlich“, sondern „Prüfe zuerst X, dann Y“. Claude folgt konkreten Schritten zuverlässiger als vagen Wünschen.
• Leg Skills in deinen Projektordner. Speicherst du sie unter .claude/skills/ direkt im Projekt, hat jeder, der mit diesem Projekt arbeitet, automatisch dieselben Skills.
• Teste mit /skills. Prüfe nach jeder Änderung, ob der Skill korrekt erkannt wird – am besten mit verschiedenen Prompts, wie du auch echten Code testen würdest.

Der offene Standard: Skills laufen längst nicht mehr nur in Claude

Hier kommt das vielleicht spannendste Update. Seit Dezember 2025 ist das Format ein offener Standard, dokumentiert unter agentskills.io. Was bedeutet das für dich konkret? Eine einmal gebaute SKILL.md ist nicht mehr an Claude gekettet.

Dieselbe Datei funktioniert ohne Änderung in einer wachsenden Zahl von Tools – darunter OpenAI Codex CLI, Gemini CLI, GitHub Copilot, Cursor, VS Code und über 20 weitere Plattformen. Das ist derselbe Weg, den Anthropic schon beim Model Context Protocol gegangen ist: aus einem internen Feature einen Branchenstandard machen. Für dich heißt das: Deine Skill-Bibliothek ist eine Investition, die du mitnehmen kannst, selbst wenn du irgendwann das Tool wechselst.

Fazit

Claude Code Skills sind eines der unterschätztesten Produktivitäts-Features. Sie verwandeln wiederkehrende Erklärungen in wiederverwendbares Wissen, das Claude genau dann zieht, wenn er es braucht – dank Progressive Disclosure, ohne dein Kontextfenster zuzumüllen. Während Slash-Commands manuelle Shortcuts bleiben, Subagenten Arbeit delegieren, MCP die Verbindung zur Außenwelt herstellt und Plugins das Teilen ermöglichen, sind Skills die schlanke, fokussierte Basis dafür. Und weil das Format mittlerweile ein offener Standard ist, nimmst du deine Skill-Bibliothek sogar über Tool-Grenzen hinweg mit.

Fang klein an: Nimm eine Aufgabe, die du immer wieder erklärst, gieß sie in eine SKILL.md, prüfe sie mit /skills und beobachte, wie Claude ab sofort von selbst weiß, was zu tun ist. Dein zukünftiges Ich wird es dir danken.

Häufig gestellte Fragen