Skills: Expertise auf Abruf
- Definieren, was ein Skill ist und wie er sich davon unterscheidet, alles in CLAUDE.md zu stopfen
- Eine SKILL.md lesen und schreiben — Frontmatter plus Anweisungen — und verstehen, warum die Beschreibung der Auslöser ist
- Progressive Offenlegung erklären und warum sie viele Skills skalieren lässt, ohne den Kontext aufzublähen
- Die drei Orte kennen, an denen Skills leben: persönlich, Projekt und in einem Plugin gebündelt
- Richtig wählen zwischen Skill, Slash-Befehl, Subagent und MCP
- Die vier häufigen Fehler vermeiden, die Skills am Auslösen hindern
Ein Skill verpackt Expertise — Anweisungen plus optionale Skripte und Ressourcen — die Claude nur lädt, wenn sie relevant ist. Statt alles in CLAUDE.md zu stopfen, gibst du Claude eine Bibliothek von Fähigkeiten, die es bei Bedarf hereinholt.
Anatomie
Ein Skill ist ein Ordner mit einer SKILL.md: YAML-Frontmatter + Anweisungen.
---
name: pdf-forms
description: Use when the user needs to fill, read, or generate PDF forms.
---
# PDF Forms
Steps and rules for working with PDF forms…
(optionally reference scripts/ or resources/ in this folder)
- Die Beschreibung ist der Auslöser — Claude liest sie, um zu entscheiden, wann der Skill zu aktivieren ist. Schreib sie als "Use when…", spezifisch genug, damit sie zur richtigen Zeit lädt und sonst nicht.
Progressive Offenlegung (warum Skills skalieren)
Claude lädt nicht den vollen Körper jedes Skills im Voraus — es sieht den leichtgewichtigen name + description und holt die vollen Anweisungen (und führt Skripte aus) nur, wenn eine Anfrage passt. Das hält den Kontext schlank, selbst mit vielen installierten Skills.
Wo sie leben
- ~/.claude/skills/<name>/SKILL.md — bleibt deins, verfügbar über alle deine Projekte.
- .claude/skills/<name>/SKILL.md — committe es nach git und das ganze Team bekommt die Fähigkeit.
- Pack Skills in ein Plugin zur Team-Verteilung. Siehe Plugins & Marktplätze.
AILmanac liefert 7 fertige Skill-Pakete — kopier eines hinein, um es auszuprobieren.
Praxisbeispiel: ein Skill, der sich selbst auslöst
Erstelle ~/.claude/skills/release-notes/SKILL.md:
---
name: release-notes
description: Use when the user asks to write release notes or a changelog from git history.
---
# Release Notes
1. Run `git log <last-tag>..HEAD --oneline` to get the commits.
2. Group them into Features / Fixes / Breaking changes.
3. Write user-facing notes — what changed for *users*, not commit messages.
4. Output Markdown ready to paste into a GitHub release.
Später tippst du den Prompt unten. Claude hatte diese Schritte nie im Kontext — aber die Anfrage passt zur description, also holt es die volle SKILL.md, führt das git log aus und produziert gruppierte Notizen. Du hast nichts namentlich aufgerufen; die Beschreibung hat das Routing übernommen. Füge eine scripts/-Datei im selben Ordner hinzu und der Skill kann sie als Teil von Schritt 1 ausführen.
Den Skill durch Absicht auslösen — kein Name nötig
Draft release notes since v1.4.
Skill vs. Befehl vs. Subagent vs. MCP
| Tool | Was es ist | Du vs. Claude löst aus |
|---|---|---|
| Slash-Befehl | Ein gespeicherter Prompt | Du rufst ihn auf |
| Skill | Expertise auf Abruf + Skripte | Claude lädt ihn, wenn relevant |
| Subagent | Ein delegierter Agent mit eigenem Kontext | Claude delegiert |
| MCP | Eine Verbindung zu externen Tools/Daten | Stellt Tools zum Aufrufen bereit |
- Du willst es auf Abruf auslösen → Slash-Befehl.
- Claude soll die Prozedur kennen und sie anwenden, wenn relevant → Skill.
- Die Arbeit soll in einem separaten Kontext passieren → Subagent.
- Du musst ein externes System erreichen → MCP.
Häufige Fehler
- Eine Beschreibung, die nicht auslöst. "Hilft mit PDFs" ist zu vage; "Use when the user needs to fill, read, or generate PDF forms" sagt Claude genau, wann es zu laden ist. Die Beschreibung ist der ganze Aktivierungsmechanismus — schreib sie fürs Matching, nicht für Menschen.
- Stattdessen alles in CLAUDE.md zu packen. CLAUDE.md lädt in jeder Sitzung und kostet immer Kontext; ein Skill lädt nur, wenn relevant. Verschieb situative Prozeduren in Skills und halte CLAUDE.md für immer-wahre Projektregeln.
- Ein riesiger Skill. Viele kleine, scharf beschriebene Skills routen besser als ein Allzweck-Skill — progressive Offenlegung hilft nur, wenn jede Beschreibung spezifisch ist.
- Vergessen, dass er teilbar ist. Ein Projekt-Skill in .claude/skills/, nach git committet, gibt dem ganzen Team die Fähigkeit; ein persönlicher in ~/.claude/skills/ bleibt deins.