Skill-Muster und Best Practices
Übliche Muster, Anti-Muster und die Gewohnheiten starker Skill-Builder
⏱ ca. ~8 Min
01 · Lesen
Jetzt, wo du weißt, wie Skills funktionieren, schauen wir uns an, welche Muster Entwickler im Alltag wirklich nutzen.
Die beliebtesten Skills fallen in einige Kategorien: - Codestil — Namenskonventionen, Formatierungsregeln und Strukturmuster durchsetzen - Code-Review — eine konsistente Checkliste für Reviews von PRs und Codeänderungen - Commit-Nachrichten — Formate wie Conventional Commits durchsetzen - Tests — am Test-Framework und den Mustern deines Projekts ausrichten - Dokumentation — standardisieren, wie Dokumentation, Kommentare und READMEs geschrieben werden
Jedes Muster folgt derselben Struktur: klare Regeln, konkrete Beispiele, eindeutiges Ausgabeformat. Wir schauen uns die zwei nützlichsten an.
Kernpunkte
- Codestil-Skills setzen Namens-, Formatierungs- und Strukturkonventionen durch
- Review-Skills liefern eine konsistente Checkliste für Code-Reviews
- Commit-Nachrichten-Skills setzen Formate wie Conventional Commits durch
- Test-Skills passen sich an die bestehenden Testmuster deines Projekts an
- Dokumentations-Skills standardisieren, wie Dokumentation geschrieben wird
02 · Code-Beispiel
Hier ist ein Skill, der durchsetzt, dass alle Commit-Nachrichten dem Conventional-Commits-Format folgen.
commit-style/SKILL.md
---
name: Commit Message Style
description: Enforces Conventional Commits format
instructions: Use when creating git commits
---
## Format
All commits must follow Conventional Commits:
```
<type>(<scope>): <description>
[optional body]
```
## Types
- `feat`: New feature
- `fix`: Bug fix
- `docs`: Documentation only
- `refactor`: Code change that neither fixes nor adds
- `test`: Adding or updating tests
- `chore`: Maintenance (dependencies, CI, build)
## Rules
- Description must be lowercase, no period at the end
- Scope is optional but encouraged
- Body should explain WHY, not WHAT (the diff shows what)
- Max 72 characters for the first line
## Examples
Good: `feat(auth): add password reset flow`
Good: `fix(api): handle null response from payment gateway`
Bad: `Fixed stuff`
Bad: `Update code`
Schau, wie explizit das ist — exaktes Format, aufgezählte Typen, Zeichenobergrenze, gute und schlechte Beispiele. Je expliziter deine Regeln, desto konsistenter sind Claudes Commits. Vage Anweisungen wie „Schreib gute Commit-Nachrichten" bringen nichts.
03 · Code-Beispiel
Hier ist ein Skill, der Claude sagt, dass er sich an die bestehenden Testkonventionen deines Projekts halten soll.
test-writer/SKILL.md
---
name: Test Writer
description: Writes tests matching project conventions
instructions: Use when writing or updating tests
---
## Conventions
- Use `describe` / `it` blocks (not `test`)
- Test file goes next to source: `Foo.ts` → `Foo.test.ts`
- Use `vi.fn()` for mocks (Vitest, not Jest)
- Arrange-Act-Assert pattern in every test
## What To Test
- Happy path first
- Error cases and edge cases
- Boundary values (0, 1, -1, empty string, null)
- Never test implementation details — test behavior
## Naming
`it('should return 404 when user not found')`
Not: `it('test user')`
Dieser Skill verweist auf das konkrete Test-Framework des Projekts (Vitest) und seine Muster (describe/it, vi.fn). Eine generische Anweisung wie „Schreib gute Tests" bringt nichts — Claude versucht ohnehin schon, gute Tests zu schreiben. Dieser Skill sagt ihm deine spezifischen Konventionen.
04 · Quiz
Merk dir: Ein Skill sollte Regeln ergänzen, die Claude von sich aus nicht kennt. Welche Anweisung unten ist explizit genug, um Claudes Verhalten tatsächlich zu verändern?
- Sei eine hilfreiche Assistenz, die guten Code schreibt
- Beim Schreiben von API-Endpoints: JSON mit camelCase-Keys zurückgeben, kebab-case-URLs verwenden, Fehlercodes aus unserer error-codes.ts-Datei nutzen
- Beim Programmieren immer Best Practices anwenden
- Code schreiben wie ein erfahrener Entwickler
05 · Ziehen zum Sortieren
Denk darüber nach, was den größten Unterschied für die Qualität eines Skills macht. Ein vager Skill ohne Beispiele ist schlechter als ein konkreter — ordne diese Praktiken vom größten zum kleinsten Einfluss.
(Diese Sektion ist interaktiv — aktiviere JavaScript, um sie zu nutzen.)
06 · Lesen
Manche Skills machen Claude tatsächlich schlechter. Folgendes solltest du vermeiden:
Zu vage: „Schreib guten, sauberen Code." Das versucht Claude ohnehin schon. Dein Skill sollte konkrete Regeln ergänzen, die Claude von sich aus nicht kennt.
Zu lang: Ein 500-Zeilen-Skill mit Regeln für jedes mögliche Szenario überlastet Claudes Kontext. Halt Skills auf einen Workflow fokussiert. Mehrere fokussierte Skills schlagen einen riesigen.
Eingebautes Verhalten duplizieren: Claude formatiert Code, schreibt Markdown und nutzt git ohnehin schon gut. Verschwend keinen Skill-Platz an Dinge, die Claude standardmäßig gut macht.
Widersprüchliche Regeln: „Immer Kommentare hinzufügen" + „Code minimal halten" sorgt für Chaos. Prüf vor dem Testen, ob deine Regeln intern konsistent sind.
Kernpunkte
- Schreib keine vagen Skills — explizit oder gar nicht
- Schreib keine riesigen Skills — ein Skill, ein fokussierter Workflow
- Duplizier nicht, was Claude standardmäßig gut macht
- Prüf deine Skills auf widersprüchliche Regeln
07 · Lesen
Du hast jetzt eine Superkraft, die die meisten Claude-Code-Nutzer nicht kennen: die Fähigkeit, Claude beizubringen, wie du genau arbeitest.
Jedes Team hat Konventionen. Jede Entwicklerin hat Vorlieben. Skills verwandeln diese ungeschriebenen Regeln in dauerhafte, teilbare und versionierte Anweisungen.
Fang klein an. Nimm das eine, was du Claude am häufigsten sagst, und mach einen Skill daraus. Teste, verfeinere, committe. Dann noch einen. Mit der Zeit wird deine Skill-Sammlung zum Kraftverstärker — jeder Skill, den du schreibst, macht Claude für deine konkrete Arbeit besser.
Der Unterschied zwischen einer generischen KI-Assistenz und einem personalisierten KI-Workflow? Skills.
Kernpunkte
- Fang mit einem Skill für die Anweisung an, die du am häufigsten wiederholst
- Iterieren: testen, verfeinern, committen
- Projekt-Skills über git teilen, damit das ganze Team profitiert
- Mit der Zeit eine Sammlung aufbauen — jeder Skill macht Claude für deine Arbeit schlauer
- Skills sind der Unterschied zwischen generischer KI-Assistenz und personalisiertem KI-Workflow
08 · Quiz
Du hast einen Skill geschrieben, der sagt: „Schreib guten, sauberen Code." Nach dem Test scheint sich Claudes Ausgabe kaum zu verändern. Warum?
- Die SKILL.md hat einen Syntaxfehler
- Skills funktionieren nur mit dem Opus-Modell
- Die Anweisung ist zu vage — Claude versucht ohnehin schon, guten Code zu schreiben
- Nach dem Hinzufügen eines Skills muss Claude Code neu gestartet werden
09 · Ausfüllen
Ein 500-Zeilen-Skill, der jedes mögliche Szenario abdeckt, ist ein Anti-Muster. Schreib stattdessen mehrere _____-Skills, die jeweils einen Workflow abdecken.
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.