Claude Skills-Leitfaden

Problem: Du fügst dieselben Zeilen in jede neue Claude Code-Session ein. "Folge unseren Brand-Guidelines." "Nutze unseren Deployment-Prozess." "Prüfe zuerst die Security-Patterns." Tokens verbrannt. Minuten weg. Und die Hälfte der Regeln wird trotzdem vergessen.

Quick Win: Erstelle deinen ersten Skill in unter einer Minute:

.claude/skills/my-skill/SKILL.md

---
name: code-review
description: Reviews code for security and performance issues
---
 
# Code Review Process
 
1. Check for SQL injection vulnerabilities
2. Verify input validation exists
3. Confirm error handling patterns

Das ist ein vollständiger Skill. Leg den Ordner in dein Projekt. Die nächste Review-Anfrage zieht ihn automatisch rein.

Was sind Skills?

Ein Skill ist ein Ordner mit Anweisungen, den Claude bei Bedarf findet und lädt. Stell dir einen Schrank mit kurzen Referenzhandbüchern vor, der nur geöffnet wird, wenn das Thema passt.

Prompts verschwinden nach einem Turn. MCP-Server verdrahten Claude mit externen Tools. Skills sitzen dazwischen: Sie lehren, wie man Dinge tut. Prozedurales Wissen. Workflows, Checklisten, Hausstil, Domain-Know-how.

Simon Willison hat es beziffert: "Each skill only takes up a few dozen extra tokens, with the full details only loaded in should the user request a task that the skill can help solve."

Wie Progressive Disclosure funktioniert

Das Laden geschieht in zwei Stufen, damit dein Context Window schlank bleibt.

Stufe 1 - Nur Metadaten (~100 Tokens): Claude sieht nur den Namen und die kurze Beschreibung jedes Skills. Genug, um zu erkennen, was angeboten wird.

Stufe 2 - Vollständige Anweisungen (wenn nötig): Der Body fällt rein, sobald Claude entscheidet, dass ein Skill zu deiner Aufgabe passt. Dieser Body bleibt üblicherweise unter 5.000 Tokens.

my-skill/
├── SKILL.md              # Core instructions (loads when needed)
├── scripts/              # Automation scripts
├── references/           # Documentation Claude can read
└── assets/               # Templates and files

Du kannst Dutzende von Skills so tragen, ohne Claudes Arbeitsgedächtnis zu überfüllen.

Skills vs. alles andere

So stehen Skills im Vergleich zum Rest des Stacks:

Wichtige Unterscheidung: Projects sagen "hier ist, was du wissen musst." Skills sagen "hier ist, wie man Dinge macht." MCP sagt "hier ist, wie man sich verbindet."

Wann man einen Skill erstellt

Die Regel: Jede Anweisung, die du in mehr als einem Gespräch einfügst, sollte ein Skill werden.

Gute Kandidaten für Skills:

• Brand-Guidelines und Stilregeln
• Code-Review-Checklisten
• Deployment-Prozeduren
• Security-Audit-Patterns
• Dokumentationsvorlagen
• Git-Commit-Konventionen

Nicht ideal für Skills:

• Einmalige Anfragen
• Projektspezifischer Kontext (verwende stattdessen Projects)
• Externer API-Zugriff (verwende stattdessen MCP)

Eine effektive SKILL.md schreiben

Drei Teile gehen in jeden Skill:

---
name: my-skill
description: What it does and WHEN to trigger it
allowed-tools: "Read,Write,Bash"
---
 
# Clear Purpose Statement
 
## Step-by-Step Instructions
 
1. First action
2. Second action
3. Expected output

Kritisch: Das description-Feld ist das, was Claude scannt, um zu entscheiden, ob dein Skill auslöst. Sei spezifisch bei dem Trigger. "When user requests code review" schlägt "Helps with code" bei weitem.

Vorgefertigte Skills von Anthropic

Anthropic veröffentlicht ein offizielles Set an Drop-In-Skills:

• pdf: Text und Tabellen aus PDF-Dokumenten extrahieren
• docx: Word-Dokumente mit Tracked Changes erstellen und bearbeiten
• xlsx: Excel-Tabellen manipulieren
• pptx: PowerPoint-Präsentationen generieren
• brand-guidelines: Konsistentes Styling anwenden

Hol sie von github.com/anthropics/skills, oder baue eigene auf demselben Muster. Claude Code liefert auch /simplify und /batch als Built-Ins für Reviews und Codebase-weite Migrationen. Null Setup.

Häufige Fehler

Vage Beschreibungen: "This skill helps with documents" wird nie zuverlässig auslösen. Nenne den Trigger klar und deutlich.

Überfüllte Anweisungen: Dein SKILL.md sollte unter 5.000 Wörtern bleiben. Lange Docs in Referenzdateien auslagern, auf die der Skill zeigen kann.

Fehlende Grenzen: Sag klar, was der Skill nicht anfassen soll. Das verhindert, dass er bei Prompts auslöst, für die er nicht gemacht wurde.

Deine nächsten Schritte

1. Erstelle einen Skill, der die Anweisung abdeckt, die du am häufigsten wiederholst
2. Teste das Auslösen mit realen Anfragen, nicht nur expliziten Befehlen
3. Iteriere, wenn echte Sessions zeigen, was Anpassung braucht
4. Tauche in das Kontext-Management ein für mehr Mileage pro Skill
5. Lies über Context Engineering, um zu sehen, wo Skills in einem Produktions-AI-Stack sitzen

Claude wechselt vom Generalisten zum Spezialisten, sobald Skills vorhanden sind, und der Kontext-Tax auf wiederholte Erklärungen verschwindet. Dein Fachwissen wird portabel. Für ein funktionierendes Kit statt eines leeren Ordners liefert ClaudeFast's Code Kit 20+ Produktions-Skills in 21 Kategorien (React-Patterns bis Datenbankoperationen), plus einen SkillActivationHook, der bei jedem Prompt den richtigen Skill auswählt.

Einer von fünf Zügen, die Top-Agentic-Engineers täglich machen. Das vollständige Set lebt in unserem Claude Code-Best-Practices-Leitfaden.