Claude Code Skills: Erstellen Sie individuelle Workflows für Ihren KI-Coding-Assistenten

Claude Code wird mit einem universellen KI-Assistenten ausgeliefert. Skills ermöglichen es Ihnen, ihn zu spezialisieren. Ein Skill ist eine Markdown-Datei, die Claude Code beibringt, wie eine bestimmte Art von Aufgabe zu bewältigen ist: Deployment auf Kubernetes, Schreiben von Datenbankmigrationen, Überprüfen von Pull Requests oder Einhalten der Codierungsrichtlinien Ihres Teams.

Der Unterschied zwischen „Schreibe mir eine React-Komponente“ und „Schreibe mir eine React-Komponente, die unserem Designsystem folgt, unsere Custom Hooks verwendet, mit korrekten Fehlergrenzen und Barrierefreiheitsattributen“ ist ein Skill.

Was Skills eigentlich sind

Ein Skill ist eine Markdown-Datei in .claude/commands/ (projektbezogen) oder ~/.claude/commands/ (global). Wenn Sie /skill-name in Claude Code eingeben, wird der Inhalt der Datei als Anweisung in das Gespräch eingefügt.

.claude/
  commands/
    deploy.md          # /deploy
    review-pr.md       # /review-pr
    write-test.md      # /write-test

Das war’s. Keine spezielle Syntax, keine Kompilierung, kein SDK. Einfach Markdown, das beschreibt, wie etwas gemacht wird.

Schreiben Sie Ihren ersten Skill

Hier ein praktisches Beispiel: ein Skill, der die Commit-Message-Konventionen Ihres Teams durchsetzt.

Erstellen Sie .claude/commands/commit.md:

# Commit Workflow

## Schritte
1. Führen Sie `git diff --staged` aus, um zu sehen, was committed wird
2. Analysieren Sie die Änderungen und kategorisieren Sie sie: feat, fix, refactor, docs, test, chore
3. Schreiben Sie eine Commit-Nachricht gemäß unserer Konvention:
   - Format: `type(scope): description`
   - Scope ist der Paket- oder Modulname
   - Beschreibung im Imperativ, kleingeschrieben, ohne Punkt
   - Der Body erklärt WARUM, nicht WAS
4. Wenn Änderungen mehrere Scopes betreffen, erstellen Sie separate Commits
5. Führen Sie `git commit -m "message"` mit der generierten Nachricht aus

## Regeln
- Verwenden Sie niemals `--no-verify`, um Hooks zu umgehen
- Ändern Sie keine bereits veröffentlichten Commits
- Wenn Tests im Pre-Commit fehlschlagen, beheben Sie zuerst das Problem

## Beispiele
- `feat(billing): add stripe webhook handler`
- `fix(auth): handle expired refresh tokens`
- `refactor(api): extract rate limiter to shared package`

Jetzt gibt /commit Claude Code einen strukturierten Workflow statt einer vagen Anweisung wie „commit my changes“.

Designmuster für Skills

Das Checklisten-Muster

Ideal für Aufgaben mit mehreren Prüfschritten.

# Pre-Deploy Checkliste

Vor dem Deployment überprüfen Sie jeden Punkt:

- [ ] `pnpm typecheck` besteht
- [ ] `pnpm test` besteht
- [ ] Keine console.log-Anweisungen im Produktionscode
- [ ] Umgebungsvariablen in .env.example dokumentiert
- [ ] Datenbankmigrationen sind reversibel
- [ ] API-Änderungen sind abwärtskompatibel

Wenn eine Prüfung fehlschlägt, stoppen Sie und melden Sie das Problem. Fahren Sie nicht mit dem Deployment fort.

Das Entscheidungsbaum-Muster

Ideal für Aufgaben, bei denen die Vorgehensweise vom Kontext abhängt.

# Bugfix-Workflow

1. Reproduzieren Sie den Fehler (finden oder schreiben Sie einen fehlschlagenden Test)
2. Identifizieren Sie die Ursache:
   - Wenn es ein Typfehler ist → beheben Sie die Typdefinition an der Quelle
   - Wenn es eine Race Condition ist → fügen Sie korrektes Locking/Sequencing hinzu
   - Wenn eine Validierung fehlt → fügen Sie Schema-Validierung an der Grenze hinzu
   - Wenn es ein Logikfehler ist → beheben Sie ihn und fügen Sie einen Regressionstest hinzu
3. Verifizieren Sie, dass der Fix bestehende Tests nicht bricht
4. Schreiben Sie einen Test, der diesen Fehler hätte entdecken können

Das Template-Muster

Ideal zur Generierung konsistenter Ausgaben.

# Neuer API-Endpunkt

Erstellen Sie einen neuen API-Endpunkt gemäß unseren Konventionen:

## Dateistruktur
- Routen-Handler: `apps/api/src/routes/{resource}/{action}.ts`
- Schema: `apps/api/src/schemas/{resource}.ts`
- Test: `apps/api/src/routes/{resource}/__tests__/{action}.test.ts`

## Erforderliche Elemente
- Zod-Schema zur Request-Validierung
- Authentifizierungs-Middleware
- Rate Limiting
- Strukturierte Fehlerantworten mit errorResponse()
- Erfolgsantworten mit successResponse()
- OpenAPI-Dokumentationskommentare

Installation von Community Skills

Das Claude Code-Ökosystem verfügt über eine wachsende Bibliothek an Community Skills. Installieren Sie diese mit:

npx add-skill username/repo-name -y

Beliebte Skill-Sammlungen:

coreyhaines31/marketingskills (29 Marketing-/SEO-Skills)
hedging8563/lemondata-api-skill (LemonData API-Integration)

Installierte Skills erscheinen in ~/.claude/commands/ und funktionieren projektübergreifend.

Projekt- vs. globale Skills

Ort	Geltungsbereich	Anwendungsfall
`.claude/commands/`	Nur dieses Projekt	Projektkonventionen, Deployment-Workflows
`~/.claude/commands/`	Alle Projekte	Persönliche Präferenzen, allgemeine Werkzeuge

Projekt-Skills sollten in Ihrem Repo committed werden, damit das ganze Team davon profitiert. Globale Skills sind für persönliche Workflow-Präferenzen gedacht.

Fortgeschritten: Skills mit Hooks

Skills können Hooks referenzieren (Shell-Befehle, die bei bestimmten Ereignissen ausgeführt werden) zur automatischen Durchsetzung:

# Pre-Commit Check

Vor jedem Commit laufen automatisch folgende Hooks:
- `pre-commit`: führt typecheck + lint aus
- `post-commit`: aktualisiert das Changelog

Wenn ein Hook fehlschlägt, prüfen Sie die Fehlermeldung und beheben Sie das Problem.
Verwenden Sie nicht --no-verify, um Hooks zu umgehen.

Die Hooks selbst werden in .claude/settings.json konfiguriert:

{
  "hooks": {
    "pre-commit": "pnpm typecheck && pnpm lint-staged"
  }
}

Tipps für effektive Skills

Seien Sie spezifisch bei Dateipfaden und Namenskonventionen. „Erstelle eine Komponente“ ist vage. „Erstelle eine Komponente in src/components/ui/ mit PascalCase-Namensgebung“ ist umsetzbar.
Fügen Sie Beispiele für korrekte Ausgaben hinzu. Claude Code lernt besser aus Beispielen als aus abstrakten Regeln.
Definieren Sie, was NICHT zu tun ist. „Verwende niemals den Typ any“ ist besser durchsetzbar als „verwende passende Typen“.
Halten Sie Skills fokussiert. Ein Skill pro Workflow. Ein 200-Zeilen-Skill, der alles abdeckt, ist weniger nützlich als fünf 40-Zeilen-Skills, die jeweils eine Aufgabe gut erledigen.
Versionieren Sie Ihre Skills. Wenn sich Ihre Konventionen weiterentwickeln, aktualisieren Sie die Skills. Veraltete Skills sind schlimmer als keine, weil sie alte Muster durchsetzen.

Praxisnahe Wirkung

Teams, die Skills einsetzen, berichten von konsistenten Verbesserungen:

Code-Review-Zyklen verkürzen sich, weil Konventionen vor der Review durchgesetzt werden
Die Einarbeitungszeit sinkt, weil neue Entwickler dieselbe Anleitung wie erfahrene erhalten
Die Qualität KI-generierten Codes verbessert sich, weil die KI expliziten Kontext zu Projektstandards hat

Der Aufwand ist gering (30 Minuten, um die ersten Skills zu schreiben) und der Nutzen wächst mit jeder Interaktion.

Entwickeln Sie mit KI, geleitet von Ihren eigenen Regeln. lemondata.cc bietet die API-Infrastruktur für KI-gestützte Entwicklungstools.

Claude Code Skills: Erstellen Sie maßgeschneiderte Workflows für Ihren KI-Coding-Assistenten