Claude Code Skills — Vollständige Referenz

Was sind Skills?

Skills sind erweiterbare Befehle, die du in Claude Code erstellst und verwaltest. Mit einer SKILL.md Datei im .claude/skills/ Verzeichnis kannst du Claude neue Fähigkeiten beibringen. Claude nutzt Skills automatisch bei Bedarf oder du rufst sie manuell mit /skill-name auf.

Skills folgen dem offenen Agent Skills Standard und werden mit zusätzlichen Features erweitert: Invocation Control (wer darf Skills aufrufen), Subagent-Ausführung und dynamischer Kontext-Injektion.

SKILL.md Frontmatter — Alle Felder

Jeder Skill beginnt mit YAML Frontmatter zwischen --- Markern. Diese Tabelle dokumentiert alle verfügbaren Felder:

Frontmatter Beispiel

---
name: deep-research
description: Recherchiert ein Thema gründlich
context: fork
agent: Explore
allowed-tools: "Read, Grep, Glob"
model: sonnet
---

String Substitutionen — Dynamische Werte

Skills unterstützen String-Substitution für dynamische Werte im Skill-Content:

Substitutions-Beispiele

Mit mehreren Argumenten (indexed):

---
name: migrate-component
description: Migriert eine Komponente
---

Migriere $0 von $1 zu $2. Behalte Verhalten und Tests bei.

Aufruf: /migrate-component SearchBar React Vue → $0=SearchBar, $1=React, $2=Vue

Mit Session-Logging:

---
name: session-logger
description: Loggt Aktivität
---

Schreibe folgendes zu `logs/${CLAUDE_SESSION_ID}.log`:

$ARGUMENTS

Mit Skill-Verzeichnis:

---
name: codebase-visualizer
allowed-tools: "Bash(python *)"
---

python ${CLAUDE_SKILL_DIR}/scripts/visualize.py .

WICHTIG: ${CLAUDE_SKILL_DIR} verwenden statt hardcoded Pfade!

Dynamische Kontext-Injektion — Live-Daten

Die !`<command>` Syntax führt Shell-Commands AUS BEVOR der Skill an Claude gesendet wird. Das Output ersetzt den Placeholder:

---
name: pr-summary
description: Fasst PR-Änderungen zusammen
context: fork
agent: Explore
allowed-tools: "Bash(gh *)"
---

## Pull Request Kontext
- PR diff: !`gh pr diff`
- PR comments: !`gh pr view --comments`
- Changed files: !`gh pr diff --name-only`

## Deine Aufgabe
Fasse diesen Pull Request zusammen...

Ablauf:

1. Jeder !`<command>` wird SOFORT ausgeführt
2. Das Output ersetzt den Placeholder
3. Claude erhält die vollständig gerenderte Prompt mit echten Daten

Das ist Preprocessing, nicht etwas das Claude ausführt!

Bundled Skills — Fertig vorhanden

Claude Code enthält integrierte Skills in jeder Session:

Diese Skills sind prompt-basiert — können parallel Agents spawnen und sich an Codebase adapten.

Skill Locations — Scope und Priority

Wo du einen Skill speicherst, bestimmt Scope und Priority:

Priority-Regel: Enterprise > Personal > Project > Plugin.

Automatic Nested Discovery: Claude Code findet Skills automatisch in nested .claude/skills/ Verzeichnissen. In Monorepos: packages/frontend/.claude/skills/.

Verzeichnis-Struktur eines Skills

my-skill/
├── SKILL.md           # Main Instructions (PFLICHT)
├── template.md        # Template für Claude
├── examples/
│   └── sample.md      # Beispiel-Output
└── scripts/
    ├── main.py        # 1 Job pro Script!
    └── helpers.py     # Support Code

SKILL.md ist erforderlich. Referenziere Supporting Files damit Claude weiß wann sie zu laden sind:

## Detaillierte Dokumentation
- API-Details: [reference.md](reference.md)
- Usage-Beispiele: [examples.md](examples.md)

Tipp: SKILL.md unter 500 Zeilen halten.

Wer darf Skills aufrufen?

disable-model-invocation: true — Nur User aufrufen

Verhindert dass Claude automatisch lädt. Nutzen für Workflows mit Seiteneffekten:

---
name: deploy
description: Deploye die App zu Production
disable-model-invocation: true
---

Effekt:

• Du kannst /deploy aufrufen ✅
• Claude ruft automatisch auf ❌
• In Claude's Context ❌

user-invocable: false — Nur Claude aufrufen

Skill ist hidden. Nur Claude kann aufrufen. Für Hintergrund-Wissen:

---
name: legacy-system-context
description: Erklärt wie das alte System funktioniert
user-invocable: false
---

Effekt:

• Du kannst aufrufen ❌
• Claude ruft automatisch auf ✅
• In Claude's Context ✅

Invocation-Matrix

Tool-Zugriff limitieren — allowed-tools

Mit allowed-tools kannst du Tools restricten:

---
name: safe-reader
description: Liest Dateien ohne Änderungen
allowed-tools: "Read, Grep, Glob"
---

Claude darf NUR Read, Grep, Glob nutzen.

Best Practice: Principle of Least Privilege:

• Read-Only: Read, Grep, Glob
• Content Creation: Read, Grep, Glob, Write, Edit
• Deployment: Read, Grep, Glob, Bash

Skills in Subagents — context: fork

Mit context: fork läuft der Skill in isoliertem Subagent-Context:

---
name: deep-research
description: Recherchiert ein Thema gründlich
context: fork
agent: Explore
---

Recherchiere $ARGUMENTS gründlich:

1. Finde relevante Files
2. Lese und analysiere Code
3. Fasse Findings zusammen

Ablauf:

1. Neuer isolierter Context
2. Subagent erhält Skill-Content als Prompt
3. agent bestimmt Execution Environment
4. Results zurück zur Main-Session

Subagent-Typen:

• Explore: Codebase-Suche, Read-only, Haiku
• Plan: Forschung, Architektur, Read-only, Sonnet
• general-purpose: Voller Tool-Zugriff

Hooks in Skills — Lifecycle-Automation

Skills können Hooks definieren für bestimmte Events:

---
name: code-reviewer
description: Reviews Code mit automatischem Linting
hooks:
  PreToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "./scripts/validate-command.sh"
  PostToolUse:
    - matcher: "Edit|Write"
      hooks:
        - type: command
          command: "./scripts/run-linter.sh"
---

Hook-Events:

• PreToolUse: Bevor Claude ein Tool nutzt (Validation)
• PostToolUse: Nachdem ein Tool genutzt wurde (Cleanup)
• Stop: Wenn Skill beendet wird

Hook-Scripts bekommen Input via stdin. Exit Code 0 (OK) oder 2 (Block).

Argumente an Skills übergeben

Both du und Claude können Argumente übergeben. Verfügbar über $ARGUMENTS:

---
name: fix-issue
description: Fixt einen GitHub Issue
disable-model-invocation: true
---

Fixe GitHub Issue $ARGUMENTS nach unseren Standards.

1. Lese Issue-Description
2. Verstehe Requirements
3. Implementiere Fix
4. Schreibe Tests
5. Erstelle Commit

Aufruf: /fix-issue 123 → "Fixe GitHub Issue 123..."

Mit mehreren Argumenten:

---
name: migrate-component
---

Migriere $0 von $1 zu $2.

Aufruf: /migrate-component Button React Vue

Wenn Skill kein $ARGUMENTS enthält, werden sie automatisch angehängt.

Skill Discovery — Wann nutzt Claude Skills?

Claude kennt eure Skills durch ihre description. Je besser die Description, desto besser die Auto-Detection:

• Gut: "Erklärt Code mit Diagrammen. Nutzen wenn erklärt wird wie etwas funktioniert."
• Schlecht: "Code-Tool" (zu vage)

Claude's Skill Context hat ein Budget (2% des Context Windows, min 16KB). /context zeigt ob Descriptions excluded wurden. SLASH_COMMAND_TOOL_CHAR_BUDGET Env-Var kann Budget setzen.

Skill-Namen und Präfixe — Konventionen

Standard Präfixe helfen:

Name: kebab-case, max 64 Zeichen, eindeutig über alle Repos.

Troubleshooting

Skill triggert nicht

1. Prüfe ob Description Keywords enthält
2. Verifiziere in "What skills available?"
3. Natürlichere Formulierung versuchen
4. Direkt invoken: /skill-name

Skill triggert zu oft

1. Description präziser machen
2. disable-model-invocation: true setzen

Claude sieht nicht alle Skills

Skill-Description Budget (~16KB). Mit vielen Skills können manche excluded sein. Lösung: SLASH_COMMAND_TOOL_CHAR_BUDGET setzen.

Verwandte Features

• Sub-Agents: Tasks delegieren
• Plugins: Skills verteilen
• Memory (CLAUDE.md): Persistente Kontext
• Hooks: Workflow-Automation
• Permissions: Tool-Kontrolle

Erstellt: 2026-03-21 | Quelle: code.claude.com/docs/en/skills

Quellen und Links

• Skills Documentation
• Plugin Marketplaces
• Official Claude Code Documentation
• CLI Reference
• GitHub (Anthropic)
• Anthropic SDK Python
• Anthropic SDK TypeScript
• Claude Code Docs Index