Deploy-Routinen
Pre-Deploy-Checkliste (Tests grün, Migrations geprüft, Security-Review), Deploy-Schritte, Post-Deploy-Verifikation. Skill garantiert, dass Claude nichts überspringt.
Praxis-Guide · KI-Workflows
Claude Skills erklärt: Wiederverwendbare Workflows für Claude Code und Claude Agents
Claude Skills sind wiederverwendbare Workflows für Claude Code und Claude Agents. Sie sparen Token, garantieren reproduzierbare Qualität und ermöglichen es, Wissen einmal zu kodifizieren und beliebig oft abzurufen. Dieser Guide erklärt, wie Skills funktionieren, wie Progressive Disclosure Token spart und wie du eigene Skills erstellst.
Kurzantwort: Ein Claude Skill ist ein Ordner mit einer SKILL.md-Datei, die YAML-Frontmatter (name, description) und Anleitungstext enthält. Claude lädt beim Start nur Name und Beschreibung (Progressive Disclosure) — der volle Body wird erst geladen, wenn der Skill getriggert wird. Aufruf per /skill-name in Claude Code. Skills werden projektbezogen in .claude/skills/ oder global abgelegt. Es gibt offizielle Anthropic-Skills, verifizierte Third-Party-Skills und tausende Community-Skills im universellen SKILL.md-Format.
Was sind Claude Skills überhaupt?
Claude Skills sind wiederverwendbare Workflows, die Claude Code und Claude Agents nutzen können. Technisch ist ein Skill ein Ordner mit einer SKILL.md-Datei, die zwei Teile enthält:
- →YAML-Frontmatter mit name und description (wenige Zeilen)
- →Anleitungstext: Was soll Claude tun, in welcher Reihenfolge, mit welchen Validierungskriterien
Skills werden per Slash-Command aufgerufen (/skill-name in Claude Code) und können Scripts oder Ressourcen im selben Ordner referenzieren. Sie ermöglichen reproduzierbare Workflows: Deploy-Checklisten, Code-Review-Guides, wiederkehrende Feature-Patterns.
SKILL.md-Anatomie: So ist ein Skill aufgebaut
Ein Skill besteht aus YAML-Frontmatter (name, description) und Anleitungstext. Hier ein generisches Beispiel für eine Deploy-Checkliste:
---
name: deploy-checklist
description: Pre-Deploy-Checkliste für sichere Produktiv-Deployments
---
# Deploy-Checkliste
Führe diese Schritte vor jedem Produktiv-Deployment aus:
1. **Tests grün**: `make test` → alle Tests grün (Ausgabe zeigen)
2. **Lint clean**: `make lint` → 0 Fehler
3. **Migrations geprüft**: upgrade + downgrade getestet
4. **Security-Review**: Security-Checkliste abgearbeitet
5. **DoD erfüllt**: alle Features vollständig implementiert
6. **Projektstand aktualisiert**: PROJEKTSTAND.md reflektiert Live-Stand
Erst nach allen grünen Checks: Deployment starten.Das Frontmatter (name, description) wird beim Start geladen. Der Body (die eigentliche Anleitung) wird erst geladen, wenn der Skill getriggert wird — das ist Progressive Disclosure.
Progressive Disclosure: Warum Skills Token sparen
Progressive Disclosure ist das Prinzip, dass Claude beim Start nur Name und Beschreibung jedes Skills lädt (wenige Dutzend Tokens pro Skill). Der vollständige SKILL.md-Body wird erst geladen, wenn der Skill relevant wird oder explizit per /skill-name getriggert wird.
Vorteil: Du kannst hunderte Skills vorhalten, ohne das Kontext-Fenster zu sprengen. Claude lädt nur das, was für die aktuelle Aufgabe gebraucht wird. Mehrere Skills können auch in einem Workflow nacheinander aktiv werden.
Konkretes Beispiel:
- →50 Skills im Projekt, je 30 Tokens für name + description = 1.500 Tokens beim Start
- →Durchschnittlicher Skill-Body: 800 Tokens. Ohne Progressive Disclosure: 50 × 800 = 40.000 Tokens — ständig geladen
- →Mit Progressive Disclosure: 1.500 Tokens + nur die 2-3 aktiven Skill-Bodies (2.400 Tokens) = 3.900 Tokens statt 40.000
Eigenen Skill in 4 Schritten erstellen
So erstellst du einen eigenen Claude Skill für reproduzierbare Workflows:
- 01
Ordner anlegen
Erstelle einen Ordner mit einem sprechenden Namen in .claude/skills/ deines Projekts (projektbezogen) oder in deinem globalen Skills-Verzeichnis. Beispiel: .claude/skills/deploy-checklist/
- 02
SKILL.md erstellen
Lege eine SKILL.md-Datei im Ordner an. Diese enthält YAML-Frontmatter (name, description) und den Anleitungstext. Claude lädt beim Start nur Name und Description (Progressive Disclosure) — der volle Body wird erst geladen, wenn der Skill getriggert wird.
- 03
Anleitung formulieren
Schreibe die Anleitung so, dass Claude sie selbstständig umsetzen kann: klare Schritte, Validierungskriterien, Beispiel-Befehle, DoD. Skills können auch Scripts oder Ressourcen im selben Ordner referenzieren.
- 04
Skill aktivieren und testen
Rufe den Skill per /skill-name in Claude Code auf. Prüfe, ob Claude die Anleitung korrekt befolgt. Iteriere die Formulierung, bis der Workflow reproduzierbar funktioniert. Skills können auch von anderen Skills oder Workflows getriggert werden.
Skills können auch über npx skills add <owner>/<repo> aus Repositories installiert werden. Für projektbezogene Skills: ins Repo committen, damit das Team sie nutzen kann.
Skills vs. CLAUDE.md vs. Subagenten
Claude Code bietet drei Mechanismen für Kontext und Workflows. Hier die klare Abgrenzung:
| Typ | Zweck | Geladen | Beispiel |
|---|---|---|---|
| CLAUDE.md | Projektweite Regeln und Kontext | Immer beim Start | Stack-Info, Coding-Rules, DoD, Orchestrierung |
| Skill (SKILL.md) | Wiederverwendbare Workflows | On-demand wenn getriggert | Deploy-Checkliste, Code-Review-Guide, DB-Migration-Workflow |
| Subagent | Spezialisierte Task-Ausführung | On-demand via Spawn | Backend-Developer, Security-Reviewer, QA-Engineer |
Faustregel: CLAUDE.md = projektweite Regeln (immer aktiv), Skill = abrufbare Workflow-Anleitung (on-demand), Subagent = spezialisierte Task-Ausführung (on-demand via Spawn).
Praxis-Einsatzfälle für Claude Skills
Diese vier Use-Cases sehen wir regelmäßig in der deutschsprachigen Community:
Code-Review-Checklisten
Systematische Code-Quality-Prüfung: Security-Checks, Performance-Kriterien, Test-Coverage, DoD-Compliance. Wiederholbar für jedes Feature.
Wiederkehrende Workflows
Neuen API-Endpoint anlegen (Pydantic-Schema, Auth, Ownership, Error-Handling, Tests), React-Komponente mit allen States, DB-Migration mit upgrade/downgrade.
Onboarding neuer Entwickler
Skill-basierte Setup-Guides für neue Team-Mitglieder: Environment-Setup, lokale DB, MCP-Server-Konfiguration, erste eigene Feature implementieren.
Skills im Ökosystem
Stand März 2026 gibt es drei Kategorien: Offizielle Anthropic-Skills (z.B. für Supabase, WorkOS, HeyGen), verifizierte Third-Party-Skills von Anbietern und tausende Community-Skills im universellen SKILL.md-Format. Skills existieren für Claude Code (CLI, Desktop, Web, IDE-Extensions) und für Claude Agents allgemein.
Skills in der FlowKI-Community
Im FlowKI Discord teilen wir Skills speziell für deutsche Stacks: Next.js, FastAPI, Django, Supabase, Postgres. Skills werden als Gists oder Repos geteilt und können direkt installiert oder an den eigenen Stack angepasst werden.
Skills in der deutschsprachigen Community austauschen
Die offizielle Dokumentation ist auf Englisch. Im FlowKI Discord bekommst du deutschsprachigen Support, fertige Skills für gängige Stacks und kannst deine eigenen Skills mit der Community teilen. Skills werden als Gists, Repos oder direkte SKILL.md-Snippets geteilt.
Häufige Fragen
Was ist ein Claude Skill?
Ein Claude Skill ist ein wiederverwendbarer Workflow für Claude Code und Claude Agents. Technisch ist es ein Ordner mit einer SKILL.md-Datei, die YAML-Frontmatter (name, description) und Anleitungstext enthält. Skills können auch Scripts oder Ressourcen im selben Ordner enthalten. Sie werden per Slash-Command /skill-name aufgerufen.
Was ist Progressive Disclosure bei Skills?
Progressive Disclosure ist das Prinzip, dass Claude beim Start nur Name und Beschreibung jedes Skills lädt (wenige Dutzend Tokens pro Skill). Der vollständige SKILL.md-Body wird erst geladen, wenn der Skill relevant wird oder explizit getriggert wird. Das spart Kontext-Tokens und ermöglicht, hunderte Skills vorzuhalten, ohne das Kontext-Fenster zu sprengen.
Skills vs. CLAUDE.md — was ist der Unterschied?
CLAUDE.md enthält projektweite Regeln, die Claude immer beim Start lädt: Stack-Info, Coding-Rules, DoD, Orchestrierung. Skills sind abrufbare Spezial-Anleitungen, die nur geladen werden, wenn sie gebraucht werden: Deploy-Checklisten, Code-Review-Guides, wiederkehrende Workflows. CLAUDE.md = immer aktiv, Skill = on-demand.
Wo finde ich fertige Claude Skills?
Es gibt drei Kategorien: Offizielle Anthropic-Skills (z.B. für Supabase, WorkOS, HeyGen), verifizierte Third-Party-Skills von Anbietern und tausende Community-Skills im universellen SKILL.md-Format. Installation oft per npx skills add <owner>/<repo>. Die deutschsprachige FlowKI-Community teilt Skills speziell für deutsche Stacks.
Kann ich Skills mit meinem Team teilen?
Ja. Skills im Projekt-Ordner (.claude/skills/) werden mit dem Repo geteilt und sind für alle Team-Mitglieder verfügbar. Globale Skills (außerhalb des Projekts) bleiben lokal. Für Team-weite Workflows: Skills ins Repo committen.
Skills vs. Subagenten — wann nutze ich was?
Skills sind Anleitungen — Claude Code führt den Workflow selbst aus. Subagenten sind spezialisierte eigenständige Agents, die eine Task übernehmen und zurückmelden (z.B. Backend-Developer, Security-Reviewer). Faustregel: Für reproduzierbare Schritt-für-Schritt-Workflows → Skill. Für spezialisierte Analyse oder Implementierung → Subagent.
Funktionieren Skills nur in Claude Code?
Nein. Skills existieren für Claude Code (CLI, Desktop, Web, IDE-Extensions) und für Claude Agents allgemein (Agent Skills). Das SKILL.md-Format ist universell. Ein Skill kann in verschiedenen Kontexten wiederverwendet werden.