Custom Skills erstellen

Skills sind wiederverwendbare Prompt-Templates, die du als Slash-Commands in Claude Code nutzen kannst. Statt jedes Mal den gleichen Prompt zu formulieren, erstellst du einmal einen Skill — und rufst ihn danach mit /skill-name auf. Dieser Guide zeigt dir, wie du eigene Skills erstellst und effektiv einsetzt.

Für wen ist das?

Für Entwickler, die Claude Code regelmäßig nutzen und merken, dass sie bestimmte Aufgaben immer wieder auf die gleiche Weise erledigen. Skills standardisieren diese Workflows und sparen dir Tipparbeit.

Was lernst du?

• Was Skills sind und wie sie funktionieren
• Wo Skill-Dateien abgelegt werden
• Wie du Schritt für Schritt einen eigenen Skill erstellst
• Drei praktische Beispiele für den Alltag
• Wie du mit $ARGUMENTS dynamische Skills baust
• Den Unterschied zwischen Skills und Hooks

Wann nutzen?

• Du führst die gleiche Art von Aufgabe regelmäßig aus (Code Review, Commit Messages, Dokumentation)
• Du willst sicherstellen, dass eine Aufgabe immer nach dem gleichen Schema abläuft
• Dein Team soll einheitliche Workflows nutzen

Wann nicht?

• Für einmalige Aufgaben — da ist ein direkter Prompt schneller
• Wenn die Aufgabe jedes Mal komplett anders aussieht und sich nicht standardisieren lässt

Was sind Skills?

Skills sind Markdown-Dateien, die einen Prompt-Template enthalten. Jede Datei wird zu einem Slash-Command, den du in Claude Code aufrufen kannst. Der Dateiname bestimmt den Command-Namen:

• commit.md → /commit
• review.md → /review
• doc.md → /doc

Wenn du /commit eingibst, liest Claude Code den Inhalt von commit.md und führt den darin definierten Prompt aus — mit dem aktuellen Kontext deines Projekts.

Wo Skills abgelegt werden

Skills liegen im Verzeichnis .claude/commands/ — entweder im Projekt oder global:

• Projekt-Skills: .claude/commands/ im Projektverzeichnis — nur für dieses Projekt verfügbar, können ins Repository committed werden
• Globale Skills: ~/.claude/commands/ im Home-Verzeichnis — in jedem Projekt verfügbar

Deinen ersten Skill erstellen

Drei praktische Beispiele

/commit — Bessere Commit Messages

Datei: .claude/commands/commit.md

Analysiere alle aktuellen Änderungen (git diff --staged und unstaged).

Erstelle einen Commit mit einer Conventional Commit Message:
- Format: type(scope): beschreibung
- Types: feat, fix, refactor, docs, test, chore
- Scope: betroffenes Modul oder Feature
- Beschreibung: kurz, prägnant, auf Englisch

Wenn $ARGUMENTS angegeben ist, verwende es als Hinweis für den Scope
oder die Beschreibung.

Zeige mir die vorgeschlagene Message, bevor du den Commit erstellst.

Aufruf: /commit oder /commit login validation

/review — Code Review Checkliste

Datei: .claude/commands/review.md

Führe ein Code Review für die Datei $ARGUMENTS durch.

Prüfe diese Punkte:
1. **Lesbarkeit:** Sind Variablennamen verständlich? Gibt es unnötige Komplexität?
2. **Fehlerbehandlung:** Werden Fehlerfälle abgefangen? Gibt es fehlende try/catch?
3. **Typen:** Gibt es `any` oder fehlende Typ-Annotationen?
4. **Tests:** Gibt es Tests für die Kernlogik? Fehlen Edge Cases?
5. **Security:** Gibt es hartcodierte Secrets, SQL-Injection-Risiken oder unsanitized Input?

Gib für jeden Punkt eine Bewertung (OK / Verbesserung nötig) und konkrete Vorschläge.

Aufruf: /review src/auth/login.ts

/doc — Dokumentation generieren

Datei: .claude/commands/doc.md

Generiere Dokumentation für $ARGUMENTS.

Format:
- Kurzbeschreibung (1-2 Sätze)
- Parameter mit Typen und Beschreibung
- Rückgabewert
- Beispiel-Aufruf
- Mögliche Fehler

Schreibe die Dokumentation als JSDoc-Kommentar direkt in die Datei.
Wenn die Funktion bereits dokumentiert ist, aktualisiere die bestehende
Dokumentation.

Aufruf: /doc src/utils/formatDate.ts

Dynamische Skills mit $ARGUMENTS

Die Variable $ARGUMENTS macht Skills flexibel. Alles, was du nach dem Skill-Namen eingibst, wird als $ARGUMENTS eingesetzt:

Tipp: Formuliere deine Skills so, dass sie auch ohne $ARGUMENTS sinnvoll funktionieren. Beispiel: “Wenn $ARGUMENTS leer ist, analysiere die zuletzt geänderte Datei.”

Skills vs. Hooks

Skills und Hooks klingen ähnlich, funktionieren aber unterschiedlich:

Skills sind interaktiv — du entscheidest, wann du sie aufrufst. Hooks laufen automatisch im Hintergrund.

Mehr zum Unterschied zwischen Skills und anderen Erweiterungen findest du im Vergleich Skills vs. MCP.

Typische Fehler

• Zu komplexe Skills: Ein Skill, der 500 Wörter lang ist und 10 Dinge gleichzeitig tut, liefert unvorhersehbare Ergebnisse. Halte Skills fokussiert auf eine Aufgabe.
• $ARGUMENTS nicht nutzen: Skills ohne Variablen sind statisch und weniger nützlich. Nutze $ARGUMENTS, um Skills flexibel zu machen.
• CLAUDE.md duplizieren: Wenn eine Regel immer gelten soll, gehört sie in die CLAUDE.md, nicht in einen Skill. Skills sind für Aufgaben, die du explizit auslöst.
• Skills nicht ins Repository committen: Wenn dein Team den gleichen Skill nutzen soll, committe .claude/commands/ ins Repository.
• Keine Fehlerbehandlung: Formuliere, was der Skill tun soll, wenn $ARGUMENTS fehlt oder die Datei nicht existiert.

Mini-Übung

Erstelle einen /commit Skill, der Conventional Commit Messages generiert:

1. Erstelle das Verzeichnis .claude/commands/ in deinem Projekt
2. Erstelle die Datei .claude/commands/commit.md
3. Schreibe einen Prompt, der Claude anweist, den Diff zu analysieren und eine Conventional Commit Message zu generieren
4. Mache eine kleine Änderung an einer Datei
5. Rufe /commit auf und prüfe die generierte Message
6. Passe den Skill an, bis die Messages deinem Stil entsprechen

Nächster Schritt

Du kannst jetzt eigene Skills erstellen und wiederkehrende Aufgaben automatisieren. Entdecke weitere Möglichkeiten, Claude Code zu erweitern, unter Mit Claude bauen. Oder lies den Vergleich Skills vs. MCP, um zu verstehen, wann welche Erweiterung die richtige ist.