Praktischer Leitfaden zur Erstellung von Claude Skills: Struktur, Auslöser und Skripte

Was Claude Skills sind und wie sie funktionieren

Claude Skills sind Anleitungsmanuale, die spezifische Aufgaben automatisieren, unterschieden von Projekten (Wissensbasen) und dem Model Context Protocol (Verbindungsschicht für Live-Daten). Wenn Sie dieselben Anweisungen zu Beginn von mehr als drei Gesprächen getippt haben, ist das ein Skill, der darauf wartet, erstellt zu werden.

Skill-Struktur und Einrichtung

Ein Skill ist ein Ordner, der eine Datei namens SKILL.md enthält. Die Grundstruktur ist:

dein-skill-name/
├── SKILL.md
└── references/
    └── deine-ref.md

Legen Sie den Ordner in ~/.claude/skills/ auf Ihrem Computer ab. Claude findet ihn automatisch.

YAML-Trigger: Der Aktivierungsmechanismus

Schreiben Sie oben in SKILL.md Metadaten zwischen --- Zeilen, um Claude mitzuteilen, wann er aktiv werden soll. Beispiel:

---
name: csv-cleaner
description: Wandelt unordentliche CSV-Dateien in saubere Tabellen um. Verwenden Sie diesen Skill, wenn der Nutzer sagt 'clean up this CSV', 'fix the headers', 'format this data' oder 'organise this spreadsheet'. NICHT verwenden für PDFs, Word-Dokumente oder Bilddateien.
---

Folgen Sie drei Regeln: in der dritten Person schreiben, genaue Auslösephrasen auflisten und negative Grenzen setzen. Das Beschreibungsfeld ist die wichtigste Zeile im gesamten Skill – eine schwache Beschreibung bedeutet, dass der Skill nie ausgelöst wird.

Wenn Anweisungen nicht ausreichen: Das Skriptverzeichnis

Einfache englische Anweisungen handhaben Urteilsvermögen, Sprache, Formatierung und Entscheidungen. Für Aufgaben, die tatsächliche Berechnungen benötigen, fügen Sie einen scripts/ Ordner hinzu.

Verwenden Sie Anweisungen für: "dies in unserer Markenstimme umschreiben" oder "diese Besprechungsnotizen kategorisieren".

Verwenden Sie Skripte für: "den gleitenden Durchschnitt dieser Zahlen berechnen", "diese XML parsen und spezifische Felder extrahieren" oder "alle Bilder in diesem Ordner auf 800x600 verkleinern".

Ordnerstruktur für einen Skill, der beides verwendet:

data-analyser/
├── SKILL.md
├── references/
│   └── analysis-template.md
└── scripts/
    ├── parse-csv.py
    └── calculate-stats.py

Verweisen Sie in SKILL.md wie folgt auf Skripte:

## Workflow
1. Lesen Sie die hochgeladene CSV-Datei, um ihre Struktur zu verstehen.
2. Führen Sie scripts/parse-csv.py aus, um die Daten zu bereinigen:
   - Befehl: `python scripts/parse-csv.py [input_file] [output_file]`
   - Dies entfernt leere Zeilen, normalisiert Kopfzeilen und erzwingt Datentypen.
3. Führen Sie scripts/calculate-stats.py auf den bereinigten Daten aus:
   - Befehl: `python scripts/calculate-stats.py [cleaned_file]`
   - Dies gibt aus: Mittelwert, Median, Standardabweichung und Ausreißer für jede numerische Spalte.
4. Lesen Sie die statistische Ausgabe und schreiben Sie eine menschenlesbare Zusammenfassung gemäß der Vorlage in references/analysis-template.md. Heben Sie alle Anomalien oder Ausreißer hervor, die einen nicht-technischen Leser beunruhigen würden.

Skripte handhaben Berechnungen; Anweisungen handhaben Urteilsvermögen. Eine Regel für Skripte: ein Skript, eine Aufgabe. parse-csv.py sollte nicht auch Statistiken berechnen. Halten Sie sie fokussiert, akzeptieren Sie Dateipfade als Argumente, kodieren Sie Pfade niemals fest ein und fügen Sie immer Fehlerbehandlung hinzu, damit Claude Fehler lesen und sie sauber kommunizieren kann.

Referenzen: Die Eine-Ebene-Tief-Regel

Wenn ein Skill einen Markenleitfaden oder eine Vorlage benötigt, legen Sie ihn in references/ ab und verlinken Sie ihn von SKILL.md. Lassen Sie Referenzdateien niemals auf andere Referenzdateien verlinken – Claude wird seine Lektüre abschneiden und Dinge verpassen. Nur eine Ebene tief.

dein-skill-name/
├── SKILL.md
└── references/
    └── brand-voice-guide.md ← verlinken Sie dies von SKILL.md ← verlinken Sie niemals von hier auf eine andere Datei

In SKILL.md: Lesen Sie vor Beginn der Aufgabe den Markenstimmen-Leitfaden unter references/brand-voice-guide.md

Multi-Skill-Orchestrierung: Konflikte verhindern

Sobald Sie fünf oder mehr Skills im Einsatz haben, beginnen Konflikte – wie wenn der Markenstimmen-Erzwinger auslöst, wenn Sie den E-Mail-Entwerfer wollten. Drei Regeln stoppen dies:

• Regel 1: Nicht überlappende Bereiche. Jeder Skill besitzt eine klar definierte Domäne (z.B. Markenstimmen-Erzwinger handhabt Stimmenkonformität, E-Mail-Entwerfer handhabt Verfassung, Content-Wiederverwerter handhabt Formatumwandlung). Keine Überschneidungen.
• Regel 2: Aggressive negative Grenzen.