Claude Code Skills: Leitfaden

Claude Code Skills erstellen und nutzen: Aufbau der SKILL.md, Frontmatter, Speicherorte, automatischer Aufruf und /skill-name (2026).

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

Zuletzt überprüft: 2026-10-20 · 📄 Gemäß offizieller Dokumentation (Claude Code Skills)

Ein Skill ist eine SKILL.md-Datei: YAML-Frontmatter zwischen ----Markern sagt Claude, wann der Skill greift, darunter folgen Markdown-Anweisungen für die Ausführung. Claude lädt Skills automatisch, wenn sie relevant sind; direkt aufrufen lassen sie sich mit /skill-name.

Skills sind Komponenten der Wissensebene in Claude Code, die Claude fachspezifisches Know-how und Orientierung bereitstellen. Claude lädt sie automatisch, wenn sie relevant sind; direkt aufrufen lassen sie sich mit /skill-name.

Was sind Skills?¶

Skills sind professionelle Wissensmodule, die in SKILL.md-Dateien gespeichert werden:

• Automatische Aktivierung: Claude verwendet passende Skills automatisch anhand des Aufgabenkontexts

• Fachwissen: Liefert Best Practices und Orientierung für bestimmte Fachgebiete

• Erweiterbar: Erstellen Sie eigene Skills, um spezifische Anforderungen abzudecken

• Kontextbewusst: Wird nur in relevanten Szenarien aufgerufen

Skills vs. Befehle vs. Agents¶

Skills, Befehle und CLAUDE.md (geprüft am 2026-10-20)¶

Claude Code Skills folgen dem offenen Agent-Skills-Standard, der in mehreren KI-Werkzeugen funktioniert. Eigene Befehle sind in Skills aufgegangen: Eine Datei unter .claude/commands/deploy.md und ein Skill unter .claude/skills/deploy/SKILL.md erzeugen beide /deploy und verhalten sich gleich. Anders als Inhalte in CLAUDE.md wird der Skill-Text erst bei der Verwendung geladen, daher kostet umfangreiches Referenzmaterial fast nichts, solange Sie es nicht brauchen.

Integrierte Skills verwenden¶

Claude-Code-Plugins enthalten in der Regel mehrere integrierte Skills. Wenn Ihre Aufgabe zur Beschreibung eines Skills passt, verwendet Claude diesen automatisch.

Claude Code enthält außerdem gebündelte Skills (bundled skills), zum Beispiel /doctor, /code-review, /batch, /debug, /loop und /claude-api (geprüft am 2026-10-20). Diese Skills rufen Sie wie jeden anderen Skill auf: / eingeben und den Skill-Namen anhängen.

Beispiel: Code-Review¶

Wenn Sie sagen „Helfen Sie mir bitte, diesen Code auf Sicherheitsprobleme zu prüfen“, wendet Claude automatisch das Wissen des entsprechenden Skills für die Prüfung an, sofern ein Plugin mit einem Skill für Sicherheitsprüfungen installiert ist.

Verfügbare Skills anzeigen¶

Skills werden in der Regel mit Plugins installiert:

# Install plugin (plugins may contain multiple Skills)
/plugin install plugin-name@marketplace

Eigene Skills erstellen¶

Grundstruktur¶

Der einfachste Skill benötigt nur eine SKILL.md-Datei:

my-skill/
└── SKILL.md

Format der SKILL.md¶

---
name: Code Style Guide
description: Use this skill when the user asks about "code style", "naming conventions", "code formatting", or discusses coding standards
---

# Code Style Guide

## Naming Conventions

- Variables use camelCase
- Constants use UPPER_SNAKE_CASE
- Classes use PascalCase
- Private members use underscore prefix

## Formatting Rules

- Use 2 spaces for indentation
- Line width should not exceed 80 characters
- Use trailing commas

## Best Practices

- Functions should have single responsibility
- Avoid deep nesting
- Use meaningful variable names

Frontmatter-Felder¶

Alle Felder sind optional. Empfohlen wird nur description, damit Claude weiß, wann der Skill zum Einsatz kommt; name darf entfallen und übernimmt standardmäßig den Verzeichnisnamen. Ein Feldname muss exakt mit der offiziellen Frontmatter-Referenz übereinstimmen, Bindestriche eingeschlossen (die Tabelle unten nennt nur gängige Felder; offiziell gibt es u. a. auch model, effort, hooks, user-invocable): Claude Code ignoriert unbekannte Felder, ohne einen Fehler zu melden (geprüft am 2026-10-20).

version gehört nicht zu dieser Tabelle: Claude Code ignoriert unbekannte Felder, ohne einen Fehler zu melden (geprüft am 2026-10-20).

Wirksame Beschreibungen verfassen¶

Das Feld „description“ bestimmt, wann ein Skill aktiviert wird, und sollte konkrete Auslösephrasen enthalten:

Gutes Beispiel:

description: Use this skill when the user asks to "create a hook", "add a PreToolUse hook", "validate tool use", or mentions hook events

Schlechtes Beispiel:

description: Guide about hooks  # Too vague

Vollständige Skill-Struktur¶

Für komplexe Skills können Sie weitere Ressourcen einbinden:

my-skill/
├── SKILL.md           # Main knowledge document
├── references/        # Detailed references
│   ├── patterns.md    # Design patterns
│   └── advanced.md    # Advanced techniques
├── examples/          # Example code
│   ├── basic.ts       # Basic example
│   └── advanced.ts    # Advanced example
└── scripts/           # Helper scripts
    └── validate.sh    # Validation script

Ressourcen referenzieren¶

Verweisen Sie in der SKILL.md auf weitere Ressourcen:

---
name: API Development Guide
description: Use when the user asks about "API design", "REST interfaces", "API best practices"
---

# API Development Guide

See @references/patterns.md for detailed API design patterns

## Quick Example

See @examples/basic.ts for basic usage

Dynamische Kontext-Injektion¶

Eine Zeile wie !`git diff HEAD` nutzt dynamische Kontext-Injektion: Claude Code führt den Befehl aus und ersetzt die Zeile durch seine Ausgabe, bevor Claude den Skill-Inhalt sieht; die Anweisungen kommen also mit bereits eingefügtem aktuellem Diff an (geprüft am 2026-10-20).

Wo Skills liegen¶

• Persönliche Skills liegen in ~/.claude/skills/<skill-name>/SKILL.md.
• Projekt-Skills liegen im Repository unter .claude/skills/<skill-name>/SKILL.md.
• Plugin-Skills liegen im Plugin unter <plugin>/skills/<skill-name>/SKILL.md.

Skills in Plugins verwenden¶

Verzeichnisstruktur¶

Skills gehören in das Verzeichnis skills/ des Plugins:

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── commands/          # Command layer
├── agents/            # Agent layer
└── skills/            # Knowledge layer
    ├── code-style/
    │   └── SKILL.md
    └── api-docs/
        ├── SKILL.md
        └── references/

Skills in Befehlen referenzieren¶

Befehle können explizit auf Skill-Wissen verweisen:

---
description: Generate standards-compliant API documentation
argument-hint: [api-file]
---

Generate API documentation for @$1.

Use the api-docs skill to ensure documentation includes:

- Complete endpoint descriptions
- Parameter specifications
- Response formats
- Error codes
- Usage examples

Praxisbeispiele¶

Beispiel 1: Projektstandards-Skill¶

---
name: Project Standards
description: Use when the user asks about "project structure", "file organization", "directory conventions"
---

# Project Standards

## Directory Structure

\`\`\`
src/
├── components/    # React components
├── hooks/         # Custom Hooks
├── services/      # API services
├── utils/         # Utility functions
└── types/         # TypeScript types
\`\`\`

## File Naming

- Components: PascalCase (e.g., `UserProfile.tsx`)
- Utilities: camelCase (e.g., `formatDate.ts`)
- Constants: UPPER_SNAKE_CASE (e.g., `API_ENDPOINTS.ts`)

## Import Order

1. React related
2. Third-party libraries
3. Internal modules
4. Type definitions
5. Style files

Beispiel 2: Git-Workflow-Skill¶

---
name: Git Workflow
description: Use when the user asks about "branch strategy", "commit conventions", "Git process"
---

# Git Workflow Standards

## Branch Naming

- Features: `feature/description`
- Fixes: `fix/description`
- Hotfixes: `hotfix/description`

## Commit Message Format

\`\`\`
<type>(<scope>): <subject>

<body>

<footer>
\`\`\`

### Type Values

- `feat`: New feature
- `fix`: Bug fix
- `docs`: Documentation update
- `style`: Code formatting
- `refactor`: Refactoring
- `test`: Testing
- `chore`: Build/tooling

Beispiel 3: Security-Review-Skill¶

---
name: Security Review
description: Use when the user asks about "security check", "vulnerability scan", "security best practices", or reviewing code security
---

# Security Review Guide

## Common Vulnerability Checks

### SQL Injection

- Check for parameterized queries
- Avoid string concatenation in SQL

### XSS Attacks

- Check if user input is escaped
- Use CSP headers

### Sensitive Data

- Ensure passwords are not stored in plaintext
- Don't hardcode API keys
- Check logs for sensitive data leaks

## Review Checklist

- [ ] Input validation
- [ ] Output encoding
- [ ] Authentication mechanism
- [ ] Authorization checks
- [ ] Encryption usage
- [ ] Error handling

Bewährte Praktiken¶

1. Klare Trigger-Beschreibungen¶

Verwenden Sie spezifische Trigger-Phrasen statt vager Beschreibungen:

# Good
description: Use when the user asks about "create component", "React component template", "component best practices"

# Bad
description: React component related

2. Strukturiertes Wissen¶

Organisieren Sie Wissen in klare Hierarchien:

• Überschriftsebenen verwenden

• Codebeispiele bereitstellen

• Checklisten einbeziehen

3. Aktuell halten¶

• Skill-Inhalte regelmäßig aktualisieren

• Versionsnummern bilden Änderungen ab

• Wichtige Updates dokumentieren

4. Modulares Design¶

• Jeder Skill konzentriert sich auf ein Fachgebiet

• Verzeichnis references für detaillierte Materialien verwenden

• Praxisbeispiele bereitstellen

Skills debuggen¶

Wenn ein Skill nicht wie erwartet aktiviert wird:

1. Beschreibung prüfen: Stellen Sie sicher, dass die Trigger-Phrasen mit der Benutzereingabe übereinstimmen

2. Format überprüfen: Stellen Sie sicher, dass das YAML-Frontmatter korrekt formatiert ist

3. Trigger testen: Verwenden Sie exakt die Phrasen aus der Beschreibung

Nächste Schritte¶

• Plugin-System – Vollständige Plugin-Entwicklung kennenlernen

• MCP-Server – Werkzeugfähigkeiten von Claude erweitern

• CLI-Tipps – Effizienz auf der Kommandozeile verbessern

Enterprise →