Claude Code Skills erklaert: Erstellen, installieren, nutzen

Claude Code Skills sind der Grund, warum das Claude eines Kollegen Release Notes im Hausformat schreibt, waehrend deins sie wie eine Pressemitteilung formuliert. Ein Skill ist ein Ordner mit einer SKILL.md-Datei, die Claude eine bestimmte Aufgabe beibringt, und Claude laedt ihn nur, wenn deine Anfrage danach verlangt. Die offizielle Referenz ist lang, und die GitHub-Listen umfassen Hunderte Skills ohne Einstieg.

Das hier ist der kurze Weg: was ein Skill ist, wie du einen erstellst, wie du fremde Skills installierst, wie du sie ausfuehrst und wie du einen reparierst, der nie anspringt. Jeder Befehl unten wurde im Oktober 2026 mit der Dokumentation von Anthropic abgeglichen, und es gibt zwei Skills, die du direkt kopieren kannst.

Die wichtigsten Erkenntnisse

• Ein Skill ist ein Ordner mit einer SKILL.md-Datei: YAML-Frontmatter, das sagt, was er tut und wann er genutzt wird, darunter Markdown-Anweisungen. Jedes Frontmatter-Feld ist optional, und description ist das, worauf es ankommt.
• Skills laden bei Bedarf. Claude sieht vorab Name und Beschreibung jedes Skills; der Inhalt laedt erst, wenn der Skill genutzt wird.
• Wo der Ordner liegt, bestimmt den Geltungsbereich: persoenlich (~/.claude/skills/), Projekt (.claude/skills/), Plugin oder von deiner Organisation verteilt. Bei gleichem Namen gewinnt persoenlich vor Projekt.
• Fuehre einen Skill mit /skill-name aus oder lass Claude ihn anhand deiner Formulierung waehlen. Plugin-Skills laufen als /plugin-name:skill-name.
• Eigene Slash Commands wurden mit Skills zusammengelegt. .claude/commands/deploy.md und .claude/skills/deploy/SKILL.md erzeugen beide /deploy.
• Fremde Skills installierst du ueber einen Plugin-Marketplace mit /plugin install name@marketplace, und du liest vorher, was das Plugin hinzufuegt.
• Ein Skill sagt, WIE die Arbeit zu erledigen ist. Er traegt keine deiner aktuellen Fakten, und genau daher kommt der meiste generische Output.

Was ist ein Claude Skill?

Technisch ist ein Skill ein Verzeichnis mit einer SKILL.md. Die Datei hat zwei Teile: YAML-Frontmatter zwischen ----Markierungen, das Claude sagt, was der Skill tut und wann er gilt, und Markdown-Anweisungen, denen Claude folgt, sobald der Skill laeuft. Optionale Dateien (Referenzdokumente, Beispiele, Skripte) liegen daneben im selben Ordner.

Die Grundidee heisst Progressive Disclosure. Claude Code haelt eine Liste mit Name und Beschreibung jedes Skills im Kontext, damit Claude weiss, was es gibt. Der Inhalt laedt erst, wenn der Skill genutzt wird, also kostet ein Skill voller Referenzmaterial fast nichts, bis du ihn brauchst. Das ist der praktische Unterschied zu CLAUDE.md, das in jede Sitzung geladen wird.

Daraus ergibt sich ein Test, was wohin gehoert. Regeln, die Claude in jeder Runde braucht, gehoeren in CLAUDE.md; Ablaeufe gehoeren in Skills. Schritte, die du immer wieder in den Chat kopierst, oder ein CLAUDE.md-Abschnitt, der zu einer nummerierten Checkliste gewachsen ist, sind ein Skill, der darauf wartet, herausgeloest zu werden. Geh deine CLAUDE.md durch und markiere jeden Block, der klingt wie "wenn du X machst, folge diesen Schritten": Jeder davon ist ein Kandidat.

Skills sind nicht aufs Terminal beschraenkt. Claude Code Skills folgen dem offenen Agent-Skills-Standard, und dasselbe Format funktioniert in den Claude-Apps und in der API. Claude Code legt Extras obendrauf: Kontrolle darueber, wer einen Skill aufrufen darf, die Ausfuehrung in einem Subagent und das Einfuegen von Live-Shell-Output. Ein Skill, der diese Extras nutzt, laesst sich nicht unveraendert auf claude.ai hochladen (Details unten).

Ein Skill ist auch etwas anderes als ein Prompt oder ein Plugin. Ein Prompt ist einmaliger Text, den du tippst. Ein Plugin ist eine Verpackungsschicht, die Skills plus Agents, Hooks und MCP-Server tragen kann. Ein Skill liegt dazwischen: wiederverwendbare Anweisungen, die laden, wenn sie relevant sind.

Wo Skills liegen (und wer sie nutzen kann)

Der Ordner, in dem du einen Skill speicherst, entscheidet, wer ihn bekommt.

Unter Windows wird ~/.claude zu %USERPROFILE%\.claude aufgeloest.

Haben zwei Skills denselben Namen, gewinnt Enterprise vor persoenlich und persoenlich vor Projekt, also laeuft dein persoenliches deploy statt dem deploy des Repos. Ein Skill gewinnt ausserdem gegen eine gleichnamige Datei in .claude/commands/. Plugin-Skills haben einen Namensraum und kollidieren daher nie mit deinen. In einem Monorepo laedt Claude Code Projekt-Skills aus jedem Verzeichnis zwischen deinem Startpunkt und dem Repo-Root und uebernimmt die Skills eines Unterordners, sobald es dort zum ersten Mal eine Datei liest oder bearbeitet.

Eine Falle, wenn du auf mehreren Oberflaechen arbeitest: Cloud- und Cowork-Sitzungen lesen ~/.claude/skills/ nicht. Sie laden die Skills, die in deinem claude.ai-Konto aktiviert sind, also gilt ein Skill, der nur auf deinem Laptop existiert, dort als nicht gefunden. Die vollstaendigen Regeln stehen in der Claude-Code-Dokumentation zu Skills.

So erstellst du einen Skill, Schritt fuer Schritt

Hier ist ein vollstaendiger persoenlicher Skill zum Kopieren. Er fasst deine nicht committeten Aenderungen zusammen und markiert alles Riskante.

Schritt 1. Lege den Ordner an. Der Ordnername wird zum Befehl.

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

Schritt 2. Schreibe die SKILL.md 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.
allowed-tools: Bash(git diff *)
---

Current changes:

!`git diff HEAD`

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.

Die !-Zeile ist Dynamic Context Injection: Claude Code fuehrt den Befehl aus, bevor Claude den Skill sieht, und setzt die Ausgabe an ihre Stelle, sodass Claude deinen echten Diff liest, statt zu raten. Zwei Details entscheiden, ob das funktioniert. Eingefuegte Befehle fragen nie nach Erlaubnis, also bricht alles, was eine Freigabe braeuchte, den Aufruf ab, es sei denn, allowed-tools gibt es vorab frei; genau das macht die Zeile Bash(git diff *). Und ein Befehl, der mit einem Fehler endet, bricht den ganzen Skill ab; git diff HEAD scheitert in einem Repo ohne Commits, also haenge || true an, wo ein Fehler normal ist.

Schritt 3. Fuehre ihn aus. Tippe in einem beliebigen Git-Repo /summarize-changes oder frag einfach "was habe ich geaendert?". Claude Code beobachtet deine Skill-Ordner, neue und bearbeitete Skills funktionieren also in der laufenden Sitzung. Hast du waehrend der Sitzung ein ganz neues Skills-Verzeichnis auf oberster Ebene angelegt, fuehre /reload-skills aus, statt neu zu starten.

Regeln, die Skills gesund halten:

• Nur SKILL.md ist Pflicht. Lange Referenzinhalte gehoeren in Nachbardateien, und in der SKILL.md steht, wann welche zu lesen ist.
• Halte die SKILL.md unter 500 Zeilen. Darueber hinaus lagerst du Details in Zusatzdateien aus.
• Die SKILL.md muss direkt im benannten Ordner liegen. Ein Pfad wie ~/.claude/skills/summarize-changes/v2/SKILL.md ist der haeufigste Grund, warum ein Skill nie auftaucht.
• Das Frontmatter wird nur gelesen, wenn das oeffnende --- die allererste Zeile der Datei ist.

Frontmatter-Felder, die du kennen solltest

Jedes Feld ist optional, und Claude Code ignoriert Felder, die es nicht kennt. Diese wirst du tatsaechlich nutzen:

Ausserhalb von Claude Code sind die Regeln strenger. Ein Skill, der auf claude.ai hochgeladen oder ueber die Skills API geschickt wird, darf nur name, description, license, compatibility, metadata und allowed-tools nutzen; jedes andere Feld fuehrt zu einem harten Fehler.

Hier ist ein zweiter Skill zum Kopieren, diesmal nur manuell aufrufbar und mit Argumenten. Speichere ihn als .claude/skills/release-notes/SKILL.md in deinem Repo:

---
description: Drafts release notes for a new version from the git log. Use only when the user asks for release notes.
disable-model-invocation: true
argument-hint: "[previous-tag] [new-version]"
allowed-tools: Bash(git log *)
---

Write release notes for $1, covering every commit since $0.

1. Run git log $0..HEAD --oneline and read every commit.
2. Group the user-facing changes under Added, Changed and Fixed.
3. Skip merge commits, version bumps and internal refactors.
4. Write one plain sentence per change, starting with a verb.
5. End with a list of anything that looks like a breaking change.

Fuehre ihn mit /release-notes v1.4.0 v1.5.0 aus. Argumente zaehlen ab 0, also ist $0 der erste Wert und $1 der zweite; $ARGUMENTS enthaelt alles, was du nach dem Namen getippt hast. Wegen disable-model-invocation: true entscheidet Claude nie von selbst, mitten im Gespraech Release Notes zu schreiben.

So rufst du einen Skill auf

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

Automatisch. Frag etwas, das zur description des Skills passt, und Claude laedt ihn. Beim ersten Beispiel loest "was habe ich geaendert?" summarize-changes aus, weil die Beschreibung genau diese Absicht nennt.

Direkt. Tippe /skill-name am Anfang einer Nachricht, mit eventuellen Argumenten dahinter. Du kannst bis zu sechs Skills am Anfang einer Nachricht stapeln, und der Text danach geht an jeden als Argument. Ein Name mitten im Satz, etwa "mach weiter und /deploy", erlaubt Claude nur, den Skill zu nutzen; er fuehrt ihn nicht aus.

Aeltere Dateien in .claude/commands/ laufen genauso, weil eigene Befehle mit Skills zusammengelegt wurden, und wie sich Slash Commands, Skills und Subagents unterscheiden erklaert, wann du was schreibst.

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

Claude entscheidet anhand dieser einen Zeile, ob es einen Skill laedt, also schreib sie so, wie du tatsaechlich fragen wuerdest:

• Schwach: description: Helps with git.
• Stark: description: Summarizes uncommitted changes and flags risky edits. Use when the user asks what changed, wants a commit message, or asks to review their diff.

Auch die Menge zaehlt. Die Skill-Liste bekommt ein Budget von etwa 1% des Kontextfensters des Modells. Installierst du genug Skills, laesst Claude Code Beschreibungen weg, beginnend bei den Skills, die du am seltensten nutzt, und genau damit verschwinden die Keywords, auf die Claude reagiert.

Sobald ein Skill geladen ist, bleibt sein Inhalt im Gespraech, aber Claude Code liest die Datei in spaeteren Runden nicht neu. Nach einer Komprimierung des Gespraechs bleiben nur die ersten 5.000 Tokens jedes zuletzt aufgerufenen Skills erhalten, also gehoeren die wichtigsten Anweisungen nach oben in die SKILL.md.

So fuegst du Claude Code Skills hinzu

Es gibt drei Wege, an Skills zu kommen, die jemand anderes geschrieben hat.

1. Einen Ordner kopieren. Jeder Skill auf GitHub ist einfach ein Ordner. Kopiere ihn nach ~/.claude/skills/ oder in die .claude/skills/ eines Projekts, und er ist sofort verfuegbar. Lies vorher die SKILL.md: Jede !-Zeile fuehrt einen Shell-Befehl auf deinem Rechner aus.

2. Ein Plugin aus einem Marketplace installieren. So werden die meisten geteilten Skills ausgeliefert. Der offizielle Marketplace von Anthropic, claude-plugins-official, wird beim ersten Start einer interaktiven Sitzung automatisch hinzugefuegt, das hier funktioniert also ohne Einrichtung:

/plugin install skill-creator@claude-plugins-official

In einer Sitzung oeffnet dieser Befehl die Details des Plugins, statt blind zu installieren. Du siehst, was es hinzufuegt (Skills, Agents, Hooks, MCP-Server), und bei offiziellen Plugins eine Schaetzung der Kontextkosten. Dann waehlst du einen Geltungsbereich: nur du in jedem Projekt, alle in diesem Repo oder nur du in diesem Repo. Ein Plugin kann Hooks und MCP-Server ausfuehren, also lies diese Ansicht, bevor du bestaetigst.

Jeder andere Marketplace muss einmal vorher hinzugefuegt werden. Die oeffentlichen Beispiel-Skills von Anthropic, darunter die Skills fuer Word, Excel, PowerPoint und PDF, installierst du so:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

Dieselben zwei Zeilen funktionieren fuer unseren kostenlosen Claude-Skills-Marketplace, auf dem jede Skill-Seite die rohe SKILL.md zeigt, die du vor der Installation lesen kannst: /plugin marketplace add mkhalid1/locul-skills, dann /plugin install locul-seo@locul fuer das SEO-Paket. Keiner dieser Skills wurde bisher gegen eine Kontrollgruppe gemessen, und jeder sagt das auch.

Tippe nach einer Installation / und suche die Skills des Plugins als /<plugin>:<skill>. Aus deiner Shell erledigt claude plugin install <name>@<marketplace> --scope project dasselbe, ohne eine Sitzung zu oeffnen. Der vollstaendige Ablauf inklusive Updates und Entfernen steht in Anthropics Anleitung zum Installieren und Verwalten von Plugins.

3. Aus claude.ai synchronisieren. Skills, die du in deinem claude.ai-Konto aktivierst, laden in Claude Code, wenn du dich mit demselben Konto anmeldest (ab Claude Code v2.1.273). Sie erscheinen unter "claude.ai sync" in /skills. Die Synchronisierung laeuft nur in eine Richtung, findet nicht statt, wenn Claude Code mit einem API-Key oder ueber einen Cloud-Anbieter wie Amazon Bedrock laeuft, und laesst sich mit syncClaudeAiSkills: false in deinen Einstellungen abschalten.

Skills verwalten, teilen und reparieren

Drei Befehle decken den Alltag ab:

• /skills listet alle deine Skills. Tippe zum Filtern, druecke t, um nach Token-Anzahl zu sortieren, und Leertaste oder Enter, um einen Skill zwischen on, name-only, user-invocable-only und off umzuschalten.
• /skill-doctor (ab v2.1.252) zeigt, was jeder Skill an Kontext kostet und wie oft er genutzt wird, damit du Ballast findest.
• /context enthaelt eine Skills-Zeile, die zeigt, wie viel deines Fensters die Liste belegt.

Um einen Skill mit deinem Team zu teilen, checke ihn in die .claude/skills/ des Repos ein. Fuer mehr als ein Repo packst du ihn in ein Plugin. Fuer alle in einer Organisation verteilst du ihn ueber Managed Settings.

Wenn ein Skill sich falsch verhaelt, steht die Ursache fast immer in dieser Liste:

Skills vs Plugins vs Memory Packs

Diese drei werden staendig verwechselt. Sie loesen unterschiedliche Probleme.

Skills und Plugins liegen auf derselben Achse in unterschiedlichem Massstab: was zu tun ist und wie es verteilt wird. Memory Packs liegen auf einer anderen Achse, und genau die fehlt den meisten Setups. Ein Skill kann Claude perfekt erklaeren, wie man eine Launch-E-Mail schreibt, und die E-Mail klingt trotzdem nach niemandem, weil der Skill deine Positionierung nicht kennt, den Einwand, den du in Verkaufsgespraechen staendig hoerst, oder die Meinung, die du dir letzte Woche gebildet hast. Ein Memory Pack ist die "deine Fakten"-Haelfte des Paares: echter Kontext, den du in dein Gehirn injizierst, damit derselbe Skill deinen Output erzeugt statt eines generischen.

Was dir niemand sagt: auch Skills veralten. Hier ist der Fehler, der einen Monat nach deiner Begeisterung fuer Skills 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 weiter selbstbewusst die alte Regel an. Ein Skill ist statischer Text. Sobald sich deine Realitaet bewegt, ist er still und leise falsch, und du aktualisierst ihn wieder von Hand.

Die Loesung: Jede Ebene macht genau eine Aufgabe. Skills halten das dauerhafte Wie: die Schritte, das Format, die Pruefungen. Alles, was sich aendert (Versionen, Namen, Preise, Entscheidungen), gehoert in eine Memory-Ebene, die sich selbst aktualisiert und die der Skill zur Laufzeit liest, statt sie fest einzuschreiben.

Genau diese Ebene aktueller Fakten soll Locul sein. Locul ist eine Local-first-Desktop-App, die aus dem, was du ohnehin produzierst (lokale Dateien, PDFs, Diktate, Notion und dein LinkedIn-Profil), ein Second Brain aufbaut, es selbststaendig aktuell haelt und es Claude Code ueber MCP bereitstellt. Aendert sich ein Fakt, wird die alte Version als ueberholt markiert und die neue aktiv, ohne dass du etwas bearbeitest. Du kannst Locul ueber MCP mit Claude Code verbinden, ohne eine Konfiguration von Hand zu bearbeiten: Locul traegt seinen MCP-Server selbst in die Nutzerkonfiguration von Claude Code ein, damit deine Skills die Fakten von heute ziehen statt die vom letzten Quartal. Die meisten installieren einen Haufen Skills, erleben einen Schub und stagnieren dann, weil sie das Wie geloest und das Was nie angefasst haben.

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, was der Skill tut und wann er genutzt wird, und Markdown-Anweisungen, was zu tun ist. Claude laedt den ganzen Skill nur, wenn deine Anfrage zu seiner Beschreibung passt oder wenn du /skill-name tippst.

Sind Claude Skills nur fuer Claude Code?

Nein. Skills funktionieren auch in den Claude-Apps in den Tarifen Free, Pro, Max, Team und Enterprise. Aktiviere "Code execution and file creation" unter Settings > Capabilities und schalte Skills dann unter Customize > Skills ein oder aus; fuer eigene Skills zippst du den Skill-Ordner und waehlst dort +, dann Create skill, dann Upload a skill. Anthropics Hilfeartikel, wie du Skills in Claude nutzt, beschreibt die aktuellen Schritte. In der API sind Skills fuer Nutzer des Code-Execution-Tools in der Beta. claude.ai und die API akzeptieren weniger Frontmatter-Felder als Claude Code, ein Skill mit context: fork oder disable-model-invocation laesst sich dort also nicht unveraendert hochladen.

Wie erstelle ich einen Claude Skill?

Lege einen Ordner wie ~/.claude/skills/my-skill/ an und darin eine SKILL.md mit einer description im Frontmatter und deinen Anweisungen darunter. Das ist das Minimum. Claude Code erkennt ihn in der laufenden Sitzung, und /my-skill fuehrt ihn aus.

Wie nutze oder starte ich einen Skill?

Auf zwei Arten. Frag etwas, das zur Beschreibung des Skills passt, und Claude laedt ihn automatisch, oder tippe /skill-name am Anfang einer Nachricht, um ihn direkt auszufuehren. Plugin-Skills laufen als /plugin-name:skill-name. Wenn das automatische Laden unzuverlaessig ist, liegt es fast immer an der Beschreibung.

Wie fuege ich Claude Code Skills hinzu?

Kopiere einen Skill-Ordner nach ~/.claude/skills/ oder in die .claude/skills/ deines Projekts, oder installiere ein Plugin: /plugin install <plugin>@<marketplace>, wobei du den Marketplace vorher mit /plugin marketplace add owner/repo hinzufuegst, falls es nicht der offizielle von Anthropic ist. In deinem claude.ai-Konto aktivierte Skills werden ausserdem in Claude Code synchronisiert, wenn du dich mit demselben Konto anmeldest.

Wo werden Claude Code Skills gespeichert?

Persoenliche Skills liegen unter ~/.claude/skills/, Projekt-Skills unter .claude/skills/ in einem Repo (zum Teilen einchecken) und Plugin-Skills im skills/-Ordner des Plugins. Organisationen koennen Skills ausserdem ueber Managed Settings verteilen. Unter Windows wird ~/.claude zu %USERPROFILE%\.claude aufgeloest. Mit /skills siehst du alles, was geladen ist.

Ist ein Skill dasselbe wie ein Slash Command oder ein Plugin?

Ein Skill und ein eigener Slash Command sind inzwischen dasselbe: .claude/commands/deploy.md und .claude/skills/deploy/SKILL.md erzeugen beide /deploy, und der Skill gewinnt, wenn beide existieren. Ein Plugin ist etwas anderes: ein Verteilungspaket, das mehrere Skills plus Agents, Hooks oder MCP-Server buendeln kann, damit du sie zusammen installieren und aktualisieren kannst.

Werden meine Skills veralten?

Die Anweisungen nicht, aber alle Fakten, die darin fest eingeschrieben sind. Verweist ein Skill auf deinen Stack, deine Namen oder deine Preise, wendet er die alten Werte weiter an, nachdem du sie geaendert hast. Halte das dauerhafte "Wie" in Skills und das veraenderliche "was jetzt gilt" in einer Memory-Ebene, die sich selbst aktualisiert, damit du nicht jedes Mal Skills von Hand bearbeitest, wenn sich deine Realitaet bewegt.