Claude Skills erklaert: Was sie sind und wie du sie nutzt

Du hoerst staendig, dass Claude Code Skills deine Arbeitsweise veraendern werden, aber jede Erklaerung, die du findest, ist entweder die offizielle Referenz-Doku oder eine riesige GitHub-Liste mit 300 Skills und keinem Einstieg. Du willst die Version, die dir sagt, was ein Skill wirklich ist, wie du einen erstellst und wann sich der Aufwand lohnt. Genau das ist das hier.

Ein Claude Skill ist kein Plugin, kein Prompt und keine Einstellung. Es ist ein Ordner mit einer einzigen Markdown-Datei, die Claude beibringt, wie eine bestimmte Art von Arbeit zu erledigen ist, und die Claude nur dann laedt, wenn deine Anfrage dazu passt. Sobald das klickt, wird das ganze System einfach.

Die wichtigsten Erkenntnisse

• Ein Skill ist ein Ordner mit einer einzigen SKILL.md-Datei: YAML-Frontmatter, das sagt, wann der Skill genutzt wird, plus Markdown-Anweisungen, was zu tun ist.
• Skills laden bei Bedarf. Standardmaessig steht nur die kurze Beschreibung im Kontext. Die vollstaendigen Anweisungen laden erst, wenn deine Anfrage passt, sodass dein Kontextfenster schlank bleibt.
• Wo du den Ordner speicherst, legt fest, wer ihn nutzen kann: persoenlich (~/.claude/skills/), Projekt (.claude/skills/, in Git eingecheckt) oder gebuendelt in einem Plugin.
• Rufe einen Skill auf zwei Arten auf: lass Claude ihn automatisch aus deiner Formulierung ausloesen, oder rufe ihn direkt mit /skill-name auf.
• Der haeufigste Fehler ist eine vage description. Eine spezifische, keyword-reiche Beschreibung ist es, die das automatische Ausloesen zuverlaessig macht.
• Ein Skill sagt der KI, WIE die Arbeit zu erledigen ist. Er traegt nicht DEINE Fakten, Entscheidungen und deinen aktuellen Kontext. Das ist eine separate Aufgabe, und dort steckt der Grossteil der Probleme nach dem Motto "warum klingt der Output trotzdem generisch".

Was ist ein Claude Skill?

Ein Skill ist die On-Demand-Expertise-Ebene von Claude. Mechanisch gesehen ist es ein Ordner mit einer SKILL.md-Datei darin. Diese Datei hat zwei Teile: YAML-Frontmatter zwischen ----Markierungen, das Claude sagt, wann der Skill zutrifft, und darunter Markdown mit den eigentlichen Anweisungen, denen Claude folgt, wenn der Skill laeuft.

Die wichtige Design-Idee ist Progressive Disclosure. Claude liest nicht bei jeder Anfrage jeden deiner Skills. Die kurze description aus dem Frontmatter jedes Skills steht im Kontext, damit Claude weiss, dass der Skill existiert. Der vollstaendige Inhalt laedt erst, wenn deine Anfrage zu dieser Beschreibung passt. Deshalb kannst du Dutzende Skills installiert haben, ohne dein Kontextfenster aufzublaehen oder jeden Prompt zu verlangsamen.

Skills gibt es nicht nur im Terminal. Dasselbe Skill-Format funktioniert in den Claude-Apps, in Claude Code und in der API, sodass ein einmal geschriebener Skill mit dir mitreist. In dieser Anleitung nutzen die Beispiele Claude Code, weil dorthin die meisten Menschen ueber den Begriff "claude code skills" gelangen, aber das Konzept ist ueberall dasselbe.

Eine Klarstellung, die Verwirrung erspart: Ein Skill ist etwas anderes als ein Prompt und etwas anderes als ein Plugin. Ein Prompt ist einmaliger Anweisungstext, den du eintippst. Ein Plugin ist eine Verpackungs- und Verteilungsebene (dazu unten mehr). Ein Skill liegt dazwischen: wiederverwendbar, strukturiert und automatisch geladen, wenn er relevant ist.

Wo Skills liegen (und wer sie nutzen kann)

Der Ordner, in den du einen Skill speicherst, bestimmt seinen Geltungsbereich. Das ist die nuetzlichste Tabelle, die du im Kopf behalten solltest.

Persoenliche Skills unter ~/.claude/skills/ begleiten dich ueber all deine Projekte hinweg. Projekt-Skills liegen in einem Repo unter .claude/skills/ (ohne Tilde), werden eingecheckt und reisen mit der Codebasis mit, sodass jeder Teamkollege, der das Repo klont, automatisch dieselben Skills bekommt. Unter Windows loest ~/.claude zu %USERPROFILE%\.claude auf.

Wenn zwei Skills ueber Ebenen hinweg denselben Namen haben, gewinnt die spezifischere Ebene in einer festgelegten Reihenfolge: Enterprise ueberschreibt persoenlich, und persoenlich ueberschreibt Projekt. Das brauchst du selten, aber es ist gut zu wissen, wenn sich ein Skill unerwartet verhaelt.

So erstellst du einen Skill, Schritt fuer Schritt

Hier ist ein vollstaendiger, kopierbarer persoenlicher Skill. Er fasst deine nicht committeten Aenderungen zusammen und markiert alles Riskante. Nichts an der Struktur ist spezifisch fuer diese Aufgabe, du kannst sie also fuer alles umformen.

Schritt 1. Erstelle den Ordner.

mkdir -p ~/.claude/skills/summarize-changes

Schritt 2. Schreibe SKILL.md in diesen Ordner unter ~/.claude/skills/summarize-changes/SKILL.md:

---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in two or three bullet points, then list any
risks you notice such as missing error handling, hardcoded values, or tests
that need updating. If the diff is empty, say there are no uncommitted changes.

Das ist der ganze Skill. Die description im Frontmatter ist der Ausloeser. Das Markdown ist das Verhalten. Der Ordnername (summarize-changes) wird zum Befehl, mit dem du ihn direkt aufrufen kannst.

Ein paar Regeln, die Skills gesund halten:

• Die einzige erforderliche Datei ist SKILL.md. Skripte, Referenzdokumente und Assets sind optionale Extras, die du spaeter hinzufuegen und aus der Hauptdatei heraus referenzieren kannst.
• Halte SKILL.md unter etwa 500 Zeilen. Wenn sie darueber hinaus waechst, lagere Details in separate Dateien aus und referenziere sie, damit Claude nur das laedt, was es braucht.
• Verschachtele nicht zu tief. Der mit Abstand haeufigste Installationsfehler ist ein Pfad wie ~/.claude/skills/summarize-changes/irgendein-ordner/SKILL.md. Die SKILL.md muss direkt im benannten Skill-Ordner liegen.

Meist musst du nicht neu starten. Claude Code ueberwacht deine Skill-Verzeichnisse und erkennt neue oder bearbeitete Skills innerhalb der laufenden Sitzung. Die eine Ausnahme: Wenn du ein oberstes skills/-Verzeichnis erstellst, das beim Sitzungsstart noch nicht existierte, starte einmal neu, damit es ueberwacht werden kann.

So rufst du einen Skill auf

Es gibt zwei Wege, einen Skill auszufuehren, und du wirst beide nutzen.

Automatisch. Frage etwas, das zur description des Skills passt, und Claude laedt ihn fuer dich. Mit dem Beispiel oben loest "was habe ich geaendert?" den summarize-changes aus, weil die Beschreibung genau diese Absicht benennt.

Direkt. Rufe den Skill mit einem Schraegstrich beim Namen auf: /summarize-changes. Das ist praktisch, wenn du genau weisst, welchen Skill du willst, und die Zuordnung nicht der Formulierung ueberlassen moechtest.

Die Beschreibung ist keine Dokumentation. Sie ist der Ausloeser. Eine vage Zeile wie "hilft mit Code" feuert fast nie; eine spezifische, keyword-reiche Zeile feuert zuverlaessig.

Bei der Beschreibung entscheidet sich Zuverlaessigkeit. Claude entscheidet anhand des Abgleichs deiner Anfrage mit dieser einen Zeile, ob ein Skill geladen wird. Schreibe sie also so, wie du tatsaechlich fragen wuerdest: benenne die Aufgaben, benenne die Ausloese-Woerter, sei konkret. Dieser eine Satz bringt fuer die Zuverlaessigkeit mehr als alles andere in der Datei.

Skills vs Plugins vs Memory Packs

Diese drei werden staendig verwechselt. Sie loesen unterschiedliche Probleme.

Ein Plugin ist nur eine praktische Huelle: Ein Plugin zu installieren kann mehrere Skills auf einmal hinzufuegen und sie aktualisierbar halten. Du kannst sogar einen einzelnen Skill-Ordner in ein Plugin verwandeln, indem du ihm eine .claude-plugin/plugin.json hinzufuegst. Skills und Plugins sind also dieselbe Achse in unterschiedlichem Massstab: was zu tun ist und wie es verteilt wird.

Memory Packs sind eine voellig andere Achse, und es ist die, die den meisten Menschen fehlt. Ein Skill kann perfekt darin sein, Claude zu sagen, wie eine Launch-E-Mail zu schreiben ist, und die E-Mail wird trotzdem nach niemandem klingen, weil der Skill nicht die Positionierung deines Produkts kennt, nicht deine Preise, nicht den Einwand, den du staendig in Sales-Gespraechen hoerst, und nicht die Meinung, die du letzte Woche gebildet hast. Ein Memory Pack ist die "deine Fakten"-Haelfte des Paares: ein Buendel echten Kontexts, das du in dein Gehirn injizieren kannst, sodass derselbe Skill deinen Output statt eines generischen produziert. Skills sagen der KI, wie. Memory Packs sagen ihr, was ueber dich wahr ist.

Was dir niemand sagt: auch Skills veralten

Hier ist der Fehlermodus, der einen Monat, nachdem du dich in Skills verliebt hast, auftaucht. Du schreibst einen Skill, der auf deinen aktuellen Stack, deine Namenskonventionen oder deine Preise verweist. Er funktioniert. Dann migrierst du eine Bibliothek, benennst einen Service um oder aenderst einen Preis, und der Skill wendet weiterhin selbstbewusst die alte Regel an. Ein Skill ist statischer Text. In dem Moment, in dem sich deine Realitaet bewegt, liegt der Skill still und leise falsch, und du bist wieder der Wartungsarbeiter, der ihn von Hand aktualisiert.

Das ist dasselbe Problem, das ein handgebautes zweites Gehirn hat, und es lohnt sich, es klar zu benennen: Der Wert jeder KI-Anweisung ist durch die Aktualitaet der zugrunde liegenden Fakten begrenzt. Skills loesen das "Wie" und frieren es an Ort und Stelle ein. Fuer das "Was ist gerade wahr" tun sie nichts.

Genau diese Ebene aktueller Fakten soll Locul sein. Locul ist ein lokal-first zweites Gehirn, das sich aus dem aufbaut, was du ohnehin produzierst (deine lokalen Dateien, deine PDFs, deine Diktate, dein Notion und dein LinkedIn-Profil), und sich von selbst aktuell haelt, um diesen Kontext dann ueber MCP an Claude und andere Tools zu liefern. Wenn sich deine Preise aendern oder deine Meinung sich weiterentwickelt, wird der alte Fakt als ueberholt markiert und der neue aktiv, ohne dass du etwas bearbeitest. Kombiniere ein gutes Set an Skills (das Wie) mit einem Gehirn, das aktuell bleibt (das Was), und der Output hoert auf abzudriften. Wenn du die tiefere Version willst, warum aktueller Kontext der eigentliche Hebel fuer KI-Qualitaet ist, geht der Leitfaden wie du deiner KI ein Gedaechtnis gibst, das haelt darauf ein. Locul ist kostenlos zum Starten mit 500 Memories auf lokaler KI, sodass du es in dein Claude-Setup einbinden und den Unterschied sehen kannst, bevor du dich entscheidest.

Ein schnelles Denkmodell zum Merken

Wenn du dir eine Sache merkst, dann diese Aufteilung:

• Skills und Plugins sind das Wie. Wiederverwendbare, bei Bedarf verfuegbare, strukturierte Anweisungen, die Claude laedt, wenn deine Anfrage passt. Guenstig zu schreiben, leicht zu teilen, es wert, sie fuer jede Aufgabe zu bauen, die du wiederholst.
• Memory (und Memory Packs) sind das Was. Deine echten, aktuellen Fakten und dein Kontext, aktuell gehalten, sodass der Output der KI deine Welt widerspiegelt statt den Durchschnitt des Internets.

Die meisten Menschen installieren einen Stapel Skills, bekommen einen Schub an Verbesserung und stagnieren dann, weil sie das Wie geloest und das Was nie angeruehrt haben. Loest du beides, verstaerkt sich die Verbesserung.

FAQ

Was ist ein Skill in Claude Code?

Ein Skill ist ein Ordner mit einer SKILL.md-Datei, die Claude beibringt, wie eine bestimmte Art von Aufgabe zu erledigen ist. Die Datei hat YAML-Frontmatter, das beschreibt, wann der Skill zu nutzen ist, und Markdown-Anweisungen, was zu tun ist. Claude laedt den Skill nur, wenn deine Anfrage zu seiner Beschreibung passt.

Funktionieren Skills in Claude Code oder nur in der App?

Beides. Dasselbe Skill-Format funktioniert in den Claude-Apps, in Claude Code und in der API. Ein einmal geschriebener Skill ist in jeder Oberflaeche nutzbar, auch wenn der Ort, an dem der SKILL.md-Ordner liegt, je nach Umgebung unterschiedlich ist.

Wie erstelle ich einen Claude Skill?

Erstelle einen Ordner in deinem Skills-Verzeichnis (zum Beispiel ~/.claude/skills/my-skill/) und lege darin eine SKILL.md-Datei mit einer description im Frontmatter und deinen Anweisungen darunter an. Das ist das Minimum. Alles andere, wie Skripte und Referenzdateien, ist optional.

Wie nutze oder loese ich einen Skill aus?

Auf zwei Arten. Frage etwas, das zur Beschreibung des Skills passt, und Claude laedt ihn automatisch, oder rufe ihn direkt beim Namen mit /skill-name auf. Eine spezifische, keyword-reiche Beschreibung ist es, die das automatische Ausloesen zuverlaessig macht.

Wo werden Claude Code Skills gespeichert?

Persoenliche Skills liegen unter ~/.claude/skills/, Projekt-Skills liegen unter .claude/skills/ in einem Repo (und werden in Git eingecheckt), und Plugin-Skills liegen im Plugin. Unter Windows loest ~/.claude zu %USERPROFILE%\.claude auf.

Ist ein Skill dasselbe wie ein Plugin?

Nein. Ein Skill ist ein einzelner Ordner mit Anweisungen. Ein Plugin ist eine Verteilungsebene, die mehrere Skills buendeln kann (plus Agents, Hooks oder MCP-Server), sodass du sie zusammen installieren und aktualisieren kannst. Du kannst einen Skill ganz ohne Plugin von Hand hinzufuegen.

Veralten meine Skills?

Die Anweisungen nicht, aber alle darin eingebackenen Fakten schon. Wenn ein Skill auf deinen Stack, deine Benennung oder deine Preise verweist, wendet er weiterhin die alten Werte an, nachdem du sie geaendert hast. Halte das dauerhafte "Wie" in Skills und das veraenderliche "Was ist gerade wahr" in einer Memory-Ebene, die sich selbst aktualisiert, sodass du nicht jedes Mal Skills von Hand bearbeitest, wenn sich deine Realitaet bewegt.