Claude Skills sind wiederverwendbare Anleitungen in einem Ordner mit einer SKILL.md, die Claude automatisch lädt, sobald eine Aufgabe dazu passt. Du erklärst einen Ablauf also genau einmal, und ab dann weiß Claude Bescheid – im Browser auf claude.ai, in der Desktop-App, in Cowork und in Claude Code.
Kennst du das? Manche Anweisungen tippst du immer wieder: „Halte dich an unseren Commit-Stil“, „schreib in meinem Stil“. Genau dafür gibt es Skills. Hier erfährst du, wie sie funktionieren, wie du sie mit und ohne Terminal installierst, welche fertigen sich lohnen und wie du eigene baust – inklusive Tiefgang zu Claude Code Skills.
Das Wichtigste in Kürze
- Ein Skill ist eine wiederverwendbare Anleitung in einer
SKILL.md, die Claude automatisch lädt, wenn sie zur Aufgabe passt. - Skills laufen in claude.ai, der Desktop-App, Cowork, Claude Code und über die API, laut Help Center in allen Tarifen inklusive Free.
- Dank Progressive Disclosure kostet ein Skill im Ruhezustand nur rund 80 Tokens.
- Installieren: in claude.ai als ZIP unter Einstellungen > Skills, in Claude Code als Ordner, geprüft mit /skills.
- Skills sind das Know-how, MCP die Leitung, Plugins die Verpackung.
- Die
descriptionentscheidet über alles: Nur an ihr erkennt Claude, ob ein Skill zur Aufgabe passt. - Fremde Skills behandelst du wie Software: erst lesen, dann installieren.
- Das Format ist ein offener Standard, liegt seit Oktober 2026 bei der Linux Foundation und läuft in über 70 Tools.

Was sind Claude Skills?
Ein Skill ist eigentlich nichts anderes als eine Anleitung als Text, die in einer SKILL.md steckt. Darin steht, was die Fähigkeit draufhat, wann sie gebraucht wird und welche Schritte Claude abarbeiten soll. Wenn du willst, packst du noch Skripte, Templates oder andere Dateien dazu.
Skills werden manchmal auch „Plugins auf Anweisungsbasis“ genannt – passt ziemlich gut. Du musst nichts kompilieren oder umständlich installieren, sondern brauchst nur ordentlich aufgebautes Markdown. Kannst du eine Datei schreiben, kannst du auch einen Skill erstellen.
Der Clou dabei: Claude holt sich einen Skill erst dann, wenn er zur Aufgabe passt. Stell dir ein Kochbuch im Regal vor: Erst wenn gekocht wird, zieht Claude das passende Rezept raus. Ob du nun Opus 5.5, Sonnet 5.5 oder Haiku 5.5 nutzt, macht dabei keinen Unterschied.
Anthropic hat das Feature im Oktober 2025 rausgebracht – erst mal nur als kleine Verbesserung für bestimmte Aufgaben. Die Idee kam aber so gut an, dass Skills mittlerweile in Claudes gesamtem Ökosystem funktionieren. Einmal erstellen, überall einsetzen.
Warum Skills mehr sind als ein Textschnipsel
Ein Skill löst gleich vier Probleme auf einmal:
- Wiederverwendbarkeit: Du erklärst eine Sache genau einmal, nicht bei jedem neuen Chat.
- Kontextökonomie: Der Skill schläft, bis er gebraucht wird. Dazu gleich mehr.
- Teamstandardisierung: Liegt der Ordner
.claude/skills/im Git-Repo oder teilst du den Skill in claude.ai, arbeitet dein ganzes Team nach denselben Regeln. Ohne Wiki, ohne Onboarding-Call. - Kompositionsfähigkeit: Ein Skill kann Skripte ausführen, MCP-Tools ansprechen, einen Subagenten starten oder auf andere Skills verweisen. Er ist der Dirigent, nicht nur die Notiz.

Progressive Disclosure: warum Skills dein Kontextfenster nicht zumüllen
Klingt ein Skill für dich erst mal wie „noch mehr Text, den Claude lesen muss“? Das muss aber gar nicht sein! Der eigentliche Geniestreich heißt Progressive Disclosure, zu Deutsch etwa „schrittweise Offenlegung“. Laut dem offiziellen Agent-Skills-Standard läuft das so ab:
- Discovery (Entdecken): Beim Start liest Claude nur Name und Beschreibung jedes Skills. Das ist quasi dein Inhaltsverzeichnis.
- Activation (Aktivieren): Passt eine Aufgabe dazu, lädt Claude die vollständige SKILL.md nach – und behält sie für den Rest der Session im Kontext.
- Execution (Ausführen): Erst wenn ein Detail gebraucht wird, liest Claude zusätzliche Dateien oder führt ein hinterlegtes Skript aus.
Wieso spielt das eine so große Rolle? Weil dein Kontextfenster nun mal begrenzt ist – und die Antworten schlechter werden, je mehr darin steckt. Tests mit Anthropics offiziellen Skills zeigen, dass ein Skill im Ruhezustand einen Median von rund 80 Tokens pro Skill hat. Selbst Dutzende Skills bremsen Claude also nicht aus und treiben auch die Kosten nicht hoch.
Genau das ist der Unterschied zu einer riesigen CLAUDE.md, die immer komplett mitläuft. Skills sind wie ein gut sortiertes Regal: Claude sieht die Etiketten, greift aber nur nach dem Buch, das er gerade braucht.
Wo Claude Skills laufen
Claude Skills sind längst kein reines Entwickler-Feature mehr. Laut Help Center stehen sie in allen Tarifen zur Verfügung, von Free bis Enterprise. Einzige Voraussetzung in den Claude-Apps: Die Code-Ausführung muss eingeschaltet sein.
- claude.ai und Desktop-App: mitgelieferte Skills für Word, Excel, PowerPoint und PDF, eigene Skills per ZIP-Upload und ein Verzeichnis mit fertigen Skills. Alles ohne Terminal.
- Cowork: nutzt die Skills aus deinem Konto und läuft seit Juli 2026 auch im Browser und auf dem Handy. Cowork selbst setzt allerdings einen bezahlten Tarif voraus.
- Claude Code: Skills als Ordner auf deiner Festplatte, dazu Plugins. Meldest du dich mit deinem claude.ai-Konto an, holt sich Claude Code ab Version 2.1.273 zusätzlich die Skills aus deinem Konto – nur lesend, nie zurück.
- Microsoft 365: In den Claude-Add-ins für Excel, PowerPoint, Word und Outlook stehen deine aktivierten Skills ebenfalls bereit, aufrufbar mit
/. - API: Entwickler laden Skills über die Skills-API hoch und nutzen sie mit dem Code-Execution-Tool. Was du in claude.ai hochlädst, landet nicht automatisch dort.
Wichtig, weil viele darüber stolpern: Cowork- und Cloud-Sessions lesen deinen lokalen Ordner ~/.claude/skills/ nicht. Was nur auf deinem Rechner liegt, existiert für sie schlicht nicht.

Claude Skills installieren und verwalten
Wie die Installation eines Skills läuft, kommt darauf an, wo du ihn einsetzen willst. Das Gute daran: Bei claude.ai, der Desktop-App und Cowork kommst du komplett ohne Terminal aus. Ganz easy!
In claude.ai, Desktop und Cowork: Skills ohne Terminal installieren
Der Weg ist überall derselbe, so steht’s in Anthropics Anleitung. In der deutschen Oberfläche heißen die Menüs so:
- Öffne Einstellungen > Funktionen und schalte unter „Codeausführung und Dateierstellung“ Code in der Cloud ausführen ein. Ohne diesen Schalter laufen keine Skills.
- Geh zu Einstellungen > Skills. Unter Meine siehst du alle deine Skills und schaltest sie an oder aus.
- Klick oben rechts auf Hinzufügen und dann auf Skill hochladen. Mit Einen Skill erstellen oder Mit Claude erstellen legst du stattdessen einen neuen an.
- Lade eine ZIP-Datei mit deinem Skill-Ordner hoch und aktiviere den Skill.


Hier scheitern die meisten: In der ZIP-Datei muss der komplette Skill-Ordner stecken, nicht bloß die Dateien darin. Und sein Ordnername muss mit dem name im Frontmatter übereinstimmen.
Wenn du fertige Skills suchst, findest du sie auf derselben Seite im Reiter Entdecken oder im Chat über + > Skills > Skills durchsuchen, im Verzeichnis mit Skills, Connectors und Plugins. Dort gibt es auch Partner-Skills von Notion, Canva, Figma, Atlassian und weiteren Anbietern. Bei Team und Enterprise kann ein Owner Skills unter Organization settings > Plugins & skills freigeben und für alle zentral bereitstellen. So werden Skills zu einem festen Bestandteil der Infrastruktur statt bloß zu einem privaten Bastelprojekt.

Einen installierten Skill rufst du im Chat gezielt über + > Skills auf. Meist ist das gar nicht nötig, weil Claude passende Skills von selbst lädt.

Claude Code Skills installieren und mit /skills verwalten
In Claude Code listet dir der Slash-Command /skills alle Skills auf, die du nutzen kannst. Per Leertaste wechselst du zwischen den Einstellungen: an, nur mit Namen, nur manuell oder komplett aus. Wie viel Kontext jeder Skill verbraucht und welche du überhaupt nicht verwendest, zeigt dir /skill-doctor. Normalerweise brauchst du einen Skill gar nicht selbst aufzurufen. Claude lädt ihn automatisch, wenn er zur Aufgabe passt. Willst du ihn bewusst starten, geht das mit /skill-name.
In der Liste siehst du auch, woher ein Skill kommt (project, user oder claude.ai sync) und wie viele Tokens seine Beschreibung ungefähr kostet. Hier steht der blog-formatter nach einem Druck auf die Leertaste auf name-only: Claude kennt dann nur noch seinen Namen.

Randnotiz für alle, die schon länger dabei sind: Im Januar 2026 hat Anthropic mit Version 2.1.3 Slash-Commands und Skills zu einem Werkzeug verschmolzen. Ein Slash-Command ist seitdem nur ein Skill, den du von Hand aufrufst. Alte Dateien unter .claude/commands/ laufen weiter.
Wo Skills in Claude Code liegen
Claude sucht an verschiedenen Stellen danach. Taucht ein Name mehrfach auf, greift laut offizieller Doku diese Reihenfolge: Enterprise hat Vorrang vor persönlich, persönlich vor Projekt.
- Persönlich: unter
~/.claude/skills/<name>/, für alle Projekte auf deinem Rechner. - Projekt-spezifisch: unter
.claude/skills/<name>/im Repo. Commitest du den Ordner, hat jeder im Team dieselben Skills. - Über Plugins: als Paket aus einem Marketplace, sauber unter eigenem Namensraum.
- Organisationsweit: von Admins über Managed Settings an alle verteilt.
- Aus deinem claude.ai-Konto: synchronisiert nach
~/.claude/skills/synced/, in /skills unter „claude.ai sync“.
Im Monorepo werden verschachtelte .claude/skills/-Ordner erkannt, sobald Claude dort an Dateien arbeitet. Die Ordnernamen synced und anthropic-skills sind reserviert.
Besonders spannend sind die Routines, seit Mai 2026 offiziell verfügbar: Damit laufen Skills zeitgesteuert oder event-basiert in der Cloud, etwa wenn ein GitHub-Webhook feuert. Dein Security-Skill prüft dann jede Nacht die Abhängigkeiten, bevor du überhaupt den Rechner hochfährst.
Ein Fehler, über den viele stolpern: Routines arbeiten in der Cloud und haben keinen Zugriff auf deinen persönlichen Ordner ~/.claude/skills/. Sie sehen ausschließlich Skills, die im Repo unter .claude/skills/ eingecheckt sind oder die du in deinem claude.ai-Konto aktiviert hast. Findet deine Routine also „den Skill nicht“, ist das fast immer der Grund.
Fertige Skills per Plugin installieren
Du brauchst das Rad nicht neu zu erfinden: Das offizielle Skills-Repository von Anthropic auf GitHub kannst du in Claude Code als Marketplace einbinden. Dafür brauchst du gerade mal zwei Befehle:
# 1. Offizielles Repo als Marketplace hinzufügen
/plugin marketplace add anthropics/skills
# 2. Dokumenten-Skills installieren (PDF, Excel, Word, PPTX)
/plugin install document-skills@anthropic-agent-skillsDamit kann Claude dann zum Beispiel Excel-Reports samt Formeln bauen, Word-Dokumente erstellen oder PDFs auslesen. Und noch ein praktischer Vorteil: Änderst du etwas in einer SKILL.md, greift die Änderung direkt. Neustarten musst du nichts.
Es geht auch ohne Befehle abzutippen: Gib /plugin ein und wechsle auf Discover. Dort stehen über 3.600 Plugins, sortiert nach Installationen. Mit der Leertaste wählst du eins aus, mit Enter siehst du die Details.

Skills teilen: vom Git-Ordner bis zum eigenen Plugin
Der einfachste Weg ist auch der unspektakulärste: Du commitest den Skill unter .claude/skills/. Wer das Repo klont, hat ihn sofort dabei.
Bei claude.ai brauchst du dafür kein Git: Mit dem Team- und Enterprise-Tarif kannst du Skills über das Drei-Punkte-Menü an Kollegen weitergeben. Im Enterprise-Tarif geht das sogar für ganze Gruppen. Über Publish to org schlägst du einen Skill für die Bibliothek deiner Organisation vor.
Willst du in Claude Code mehr Leute erreichen, packst du alles in ein Plugin. Das ist ein Verzeichnis, in dem du Skills, Subagenten, Hooks und MCP-Konfigurationen über eine plugin.json zusammenfasst. Damit bekommst du Versionierung und einen eigenen Namensraum, etwa /mein-plugin:review. Weitergeben kannst du es über den offiziellen Community-Marketplace oder dein eigenes Git-Repo. Zum Ausprobieren brauchst du aber nichts zu veröffentlichen:
# Marketplace hinzufügen
/plugin marketplace add anthropics/claude-plugins-community
# Lokal testen, ohne irgendwas zu veröffentlichen
claude --plugin-dir ./mein-pluginMit /reload-plugins lädst du Änderungen einfach nach, ohne Claude Code dafür neu hochzufahren.

Die besten fertigen Claude Skills
Die Community ist hier verdammt fleißig: Laut Anthropic sind inzwischen rund eine Million Skills veröffentlicht. „Die besten Claude Skills“ gibt es trotzdem nicht pauschal, es kommt auf deine Aufgabe an. Die GitHub-Sterne (Stand: 3. November 2026) zeigen, wie beliebt ein Projekt ist – nicht, ob es gut oder sicher ist.
Die mitgelieferten Skills von Anthropic
Den einfachsten Einstieg hast du schon an Bord: In claude.ai bringt Anthropic Skills für Excel, Word, PowerPoint und PDF mit. Bittest du Claude um eine Präsentation, greift er automatisch zum PowerPoint-Skill. Der heimliche Star ist aber der skill-creator: Er fragt deinen Ablauf ab, baut daraus den Skill und testet auf Wunsch, ob er wirklich hilft. Claude Code bringt außerdem gebündelte Skills wie /code-review oder /debug mit.
Die offizielle Sammlung: anthropics/skills
anthropics/skills ist mit rund 187.000 Sternen die erste Adresse für dich. Dort hat Anthropic einige seiner eigenen Skills auf GitHub zugänglich gemacht. Dazu zählen skill-creator, frontend-design, brand-guidelines und mcp-builder. Kleiner Hinweis: Die Dokument-Skills sind dort nur „source-available“. Du darfst sie dir also anschauen, Open Source sind sie aber nicht.
Besonders beliebt ist das offizielle frontend-design-Plugin. Sein einziger Job: verhindern, dass deine Oberflächen aussehen wie von der KI zusammengeklickt – also kein Standard-Inter, kein lila Farbverlauf, keine austauschbaren Karten. Installiert wird es mit einem Befehl:
/plugin install frontend-design@claude-plugins-officialKoppelst du so einen Design-Skill per MCP mit einem WordPress- oder Shop-Server, sagt der Skill, wie es aussehen soll, und der Server bringt es dorthin, wo es hingehört.
Community-Skills, die sich wirklich lohnen
Aus der Community lohnen sich vor allem diese Projekte:
- obra/superpowers (rund 311.000 Sterne): eher ein Framework als ein einzelner Skill. Es bringt Claude Code eine saubere Arbeitsweise bei, von Planung über testgetriebene Entwicklung bis zu systematischem Debugging. Ideal, wenn du mit Claude Code Websites oder Apps baust.
- coreyhaines31/marketingskills (rund 58.000 Sterne): rund 50 Skills für Conversion-Optimierung, Copywriting, SEO, Ads und Analytics. Die naheliegende Wahl für Selbstständige und Marketer.
- AgriciDaniel/claude-seo: ein SEO-Baukasten mit Unter-Skills und Subagenten für technische Audits, strukturierte Daten und Sichtbarkeit in KI-Suchen. Stark für SEO-Profis, für den gelegentlichen Blogartikel überdimensioniert.
- pbakaus/impeccable (rund 101.000 Sterne): ein Design-Vokabular gegen austauschbares KI-Design, mit Befehlen wie
critique,auditundpolish. Perfekt für Webdesigner. - nextlevelbuilder/ui-ux-pro-max-skill (rund 145.000 Sterne): durchsuchbares Designwissen zu Farben, Typografie und UI-Mustern für Landingpages, Dashboards und Apps.
- anthropics/knowledge-work-plugins: Anthropics Sammlung für Büro- und Wissensarbeit, interessant für Cowork. Achtung: Das sind Plugins, also ganze Bündel, keine einzelnen ZIP-Skills.
In vielen Sammlungen tauchen außerdem dieselben Klassiker auf:
- test-driven-development: zwingt Claude, erst den Test zu schreiben und dann den Code.
- systematic-debugging: statt wildem Raten ein sauberer Ablauf aus reproduzieren, eingrenzen, Hypothese, Fix.
- code-reviewer: läuft meist mit
context: forkim eigenen Fenster und liefert nur das Ergebnis zurück. - security-scan: prüft Code gegen typische OWASP-Schwachstellen.
- commit-writer: baut die Commit-Message direkt aus dem gestagten Diff.
Verzeichnisse – und gibt es deutsche Skills?
Zum Stöbern eignen sich gepflegte Sammlungen wie travisvn/awesome-claude-skills (rund 15.700 Sterne) oder ComposioHQ/awesome-claude-skills. Aber Achtung: Wer dort steht, hat noch lange kein Gütesiegel.
Wie sieht’s mit deutschen Skills aus? Größere Sammlungen auf Deutsch gibt’s bisher kaum. Deshalb mein Rat: Erstell dir die wichtigsten Skills einfach selbst. Deine Anweisungen kannst du komplett auf Deutsch verfassen. Nur die Feldnamen wie name und description müssen englisch bleiben.

Einen eigenen Claude Skill erstellen
Ab hier geht’s ans Selbermachen. Egal, ob du einen Claude Code Skill erstellen oder einen Skill für claude.ai anlegen möchtest: Der grundlegende Aufbau unterscheidet sich nicht. Eine minimale Struktur sieht so aus:
.claude/
skills/
conventional-commits/
SKILL.md
examples.md (optional)Sobald dein Skill wächst, teilst du ihn sauber auf:
mein-skill/
├── SKILL.md # Pflicht: Frontmatter + Anleitung
├── scripts/ # optional: ausführbare Skripte
├── references/ # optional: Details, die nur bei Bedarf geladen werden
├── templates/ # optional: Vorlagen
└── assets/ # optional: Bilder, BeispieldateienDu musst eigentlich nur auf eines achten: Die SKILL.md gehört direkt in den Skill-Ordner und nicht in irgendeinen Unterordner. Ganz oben steht ein kurzer Info-Block mit Name und Beschreibung, den man in der Fachsprache „Frontmatter“ nennt. Darunter schreibst du die richtige Anleitung als einfachen Text. Claude entscheidet anhand der Beschreibung, wann der Skill dran ist. Schreib deshalb möglichst genau, wofür er gedacht ist.
---
name: conventional-commits
description: Schreibt Commit-Messages im Conventional-Commits-Stil.
Nutze diesen Skill, wenn ein Git-Commit erstellt werden soll.
---
# Conventional Commits
Wenn du einen Commit erstellst, halte dich an dieses Format:
<type>(<scope>): <kurze Beschreibung>
## Erlaubte Types
- feat: neue Funktion
- fix: Bugfix
- docs: nur Dokumentation
- refactor: Code-Umbau ohne Verhaltensänderung
- test: Tests hinzufügen oder anpassen
## Regeln
- Beschreibung im Imperativ, klein, ohne Punkt am Ende.
- Maximal 72 Zeichen in der ersten Zeile.
- Body nur bei nicht-trivialen Änderungen.Das war’s schon. Mit /skills kannst du in Claude Code nachschauen, ob dein Skill angezeigt wird. Bei claude.ai packst du den Ordner in eine ZIP-Datei und lädst sie hoch. Gratulation, dein erster Skill ist fertig!
Ohne Code: Skills im Chat bauen oder einfach aufnehmen
Keine Lust, selbst an Dateien herumzubasteln? Brauchst du gar nicht! Sag Claude einfach, dass er dir einen Skill bauen soll. Der skill-creator stellt dir ein paar gezielte Fragen und baut daraus deinen fertigen Skill.
Es geht sogar noch einfacher mit Record a skill: In Cowork auf dem Mac zeichnest du einen Ablauf auf deinem Bildschirm auf und erklärst dabei laut, was du machst. Claude baut dir daraus einen Skill. Das Help Center sagt, dass das mit Pro, Max, Ultra und Team klappt. Die Aufnahmen dauern etwa zehn Minuten. Achte nur darauf, dass keine Passwörter auf dem Bildschirm zu sehen sind.
Bau den Skill nicht am Reißbrett. Arbeite eine Aufgabe erst ganz normal im Chat durch, bis das Ergebnis sitzt. Und dann sagst du einfach: „Fasse das als Skill zusammen.“ Claude schreibt dir die SKILL.md aus dem, was gerade nachweislich funktioniert hat. Besser geht’s kaum.
Die wichtigsten Frontmatter-Felder
Hier wird’s kurz technisch. Der offene Standard kennt nur sechs Felder: name, description, license, compatibility, metadata und allowed-tools. Nur die darfst du in Skills nutzen, die du in claude.ai oder über die API hochlädst. Alles andere löst dort laut Claude-Code-Doku eine Fehlermeldung aus. Die wichtigsten Felder:
- name: maximal 64 Zeichen, nur Kleinbuchstaben, Zahlen und Bindestriche, keine reservierten Wörter wie „claude“ oder „anthropic“. Im Standard und beim Upload muss er exakt dem Ordnernamen entsprechen, in Claude Code ist er optional.
- description: der wichtigste Trigger überhaupt. Sie darf bis zu 1.024 Zeichen lang sein und sagt, was der Skill tut und wann Claude ihn nutzen soll.
- allowed-tools: gibt die genannten Werkzeuge für den Aufruf ohne Rückfrage frei. Achtung, das ist keine Sperrliste! Dafür gibt es in Claude Code
disallowed-tools. - disable-model-invocation (Claude Code): verhindert den automatischen Aufruf, etwa bei einem Deploy. Die Beschreibung belegt dann nicht mal mehr Kontext.
- context: fork (Claude Code): lässt den Skill in einem isolierten Subagenten laufen. Perfekt für alles mit viel Output.
- effort und model (Claude Code): steuern Gründlichkeit und Modell. Ein Review darf ruhig teuer sein, ein Formatierer nicht.
- paths (Claude Code): bindet den Skill per Glob-Muster an bestimmte Dateien, etwa nur an Tests.
Dann gibt’s noch ein paar Extras wie user-invocable, argument-hint und hooks. Aber mal ehrlich: In 90 Prozent aller Fälle kommst du mit name und description bestens aus.
Dynamischer Kontext statt starrer Anweisungen
Für Fortgeschrittene gibt’s noch einen ziemlich praktischen Kniff: Über die !-Syntax kann deine SKILL.md Befehle starten und deren Ausgabe direkt einfügen. Mit !`git diff HEAD` landen zum Beispiel die aktuellen Änderungen im Kontext, bevor Claude sie zusammenfasst. Das geht aber ausschließlich in Claude Code. Auf claude.ai oder über die API klappt es nicht.
Praktisch sind auch ein paar Variablen: $ARGUMENTS schnappt sich, was du beim Aufruf mitgibst. ${CLAUDE_SKILL_DIR} zeigt auf den Ordner des Skills und ${CLAUDE_PROJECT_DIR} auf die Projektwurzel. So laufen Skripte und Pfade aus jedem Unterordner heraus.
Ideen für deine ersten Skills
Skills sind übrigens längst nicht nur beim Programmieren nützlich. Sie passen zu jeder Aufgabe, die immer wieder auf deinem Tisch landet:
- Dein Schreibstil: Tonalität, Struktur und Länge deiner Blogartikel oder Newsletter.
- Standard-Dokumente: dein Format für Angebote, Rechnungen oder E-Mail-Antworten an Kunden.
- Commit- und Test-Regeln: für Entwickler, wie oben gezeigt.
- Onboarding-Schritte: alles, was neue Mitstreiter zum Aufsetzen eines Projekts brauchen.
- Deploy-Checkliste: am besten mit
disable-model-invocation, damit sie nur läuft, wenn du es sagst.
Als Faustregel kannst du dir merken: Musst du etwas mehr als zweimal erklären, lohnt es sich, dafür einen Skill zu bauen.
Ein Beispiel für alle, die mit WordPress arbeiten. Ich selbst hab damit die besten Erfahrungen gemacht: ein kleiner Blog-Formatter, der jeden Rohtext in eine saubere, SEO-freundliche Struktur bringt.
---
name: blog-formatter
description: Formatiert Blog-Artikel für WordPress. Optimiert Struktur,
SEO, Lesbarkeit und Heading-Hierarchie. Nutzen bei "Formatiere diesen
Blogpost" oder "Mache das WordPress-tauglich".
---
# WordPress Blog Formatter
## Aufgabe
Nimm den bereitgestellten Text und liefere eine optimierte Version zurück.
## Regeln
1. Struktur: H2/H3 logisch gegliedert, niemals ein zweites H1 im Body.
2. SEO: Keyword in den ersten 100 Wörtern, Meta-Description-Vorschlag am Ende.
3. Lesbarkeit: kurze Absätze, Aufzählungen wo sinnvoll, Fettung für Schlüsselbegriffe.
4. Sprache: aktiv, direkte Ansprache, sauberes Deutsch.
5. Am Ende: Alt-Text-Vorschläge für Bilder und Ideen für interne Verlinkung.Hast du ihn einmal eingerichtet, bringt Claude von da an jeden Entwurf genau in dieses Format. Die Regeln musst du kein einziges Mal mehr eintippen.

Skills, CLAUDE.md, MCP, Subagenten oder Plugins: was wann?
Bei all den Begriffen verliert man leicht den Faden. Hört sich ziemlich kompliziert an? Ist es gar nicht. Die einzelnen Konzepte passen zusammen, kümmern sich aber um verschiedene Probleme:
- Skills sind Wissen und Anleitungen. Sie sagen Claude wie etwas gemacht wird, und werden in den laufenden Kontext geladen.
- Slash-Commands sind manuelle Shortcuts für ganz einfache, immer gleiche Handgriffe. Sie werden nicht automatisch erkannt.
- Subagenten sind eigenständige Helfer mit eigenem Kontextfenster. Sie übernehmen Teilaufgaben wie eine Recherche oder ein Code-Review und liefern nur die Zusammenfassung zurück. Subagenten delegieren Arbeit, Skills beschreiben Arbeit. Übrigens: Ein Subagent kann keine weiteren Subagenten starten.
- Plugins sind das Verpackungsformat für Skills, Subagenten, Slash-Commands und Hooks, teilbar über einen Marketplace.
- MCP (Model Context Protocol) ist die Anbindung an die Außenwelt, etwa an GitHub, eine Datenbank oder den Browser. In claude.ai heißen diese Anbindungen Connectors.
Ein schönes Bild dafür: MCP ist die Leitung, Skills sind das Handbuch. MCP liefert die Daten und den Zugang, der Skill das Know-how, wie man damit umgeht. Anthropic selbst zieht denselben Vergleich zwischen Skills und MCP. Ein Skill kann ein MCP-Tool nutzen – umgekehrt geht das nicht.
Ein Unterschied, den viele unterschätzen: Ein MCP-Server bringt seinen Tool-Katalog mit in den Kontext, ein Skill nur Name und Beschreibung. Für eine reine Anweisungssache einen MCP-Server aufzusetzen, wäre deshalb, wie mit Kanonen auf Spatzen zu schießen. Und keine Sorge: Für den Anfang reicht ein einziger Skill völlig.
Die 30-Prozent-Regel: CLAUDE.md, Projekt oder Skill?
Früher oder später fragst du dich garantiert: Was packe ich denn nun wohin? Zum Glück hilft dir dabei eine simple Faustregel.
Brauchst du bestimmtes Wissen in mehr als 30 Prozent deiner Anfragen – etwa deinen Tech-Stack, die Ordnerstruktur oder die allgemeinen Projektregeln – dann pack es in die CLAUDE.md. Wissen, das du seltener brauchst, dann aber ganz gezielt, ist in einem Skill besser aufgehoben.
Der Grund ist einfach: Muss Claude einen Skill dauernd neu laden, macht das unnötig Arbeit. Stopfst du dagegen die CLAUDE.md mit allem voll, schleppt jede Anfrage diesen Ballast mit. Die Claude-Code-Doku empfiehlt einen Skill auch dann, wenn aus einem Abschnitt deiner CLAUDE.md mittlerweile eine komplette Prozedur geworden ist.
Im Browser heißt die Frage eher: Projekt oder Skill? Anthropics Skills-Tutorial rät: festes Verfahren in einen Skill, wachsender Kontext in ein Projekt. Beides lässt sich kombinieren.
Der Entscheidungsbaum: Was nehme ich wann?
Du brauchst dir darüber nicht ewig den Kopf zu zerbrechen. Arbeite diese Fragen einfach der Reihe nach ab:
- Brauchst du eine externe API oder Datenbank? Dann führt kein Weg an MCP vorbei.
- Willst du selbst auslösen, wann etwas passiert? Bei einem Einzeiler reicht ein Slash-Command. Bei allem Größeren nimmst du einen Skill und schaltest den automatischen Aufruf ab.
- Soll es automatisch laufen und produziert viel Output? Ab damit in einen Subagenten mit isoliertem Kontext.
- Soll es automatisch laufen und bleibt schlank? Klassischer Fall für einen Skill.
- Willst du es teamweit verteilen? Pack alles in ein Plugin.

Best Practices und typische Fehler
Wenn du dir nur eine Sache aus diesem Artikel mitnimmst, dann diese:
Die description entscheidet über rund 90 Prozent der Wirkung. Denn nur an diesem Signal kann Claude erkennen, ob ein Skill für die jeweilige Aufgabe geeignet ist.
Ein Abschnitt mit „Wann nutzen“ im Body hilft dabei nicht weiter – Claude schaut dort schließlich erst rein, nachdem der Skill geladen wurde. Diese Formel hat sich als zuverlässig erwiesen:
[Verb] + [Ziel] + [Standard]. Use when [Bedingung].
Schreib also nicht einfach „Hilft bei Commits“. Besser ist „Erstellt Commit-Messages nach Conventional Commits. Nutzen, wenn ein Git-Commit erstellt oder eine Message umformuliert wird.“ Auch Anthropic rät in seinen Best Practices für Skills zur dritten Person und zu klar benannten Auslösern. Mein Praxistipp: Englische Trigger-Wörter klappen häufig besser.
Der Rest ist schnell erzählt:
- Eine Fähigkeit pro Skill. Ein Skill, der zehn Dinge kann, wird selten zuverlässig geladen.
- Halte die SKILL.md kurz. Anthropic empfiehlt als Richtwert rund 500 Zeilen bzw. 5.000 Tokens. Für Referenzdateien haben sich rund 200 Zeilen bewährt, für Skripte etwa 300, für Templates 100. Alles darüber? Dann brauchst du eigentlich zwei Skills.
- Das Wichtigste nach oben. Wird ein langes Gespräch komprimiert, hängt Claude Code nur die ersten 5.000 Tokens jedes Skills wieder an.
- Schreib handlungsorientiert. Nicht „sei gründlich“, sondern „Prüfe zuerst X, dann Y“. Ein gutes Vorher-Nachher sagt mehr als drei Absätze Theorie.
- Sperr kritische Aktionen. Deploys und Datenbank-Migrationen bekommen
disable-model-invocation: true. - Teste mit und ohne Skill. Vergleiche echte Prompts in einer frischen Session mit und ohne Skill. Nur so siehst du, ob er wirklich hilft.
Das Vergleichen übernimmt auf Wunsch das offizielle skill-creator-Plugin, inklusive Vorschlägen für eine bessere description:
/plugin install skill-creator@claude-plugins-officialDie häufigsten Fehler – und wie du sie vermeidest
Fast alle Probleme mit Skills laufen auf dieselben paar Klassiker hinaus:
- Die description ist zu vage. „Hilft beim Code“ ist kein Trigger, der Skill wird nie geladen.
- Die description ist zu eng. Reagiert sie nur auf exakt eine Formulierung, springt sie im Alltag nie an.
- Alles steckt in der SKILL.md. 800 Zeilen sprengen das Prinzip der Progressive Disclosure. Auslagern!
- Der Trigger steht im Body. Den sieht Claude erst nach der Aktivierung.
- name passt nicht zum Ordnernamen. Kleiner Tippfehler, große Wirkung, vor allem beim Upload in claude.ai.
- Das Frontmatter ist kaputt. Die drei Striche gehören in die erste Zeile, Feldnamen müssen exakt stimmen. Sonst lädt Claude Code den Skill ohne Metadaten – und ohne Fehlermeldung.
- Die Code-Ausführung ist aus. Fehlt in claude.ai der Skills-Bereich oder ist alles ausgegraut, liegt es fast immer daran.
- Der Skill liegt nur lokal. Cowork sieht
~/.claude/skills/nicht, aktiviere ihn in deinem claude.ai-Konto. - Jeder Slash-Command wird zum Skill. Ein Einzeiler bleibt besser ein Einzeiler.
Fällt dir was auf? Fast alle Fehler drehen sich um die description. Steck fünf Minuten mehr in diesen einen Satz, dann läuft der Rest fast von allein.
Sicherheit: fremde Skills prüfen
Ein Skill besteht aus Text, der ausgeführt werden kann, darf Skripte mitbringen und hat dieselben Möglichkeiten wie Claude in deiner Umgebung. Deshalb empfiehlt Anthropic, Skills ausschließlich aus vertrauenswürdigen Quellen zu installieren. Das gilt auch, wenn du sie von einem Kollegen bekommst. Die größten Gefahren sind Prompt Injection, also heimlich eingeschleuste Anweisungen, und der Abfluss von Daten.
Dass das keine Theorie ist, zeigt die Studie ToxicSkills von Snyk vom Februar 2026: Von 3.984 Skills aus den Marktplätzen ClawHub und skills.sh hatten 36,8 Prozent mindestens ein Sicherheitsproblem, 13,4 Prozent sogar ein kritisches. In 76 Fällen fanden die Forscher eindeutig bösartigen Code. Anthropics offizielle Skills betrifft das nicht, aber Sterne sind eben kein Sicherheitsnachweis.
Bei offiziellen Anthropic-Skills bist du auf der sicheren Seite, bei zufälligen GitHub-Funden lohnt sich ein prüfender Blick:
- Herkunft prüfen: Originalrepo statt Kopie, bekannter Maintainer statt anonymem Upload.
- Alle Dateien lesen: nicht nur die SKILL.md, sondern auch Skripte, Referenzen und Installationsbefehle.
- Externe Quellen hinterfragen: Lädt ein Skill Inhalte aus dem Netz nach, kann er sich später unbemerkt ändern.
- Warnsignale ernst nehmen: etwa „installiere zuerst diese Voraussetzung“ oder Befehle wie
curl ... | bash. - Rechte checken: In Claude Code kann sich ein Projekt-Skill über
allowed-toolsselbst weitreichende Freigaben geben. - Erst testen: mit Testdaten und nach jedem Update erneut.
Im Enterprise-Tarif gibt’s als Extra ein optionales Skill-Scanning. Damit wird jeder hochgeladene Drittanbieter-Skill vor der ersten Nutzung geprüft. In Claude Code kannst du mit disableSkillShellExecution die !-Syntax ausschalten. Trotzdem gilt: Beide Schutzmaßnahmen sparen dir nicht den eigenen Blick in die Dateien.

Der offene Standard: Skills laufen längst nicht mehr nur in Claude
Und hier kommt vielleicht die spannendste Neuerung: Seit Dezember 2025 gibt es das Format als offenen Standard namens Agent Skills. Die Dokumentation findest du unter agentskills.io. Deine SKILL.md funktioniert damit nicht bloß bei Claude.
Schon kurz nach dem Start konnten OpenAI Codex CLI, Gemini CLI, GitHub Copilot, Cursor, VS Code und über 20 weitere Plattformen das Format lesen. Laut Anthropic sind es inzwischen mehr als 70, darunter auch ChatGPT. Am 22. Oktober 2026 hat Anthropic den Standard dann an die Agentic AI Foundation der Linux Foundation abgegeben. Dort liegt auch schon das Model Context Protocol.
Am Format ändert sich dadurch nichts. Deine Skill-Bibliothek ist eine Investition, die du mitnimmst, selbst wenn du irgendwann das Tool wechselst. Einzige Ausnahme sind Claude-spezifische Felder wie context: fork oder effort: Andere Tools ignorieren sie im besten Fall, claude.ai und die API lehnen sie beim Upload sogar ab. Schreib den Kern deiner Skills also in schlichtem Markdown, dann bist du überall zu Hause.
Du willst noch mehr aus Claude Code rausholen? In meinem Claude-Code-Kurs zeige ich dir Schritt für Schritt, wie du die Dinge selbst umsetzt, die ich hier nur kurz angeschnitten habe: CLAUDE.md, Subagenten, Hooks, Skills und MCP-Server. Dafür musst du nicht programmieren können.

Fazit
Claude Skills sind eines der unterschätztesten Produktivitäts-Features. Sie verwandeln wiederkehrende Erklärungen in wiederverwendbares Wissen, das Claude genau dann zieht, wenn er es braucht – dank Progressive Disclosure, ohne dein Kontextfenster zuzumüllen. Im Browser reicht ein ZIP-Upload, in Claude Code steuerst du jedes Detail, und dank offenem Standard nimmst du deine Bibliothek sogar über Tool-Grenzen hinweg mit.
Fang klein an: Nimm eine Aufgabe, die du immer wieder erklärst, gieß sie in eine SKILL.md, feile an der description, bis sie zuverlässig anspringt, und prüf fremde Skills vor der Installation. Dein zukünftiges Ich wird es dir danken.

Häufig gestellte Fragen
Was sind Claude Skills?
Claude Skills sind Ordner mit einer SKILL.md, in der eine wiederverwendbare Anleitung steht, optional mit Skripten und Vorlagen. Claude lädt einen Skill automatisch, sobald eine Aufgabe zu seiner Beschreibung passt.
Wie installiere ich einen Skill?
Auf claude.ai, in der Desktop-App und in Cowork aktivierst du zunächst die Code-Ausführung unter Einstellungen > Funktionen. Danach kannst du unter Einstellungen > Skills eine ZIP-Datei hochladen, die deinen Skill-Ordner enthält. Bei Claude Code speicherst du diesen Ordner stattdessen in ~/.claude/skills/ oder .claude/skills/.
Funktionieren Skills in der kostenlosen Version?
Ja. Laut Help Center kannst du Skills mit jedem Tarif nutzen, auch mit Free. Die Code-Ausführung muss dafür aber eingeschaltet sein. Auf manchen älteren Seiten steht noch, dass du einen Bezahltarif brauchst. Hier zählt die Angabe im Help Center. Für Cowork brauchst du dagegen einen bezahlten Tarif.
Wo finde ich gute Skills?
Probier zuerst die bereits enthaltenen Skills und das Verzeichnis unter Einstellungen > Skills aus. Anschließend lohnt sich ein Blick auf anthropics/skills bei GitHub. Für Entwickler ist superpowers interessant, für Marketing marketingskills. Bevor du fremde Skills einsetzt, solltest du sie grundsätzlich lesen.
Skills oder MCP-Server?
Häufig brauchst du beides: Über MCP bekommt Claude Zugriff auf Tools und Daten. Ein Skill erklärt ihm, wie er diese richtig nutzt. Geht’s nur um Anweisungen, genügt ein Skill. Willst du eine API oder Datenbank anbinden, brauchst du MCP.
Muss ich einen Skill manuell aktivieren?
Nein, das ist nicht nötig. Claude aktiviert einen Skill von selbst, wenn die description zur Aufgabe passt. Auf claude.ai musst du den Skill lediglich einmal unter Einstellungen > Skills einschalten. Ist dagegen disable-model-invocation: true gesetzt, startet er ausschließlich durch deinen manuellen Aufruf.
Was ist der Unterschied zwischen einem Skill und CLAUDE.md?
Deine CLAUDE.md ist immer im Kontext, ein Skill wird nur bei Bedarf geladen – dank Progressive Disclosure. Als Daumenregel: Was in mehr als 30 Prozent deiner Anfragen zählt, gehört in die CLAUDE.md.
Warum wird mein Skill nicht geladen?
In den meisten Fällen steckt die description dahinter. Sie ist das einzige Signal, das Claude sieht, bevor er den Skill aktiviert. Schreib deshalb genau rein, wann der Skill anspringen soll. Schau auch nach, ob er eingeschaltet ist und ob das Frontmatter direkt in Zeile eins anfängt.
Funktionieren Skills auch außerhalb von Claude Code?
Ja. Du kannst Skills in claude.ai, der Desktop-App, Cowork, den Microsoft-365-Add-ins und über die API verwenden. Durch den offenen Standard klappt das laut Anthropic auch auf über 70 Plattformen, etwa ChatGPT, Cursor oder GitHub Copilot. Die können deine SKILL.md ebenfalls lesen.
Kann ich Skills mit anderen teilen?
Ja. Am unkompliziertesten ist es, wenn du die Skill-Dateien direkt in deinen Projektordner legst. Bei claude.ai kannst du Skills im Team- und Enterprise-Tarif an Kollegen weitergeben oder für die ganze Organisation veröffentlichen. In Claude Code packst du sie dafür in ein Plugin.
Verbrauchen viele Skills nicht jede Menge Tokens?
Eben nicht – das ist der ganze Witz an Progressive Disclosure. Beim Start kostet jeder Skill nur Name und Beschreibung, also eine Handvoll Tokens. Genaue Zahlen pro Skill zeigt dir in Claude Code /skill-doctor.
Kann ein Skill automatisch nach Zeitplan laufen?
Ja, das geht mit Routines. Damit kannst du Skills zu festen Zeiten oder durch ein Event automatisch in der Cloud starten lassen. Denk aber dran: Routines greifen nur auf Skills aus dem Repo und deinem claude.ai-Konto zu. Dein persönlicher Ordner bleibt für sie unsichtbar.






