Claude Code Skills: Schluss mit Wiederholen, Schluss mit vollgestopfter CLAUDE.md

Du tippst Claude ständig dieselben Instruktionen. Dieselben Planungsschritte, dieselbe Review-Checkliste, dasselbe "so bauen wir einen PR auf" — jede Session wieder von vorn. Oder du packst es in die CLAUDE.md, um dem Retippen zu entkommen — und jetzt wächst die CLAUDE.md mit Dingen, die nur manchmal gelten.

Skills lösen beide Probleme. Ein Skill ist ein Ordner auf deiner Maschine mit einer SKILL.md-Datei drin — deine Workflow-Instruktionen, einmal geschrieben. Claude findet ihn selbstständig, anhand der Aufgabe, die du beschreibst, und lädt ihn nur, wenn er wirklich relevant ist.

Das Mentalmodell#

Die CLAUDE.md enthält deine stabilen Projektregeln — das, was immer gilt. Ein Skill ist eine wiederverwendbare Methode — ein Playbook für eine bestimmte Art von Aufgabe, geladen nur, wenn diese Aufgabe wirklich ansteht. Die Verfassung kurz halten. Die How-tos in Skills packen.

Wie die Auffindung funktioniert#

Der Agent sieht zunächst nur Name und Beschreibung jedes vorhandenen Skills — das war's, ein paar Tokens pro Skill. Anhand deiner tatsächlichen Anfrage ("hilf mir, dieses Feature zu planen") scannt er diese Beschreibungen, findet die passende, und lädt erst dann die vollständige SKILL.md. Wird der Skill zu groß, splitte ihn in unterstützende Dateien — Beispielskripte, Referenzen — die nur geladen werden, wenn der Workflow sie wirklich braucht. Dasselbe Prinzip wie bei Rules: nicht laden, was gerade nicht gebraucht wird.

Du kannst die automatische Auffindung auch überspringen und einen Skill direkt über die CLI mit /skill-name aufrufen.

Wo Skills leben#

Es gibt eine Hierarchie: unternehmensweit (jeder in der Organisation hat Zugriff), persönlich (~/.claude/skills, projektübergreifend nutzbar), projekt-gebunden (.claude/skills in einem Repo, nur für dieses Projekt) und Plugin-Ebene. Das meiste, was du im Alltag baust, ist entweder persönlich oder projekt-gebunden.

Im Video#

00:00 — Was ein Skill eigentlich ist, und warum: nicht wiederholen, CLAUDE.md nicht vollstopfen
02:59 — Die Hierarchie: Enterprise, Personal, Projekt, Plugin
04:27 — /skills — alle aktuell verfügbaren Skills auflisten
05:07 — Das Frontmatter-Format: name, description, und warum die Beschreibung wirklich spezifisch sein muss
07:45 — Live zusehen, wie ein Skill für eine echte Aufgabe automatisch gefunden und geladen wird
08:53 — Einen neuen Skill von Grund auf bauen (ein "Cooking"-Skill, mit Variablen-Substitution)
10:38 — Einen bestehenden, zu großen Skill mit Claude Opus und der offiziellen Doku überarbeiten
13:49 — find skills: einen Skill installieren, den jemand anderes gebaut hat (150k Installs, ein Befehl)

Frontmatter schreiben, das wirklich gefunden wird#

Die Metadaten oben in der SKILL.md sind keine Deko — sie sind das Einzige, was Claude liest, bevor er entscheidet, ob er den Rest lädt. Neben name und description kannst du hinzufügen:

when to use — zusätzlicher Kontext, welche Situationen genau triggern sollen
model — ein bestimmtes Modell an diesen Skill pinnen (ein Planungs-Skill profitiert von mehr Reasoning-Power als ein Boilerplate-Skill)
effort — low, medium, high oder max Reasoning-Aufwand für das, was innerhalb des Skills läuft

Ist die Beschreibung vage, wird der Skill einfach nicht gefunden, wenn er sollte. Dieser Teil lohnt sich, mehrfach umzuschreiben.

Einen zu großen Skill aufsplitten#

Im Video ist ein bestehender "Build"-Skill zu groß geworden — alles in eine einzige SKILL.md gequetscht. Die Lösung: die offizielle Claude-Skills-Dokumentation in den Context geben, Opus auf den überladenen Skill ansetzen und ihn bitten, das Ganze korrekt aufzusplitten — Code-Templates und Workflow-Details wandern in separate Referenzdateien, die Haupt-SKILL.md schrumpft auf das, was wirklich jedes Mal gebraucht wird.

Skills sind nur Markdown — also teil sie#

Weil ein Skill nichts anderes ist als ein Ordner mit Markdown-Dateien, kannst du ihn in Git committen und direkt an dein Team weitergeben — und wenn die CLAUDE.md von allen dieselben Skills referenziert, folgt das ganze Team automatisch demselben Workflow, ohne dass sich jemand die Schritte merken muss.

Die andere Richtung funktioniert genauso: find skills ist ein durchsuchbarer Marktplatz, direkt in die CLI eingebaut. Suche nach dem, was du brauchst — "ein Skill, um mein Frontend zu testen" — oder nach Namen, und installiere direkt in deinen persönlichen Ordner. Einer im Video hat 150.000 Installs, gebaut von jemand komplett anderem, und leistet ab der Installation direkt echte Arbeit.

Worum es eigentlich geht#

Pack deine wiederkehrenden Workflow-Instruktionen in einen Skill, nicht in die CLAUDE.md. Wächst der Skill, splitte ihn in unterstützende Dateien. Schreib eine Beschreibung, die wirklich beschreibt — denn das ist das Einzige, was zwischen "der Agent findet das automatisch" und "du tippst es wieder von Hand" entscheidet.