Um einen Claude-Skill zu erstellen, schreibst du einen Ordner mit einer Datei darin: eine SKILL.md, die mit einem Namen und einer Beschreibung beginnt, gefolgt von Anweisungen in verständlicher Sprache. Komprimiere den Ordner als ZIP-Datei, lade ihn in Claude hoch (oder lege ihn für Claude Code in ~/.claude/skills/ ab), und Claude lädt ihn, sobald eine Anfrage zur Beschreibung passt. Kein Code, kein SDK, kein Build-Schritt.
Auf dieser Seite
- Was du vor dem Start brauchst
- Schritt 1: Wähle eine Aufgabe und definiere, wann sie „fertig“ ist
- Schritt 2: Erstelle den Ordner und die Datei SKILL.md
- Schritt 3: Frontmatter schreiben (der Teil, der entscheidet, wann es ausgelöst wird)
- Schritt 4: Anweisungen als Methode formulieren, nicht als Stimmung
- Schritt 5: Füge ein Beispiel für ein fertiges Ergebnis hinzu
- Schritt 6: Verpacke und installiere ihn
- Schritt 7: Teste ihn ernsthaft
- Kostenlose Claude-Skill-Vorlage (kopieren und anpassen)
- Fünf Fehler, die eine Skill unbrauchbar machen
- Lass Claude den ersten Entwurf für dich schreiben
- Selbst erstellen oder mit einem fertigen Skill beginnen?
Das ist der gesamte Mechanismus. Was einen Skill, der jedes Mal ausgelöst wird und versandfertige Arbeit produziert, von einem unterscheidet, der nie ausgelöst wird, hängt von etwa sechs Entscheidungen ab, die dieser Leitfaden der Reihe nach erläutert. Am Ende findest du eine kostenlose Vorlage zum Kopieren sowie eine Checkliste, mit der du deinen Skill testen kannst, bevor du dich darauf verlässt.
Wenn das Konzept für dich neu ist, beginne mit Was sind Claude Skills? und kehre anschließend hierher zurück. Diese Seite setzt voraus, dass du weißt, was ein Skill ist, und einen erstellen möchtest.
Was du vor dem Start brauchst
- Ein Claude-Konto mit aktivierter Codeausführung. Skills funktionieren mit den Tarifen Free, Pro, Max, Team und Enterprise, aber die Einstellung für Codeausführung und Dateierstellung muss aktiviert sein. Bei Team und Enterprise muss eine Administratorin oder ein Administrator Skills möglicherweise zuerst für die Organisation aktivieren.
- Ein Texteditor. Alles, womit sich reiner Text speichern lässt: VS Code, TextEdit im Nur-Text-Modus oder Notepad.
- Eine wiederholbare Aufgabe. Nicht „Marketing“. Etwa „ein Transkript eines Verkaufsgesprächs in unserem CRM-Notizformat zusammenfassen“ oder „einen Vertrag auf unsere fünf üblichen Warnsignale prüfen“. Je enger die Aufgabe gefasst ist, desto besser ist der Skill.
- Zwei oder drei echte Beispiele für gute Ausgaben. Frühere Berichte, E-Mails oder Briefings, die du gern versenden würdest. Sie sind das beste Ausgangsmaterial für einen Skill.
Schritt 1: Wähle eine Aufgabe und definiere, wann sie „fertig“ ist
Die meisten fehlgeschlagenen Skills scheitern hier, noch bevor eine einzige Zeile geschrieben wurde. Ein Skill, der versucht, „alles abzudecken, was eine Marketingmanagerin oder ein Marketingmanager tut“, endet mit einer vagen Beschreibung, wird im falschen Moment ausgelöst und liefert allgemeine Antworten, wenn er überhaupt ausgelöst wird.
Schreibe zwei Sätze, bevor du irgendetwas anderes tust:
- Der Auslöser: „Verwende dies, wenn jemand nach X fragt oder Y übergibt.“
- Das Ergebnis: „Die Ausgabe ist ein Z mit diesen Abschnitten, in dieser Länge und in diesem Ton.“
Beispiel: „Verwende dies, wenn jemand ein Transkript eines Kundengesprächs einfügt und Notizen anfordert. Die Ausgabe ist eine CRM-Notiz mit den Abschnitten Zusammenfassung, Schmerzpunkte, Budget, Nächster Schritt und Risiko, unter 200 Wörtern und für eine Vertriebsleitung geschrieben, die nicht am Gespräch teilgenommen hat.“ Wenn du diese beiden Sätze nicht formulieren kannst, teile die Aufgabe in zwei Skills auf.
Schritt 2: Erstelle den Ordner und die Datei SKILL.md
Eine Skill ist ein Ordner, dessen Name dem Skill-Namen entspricht. Darin ist die einzige erforderliche Datei SKILL.md (Der Dateiname muss die Groß- und Kleinschreibung beachten.) Optionale zusätzliche Dateien kommen daneben:
| Pfad | Erforderlich? | Wofür es gedacht ist |
|---|---|---|
call-notes/SKILL.md |
Ja | Frontmatter plus die Anweisungen, an die sich Claude hält |
call-notes/resources/example-output.md |
Empfohlen | Ein fertiges Beispiel des Ergebnisses |
call-notes/resources/style-guide.md |
Optional | Längeres Referenzmaterial, das Claude nur bei Bedarf liest |
call-notes/scripts/ |
Optional | Python- oder Shell-Skripte für Schritte, die exakt sein müssen, etwa zum Parsen einer CSV-Datei |
Halte den Ordnernamen in Kleinbuchstaben und mit Bindestrichen, wie bei call-notes oder quarterly-report. Dieselbe Zeichenfolge steht in Name Feld im nächsten Schritt.
Schritt 3: Frontmatter schreiben (der Teil, der entscheidet, wann es ausgelöst wird)
Die Datei beginnt mit einem kurzen YAML-Block zwischen zwei Zeilen mit jeweils drei Bindestrichen. Zwei Felder sind erforderlich:
-
name- Kleinbuchstaben, Ziffern und Bindestriche, bis zu 64 Zeichen. Daraus wird die Kennung und in Claude Code der Slash-Befehl (/call-notes). -
description- bis zu 1.024 Zeichen. Dies ist der einzige Teil, den Claude zu Beginn einer Sitzung für jeden installierten Skill liest. Er entscheidet, ob dein Skill überhaupt geladen wird.
Schreibe die Beschreibung so, als würdest du einen Kollegen briefen, der in einer Sekunde entscheiden muss, ob eine Anfrage in seinen Zuständigkeitsbereich fällt. Beginne damit, was der Skill erzeugt, und liste dann die Situationen und Formulierungen auf, die ihn aktivieren sollten. Vergleiche:
- Schwach: „Hilft bei Vertriebsnotizen.“
- Stark: „Wandelt das Transkript eines Verkaufs- oder Kennenlerngesprächs in eine strukturierte CRM-Notiz (Zusammenfassung, Problempunkte, Budget, nächster Schritt, Risiko) mit weniger als 200 Wörtern um. Verwenden, wenn der Nutzer ein Gesprächstranskript, den Text einer Besprechungsaufzeichnung oder grobe Gesprächsnotizen einfügt und nach Notizen, einer Zusammenfassung, einem CRM-Eintrag oder einer Follow-up-Zusammenfassung fragt.“
Die starke Version benennt die Eingabe, die Ausgabe und die Wörter, die Nutzer tatsächlich eingeben. Dadurch wird sie zuverlässig ausgelöst und bleibt ansonsten im Hintergrund.
Schritt 4: Anweisungen als Methode formulieren, nicht als Stimmung
Alles unterhalb des Frontmatters ist Markdown, an das sich Claude hält, sobald der Skill geladen wird. Ein häufiger Fehler ist eine lange Persona („Du bist ein weltweit führender Vertriebsexperte mit 20 Jahren ...“) ohne Verfahren. Claude braucht keine Hintergrundgeschichte. Es braucht Schritte, Regeln und ein Zielformat. Eine Struktur, die für die meisten Business-Skills funktioniert:
- Eingaben - was der Nutzer bereitstellen wird und wonach gefragt werden soll, wenn etwas fehlt (maximal zwei Fragen, dann mit den genannten Annahmen fortfahren).
- Arbeitsablauf - nummerierte Schritte in der Reihenfolge, in der ein sorgfältiger Profi sie ausführen würde.
- Ausgabeformat - die genauen Abschnitte, Überschriften, Länge und den Ton.
- Regeln - Dinge, die immer oder niemals geschehen dürfen („nie einen Budgetbetrag erfinden; ‚nicht besprochen‘ schreiben“).
- Qualitätsprüfung - eine kurze Liste, die Claude vor jeder Antwort durchgeht.
Es sollte auf einen oder zwei Bildschirme passen. Wenn die Datei ungefähr mehr als 500 Zeilen umfasst, verschiebe Referenzmaterial (ausführliche Styleguides, Preislisten, Richtlinientexte) in Dateien unter resources/ und weise Claude in SKILL.md an, wann diese geöffnet werden sollen. Weitere Informationen zum Aufbau der Datei findest du unter Was ist eine SKILL.md-Datei?
Schritt 5: Füge ein Beispiel für ein fertiges Ergebnis hinzu
Ein Beispiel vermittelt das Format schneller als jede noch so ausführliche Beschreibung. Füge ein realistisches, fertiges Ergebnis in resources/example-output.md und verweise im Workflow darauf („halte dich an Struktur und Länge von resources/example-output.md“). Verwende ein echtes früheres Arbeitsergebnis, bei dem Namen und Zahlen geändert wurden, keine Platzhalterdatei voller eckiger Klammern. Auch unser eigener Katalog folgt dieser Regel: Jeder Skill enthält ein Beispielergebnis, weil dies das deutlichste Zeichen dafür ist, dass jemand ihn tatsächlich getestet hat.
Schritt 6: Verpacke und installiere ihn
In Claude (Web und Desktop): Komprimiere den Ordner als ZIP-Datei, sodass der Ordner selbst im Stammverzeichnis der ZIP-Datei liegt (call-notes.zip mit call-notes/SKILL.md). Öffne in den Einstellungen den Skills-Bereich, lade die ZIP-Datei hoch und aktiviere den Skill. Starte einen neuen Chat und stelle eine Anfrage, die zur Beschreibung passt.
In Claude Code: Du brauchst keine ZIP-Datei. Lege den Ordner in ~/.claude/skills/, um ihn in jedem Projekt zu verwenden, oder in .claude/skills/ innerhalb eines Repositorys, um ihn mit allen Personen zu teilen, die an diesem Repository arbeiten. Gib /call-notes ein oder beschreibe einfach die Aufgabe. Claude Code übernimmt Änderungen am Ordner ohne Neustart.
Den vollständigen Ablauf für jede Oberfläche, einschließlich des Speicherorts der Dateien und der Vorgehensweise bei abgelehnten Uploads, findest du unter So installierst du einen Claude Skill. Entwickler, die überwiegend im Terminal arbeiten, sollten außerdem Claude Code Skills lesen.
Schritt 7: Teste ihn ernsthaft
Ein Skill, der erst einmal ausprobiert wurde, ist nicht getestet. Führe diese Prüfung durch, bevor du ihn mit einem Team teilst:
- Auslösetest (5 Prompts). Formuliere fünf unterschiedlich klingende Anfragen, bei denen der Skill ausgelöst werden sollte. Zähle, wie viele davon es tun. Bei weniger als vier Treffern muss die Beschreibung mehr der tatsächlichen Formulierungen der Nutzer enthalten.
- Test auf Stille (5 Prompts). Formuliere fünf ähnliche Anfragen, bei denen es nicht ausgelöst werden sollte. Wenn es bei einer davon ausgelöst wird, beschreibe es genauer.
- Test für fehlende Eingaben. Gib nur die Hälfte der Eingaben an. Es sollte eine kurze Frage stellen oder seine Annahmen nennen, statt Fakten zu erfinden.
- Formatprüfung. Vergleiche drei Ausgaben nebeneinander mit deinem Beispiel. Gleiche Abschnitte, derselbe Längenbereich, derselbe Ton?
- Grenzfalltest. Gib die chaotischste echte Eingabe ein, die du hast: ein weitschweifiges Transkript, eine halb leere Tabelle.
Behebe Auslöseprobleme in der Beschreibung und Ausgabeprobleme im Arbeitsablauf oder in den Regeln. Führe am Ende der Datei ein kurzes Änderungsprotokoll, damit du weißt, welche Version dein Team verwendet.
Kostenlose Claude-Skill-Vorlage (kopieren und anpassen)
Ersetze die GROSSGESCHRIEBENEN TEILE, lösche, was du nicht brauchst, und speichere sie als SKILL.md in einem Ordner mit demselben Namen wie die Name Feld.
---
name: dein-skill-name
description: Erstellt EIN KONKRETES ERGEBNIS (Abschnitte, Länge) aus EINER KONKRETEN EINGABE. Verwende sie, wenn der Nutzer NACH X FRAGT, Y EINFÜGT oder Z ERWÄHNT. Nicht für EINE ÄHNLICHE AUFGABE VERWENDEN, DIE ANDERWOHINGEHÖRT.
---
# TITEL DEINER SKILL
## Zweck
Ein oder zwei Sätze darüber, für wen dies bestimmt ist und woran man erkennt, dass die Aufgabe erledigt ist.
## Eingaben
- Erforderlich: WAS DER NUTZER BEREITSTELLEN MUSS
- Optional: WAS DAS ERGEBNIS VERBESSERT
- Wenn eine erforderliche Eingabe fehlt, stelle höchstens zwei kurze Fragen,
Fahre anschließend fort und liste deine Annahmen am Anfang der Ausgabe auf.
## Arbeitsablauf
1. Lies die Eingabe und identifiziere die WESENTLICHEN ELEMENTE.
2. Prüfe sie anhand der REGELN ODER KRITERIEN.
3. Erstelle die Ausgabe im unten angegebenen Format.
4. Führe die Qualitätsprüfung durch, behebe alle Fehler und antworte anschließend.
## Ausgabeformat
- Abschnitt 1: NAME - WAS HIERHIN GEHÖRT (Länge)
- Abschnitt 2: NAME - WAS HIERHIN GEHÖRT (Länge)
- Abschnitt 3: NAME - WAS HIERHIN GEHÖRT (Länge)
Halte dich an die Struktur und Länge von resources/example-output.md.
## Regeln
- Erfinde niemals Zahlen, Namen oder Daten. Schreibe stattdessen „nicht angegeben“.
- Verwende einfaches Englisch. Keine nichtssagenden Einleitungen.
- REGEL, DIE FÜR DEIN TEAM ODER DEINE BRANCHE GILT.
## Qualitätsprüfung
- Ist jeder Abschnitt vorhanden und in der richtigen Reihenfolge?
- Ist jede Aussage auf die Eingabe zurückführbar?
- Innerhalb des Längenlimits?
## Änderungsprotokoll
- v1.0 ERSTE VERSION, DATUM
Du möchtest sehen, wie fertige Skills aussehen? Claude Skill Examples führt anhand von zwölf echten SKILL.md-Dateien Zeile für Zeile durch das Thema. So kannst du am schnellsten einschätzen, wie viel Detail ausreicht.
Fünf Fehler, die eine Skill unbrauchbar machen
- Eine Beschreibung, die sagt, was die Skill ist, nicht wann sie verwendet werden soll. „Ein Experte für Werbetexte“ wird nie ausgelöst. „Verfasst Texte für Produktseiten anhand einer Merkmalsliste, wenn der Nutzer eine Produktbeschreibung, PDP-Texte oder Angebotstexte anfordert“ dagegen schon.
- Eine Skill für eine ganze Abteilung. Budgetplanung, Lohnabrechnung und Prüfung in einer Datei liefern dir drei halbe Antworten. Erstelle drei Skills.
- Kein Ausgabeformat. Ohne eines sieht jeder Durchlauf anders aus, und niemand vertraut darauf.
- Geheimnisse in der Datei. Füge niemals API-Schlüssel, Passwörter oder Kundendaten in ein Skill ein. Jede Person, mit der du es teilst, kann sie lesen.
- Ein Skill von jemand anderem ungelesen zu installieren. Ein Skill besteht aus Anweisungen, die Claude befolgt, manchmal auch aus Skripten. Lies ihn so, wie du ein Skript lesen würdest, bevor du es ausführst.
Lass Claude den ersten Entwurf für dich schreiben
Du musst nicht mit einer leeren Datei beginnen. Claude kann dich zur Aufgabe interviewen, das Frontmatter und den Workflow entwerfen, eine Beispielausgabe erstellen und die oben genannten Test-prompts vorschlagen. Anthropic liefert ein integriertes Skill-Creator-Skill genau für diesen Zweck mit. Du kannst auch in einfachen Worten fragen: „Interviewe mich dazu, wie ich unseren wöchentlichen Kundenbericht schreibe, und erstelle anschließend eine SKILL.md dafür.“ Der Entwurf muss von dir überarbeitet werden, insbesondere die Beschreibung und die Regeln, aber du musst dadurch den größten Teil nicht selbst tippen.
Du bevorzugst ein Formular statt eines Chats? Der kostenlose Claude Skill Builder verwandelt eine kurze Aufgabenbeschreibung in eine fertige SKILL.md mit Frontmatter und Workflow, die du für Claude.ai und Claude Code kopieren oder als .zip herunterladen kannst. Keine Registrierung erforderlich.
Du möchtest, dass das Interview, der Selbsttest und die Aufbereitung für dich erledigt werden? Der Claude Skill Creator (19 $) ist ein Skill, der Skills erstellt: Er fragt nach der Aufgabe, den Anfragen, die Menschen tatsächlich eingeben, und dem, was niemals passieren darf, erstellt einen vollständigen Skill-Ordner mit der SKILL.md und einer Beispielausgabe, testet die Beschreibung anhand von Anfragen, die den Skill auslösen sollten oder nicht, und bereitet den Ordner für Claude, Claude Code und die API auf. Um ein von dir erstelltes oder heruntergeladenes Skill zu prüfen, verwende den Claude Skill Reviewer & Security Linter oder hol dir beides zusammen mit Skills zur Überprüfung von prompts, MCP und Code im Build Your Own Claude Skills Kit (49 $).
Selbst erstellen oder mit einem fertigen Skill beginnen?
Erstelle dein eigenes, wenn der Workflow einzigartig für dein Team ist, internes Wissen enthält, das niemand außerhalb eures Teams hat, oder du gerne iterierst. Beginne mit einem fertigen Skill, wenn es sich um eine Standardaufgabe handelt (Buchhaltung, SEO-Briefings, Vertragsprüfung, Supportantworten) und du den Nachmittag lieber mit der Arbeit als mit den Anweisungen verbringen möchtest. Ein fertiges Skill aus unserer Claude-Skill-Bibliothek kostet 19 $, enthält eine Beispielausgabe und ist eine einfache Markdown-Datei, die du öffnen und bearbeiten kannst. Damit eignet es sich auch als Ausgangsvorlage für deine eigene Version.
So oder so ist der nächste Schritt derselbe: Wähle eine Aufgabe, die du jede Woche wiederholst, schreibe die beiden Sätze aus Schritt 1 und habe noch vor Tagesende ein funktionierendes Skill.