Claude Skills erstellen: Anleitung mit Beispielen

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?

Claude Skills sind wiederverwendbare Anleitungen, die Claude nur dann lädt, wenn eine Aufgabe dazu passt. Ein Skill ist ein Ordner mit einer SKILL.md-Datei: oben Name und Beschreibung, darunter die Arbeitsschritte in normalem Text. Anhand der Beschreibung erkennt Claude selbst, wann der Skill gebraucht wird, und erledigt die Aufgabe jedes Mal nach denselben Vorgaben. Das funktioniert in Claude.ai, in der Desktop-App und in Claude Code.

Im Detail besteht ein Skill 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.

Skills folgen dem offenen Agent-Skills-Standard, funktionieren also auch ausserhalb von Claude Code. Claude Code erweitert den Standard um eigene Features: Invocation-Kontrolle, Ausführung im Subagent und dynamische Kontext-Injektion.

Skills in Claude.ai, Desktop-App und Claude Code

Skills sind kein reines Entwickler-Feature. Dasselbe Format läuft in allen Claude-Oberflächen, nur der Weg hinein ist ein anderer:

Skills sind in allen Plänen verfügbar, von Free bis Enterprise. In Team- und Enterprise-Organisationen lassen sich Skills zudem mit einzelnen Personen, Gruppen oder der ganzen Organisation teilen; Änderungen kommen bei allen automatisch an.

Praktisch: Wer sich in Claude Code mit dem Claude.ai-Konto anmeldet, bekommt die dort hinterlegten Skills automatisch ins Terminal. Claude Code lädt sie beim Session-Start nach ~/.claude/skills/synced/ und prüft etwa alle zehn Minuten auf Änderungen. Mit "syncClaudeAiSkills": false in den Settings schalten Sie das ab.

Der Rest dieses Artikels zeigt die Details anhand von Claude Code, weil dort am meisten konfigurierbar ist. Aufbau und Inhalt der SKILL.md gelten aber überall.

Custom Commands sind Skills geworden

Wer Claude Code länger nutzt, kennt die Custom Commands unter .claude/commands/. Diese sind inzwischen in Skills aufgegangen:

• .claude/commands/deploy.md und .claude/skills/deploy/SKILL.md erzeugen beide /deploy
• Beide verhalten sich identisch und unterstützen dasselbe Frontmatter
• Bestehende Command-Dateien funktionieren unverändert weiter

Bei Namensgleichheit gewinnt der Skill. Für alles Neue sind Skills die bessere Wahl, weil sie ein eigenes Verzeichnis für Templates und Scripts mitbringen und von Claude automatisch geladen werden können.

Bundled Skills

Claude Code bringt eine Reihe eigener Skills mit, unter anderem /doctor, /code-review, /debug, /batch und /loop. Seit v2.1.215 sind /verify und /code-review nur noch manuell per Slash-Command aufrufbar (kein Auto-Loading mehr). Drei weitere arbeiten zusammen, um Änderungen an der laufenden Anwendung zu prüfen statt nur an Tests:

/run-skill-generator bringt Ihr Projekt einmal aus einer sauberen Umgebung zum Laufen und schreibt das Rezept als projekteigenen Skill nach .claude/skills/run-<name>/. Danach folgen alle Agenten im Repository denselben Schritten, statt sie jedes Mal neu zu erraten.

Einen eigenen Skill mit gleichem Namen legen Sie einfach unter .claude/skills/ ab – er ersetzt den mitgelieferten.

Skills hinzufügen und installieren

Sie müssen nicht jeden Skill selbst schreiben. Es gibt drei Wege, fertige Skills zu übernehmen:

1. Claude.ai und Desktop-App: ZIP hochladen

1. Unter Einstellungen → Funktionen die Option «Code-Ausführung und Dateierstellung» aktivieren – ohne sie laufen Skills nicht.
2. Anpassen → Skills öffnen und auf Hinzufügen klicken.
3. Den Skill-Ordner als ZIP-Datei hochladen.

Zwei typische Fehlerquellen: Im ZIP fehlt die SKILL.md, oder der Ordnername stimmt nicht mit dem name im Frontmatter überein. In Team- und Enterprise-Plänen muss ein Admin Skills zuerst in den Organisationseinstellungen freischalten.

2. Claude Code: Ordner kopieren

# Für alle Ihre Projekte
cp -r code-review ~/.claude/skills/

# Nur für dieses Projekt (committen = mit dem Team teilen)
cp -r code-review .claude/skills/

3. Claude Code: Plugin installieren

Plugins bündeln mehrere Skills und lassen sich mit einem Befehl installieren und aktualisieren:

/plugin marketplace add anthropics/claude-plugins-official
/plugin install skill-creator@claude-plugins-official

Plugin-Skills erscheinen mit Namensraum, also etwa /skill-creator:skill-creator.

Welche Skills gerade aktiv sind, woher sie stammen und wie viele Tokens ihre Beschreibung kostet, zeigt das /skills-Menu:

Vorsicht bei fremden Skills: Ein Skill kann Scripts enthalten und Shell-Befehle ausführen. Lesen Sie SKILL.md und den scripts/-Ordner, bevor Sie etwas aus dem Internet installieren – genau wie bei jeder anderen Software.

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

Alle Felder sind optional. Empfohlen ist lediglich description, damit Claude weiss, wann der Skill passt.

Boolesche Felder akzeptieren neben true/false auch yes, no, on, off, 1 und 0.

Skill-Locations

Wo ein Skill liegt, bestimmt, wer ihn nutzen kann:

Bei gleichem Namen überschreibt Enterprise die persönliche Ebene, und die persönliche das Projekt. Jede dieser Ebenen ersetzt zudem einen gleichnamigen Bundled Skill. Plugin-Skills laufen unter einem eigenen Namensraum (plugin-name:skill-name) und kollidieren deshalb nie mit den anderen Ebenen.

Monorepos: Skills werden auch aus verschachtelten .claude/skills/-Verzeichnissen geladen, sobald Claude eine Datei in dem Unterverzeichnis liest oder bearbeitet. Bei Namensgleichheit bekommt die verschachtelte Variante einen qualifizierten Namen wie /apps/web:deploy, und Claude wählt die Variante, die zu den bearbeiteten Dateien passt.

Live-Änderungen: Neue oder geänderte SKILL.md-Dateien greifen ohne Neustart. Nur wenn Sie ein Skills-Verzeichnis komplett neu anlegen, das beim Session-Start noch nicht existierte, ist ein Neustart nötig.

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 Syntax !`command` 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
allowed-tools: Bash(gh *)
---

## 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.

Zwei Details zur Syntax: Das Ausrufezeichen wird nur erkannt, wenn es am Zeilenanfang oder direkt nach einem Leerzeichen steht. Steht ein anderes Zeichen davor, etwa bei einer Zuweisung wie KEY=, bleibt der Ausdruck literaler Text und der Befehl läuft nicht. Und für mehrzeilige Befehle nutzen Sie einen Code-Block, der mit ```! geöffnet wird:

## Umgebung
```!
node --version
npm --version
git status --short
```

In Managed Settings lässt sich diese Ausführung übrigens mit "disableSkillShellExecution": true organisationsweit abschalten.

String Substitutions

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

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

${CLAUDE_SKILL_DIR} ist in der Praxis besonders nützlich, weil es auch in allowed-tools ersetzt wird. So läuft ein mitgeliefertes Script ohne Permission-Prompt, egal ob der Skill persönlich, im Projekt oder in einem Plugin installiert ist:

---
name: render-chart
description: Rendert ein Diagramm aus einer CSV-Datei
allowed-tools: Bash(${CLAUDE_SKILL_DIR}/scripts/render.sh *)
---

Führe `${CLAUDE_SKILL_DIR}/scripts/render.sh <csv-datei>` aus.

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.

Der geforkte Subagent läuft standardmässig im Hintergrund: Sie arbeiten weiter, das Ergebnis kommt an, sobald es fertig ist. Wenn Sie im selben Turn auf das Resultat warten wollen, setzen Sie background: false (Claude Code ≥ v2.1.218). Zwei Dinge sind dabei zu beachten: Ein Hintergrund-Fork hat einen eingeschränkteren Tool-Satz, und seine Datei-Änderungen liegen ausserhalb der Session-Checkpoints – /rewind macht sie nicht rückgängig, dafür brauchen Sie Git.

context: fork ergibt nur bei Skills mit konkretem Auftrag Sinn. Ein Skill, der reine Richtlinien enthält ("nutze diese API-Konventionen"), gibt dem Subagenten nichts zu tun.

Skills mit Hooks

Skills können eigene Hooks definieren, die nur laufen, solange der Skill aktiv ist:

---
name: safe-edit
description: Editiert Dateien mit Backup
hooks:
  PreToolUse:
    - matcher: "Edit"
      hooks:
        - type: command
          command: "${CLAUDE_PROJECT_DIR}/.claude/hooks/backup.sh"
---

Editiere die angegebene Datei...

Das Hook-Script erhält die Details des Tool-Aufrufs als JSON über stdin – es gibt keine Variablen wie $FILE im Command-String. Der Pfad der zu bearbeitenden Datei steht in tool_input.file_path:

#!/bin/bash
# .claude/hooks/backup.sh
FILE=$(jq -r '.tool_input.file_path')
[ -f "$FILE" ] && cp "$FILE" "$FILE.bak"

Claude Skills Beispiele: Ideen für Teams

Die folgenden Beispiele sind bewusst kurz gehalten und lassen sich direkt kopieren. Die ersten vier richten sich an Entwicklungsteams, das fünfte zeigt einen Skill ganz ohne Code.

1. Commit Message Generator

---
name: commit
description: Generiert Commit Messages nach Conventional Commits
disable-model-invocation: true
allowed-tools: Bash(git add *) Bash(git commit *) Bash(git status *)
---

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
disable-model-invocation: true
---

## Ä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)

5. Offerten-Entwurf auf Deutsch (ohne Code)

Skills müssen weder englisch noch technisch sein. Dieser Skill läuft genauso in Claude.ai oder der Desktop-App:

---
name: offerte-entwurf
description: Erstellt einen Offerten-Entwurf aus Gesprächsnotizen. Nutze diesen Skill, wenn nach Offerte, Angebot oder Kostenvoranschlag gefragt wird.
---

Erstelle aus den Notizen einen Offerten-Entwurf.

## Regeln
- Schweizer Rechtschreibung (ss statt ß), Anrede "Sie"
- Beträge in CHF, exkl. MwSt. ausweisen, MwSt. separat
- Aufbau: Ausgangslage, Leistungsumfang, Nicht enthalten,
  Termine, Preis, Gültigkeit (30 Tage)
- Fehlende Angaben nicht erfinden, sondern am Ende
  unter "Offene Punkte" auflisten

Entscheidend ist die description: Sie enthält die Wörter, die im Alltag tatsächlich fallen ("Offerte", "Angebot", "Kostenvoranschlag"). Schreiben Sie deutsch mit Claude, gehört auch die Beschreibung auf Deutsch.

Fertige Skills, die sich lohnen

Behandeln Sie fertige Skills als Startpunkt. Der grösste Nutzen entsteht, wenn ein Skill Ihre eigenen Standards, Vorlagen und Formulierungen kennt.

Anweisungen, Skills oder Hooks?

Wer nach "Anweisungen für Claude" sucht, meint meist die dauerhaften Vorgaben: die persönlichen Präferenzen in den Claude.ai-Einstellungen, Projektanweisungen oder in Claude Code die CLAUDE.md. Skills ersetzen diese nicht, sie ergänzen sie.

Faustregel:

• Anweisungen für "wie hier gearbeitet wird"
• Skills für "wiederkehrende Aufgaben"
• Hooks für "muss immer passieren"

Ein Beispiel für die Trennung: "Antworte in Schweizer Rechtschreibung und fasse dich kurz" ist eine Anweisung, denn sie gilt für jede Unterhaltung. "So wird eine Offerte aufgebaut" ist ein Skill, denn die zwanzig Zeilen dazu braucht Claude nur, wenn tatsächlich eine Offerte ansteht. Landet alles in den Anweisungen, zahlen Sie die Tokens bei jeder Nachricht und verwässern die wichtigen Regeln.

Was passiert mit dem Skill-Inhalt?

Ein Punkt, der in der Praxis oft überrascht: Wird ein Skill aufgerufen, landet sein gerenderter Inhalt als Nachricht in der Konversation und bleibt dort für den Rest der Session. Claude Code liest die Datei nicht bei jedem Turn neu ein.

Daraus folgen drei praktische Konsequenzen:

1. Jede Zeile kostet dauerhaft Tokens. Halten Sie den Body knapp – schreiben Sie, was zu tun ist, nicht warum. Ausführliches Referenzmaterial gehört in separate Dateien im Skill-Verzeichnis, die Claude nur bei Bedarf liest.
2. Formulieren Sie Anweisungen als Dauerregeln, nicht als einmalige Schritte, wenn sie über die ganze Aufgabe gelten sollen.
3. Der allowed-tools-Zugriff ist die Ausnahme: Er gilt nur für den auslösenden Turn und verfällt mit Ihrer nächsten Nachricht, auch wenn der Skill-Inhalt im Kontext bleibt.

Wenn ein Skill nach der ersten Antwort scheinbar keine Wirkung mehr hat, ist der Inhalt meist noch da – Claude wählt nur andere Wege. Dann hilft eine präzisere description, ein Hook für hartes Durchsetzen, oder ein erneuter Aufruf nach einer Kontext-Komprimierung.

Best Practices

1. Fokussiert halten

Ein Skill = eine Aufgabe. Lieber mehrere kleine Skills als ein Mega-Skill. Als Faustregel: SKILL.md unter 500 Zeilen halten.

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.

Setzen Sie den wichtigsten Anwendungsfall nach vorne. Claude Code lädt eine Liste aller Skill-Namen und -Beschreibungen in den Kontext, und diese Liste hat ein Zeichenbudget. Bei vielen Skills werden Beschreibungen gekürzt – zuerst bei den selten genutzten. Pro Skill ist zudem bei 1536 Zeichen für description und when_to_use zusammen Schluss. /doctor zeigt Ihnen, wie viel Kontext die Liste kostet und welche Skills die grössten Posten sind.

Wer Trigger-Formulierungen sauber trennen will, nutzt zusätzlich when_to_use:

description: Führt Code Reviews nach OWASP-Standards durch.
when_to_use: Bei PR-Reviews, vor Deployments, wenn nach Sicherheitslücken gefragt wird.

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

5. Sichtbarkeit ohne Datei-Änderung steuern

Bei Skills aus einem geteilten Repository wollen Sie die SKILL.md oft nicht anfassen. Dafür gibt es die Einstellung skillOverrides, die das /skills-Menu für Sie schreibt:

{
  "skillOverrides": {
    "legacy-context": "name-only",
    "deploy": "off"
  }
}

Vier Zustände sind möglich: on (Standard), name-only (nur der Name wird Claude gezeigt), user-invocable-only (nur im / Menu sichtbar) und off (komplett versteckt).

6. Wirkung messen statt vermuten

Dass ein Skill auslöst, heisst noch nicht, dass er das Richtige tut. Der belastbare Test ist ein Vergleich: dieselbe Aufgabe je einmal in einer frischen Session mit und ohne Skill. Frisch deshalb, weil Kontext aus dem Entwickeln des Skills Lücken in den Anweisungen überdeckt.

Das offizielle skill-creator-Plugin automatisiert diesen Vergleich – inklusive Trefferquote der description und A/B-Test zwischen zwei Skill-Versionen:

/plugin install skill-creator@claude-plugins-official

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

Sie möchten Skills für Ihr Entwicklungsteam erstellen? Hedinger-Digital unterstützt bei der Konzeption und Implementierung von Team-spezifischen Workflows - Softwareentwicklung bei Hedinger-Digital. Geht es um den KI-Einsatz über die Entwicklung hinaus, ist die KI-Beratung für KMU der passende Einstieg.