Was genau ist eine Claude-Skill?

Es ist ein Ordner mit einer Datei SKILL.md, die Anweisungen in natürlicher Sprache für eine konkrete Aufgabe enthält: wie du deine E-Mails schreibst, wie du einen Bericht formatierst, wie du deinen Arbeitsablauf befolgst. Claude speichert sie und nutzt sie, wenn er erkennt, dass sie passt, sodass du denselben Ablauf nicht in jedem Gespräch neu erklären musst. Sie kann auch Skripte, Vorlagen oder Referenzdokumente enthalten, die nur geladen werden, wenn sie gebraucht werden.

Worin unterscheidet sich eine Skill von einer CLAUDE.md oder einem gespeicherten Prompt?

Einen Prompt fügst du jedes Mal selbst ein. Eine CLAUDE.md ist fester Kontext, der beim Start einer Sitzung in diesem Projekt gelesen wird. Eine Skill ist modular und aktiviert sich von selbst nach Thema: Claude hat mehrere zur Verfügung und wählt die passende je nach deiner Anfrage, ohne Kontext zu belegen, solange sie nicht genutzt wird. Sie ist das ideale Bauteil für einen wiederholbaren Ablauf, der in vielen verschiedenen Projekten greift.

Woher weiß Claude, wann er eine Skill nutzen soll?

Über die 'description' im Frontmatter. Claude liest immer den name und die description all deiner Skills (das ist das Einzige, was er dauerhaft geladen hält) und öffnet die vollständige SKILL.md, wenn deine Anfrage zu dieser Beschreibung passt. Deshalb macht eine description, die mit Sätzen, die deiner Art zu fragen ähneln, WAS sie tut und WANN man sie nutzt sagt, den Unterschied zwischen einer Skill, die funktioniert, und einer, die nie anspringt.

Muss ich programmieren können, um eine Skill zu erstellen?

Nein. Eine SKILL.md ist Text in Markdown: Anweisungen auf Deutsch, eine Liste von Schritten und ein paar Beispiele. Du kannst sie von Hand schreiben oder Claude bitten, sie dir zu generieren, indem du ihm den Fall beschreibst. Programmieren musst du nur, wenn du Skripte hinzufügen willst, die die Skill ausführt, und das ist optional.

Meine Skill aktiviert sich nie. Warum?

In 99 % der Fälle ist es die description: zu vage, ohne zu sagen wann man sie nutzt, oder mit Wörtern, die nicht der Art ähneln, wie du die Aufgabe stellst. Schreibe sie mit konkreten Auslösern um ('nutze sie, wenn der Nutzer X, Y oder Z verlangt'). Prüfe außerdem, dass der name in kebab-case steht und die Datei exakt SKILL.md heißt, in Großbuchstaben.

Claude Skills von 0 auf 100: Was sie sind und wie du deine eigene baust

Du erklärst Claude deine Art, einen Bericht zu schreiben. Klappt hervorragend. Morgen öffnest du einen anderen Chat und musst es ihm wieder erklären. Und am Tag darauf genauso. Genau diese Schleife brechen die Skills auf: Du packst einen Ablauf einmal ein, und Claude nutzt ihn, wenn es passt, ohne dass du ihn erneut erklärst.

Dieser Leitfaden geht von null bis zu deiner ersten funktionierenden Skill: was das ist, wie Claude entscheidet, sie zu nutzen, wie du deine eigene Schritt für Schritt baust und die Fehler, die sie tot liegen lassen, bevor es losgeht.

Hinweis

Eine Skill ist kein längerer Prompt. Sie ist ein Ordner mit Anweisungen, den Claude nur lädt, wenn er erkennt, dass deine Anfrage passt. Solange sie nicht passt, belegt sie nichts. Dieses "nur wenn nötig" ist der ganze Clou.

Was eine Skill ist (und was nicht)

Eine Skill ist ein Ordner mit einer Datei namens SKILL.md. Diese Datei enthält Anweisungen in natürlicher Sprache für eine konkrete Aufgabe: wie du deine E-Mails schreibst, wie du einen Bericht aufbaust, welche Regeln du beim Code-Review befolgst. Optional kann sie mehr enthalten —Vorlagen, Referenzdokumente, Skripte—, aber das Herzstück ist immer die SKILL.md.

Der Unterschied zu dem, was du schon kennst:

Ein Prompt wird von dir jedes Mal eingefügt. Manuelle, wiederholte Arbeit.
Eine CLAUDE.md ist fester Kontext eines Projekts: Sie wird beim Start der Sitzung in diesem Ordner gelesen.
Eine Skill ist modular und nach Thema. Claude hat mehrere und wählt die passende je nach deiner Anfrage. Sie greift in jedem Projekt, nicht nur in einem.

Wenn du einen Ablauf hast, den du an verschiedenen Stellen wiederholst, dann ist das eine Skill.

Wie Claude Skills liest: die drei Ebenen

Hier ist der technische Schlüssel, der alles Weitere erklärt. Claude lädt deine Skills nicht komplett auf einen Schlag —das würde sinnlos Kontext verbrauchen—. Er liest sie auf drei Ebenen, dem sogenannten progressive disclosure:

Frontmatter (immer geladen). Nur der name und die description jeder Skill. Das ist das "Etikett", das Claude stets vor Augen hat, um zu wissen, was verfügbar ist.
Vollständige SKILL.md (geladen, wenn passend). Wenn deine Anfrage zur description passt, öffnet Claude den Rumpf der Datei und liest die Anweisungen.
Extra-Dateien (auf Abruf). Ordner wie references/, scripts/ oder assets/ werden nur angefasst, wenn die Aufgabe sie braucht.

Die praktische Folge ist enorm: das ganze Gewicht, ob deine Skill aktiviert wird oder nicht, liegt auf der description, denn sie ist das Einzige, was Claude vor der Entscheidung sieht. Sagt die description nicht klar, wann man sie nutzt, macht er sich nicht mal die Mühe, den Rest zu öffnen.

Der Frontmatter: name und description

Der Frontmatter sind die beiden Zeilen ganz am Anfang der SKILL.md, zwischen ---. Minimal, aber entscheidend.

name — der Bezeichner, in kebab-case (Kleinbuchstaben und Bindestriche). Regeln, die man nicht überspringt:

Kleinbuchstaben, Wörter durch Bindestriche getrennt: email-lektor, nicht Email_Lektor.
Ohne das Wort "claude" oder "anthropic" darin.
Ohne Tags oder seltsame Zeichen.

description — der Satz, der über dein Schicksal entscheidet. Er muss zwei Dinge sagen: WAS die Skill tut und WANN man sie nutzt, mit Sätzen, die deiner Art zu fragen ähneln. Du hast bis zu rund 1024 Zeichen; verschwende sie nicht mit Marketing, gib sie für konkrete Auslöser aus.

Frontmatter: schwache description vs. description, die auslöst

# ❌ SCHWACH — Claude weiß nicht, wann er sie aktivieren soll
---
name: emails
description: Hilft bei E-Mails.
---

# ✅ GUT — sagt WAS + WANN mit echten Auslösern
---
name: email-lektor-blackdark
description: >
Prüft und schreibt E-Mails in der Stimme von Blackdark neu: direkt, ohne
Füllwerk, mit klarem Betreff und einem einzigen Call-to-Action. Nutze sie,
wenn der Nutzer "prüf diese E-Mail", "verbessere diese Mail", "schreib
diese Nachricht besser um" sagt oder einen E-Mail-Entwurf zum Versenden
einfügt.
---

Achte auf die gute Version: Sie enthält die wörtlichen Sätze, mit denen du die Aufgabe stellen würdest ("prüf diese E-Mail", "verbessere diese Mail"). Genau das greift. Eine vage description ist Ursache Nummer eins dafür, dass eine Skill nie anspringt.

Bau deine erste Skill, Schritt für Schritt

Wir bauen jetzt eine echte Skill. Zwei Wege.

Weg A — von Claude generieren lassen. Du beschreibst ihm den Fall in natürlicher Sprache ("ich will eine Skill, die meine E-Mails mit direktem Ton, klarem Betreff und einem einzigen CTA prüft") und er schreibt dir die SKILL.md. Schnell für den Anfang; danach feilst du die description von Hand nach.

Weg B — von Hand. Mehr Kontrolle, und du verstehst besser, was passiert. Empfohlener Aufbau des Rumpfs:

Vollständige SKILL.md als Beispiel

---
name: email-lektor-blackdark
description: >
Prüft und schreibt E-Mails in der Stimme von Blackdark neu: direkt, ohne
Füllwerk, klarer Betreff und ein einziger Call-to-Action. Nutze sie, wenn
der Nutzer "prüf diese E-Mail", "verbessere diese Mail" sagt oder einen
Entwurf zum Versenden einfügt.
---

# E-Mail-Lektor Blackdark

## Anweisungen
- Direkter, praktischer Ton. Weg mit dem Füllwerk, weg mit "ich hoffe, es geht dir gut".
- Klarer Betreff mit weniger als 50 Zeichen.
- Ein einziger Call-to-Action, am Ende, unmissverständlich.
- Achte die Sprache des Originalentwurfs.

## Schritte
1. Lies den Entwurf und erkenne das echte Ziel der E-Mail.
2. Schreib neu: Betreff + Text, maximal 120 Wörter, außer es wird mehr verlangt.
3. Vermerke in einer eigenen Zeile, was du geändert hast und warum.

## Beispiel
Eingabe: "Hallo, ich wollte mal schauen, ob wir vielleicht irgendwann einen
Anruf einplanen könnten, wenn du kannst, um über das Projekt zu sprechen, danke."
Ausgabe:
Betreff: 20-Minuten-Anruf diese Woche
Text: Passt dir ein 20-Minuten-Anruf am Donnerstag um 11:00 Uhr, um das
Projekt abzuschließen? Wenn nicht, nenn mir zwei Slots und ich richte mich danach.

## Zu vermeidende Fehler
- Erfinde keine Daten, die nicht im Entwurf stehen.
- Füge nicht mehr als einen CTA hinzu, selbst wenn das Original mehrere Absichten hat.

Jetzt lege sie dort ab, wo Claude sie liest:

In Claude Code: Erstelle den Ordner ~/.claude/skills/email-lektor-blackdark/ und leg die SKILL.md hinein. Starte die Sitzung neu und fertig.
In claude.ai: Komprimiere den Ordner zu einer .zip und lade sie über das Skills-Panel hoch; danach aktiviere sie mit ihrem Schalter.

Der Ordnername und der name im Frontmatter müssen übereinstimmen, und die Datei muss exakt SKILL.md heißen, in Großbuchstaben.

Wie du sie testest (an zwei Fronten)

Halte eine Skill nicht für gut, bevor du die zwei Dinge getestet hast, die getrennt schiefgehen können:

Aktiviert sie sich von selbst? Stell ihr die Aufgabe mit deinen echten Worten —ohne die description abzuschreiben— und schau, ob Claude sie nutzt, ohne dass du es ihm sagst. Teste drei oder vier Varianten, wie du es wirklich formulieren würdest. Springt sie nicht an, liegt das Problem in der description.
Ist das Ergebnis korrekt? Einmal aktiviert, prüfe, ob der Output die Regeln einhält (Format, Ton, Grenzen). Aktiviert sie sich, ignoriert aber Anweisungen, liegt das meist daran, dass das Wichtige am Ende vergraben oder mehrdeutig geschrieben ist.

Tipp

Validierungstrick: Öffne einen neuen Chat und stell ihm die Aufgabe ohne die Skill zu nennen. Löst Claude sie von selbst aus, ist deine description gut. Musst du "nutze die Skill X" sagen, ist sie noch nicht bereit für die echte Welt.

Häufige Fehler (und wie du sie behebst)

Die Pannen sind fast immer dieselben fünf:

Sie aktiviert sich nie → vage description, ohne "wann". Schreib sie mit konkreten Auslösersätzen um, jenen, die du beim Stellen der Aufgabe verwenden würdest.
Sie aktiviert sich zu oft und mischt sich ein, wo sie nicht gefragt ist → zu breite description. Grenze den Bereich ein und sag ausdrücklich, welche Fälle sie NICHT abdeckt.
Er erkennt sie beim Hochladen nicht → die Datei heißt nicht exakt SKILL.md, oder der name steht nicht in kebab-case, oder er stimmt nicht mit dem Ordner überein.
Sie aktiviert sich, hält sich aber nicht an die Regeln → das Kritische ist vergraben. Zieh die wichtigen Regeln ganz nach oben und gib ihnen ein klares Format (Listen, Fettdruck).
Sie ist langsam oder verbraucht viel → die SKILL.md ist ein Klotz. Lass darin das Wesentliche und verschiebe die langen Details in Dateien unter references/, die nur bei Bedarf geladen werden.

Eine gut gebaute Skill ist kurz in der SKILL.md, brutal auf den Punkt in der description und ehrlich dabei, wann man sie NICHT nutzen sollte. Fang mit einer einzigen an, der für den Ablauf, den du am häufigsten wiederholst, und feile sie, bis sie von selbst anspringt. Wenn du siehst, wie Claude deine Aufgabe erledigt, ohne dass du sie erklärst, hast du es kapiert.