Claude Code Skills: Eigene Fähigkeiten erstellen

Skills sind das Geheimrezept für produktives Arbeiten mit Claude Code. Statt bei jeder Aufgabe von vorne zu erklären, was Sie wollen, definieren Sie einmal den Workflow - und Claude führt ihn konsistent aus.

Was sind Skills?

Ein Skill ist ein wiederverwendbares Workflow-Modul. Er besteht aus:

• SKILL.md: Hauptdatei mit Anweisungen
• Templates (optional): Vorlagen für Output
• Examples (optional): Beispiele für erwartete Ergebnisse
• Scripts (optional): Ausführbare Hilfsskripte

Das Problem, das Skills lösen:

Ohne Skills:

User: Mach ein Code Review. Achte auf Security, Performance,
      unseren Code Style aus .eslintrc, teste die Edge Cases...
      [50 Zeilen Anweisungen]

Mit Skills:

User: /code-review src/auth/login.ts

Der Skill "erinnert" sich an alle Details.

Skill-Anatomie

Verzeichnisstruktur

.claude/skills/code-review/
├── SKILL.md           # Hauptanweisungen (erforderlich)
├── template.md        # Output-Template (optional)
├── examples/
│   └── sample.md      # Beispiel-Output (optional)
└── scripts/
    └── validate.sh    # Hilfsskript (optional)

SKILL.md Aufbau

---
name: code-review
description: Führt Code Reviews nach unseren Standards durch
argument-hint: [file-path]
user-invocable: true
allowed-tools: Read, Grep, Glob
model: sonnet
---

Du führst Code Reviews für unser Team durch.

## Prüfkriterien

1. **Sicherheit**: OWASP Top 10, Input Validation
2. **Performance**: N+1 Queries, unnötige Loops
3. **Code Style**: ESLint-Regeln aus .eslintrc
4. **Tests**: Edge Cases, Error Handling

## Output-Format

Erstelle einen Report mit:
- Severity (Critical/High/Medium/Low)
- Datei und Zeile
- Problem-Beschreibung
- Lösungsvorschlag

Frontmatter-Felder

Skill-Locations

Skills werden nach Priorität geladen:

Praktisches Beispiel: Code Review Skill

Schritt 1: Verzeichnis erstellen

mkdir -p .claude/skills/code-review

Schritt 2: SKILL.md schreiben

---
name: code-review
description: Führt ein Code Review nach internen Standards durch. Nutze diesen Skill bei Code-Änderungen.
argument-hint: [file-or-directory]
allowed-tools: Read, Grep, Glob
---

Du bist ein erfahrener Code Reviewer. Deine Aufgabe ist es,
Code-Qualität und Sicherheit zu gewährleisten.

## Prüfkriterien

### 1. Sicherheit (Kritisch)
- SQL Injection, XSS, CSRF
- Hardcoded Credentials
- Unsichere Deserialisierung
- Fehlende Input-Validierung

### 2. Performance (Hoch)
- N+1 Database Queries
- Unnötige Schleifen oder Rekursion
- Fehlende Indizes bei DB-Queries
- Memory Leaks

### 3. Code Quality (Medium)
- Einhaltung von .eslintrc / .prettierrc
- DRY-Prinzip
- Single Responsibility
- Aussagekräftige Namen

### 4. Testing (Medium)
- Edge Cases abgedeckt?
- Error Handling getestet?
- Mocking sinnvoll?

## Output-Format

Erstelle einen strukturierten Report:

| Severity | Datei:Zeile | Problem | Empfehlung |
|----------|-------------|---------|------------|
| ...      | ...         | ...     | ...        |

### Zusammenfassung
- X kritische Issues
- X wichtige Issues
- X Verbesserungsvorschläge

Insgesamt: [APPROVE / REQUEST CHANGES / NEEDS DISCUSSION]

Schritt 3: Testen

claude
> /code-review src/auth/

Fortgeschrittene Techniken

Dynamic Context Injection

Mit der !command`` Syntax führen Sie Shell-Commands aus, bevor der Skill-Inhalt an Claude geht:

---
name: pr-summary
description: Fasst einen Pull Request zusammen
context: fork
agent: Explore
---

## PR-Kontext

### Diff
!`gh pr diff`

### Kommentare
!`gh pr view --comments`

### Geänderte Dateien
!`gh pr diff --name-only`

## Deine Aufgabe

Erstelle eine Zusammenfassung dieses PRs...

Claude sieht dann den Output dieser Commands, nicht die Commands selbst.

String Substitutions

---
name: explain
argument-hint: [function-name]
---

Erkläre die Funktion `$ARGUMENTS` im Detail...

Skill mit Agent kombinieren

Für komplexe Recherche-Aufgaben können Sie einen Subagent nutzen:

---
name: architecture-review
description: Analysiert Architektur-Entscheidungen
context: fork
agent: Explore
allowed-tools: Read, Grep, Glob
---

Analysiere die Architektur des Projekts und erstelle einen Report...

Der Skill läuft dann in einem isolierten Kontext und belastet nicht die Haupt-Konversation.

Skills mit Hooks

Skills können eigene Hooks definieren:

---
name: safe-edit
description: Editiert Dateien mit Backup
hooks:
  PreToolUse:
    - matcher: "Edit"
      hooks:
        - type: command
          command: "cp $FILE $FILE.bak"
---

Editiere die angegebene Datei...

Skill-Ideen für Teams

1. Commit Message Generator

---
name: commit
description: Generiert Commit Messages nach Conventional Commits
---

Analysiere die staged Changes und erstelle eine Commit Message:

Format: <type>(<scope>): <description>

Types: feat, fix, docs, style, refactor, test, chore

Halte die erste Zeile unter 72 Zeichen.

2. Test Generator

---
name: generate-tests
description: Generiert Unit Tests für eine Datei
argument-hint: [file-path]
allowed-tools: Read, Write
---

Analysiere $ARGUMENTS und erstelle umfassende Unit Tests.

Nutze das Test-Framework aus package.json.
Decke ab:
- Happy Path
- Edge Cases
- Error Handling
- Boundary Conditions

3. Documentation Writer

---
name: document
description: Erstellt oder aktualisiert Dokumentation
argument-hint: [file-or-module]
---

Erstelle/aktualisiere Dokumentation für $ARGUMENTS.

Berücksichtige:
- JSDoc/TSDoc für Funktionen
- README.md für Module
- Beispiel-Code wo sinnvoll

4. PR Creator

---
name: create-pr
description: Erstellt einen Pull Request mit Beschreibung
context: fork
---

## Änderungen
!`git diff main...HEAD --stat`

## Commits
!`git log main...HEAD --oneline`

---

Erstelle einen PR mit:
- Aussagekräftigem Titel
- Beschreibung der Änderungen
- Test-Anweisungen
- Screenshots (falls UI-Änderungen)

Skills vs CLAUDE.md vs Hooks

Faustregel:

• CLAUDE.md für "wie wir hier arbeiten"
• Skills für "wiederkehrende Aufgaben"
• Hooks für "muss immer passieren"

Best Practices

1. Fokussiert halten

Ein Skill = eine Aufgabe. Lieber mehrere kleine Skills als ein Mega-Skill.

2. Gute Descriptions

Die description bestimmt, wann Claude den Skill automatisch nutzt. Seien Sie präzise:

# Schlecht
description: Hilft bei Code

# Gut
description: Führt Code Reviews nach OWASP-Standards durch.
             Nutze bei PR-Reviews und vor Deployments.

3. Beispiele mitliefern

Ein examples/ Ordner mit Beispiel-Outputs hilft Claude, das gewünschte Format zu verstehen.

4. Team-Skills dokumentieren

Führen Sie eine Liste der verfügbaren Skills in Ihrer README:

## Verfügbare Claude Code Skills

- `/code-review` - Code Review nach internen Standards
- `/commit` - Commit Message Generator
- `/document` - Dokumentation erstellen

Fazit

Skills transformieren repetitive Aufgaben in Ein-Wort-Befehle. Starten Sie mit einem Skill für Ihre häufigste Aufgabe - sei es Code Review, Commit Messages oder Dokumentation.

Mit der Zeit bauen Sie eine Bibliothek von Skills auf, die genau zu Ihrem Workflow passt.

---

Weiterführende Artikel:

• Claude Code: Der komplette Überblick - Alle Features im Überblick
• Claude Code Agents verstehen - Sub-Agenten für komplexe Aufgaben
• Claude Code Hooks konfigurieren - Event-Automatisierung
• CLAUDE.md Best Practices - Projekt-Konfiguration

Nächster Schritt: Sie möchten Skills für Ihr Entwicklungsteam erstellen? Wir helfen bei der Konzeption und Implementierung von Team-spezifischen Workflows. Mehr über unsere Entwicklungsdienstleistungen.