Claude Skills für Einsteiger: eigene KI-Workflows aufbauen

Wie Sie mit einer SKILL.md-Datei Regeln und Arbeitsabläufe einmal festhalten, statt sie in jede Unterhaltung neu einzufügen
Aktualisiert:
Abstract
- #Claude Skills
- #KI-Workflows
- #Anweisungen
- #Markdown
- #Progressive Disclosure
- #SKILL.md
- #Claude Code
- #Agent Skills
Ein Ordner, eine Markdown-Datei, eine gute Beschreibung: was Skills leisten und wo ihre Grenzen liegen
Angenommen, in einer Marketingabteilung schreiben sechs Leute mit Claude Texte, und alle fügen vorher die Markenrichtlinien ein. Nur haben drei davon eine Fassung vom letzten Jahr, einer nutzt noch den alten Produktnamen, und die Werkstudentin kennt das Dokument gar nicht. Die Ergebnisse klingen entsprechend unterschiedlich.
Genau für solche Fälle hat Anthropic die Skills eingeführt. Ein Skill ist ein Ordner mit Anweisungen, den Claude selbst entdeckt und nur dann lädt, wenn er zur aktuellen Aufgabe passt. Die Regeln werden einmal geschrieben, an einer Stelle gepflegt und gelten dann für alle, die den Skill nutzen. Das klingt unscheinbar, verändert aber die Arbeit mit KI-Assistenten spürbar: weg vom immer neuen Erklären, hin zu wiederverwendbaren Arbeitsanleitungen.
Was ein Claude Skill ist und wann Claude ihn lädt
Technisch ist ein Skill erstaunlich schlicht: ein Ordner mit einer Datei namens SKILL.md, optional ergänzt um weitere Dateien. Die SKILL.md beginnt mit einem kurzen Kopfbereich, dem sogenannten Frontmatter, in dem Name und Beschreibung stehen. Darunter folgen die eigentlichen Anweisungen in Markdown, einem einfachen Textformat mit Rautezeichen für Überschriften und Bindestrichen für Aufzählungen.
Der Kniff liegt darin, wie Claude damit umgeht. Zu Beginn einer Unterhaltung sieht das Modell nur Namen und Beschreibungen aller verfügbaren Skills, eine Art Inhaltsverzeichnis. Erst wenn eine Anfrage zu einer Beschreibung passt, liest Claude die vollständige SKILL.md. Verweist diese auf weitere Dateien, werden auch die erst bei Bedarf geöffnet. Anthropic nennt dieses Prinzip Progressive Disclosure, schrittweise Offenlegung: Informationen kommen erst in den Kontext, wenn sie gebraucht werden.
Angenommen, Sie haben einen Skill für Markenrichtlinien und einen für die Bereinigung von CSV-Dateien. Bitten Sie Claude, ein Python-Skript zu debuggen, bleiben beide unberührt. Fragen Sie nach einem LinkedIn-Post, lädt Claude den Marken-Skill. Das hält das Kontextfenster – die Textmenge, die das Modell auf einmal verarbeitet – frei für das Wesentliche. Warum das so wichtig ist, erklärt der Beitrag über Kontext-Engineering für KI-Agenten.
Bemerkenswert ist, dass das Format nicht an Claude gebunden bleibt. Anthropic hat es unter dem Namen Agent Skills als offene Spezifikation veröffentlicht (agentskills.io). Nach Angaben der Projektseite unterstützen inzwischen auch andere Werkzeuge wie OpenAI Codex, Cursor oder Gemini CLI dieses Format. Ein sorgfältig geschriebener Skill ist damit keine Investition in nur einen Anbieter.
Wann sich ein eigener Skill lohnt
Nicht jede Aufgabe braucht einen Skill. Die Faustregel: Wenn Sie dieselben Anweisungen regelmäßig in verschiedenen Unterhaltungen wiederholen und dabei ein gleichbleibendes Ergebnis erwarten, ist ein Skill sinnvoll. Für eine einmalige Frage ist er überdimensioniert.
In der Praxis lassen sich zwei Arten unterscheiden:
- Vorlagen-Skills legen fest, wie ein Ergebnis aussehen soll. Beispiel: ein wöchentlicher Statusbericht an die Teamleitung, immer mit den Abschnitten „Erledigt“, „Geplant“, „Hindernisse“ und einer Einschätzung, ob der Zeitplan hält.
- Ablauf-Skills geben eine Reihenfolge von Arbeitsschritten vor. Beispiel: Eine Controllerin bereinigt jeden Monat einen Export aus der Warenwirtschaft, prüft immer dieselben Spalten, vereinheitlicht Datumsformate und ersetzt alte Artikelnummern. Als Skill hinterlegt, läuft dieser Ablauf jedes Mal gleich.
Weniger geeignet sind Skills für Wissen, das sich ständig ändert oder sehr umfangreich ist, etwa ein komplettes Produkthandbuch mit Tausenden Seiten. Dafür gibt es andere Ansätze, dazu weiter unten mehr.
So schreiben Sie Ihren ersten Skill
Aufbau der SKILL.md mit Frontmatter
Der Ordnername muss laut Spezifikation dem Namen des Skills entsprechen und wird klein und mit Bindestrichen geschrieben, etwa status-update oder markenrichtlinien. Eine minimale SKILL.md sieht so aus:
---
name: status-update
description: Erstellt wöchentliche Statusberichte im festen Format. Verwenden, wenn nach einem Statusbericht, Wochenupdate oder Fortschrittsbericht gefragt wird. Nicht für Projektabschlussberichte.
---
# Wöchentlicher Statusbericht
## Aufbau
1. **Erledigt** – höchstens fünf Punkte, jeweils ein Satz
2. **Geplant** – Vorhaben für die kommende Woche
3. **Hindernisse** – was blockiert und wer helfen kann
4. **Zeitplan** – eine Zeile: im Plan, gefährdet oder verzögert
## Regeln
- Sachlicher Ton, keine Ausrufezeichen
- Gesamtlänge höchstens 200 Wörter
- Fehlen Angaben, nachfragen statt erfinden
## Beispiel
Siehe [beispiel.md](beispiel.md) für einen vollständigen Bericht.
Zwischen den beiden Linien aus drei Bindestrichen steht das Frontmatter im YAML-Format. Pflicht sind laut Spezifikation name und description; Claude Code übernimmt den Namen notfalls aus dem Ordnernamen. Der Name darf höchstens 64 Zeichen lang sein und nur Kleinbuchstaben, Ziffern und Bindestriche enthalten, die Beschreibung höchstens 1.024 Zeichen. Für Uploads in claude.ai nennt das Hilfe-Center für die Beschreibung höchstens 200 Zeichen. Je nach Werkzeug gibt es weitere optionale Felder, etwa um in Claude Code festzulegen, welche Werkzeuge ein Skill nutzen darf.
Die Beschreibung entscheidet über den Einsatz
Name und Beschreibung sind das Wichtigste am ganzen Skill, denn nur sie sieht Claude, bevor es entscheidet, ob es den Skill lädt. Eine Beschreibung wie „Hilft bei Texten“ ist praktisch wertlos: Daraus geht nicht hervor, ob der Skill Texte schreibt, korrigiert, übersetzt oder zusammenfasst.
Eine gute Beschreibung sagt, was der Skill tut, nennt typische Auslöser („wenn nach einem Statusbericht gefragt wird“) und grenzt ab, wofür er nicht gedacht ist. Solche negativen Abgrenzungen helfen besonders, wenn mehrere ähnliche Skills installiert sind. Verarbeitet ein Skill CSV-Dateien, aber keine Excel-Arbeitsmappen, gehört genau das in die Beschreibung.
Anweisungen, Beispiele und Grenzen
Im Hauptteil stehen die eigentlichen Regeln. Drei Dinge wirken besonders:
- Konkrete Beispiele: Zwei fertige Texte, die alle Regeln einhalten, prägen das Ergebnis oft stärker als eine lange Liste abstrakter Vorgaben.
- Ausdrückliche Grenzen: „Höchstens 400 Zeichen“ oder „keine Ausrufezeichen“ wirken zuverlässiger als die stille Erwartung, dass Claude den Stil schon treffen wird.
- Verhalten bei Lücken: Ein Satz wie „Fehlen Angaben, nachfragen statt erfinden“ verhindert, dass Claude fehlende Informationen plausibel klingend ergänzt.
Anthropic empfiehlt in seinen Hinweisen zum Schreiben von Skills, die SKILL.md selbst kompakt zu halten (als Richtwert unter 500 Zeilen) und Ausführliches auszulagern.
Zusatzdateien und Skripte
Ergänzende Unterlagen liegen als eigene Dateien im Skill-Ordner, häufig in Unterordnern wie references/ oder scripts/. Die SKILL.md verweist per Markdown-Link darauf, und Claude öffnet sie nur, wenn es sie braucht. Ein Support-Skill könnte etwa eine Tabelle mit Produktcodes enthalten, die nur bei bestimmten Anfragen relevant ist.
Skripte gehen noch einen Schritt weiter. Ein Python- oder Bash-Skript im Skill-Ordner kann Claude ausführen, statt dessen Inhalt zu lesen. In den Kontext gelangt dann nur das Ergebnis, nicht der Code. Das ist für Aufgaben nützlich, bei denen es auf exakte Berechnungen ankommt, etwa das Prüfen von Datumsformaten in einer großen Datei. Voraussetzung ist, dass die jeweilige Umgebung Code ausführen kann.
Skills installieren: Claude-App, Claude Code und API
Wo ein Skill liegt, hängt davon ab, wie Sie Claude nutzen:
- Claude-App und claude.ai: Skills werden im Bereich „Customize“ verwaltet, eigene Skills lädt man als ZIP-Datei des Ordners hoch. Laut Hilfe-Center steht die Funktion in allen Tarifen einschließlich des kostenlosen zur Verfügung, Voraussetzung ist die aktivierte Codeausführung. In Team- und Enterprise-Konten können Administratoren Skills für die ganze Organisation bereitstellen.
- Claude Code: Persönliche Skills liegen im Home-Verzeichnis unter
~/.claude/skills/und stehen in jedem Projekt zur Verfügung. Projekt-Skills liegen im Repository unter.claude/skills/und werden mit dem Code versioniert. Wer das Repository klont, bekommt sie automatisch mit. Zusätzlich lassen sich Skills über Plugins installieren. Einen Einstieg in das Werkzeug selbst gibt der Beitrag Claude Code für Einsteiger. - API: Entwickler können Skills auch über die Claude-API nutzen, dort in Verbindung mit dem Werkzeug zur Codeausführung.
Für den Anfang genügt meist ein Ordner auf dem eigenen Rechner. Ist der Skill ausgereift, lohnt sich die Ablage im Projekt-Repository oder in der Organisation, damit alle dieselbe Fassung nutzen – also genau das Problem aus dem Eingangsbeispiel lösen.
Nach Aufgaben statt nach Themen ordnen
Ein häufiger Anfängerfehler sind Sammel-Skills nach Themen, etwa „alles zum Marketing“. Besser funktionieren Skills, die eine Frage beantworten: Was soll Claude tun, wenn jemand um Aufgabe X bittet? Statt eines großen Marketing-Skills also einen für die Markenstimme und einen für Social-Media-Beiträge.
Skills lassen sich kombinieren. Bei einer Anfrage nach einem LinkedIn-Post kann Claude beide laden, und der Social-Media-Skill kann ausdrücklich auf die Markenstimme verweisen. Kleine, klar abgegrenzte Skills sind außerdem leichter zu testen und zu pflegen.
Abläufe mit festen Schritten und Prüfpunkten
Für mehrstufige Aufgaben lohnt es sich, im Skill eine klare Abfolge mit Prüfpunkten zu beschreiben. Ein Skill zur Datenaufbereitung könnte vier Phasen vorgeben: prüfen, umwandeln, zusammenfassen, ausgeben. Entscheidend ist, was bei Problemen passiert. Eine Anweisung wie „Bestehen mehr als zehn Prozent der Zeilen die Prüfung nicht, abbrechen und nachfragen; sonst fehlerhafte Zeilen in eine eigene Datei schreiben und weitermachen“ nimmt Claude die Entscheidung ab, die sonst eigenmächtig getroffen würde.
Andere Abläufe wiederholen einen Kernschritt. Bei einem Review-Skill analysiert Claude etwa einen Text oder Code, macht Vorschläge, der Mensch wählt aus, Claude setzt um und prüft erneut. Für solche Schleifen gehört ins Skill, wann sie enden, etwa wenn zwei Durchgänge nacheinander nichts Neues finden. Weil der Kontext mit jeder Runde wächst, hilft zudem die Anweisung, den Stand nach jedem Durchgang knapp zusammenzufassen.
Wie man solche Vorgaben grundsätzlich formuliert – Ziel, Rahmen, Grenzen, Abnahmekriterien –, beschreibt der Beitrag über Spezifikationen für KI-Agenten. Dort geht es um einzelne Entwicklungsaufgaben, hier um wiederkehrende Arbeitsanleitungen.
Skills im Vergleich zu Projekten, CLAUDE.md, MCP und RAG
Skills sind nicht die einzige Möglichkeit, Claude mit eigenem Wissen zu versorgen. Die Abgrenzung hilft bei der Wahl des passenden Werkzeugs:
| Ansatz | Was es leistet | Wann geladen |
|---|---|---|
| Projekte in Claude | Dokumente und Anweisungen für einen Arbeitsbereich | in jeder Unterhaltung des Projekts, bei großen Beständen per Suche |
| CLAUDE.md in Claude Code | Dauerregeln für ein Repository | in jeder Sitzung im Projekt |
| Skills | Anleitungen für bestimmte Aufgaben | nur wenn die Aufgabe passt |
| MCP-Server | Zugriff auf externe Systeme und Daten | wenn ein Werkzeug gebraucht wird |
| RAG | Suche in großen Dokumentenbeständen | pro Anfrage, passende Ausschnitte |
Projekte und CLAUDE.md sind dauerhaft geladen. Das ist richtig für Wissen, das immer gilt, etwa die Befehle eines Repositorys. Für Anleitungen, die nur manchmal gebraucht werden, ist es Verschwendung von Kontext. Skills ergänzen diese Ansätze, sie ersetzen sie nicht.
MCP (Model Context Protocol) ist ein offenes Protokoll, über das Claude auf externe Systeme wie Slack, ein Ticketsystem oder eine Datenbank zugreift. MCP liefert den Zugang, der Skill beschreibt, was mit den Daten geschehen soll. Ein Skill „Kanal-Zusammenfassung“ könnte etwa festlegen, dass Slack-Nachrichten nach Zusagen und offenen Aufgaben gefiltert und tageweise zusammengefasst werden.
Feintuning und RAG sind deutlich aufwendiger. Beim Feintuning wird ein Modell mit eigenen Daten nachtrainiert, was Infrastruktur, Daten und erneutes Training bei jeder Änderung erfordert. Retrieval-Augmented Generation (RAG) verbindet ein Modell mit einer durchsuchbaren Wissensdatenbank und ist die richtige Wahl, wenn Tausende Dokumente im Spiel sind. Skills brauchen nichts davon: Eine geänderte Markdown-Datei wirkt beim nächsten Aufruf.
Auch gegenüber gespeicherten Prompts haben Skills einen Vorteil. Ein Prompt muss man aktiv aufrufen, einen Skill wählt Claude selbst, sobald die Beschreibung passt. In Claude Code lassen sich Skills zusätzlich gezielt per Schrägstrich-Befehl starten.
Was Skills leisten und wo Vorsicht geboten ist
Skills lösen ein unscheinbares, aber teures Problem: verstreute, veraltete Anweisungen, die jeder anders einfügt. Die Einstiegshürde ist niedrig, Programmierkenntnisse sind für einfache Skills nicht nötig. Für die meisten Teams lohnt es sich, mit zwei oder drei Skills für wirklich wiederkehrende Aufgaben anzufangen, statt sofort eine große Bibliothek aufzubauen.
Zwei Punkte werden gern übersehen. Erstens die Sicherheit: Ein Skill kann Skripte enthalten, die Claude ausführt. Skills aus fremden Quellen sollten Sie daher wie Software behandeln und vor der Installation lesen. Zweitens die Pflege: Ein Skill ist nur so gut wie sein letzter Stand. Wer ihn im Repository oder zentral in der Organisation ablegt, hat eine eindeutige Quelle und eine Änderungshistorie.
Wenn Sie KI-Assistenten und Coding-Agenten im Team einführen und dafür eigene Skills, Regeln und Arbeitsabläufe entwickeln möchten, finden Sie auf unserer Seite zu KI in der Webentwicklung Angebote für Beratung und Seminare.
Häufige Fragen zu Claude Skills
Kann Claude mehrere Skills gleichzeitig verwenden?
Ja. Passen mehrere Beschreibungen zur Anfrage, kann Claude mehrere Skills laden und ihre Regeln gemeinsam anwenden, etwa Markenstimme und Social-Media-Format. Voraussetzung sind klar formulierte Beschreibungen, damit Claude erkennt, welche Skills relevant sind.
Sind Programmierkenntnisse nötig, um einen Skill zu erstellen?
Für einfache Skills nicht. Eine SKILL.md ist eine Textdatei in Markdown, ein Texteditor genügt. Erst wenn ein Skill Skripte enthalten soll, helfen Grundkenntnisse in Python oder Bash. Anthropic bietet außerdem einen Skill, der beim Erstellen neuer Skills hilft und aus einer Beschreibung einen ersten Entwurf erzeugt.
Worin unterscheiden sich persönliche und projektbezogene Skills in Claude Code?
Persönliche Skills liegen im Home-Verzeichnis und stehen in jedem Projekt zur Verfügung, etwa für eigene Vorlieben beim Schreiben von Commit-Nachrichten. Projekt-Skills liegen im Repository, werden mit dem Code versioniert und gelten für alle, die daran arbeiten. Sie eignen sich für Team-Standards wie Review-Checklisten oder Dokumentationsvorlagen.
Kategorien
Schlagworte