Claude immer wieder denselben Ablauf zu erklären, ist mühsam“ – wenn dir das bekannt vorkommt, sind Claude Skills (Agent Skills) genau der Mechanismus, der dafür gebaut wurde. Anthropic stellte sie am 16. Oktober 2025 vor, und innerhalb weniger Monate wurden sie zur Standardmethode, um Claude in Claude Code und über die API domänenspezifische Fähigkeiten zu verleihen.

Dieser Artikel erklärt anfängerfreundlich, was Skills sind, warum sie wichtig sind und wie man einen baut – bis hin zu der Frage, wie sie sich von den oft verwechselten MCP und Subagenten unterscheiden.

Claude Agent Skills · veröffentlicht Okt. 2025

Ein Skill = ein „Anleitungsordner“, den du Claude übergibst

– automatisch geladen, nur wenn er gebraucht wird

📁

Als Ordner ausgeliefert

Anweisungen, Skripte und Referenzen in einem Ordner. SKILL.md ist der Kern.

🔎

Nur bei Bedarf gelesen

Normalerweise nur die Beschreibung. Der Inhalt öffnet sich, wenn eine Aufgabe passt.

🔁

Jedes Mal gleiche Qualität

Reproduzierbar auf dieselbe Weise, ohne einen Prompt erneut einzufügen.

1. Was sind Claude Skills (Agent Skills)?

Claude Skills sind eine Möglichkeit, das „Wie erledige ich eine bestimmte Aufgabe“ in einen einzigen Ordner zu verpacken und Claude zu übergeben. Im Ordner liegt eine Anleitung namens SKILL.md, die den Ablauf enthält, dazu optional ausführbare Skripte und Referenzmaterialien.

Stell es dir wie ein Einarbeitungshandbuch vor, das du einem neuen Mitarbeiter gibst. „Wie man eine Rechnungs-PDF erstellt“, „unsere Konvention für Commit-Nachrichten“, „das Format für Besprechungsnotizen“ – sobald du diese festen Abläufe einmal als Handbuch festhältst, kann Claude sie jedes Mal heranziehen und dieselbe Qualität liefern. Es fühlt sich an, als würdest du einem KI-Agenten nachträglich spezialisierte Fähigkeiten anschrauben.

💡 In einem Satz: Ein Skill ist ein „Anleitungsordner, den sich Claude merkt“. Einmal gebaut, kannst du dieselbe Aufgabe immer wieder auf dieselbe Weise anfordern.

2. Warum sie wichtig sind: Schluss mit dem ewigen Prompt-Einfügen

Bisher bedeutete es meist, einen langen Anweisungs-Prompt jedes einzelne Mal einzufügen, um Claude Spezialarbeit erledigen zu lassen. Dieser Ansatz hat jedoch Schwächen.

  • Geringe Reproduzierbarkeit: Eine kleine Änderung am Prompt, und das Ergebnis driftet ab
  • Es überfüllt den Kontext: Lange Anweisungen belegen dauerhaft das Kontextfenster
  • Schwer zu teilen: Im Team dieselbe Qualität zu erreichen, ist mühsam
VORHER

Jedes Mal einen Prompt einfügen

  • Jedes Mal lange Anweisungen kopieren und einfügen
  • Kleine Unterschiede lassen Ergebnisse abdriften
  • Überfüllt ständig den Kontext
  • Qualität schwankt im Team
NACHHER (Skills)

Einmal schreiben, für immer wiederverwenden

  • Der Ablauf lebt in SKILL.md, einmal geschrieben
  • Stabil, jedes Mal dieselben Schritte
  • Wird nur bei Bedarf erweitert = leichtgewichtig
  • Teile einfach den ganzen Ordner

Skills ersetzen das durch eine ausklappbare Anleitung, die sich nur bei Bedarf öffnet. Die meiste Zeit sieht Claude lediglich die kurze Beschreibung jedes Skills (ein oder zwei Zeilen). Der eigentliche Ablauf entfaltet sich erst in dem Moment, in dem du genau diese Aufgabe anforderst. So bleibt dein Alltagskontext kaum berührt, selbst wenn Dutzende Skills installiert sind.

Zum Start nannte Entwickler Simon Willison es „vielleicht eine größere Sache als MCP“ – genau wegen dieser Leichtigkeit und Wiederverwendbarkeit. Dein Know-how im Prompt Engineering wird so zu einem Wert, den du ansammelst, statt ihn nach jeder Nutzung wegzuwerfen.

3. So funktioniert es: SKILL.md und progressive Offenlegung

Das Herzstück eines Skills ist eine Datei namens SKILL.md. Ganz oben schreibst du einen name und eine description, darunter folgt der Ablauf in einfachem Markdown.

---
name: pdf-filler
description: Füllt PDF-Formulare aus Daten. Verwenden, wenn der Nutzer ein PDF-Antragsformular oder eine Vorlage befüllen möchte.
---

# Ein PDF-Formular ausfüllen

1. Hole die Feldnamen mit `pdftk form.pdf dump_data_fields`
2. Ordne die Daten des Nutzers diesen Feldnamen zu
3. Trage sie ein mit `pdftk form.pdf fill_form data.fdf output filled.pdf flatten`

Siehe reference/fdf-format.md für Details zum FDF-Format.

Der Schlüssel ist die description. Zu Beginn einer Sitzung liest Claude nur die Beschreibung jedes Skills. Es entscheidet dann selbst, ob die Aufgabe, die du gerade angefordert hast, zu dieser Beschreibung passt, und lädt nur bei einer Übereinstimmung den Inhalt, die Skripte und die Referenzdateien. Dieser Mechanismus, „das Benötigte bei Bedarf schrittweise zu öffnen“, heißt progressive Offenlegung.

SCHRITT 1

Nur die Beschreibungen lesen

Beim Start nimmt Claude nur den name und die description (ein oder zwei Zeilen) jedes Skills auf. Die Inhalte bleiben geschlossen.

SCHRITT 2

Die Übereinstimmung beurteilen

Claude entscheidet selbst, ob deine Anfrage zu einer Beschreibung passt. Keine manuelle Auswahl nötig.

SCHRITT 3

Den Inhalt entfalten

Nur der passende Skill lädt seinen Inhalt, seine Skripte und Referenzen und führt dann die Schritte wie geschrieben aus.

⚠️ Die Beschreibung ist alles: Ist sie vage, kann Claude nicht erkennen, „wann es das nutzen soll“, und der Skill löst nie aus. Der Trick besteht darin, sowohl auszubuchstabieren, was er tut, als auch, wann er zu verwenden ist.

4. So baust du einen (mit Minimalbeispiel)

Es gibt zwei Wege. (1) Du lässt Anthropics offiziellen „skill-creator“-Skill ihn für dich bauen, oder (2) du richtest den Ordner selbst ein. Eine minimale Struktur sieht so aus.

.claude/skills/
└── pdf-filler/
    ├── SKILL.md          ← erforderlich: name, description, Schritte
    ├── reference/
    │   └── fdf-format.md ← zusätzliche Details, nur bei Bedarf gelesen
    └── scripts/
        └── fill.py       ← Code, den Claude ausführen kann

In Claude Code legst du den Ordner einfach in das .claude/skills/ deines Projekts (nur dieses Projekt) oder in ~/.claude/skills/ (über alle Projekte hinweg geteilt) und er wird automatisch erkannt. Ein Update vom Januar 2026 sorgte dafür, dass hinzugefügte oder bearbeitete Ordner sofort ohne Neustart wirksam werden, was das Experimentieren deutlich erleichtert. Die offizielle Beispielsammlung ist unter github.com/anthropics/skills veröffentlicht.

Als ersten Schritt ist es am besten, einen „Standardablauf“ auszuwählen, den du Claude immer wieder erklärst, und ihn als SKILL.md aufzuschreiben. Fang klein an – das Slack-Post-Format deines Teams, wie ihr Release Notes schreibt – und du bekommst schnell den Dreh raus.

5. Skills vs. MCP vs. Subagenten

Skills sind nicht die einzige Möglichkeit, Claude zu erweitern. Sortieren wir nach ihrer Rolle, wie sie sich von den oft verwechselten MCP und Subagenten unterscheiden. Die drei sind keine Konkurrenten – sie liegen auf unterschiedlichen Ebenen.

Werkzeug Rolle (in einem Satz) Einsetzen, wenn
Skill Bringt das Wie bei
= verändert das Verhalten
Du willst jedes Mal dieselben Schritte, dasselbe Format
MCP Verbindet mit der Außenwelt
= fügt Konnektivität hinzu
Du brauchst den Live-Zustand einer DB, von Google Drive usw.
Subagent Trennt den Kontext
= eine eigenständige Sitzung
Du willst parallele Arbeit oder Recherche vom Hauptstrang isolieren

Eine einfache Faustregel: Geht es bei der Anfrage um „abrufen, nachschlagen, aktueller Zustand“, willst du MCP. Geht es um „mach es auf unsere übliche Art“, willst du einen Skill. Geht es um „gib es an eine separate Einheit, damit sie parallel läuft“, willst du einen Subagenten. Und in der Praxis kombinierst du alle drei (z. B. holt ein Subagent über MCP Daten und verwandelt sie dann mit dem Ablauf eines Skills in einen Bericht).

6. Wo es läuft: Ein offener Standard

Skills sind keine an ein Produkt gebundene Funktion – sie wurden als offener Standard veröffentlicht. Solange du dem gemeinsamen SKILL.md-Format folgst, läuft derselbe Skill über mehrere Werkzeuge hinweg.

Wo es in Anthropics eigenen Produkten läuft

Die Claude-Apps (Pro / Max / Team / Enterprise), Claude Code, die API (Claude Developer Platform) und das Claude Agent SDK

Andere Werkzeuge, die den Standard übernommen haben

OpenAI Codex CLI, Cursor, Gemini CLI, GitHub Copilot und weitere große Coding-Agenten unterstützen dasselbe Format

Mit anderen Worten: Ein einmal geschriebener Skill lässt sich auch auf anderen Agenten als Claude wiederverwenden. Derselbe Wandel, der MCP zum gemeinsamen Standard für Werkzeug-Anbindungen gemacht hat, vollzieht sich nun auch in der Welt der „Arbeitsabläufe“. Je mehr du mehrere Coding-Werkzeuge jonglierst, desto größer der Gewinn.

7. Wofür kannst du es nutzen? Echte Beispiele

Abstrakt ist es schwer vorstellbar, deshalb hier ein paar gängige Anwendungen.

  • Dokumentenerstellung: Word-, PowerPoint-, PDF- und Excel-Dateien nach deinen eigenen Vorlagen erstellen (auch in den offiziellen Beispielen enthalten)
  • Interne Regeln durchsetzen: Konventionen für Commit-Nachrichten, Checklisten für Code-Reviews und Benennungsregeln jedes Mal anwenden
  • Routineberichte: wöchentliche Umsatzübersichten, Besprechungsnotizen und Release Notes im selben Format
  • Spezialisierte Workflows: Datenvalidierung, der Aufruf einer bestimmten API, die Schritte zum Erstellen eines Diagramms

Auch auf Drittanbieterseite wächst die Unterstützung: Box, Canva und Notion bieten ihre eigenen Abläufe als Skills an. Im Kontext der betrieblichen Effizienz ist die Idee, „die Arbeit, die du oft machst, in einen Skill zu verwandeln, als wiederverwendbaren Wert“, auf dem besten Weg, zur Norm zu werden.

Fazit

Claude Skills (Agent Skills) sind eine Möglichkeit, das „Wie erledige ich eine bestimmte Aufgabe“ in einen Ordner zu verpacken und Claude zu geben. Bringen wir es auf drei Punkte.

  • Was es ist: ein Ordner rund um SKILL.md (name, description, Schritte). Sehr ähnlich einem Einarbeitungshandbuch für einen neuen Mitarbeiter
  • Warum es clever ist: normalerweise nur die Beschreibung; der Inhalt entfaltet sich, wenn eine Aufgabe passt – „progressive Offenlegung“, die Kontext spart
  • Wie weit es reicht: als offener Standard auf Agenten jenseits von Claude wiederverwendbar und mit MCP und Subagenten kombinierbar

Fang damit an, einen Ablauf, den du Claude immer wieder erklärst, als SKILL.md aufzuschreiben. Einmal gebaut, wird diese Aufgabe zu einem „Wert“, den du nie wieder erklären musst. Wenn du tiefer in die Mechanik eintauchen willst, sieh dir auch unsere Beiträge zu MCP und Harness Engineering an. Neben den Skills ist Claude Code Artifacts eine weitere neue Ausgabemöglichkeit von Claude Code, die eine Coding-Session in eine teilbare Live-Seite verwandelt.

FAQ

F. Sollte ich Skills oder MCP verwenden?

A. Sie haben unterschiedliche Rollen, es ist also kein Entweder-oder. Soll Claude „auf unsere übliche Art arbeiten“, nimm einen Skill; willst du „externe Daten und den aktuellen Zustand abrufen oder darauf reagieren“, nimm MCP. In der Praxis ist es normal, beide zu kombinieren.

F. Kann ich einen ohne Programmieren bauen?

A. Ja. Eine SKILL.md funktioniert schon, wenn du die Schritte einfach in normaler Prosa (Markdown) schreibst. Skripte beizulegen ist optional – einfach „den Ablauf in Worten aufzuschreiben“ reicht, damit er funktioniert.

F. Bremsen viele Skills die Geschwindigkeit?

A. Normalerweise wird nur die kurze Beschreibung jedes Skills geladen, sodass mehr davon die Alltagsleistung kaum beeinflussen. Das ist der Vorteil der progressiven Offenlegung.

F. Ist es im kostenlosen Plan verfügbar?

A. Die Skills-Funktion in den Claude-Apps ist in Pro, Max, Team und Enterprise verfügbar. Sie funktioniert außerdem über Claude Code und die API. Prüfe die offiziellen Hinweise für die aktuelle Verfügbarkeit.