Skills: Wissen, das dein Agent lernt

Ein Skill ist ein Ordner mit Anleitung, den dein Agent automatisch lädt, wenn er zur Aufgabe passt.

Was ist ein Skill?

Ein Skill ist ein Ordner mit einer Datei namens SKILL.md. Darin steht eine Anleitung. Passt eine Aufgabe zum Skill, lädt Claude die Anleitung von selbst. Du kannst einen Skill auch direkt aufrufen, mit /skill-name.

Der Aufbau von SKILL.md

Jede SKILL.md beginnt mit einem Kopf aus YAML zwischen zwei ----Zeilen. Dort stehen Felder wie name und description. Danach kommt der eigentliche Text: die Anleitung, die Claude bekommt. Ein Skill kann weitere Dateien im selben Ordner haben, zum Beispiel eine reference.md oder ein Skript. Diese Zusatzdateien lädt Claude nur, wenn er sie wirklich braucht.

Skill oder Slash-Befehl?

Slash-Befehle gab es zuerst nur als einfache Markdown-Datei in .claude/commands/. Solche Dateien funktionieren weiterhin. Aber: Custom Commands wurden in Skills zusammengeführt. Eine Datei unter .claude/commands/deploy.md und ein Skill unter .claude/skills/deploy/SKILL.md erzeugen beide denselben Befehl /deploy. Ein Skill kann zusätzlich einen ganzen Ordner mit Dateien mitbringen. Und Claude kann ihn automatisch laden, sobald er zur Aufgabe passt.

Wann lohnt sich ein Skill?

Tippst du dieselbe Anleitung immer wieder in den Chat? Ist ein Abschnitt deiner CLAUDE.md zu einer ganzen Prozedur gewachsen? Dann ist das ein guter Moment für einen Skill. Ein Skill lädt seinen Text nur bei Bedarf. Das spart Kontext, verglichen mit einer langen CLAUDE.md, die immer komplett geladen wird.

Wo Skills liegen

Persönlich: ~/.claude/skills/<name>/SKILL.md – für alle deine Projekte
Projekt: .claude/skills/<name>/SKILL.md – nur für dieses Projekt
Plugin: <plugin>/skills/<name>/SKILL.md – überall, wo das Plugin aktiv ist