Zum Inhalt springen
Kitbay

Was ist ein Claude Skill?

Von der Kitbay-Redaktion ·

Ein Claude Skill ist ein Ordner mit Anweisungen rund um eine Datei namens SKILL.md, der Claude beibringt, eine bestimmte Art von Aufgabe zu erledigen. Claude hat von jedem Skill nur den Namen und die Beschreibung im Blick und öffnet die vollständigen Anweisungen, Skripte und Referenzdateien erst, wenn eine Anfrage sie braucht.

Wofür ein Skill da ist

Stell dir einen Skill als schriftliche Anleitung vor, die du sonst in jedem Chat wiederholen würdest: das Berichtsformat deines Teams, eine Release-Checkliste, die Schritte zum Ausfüllen eines PDF-Formulars oder die Regeln für Abfragen an eine interne Datenbank. Die Dokumentation von Anthropic vergleicht einen Skill mit einem Onboarding-Leitfaden für neue Kolleginnen und Kollegen: Er enthält das Know-how, und Claude wendet es an, sobald die Aufgabe ansteht.

Die Dokumentation von Claude Code nennt einen praktischen Anhaltspunkt: Wenn du immer wieder dieselben Anweisungen in eine Unterhaltung einfügst, ist dieser Text ein Kandidat für einen Skill. Anders als Projektnotizen, die ständig geladen sind, kommt der Hauptteil eines Skills erst in die Unterhaltung, wenn er genutzt wird.

Skills folgen dem offenen Format Agent Skills, das auf agentskills.io veröffentlicht ist und das Anthropic im Dezember 2025 als offenen Standard freigegeben hat. Deshalb kann derselbe Ordner auch außerhalb von Claude funktionieren. Laut der jeweiligen Dokumentation liest Codex Skills aus .agents/skills-Ordnern und Gemini CLI aus .gemini/skills oder .agents/skills.

Was in einem Skill steckt

Ein Skill ist ein Verzeichnis. Nur SKILL.md ist Pflicht, alles andere ist optional.

pdf-forms/
├── SKILL.md        required: front matter + instructions
├── scripts/        code the agent can run
├── references/     extra documents read on demand
└── assets/         templates, images, data files

SKILL.md und das Front Matter

SKILL.md beginnt mit YAML-Front-Matter zwischen zwei ----Zeilen, gefolgt von Anweisungen in Markdown. Die Agent-Skills-Spezifikation definiert diese Felder:

Feld Pflicht Was die Spezifikation sagt
name Ja Bis zu 64 Zeichen; Kleinbuchstaben, Ziffern und Bindestriche; kein Bindestrich am Anfang oder Ende, keine doppelten Bindestriche; muss dem Ordnernamen entsprechen
description Ja Bis zu 1.024 Zeichen; sollte sagen, was der Skill tut und wann er eingesetzt wird
license Nein Ein Lizenzname oder ein Verweis auf eine mitgelieferte Lizenzdatei
compatibility Nein Bis zu 500 Zeichen zu Anforderungen an die Umgebung, etwa benötigte Pakete oder Netzwerkzugriff
metadata Nein Beliebige Schlüssel und Werte als Strings
allowed-tools Nein Vorab freigegebene Tools; als experimentell gekennzeichnet, die Unterstützung variiert je nach Agent

Die API von Anthropic setzt zwei eigene Grenzen: Der Name darf die reservierten Wörter „anthropic“ und „claude“ nicht enthalten, und keines der beiden Felder darf XML-Tags enthalten.

Am wichtigsten ist die Beschreibung. Mit diesem Text vergleicht Claude deine Anfrage, wenn es entscheidet, ob es den Skill öffnet. Sie muss also sowohl die Aufgabe nennen als auch die Situationen, in denen der Skill greifen soll.

Claude Code akzeptiert zusätzliche Felder im Front Matter, etwa disable-model-invocation (nur du kannst den Skill starten) und context: fork (Ausführung in einem Subagenten). Die Dokumentation warnt, dass außerhalb von Claude Code, zum Beispiel beim Hochladen auf claude.ai, nur die Standardfelder akzeptiert werden und unbekannte Schlüssel einen Fehler auslösen.

Die Anweisungen

Der Markdown-Teil hat kein festes Format. Üblich sind Schritt-für-Schritt-Anweisungen, Beispiele für Ein- und Ausgaben und Hinweise zu Sonderfällen. Sowohl Anthropic als auch die Spezifikation empfehlen, die Hauptdatei unter 500 Zeilen zu halten und längeres Material in eigene Dateien auszulagern.

Skripte

Dateien in scripts/ sind Programme, die der Agent ausführt, meist in Python, Bash oder JavaScript. Wenn Claude eines davon ausführt, bleibt der Code selbst außerhalb der Unterhaltung; nur die Ausgabe wird hinzugefügt. Anthropic stellt das als Weg dar, feste Abläufe wie das Validieren eines Formulars wiederholbar zu machen, statt das Modell den Code jedes Mal neu schreiben zu lassen.

Referenzdateien und Assets

references/ enthält Dokumentation, die der Agent nur liest, wenn ein Schritt sie braucht, etwa eine API-Referenz oder ein Datenbankschema. assets/ enthält Vorlagen, Bilder und Datendateien. Die Spezifikation empfiehlt, diese Dateien direkt aus SKILL.md zu verlinken und Ketten von Dateien zu vermeiden, die auf weitere Dateien verweisen.

So lädt Claude einen Skill

Skills werden in Stufen geladen. Anthropic nennt dieses Prinzip Progressive Disclosure:

Stufe Wann Ungefährer Aufwand
Name und Beschreibung Zu Beginn jeder Sitzung Etwa 100 Tokens pro Skill
SKILL.md-Inhalt Wenn eine Anfrage zur Beschreibung passt Empfohlen: unter 5.000 Tokens
Skripte, Referenzen, Assets Nur wenn die Anweisungen darauf verweisen Nichts, bis sie gelesen werden; Skripte fügen nur ihre Ausgabe hinzu

Ein typischer Ablauf: Du bittest Claude, den Text aus einer PDF-Datei zu extrahieren. Claude erkennt, dass die Beschreibung eines PDF-Skills passt, liest dessen SKILL.md, folgt den Anweisungen und überspringt die Referenz zum Ausfüllen von Formularen, weil die Aufgabe sie nicht braucht.

In Claude Code kannst du einen Skill auch selbst starten, indem du / gefolgt von seinem Namen eingibst, zum Beispiel /summarize-changes. Einmal geladen, bleiben die Anweisungen für die folgenden Schritte in der Unterhaltung.

Wo Claude Skills funktionieren

  • Claude Code: Persönliche Skills liegen in ~/.claude/skills/<name>/SKILL.md, Projekt-Skills in .claude/skills/ innerhalb eines Repositorys, und Plugins können weitere mitbringen.
  • claude.ai: Du lädst einen Skill als ZIP-Datei hoch. Laut Anthropic gibt es eigene Skills in den Tarifen Pro, Max, Ultra, Team und Enterprise, wenn die Codeausführung aktiviert ist.
  • Claude API: Skills laufen im Container für die Codeausführung. Anthropic bietet fertige Skills für PowerPoint-, Excel-, Word- und PDF-Dateien, und du kannst eigene hochladen. Skills in der API haben keinen Netzwerkzugriff.

Eigene Skills werden zwischen diesen Orten nicht synchronisiert. Ein in claude.ai hinzugefügter Skill ist über die API nicht verfügbar, und Skills in Claude Code sind von beiden getrennt.

Skills und MCP-Server

Ein Skill vermittelt ein Vorgehen; ein MCP-Server gibt dem Agenten eine direkte Verbindung zu einem anderen System. Oft werden beide zusammen genutzt: Ein Server liest deinen Projekt-Tracker, und ein Skill beschreibt, wie dein Team Tickets schreibt. Unsere Anleitung zu MCP-Servern und Agent Skills im Vergleich erklärt den Unterschied im Detail, und Was ist ein MCP-Server? erklärt die andere Hälfte.

Kurzer Sicherheitshinweis

Ein Skill kann den Agenten anweisen, Code auszuführen und seine Tools auf deine Dateien und Konten anzuwenden. Anthropic rät, Skills nur aus vertrauenswürdigen Quellen zu nutzen und vorher jede mitgelieferte Datei zu lesen. Achte dabei auf Netzwerkaufrufe oder Dateizugriffe, die nicht zum angegebenen Zweck des Skills passen. In Claude Code haben Skills denselben Netzwerkzugriff wie jedes andere Programm auf deinem Rechner. Unsere Sicherheitsfragen zu Servern und Skills bieten eine ausführlichere Checkliste.

Skills finden und bauen

Stöbere in den Agent Skills auf Kitbay oder starte bei einer Aufgabe, etwa Skills für die Arbeit mit Dokumenten oder Schreiben und Lektorat. Jeder Eintrag zeigt, ob der Skill Skripte enthält, und verlinkt seine Quelle. Wie du einen eigenen schreibst, erfährst du unter So erstellst du einen Skill.

Fragen

Was ist ein Skill in Claude?
Ein Skill ist ein Ordner mit einer SKILL.md-Datei, die einen Namen, eine Beschreibung und Anweisungen enthält. Name und Beschreibung sieht Claude jederzeit; die vollständigen Anweisungen liest es nur, wenn deine Anfrage dazu passt.
Funktionieren Skills nur mit Claude?
Nein. Skills folgen dem offenen Format Agent Skills, und andere Agenten wie Codex und Gemini CLI dokumentieren Unterstützung für SKILL.md-Ordner. Felder, die nur ein bestimmtes Produkt kennt, werden anderswo eventuell ignoriert oder abgelehnt.
Kann ein Skill Code ausführen?
Ja. Ein Skill kann Skripte enthalten, die der Agent ausführt, und nur die Ausgabe des Skripts landet in der Unterhaltung. Deshalb solltest du die Dateien eines Skills lesen, bevor du ihn installierst.
Werden meine Skills zwischen Claude Code, claude.ai und der API synchronisiert?
Nein. Laut der Dokumentation von Anthropic werden eigene Skills nicht zwischen den Oberflächen synchronisiert. Du fügst sie also an jedem Ort, an dem du sie nutzt, separat hinzu.

Quellen

Weitere Anleitungen