Bau deinen ersten Skill
Eine SKILL.md planen, schreiben und strukturieren
⏱ ca. ~7 Min
01 · Lesen
Bevor du auch nur eine Zeile schreibst, musst du einen wiederholbaren Workflow finden.
Denk daran, was du Claude Code immer wieder sagst: „Nutze Functional Components." „Schreib zuerst Tests." „Nimm Conventional Commits." „Keine Kommentare für offensichtlichen Code."
Jedes davon ist ein Skill-Kandidat. Die besten Skills fangen Workflows ein, die du jedes Mal anwendest — keine Einmal-Anfragen.
Frag dich: „Welche Anweisung gebe ich Claude Code mindestens einmal pro Woche?" Das ist dein erster Skill.
Kernpunkte
- Gute Skills fangen wiederholbare Workflows ein, keine Einmal-Aufgaben
- Denk an Anweisungen, die du in jeder Claude-Code-Session eintippst
- Fang mit einem konkreten Workflow an, nicht mit allem auf einmal
- Skills sollten Haltung haben — klare Regeln, keine vagen Vorschläge
02 · Code-Beispiel
Jede SKILL.md beginnt mit YAML-Frontmatter zwischen ----Zeilen. Unten siehst du die drei Hauptfelder.
YAML-Frontmatter
---
name: Code Reviewer
description: Reviews code for bugs, style, and best practices
instructions: Use this skill when reviewing pull requests or code changes
---
name ist der Name, unter dem der Skill in der /skill-Liste erscheint. description sagt Claude (und dir), was der Skill tut. instructions gibt Claude einen Hinweis, wann dieser Skill aktiviert werden sollte. Alle drei sind optional, aber alle drei zu setzen ist sehr empfohlen.
03 · Quiz
Du hast gerade die drei standardmäßigen YAML-Frontmatter-Felder gesehen. Welches davon ist keines?
- name
- description
- language
- instructions
04 · Schritt für Schritt
Wir bauen Schritt für Schritt einen echten Skill. Wir machen einen „Code Reviewer"-Skill, der die Review-Standards deines Teams durchsetzt.
1. Skill-Ordner anlegen
Leg die Verzeichnisstruktur in deinem Projekt an. Führ aus: mkdir -p .claude/skills/code-reviewer. Das Flag -p legt die übergeordneten Verzeichnisse an, falls sie nicht existieren. So liegt der Skill in deinem Projekt und kann ins git committet werden.
2. YAML-Frontmatter schreiben
Öffne .claude/skills/code-reviewer/SKILL.md und füg den Metadatenblock hinzu. Beginn mit einer Zeile ---, ergänze die Felder name, description und instructions und schließ mit einer weiteren ----Zeile ab.
3. Den Anweisungs-Body ergänzen
Unter dem abschließenden --- schreibst du deine Review-Regeln in natürlicher Sprache. Strukturiere die Abschnitte mit Markdown-Überschriften und liste konkrete Regeln als Bullet-Points. Sei explizit — „Prüfe Benutzereingaben auf SQL-Injection" ist viel besser als „Überprüfe den Code".
4. Mit /skill testen
Tipp /skill in einen Claude-Code-Chat und schau, ob dein neuer Skill aufgelistet ist. Wähl ihn aus, um ihn zu aktivieren. Bitte Claude jetzt, Code zu reviewen — er sollte sich an deine Regeln halten. Falls nicht, verfeiner den Skill und versuch es noch mal.
05 · Code-Beispiel
Hier ist der fertige „Code Reviewer"-Skill — eine vollständige, einsatzbereite SKILL.md.
code-reviewer/SKILL.md
---
name: Code Reviewer
description: Reviews code changes for bugs, security, and style
instructions: Use when asked to review code, PRs, or diffs
---
## Review Checklist
When reviewing code, check for:
- **Security**: SQL injection, XSS, command injection, hardcoded secrets
- **Error handling**: Are errors caught? Are they logged? Do they fail gracefully?
- **Edge cases**: What happens with empty input? Null values? Very large data?
- **Naming**: Are variables and functions named clearly?
- **Tests**: Are there tests for the new code? Do existing tests still pass?
## Output Format
Structure your review as:
1. **Summary** — one sentence overview
2. **Issues** — bullet list, severity (high/medium/low)
3. **Suggestions** — optional improvements (not blockers)
Der Body nutzt standardmäßiges Markdown — Überschriften, Fettdruck, Bullet-Points. Claude behandelt das als Anweisungen, an die er sich hält. Die Review-Checkliste sagt Claude, worauf er achten soll, und das Ausgabeformat sorgt dafür, dass jedes Review konsistent und strukturiert ist.
06 · Ausfüllen
Die YAML-Frontmatter einer SKILL.md wird von zwei _____-Zeilen umschlossen
07 · Ziehen zum Sortieren
Eine SKILL.md-Datei hat eine bestimmte Struktur. Denk daran, was Claude beim Laden des Skills zuerst liest, und ordne die Teile von oben nach unten.
(Diese Sektion ist interaktiv — aktiviere JavaScript, um sie zu nutzen.)
Andere Lektionen aus diesem Kapitel
⚠ Das volle interaktive Erlebnis braucht JavaScript. Bitte aktiviere es und lade die Seite neu.
※ Diese Seite ist ein unabhängiges Bildungsprojekt — kein offizielles Anthropic-Produkt. Claude™ ist eine eingetragene Marke von Anthropic, PBC.