So erstellst du eigene Skills für Claude Code
Von der Kitbay-Redaktion ·
Um einen eigenen Skill für Claude Code zu erstellen, legst du in ~/.claude/skills/ (oder in einem Projekt in .claude/skills/) einen Ordner mit dem Namen des Skills an und fügst eine SKILL.md-Datei mit name, description und deinen Anweisungen hinzu. Dann testest du ihn, indem du nach genau dieser Aufgabe fragst oder /skill-name eingibst. Anschließend hilft dir der Skill skill-creator von Anthropic, ihn zu messen und zu verbessern.
Wenn das Format neu für dich ist, lies zuerst Was ist ein Claude Skill?. Diese Anleitung behandelt die praktischen Schritte.
Schritt 1: Eine Aufgabe wählen
Ein Skill funktioniert gut, wenn er eine wiederkehrende Aufgabe mit klarem Ende abdeckt: „Release Notes aus gemergten Pull-Requests schreiben“, nicht „beim Projekt helfen“. Die Dokumentation von Claude Code empfiehlt, Anweisungen, die du immer wieder in den Chat einfügst, in einen Skill zu verwandeln und Abläufe aus CLAUDE.md auszulagern, sobald sie lang werden.
Wähle einen kurzen Namen aus Kleinbuchstaben, Ziffern und Bindestrichen, etwa release-notes. Der Name wird zum Ordnernamen und zum Slash-Befehl.
Schritt 2: Den Ordner anlegen
Persönliche Skills, verfügbar in jedem Projekt auf deinem Rechner:
mkdir -p ~/.claude/skills/release-notes
Projekt-Skills, geteilt mit allen, die das Repository klonen:
mkdir -p .claude/skills/release-notes
Auch Plugins können Skills in einem skills/-Ordner mitbringen. Das ist der übliche Weg, um eine Sammlung von Skills in vielen Repositorys zu nutzen.
Schritt 3: SKILL.md schreiben
---
name: release-notes
description: Drafts release notes from merged pull requests since the last tag. Use when the user asks for release notes, a changelog entry, or a summary of what shipped.
---
## Steps
1. Find the latest git tag and list pull requests merged after it.
2. Group changes under Added, Changed and Fixed.
3. Write one plain sentence per change and link the pull request.
## Rules
- Leave out internal refactors unless they change behaviour.
- Ask before publishing anything.
Auf drei Punkte kommt es an:
- Die Beschreibung entscheidet, wann der Skill geladen wird. Claude vergleicht Anfragen mit ihr. Beschreibe, was der Skill tut und wann er eingesetzt wird, und verwende Begriffe, die man im Alltag natürlich eintippen würde. Claude Code kürzt lange Beschreibungen in seiner Skill-Liste (der Gesamttext ist auf 1.536 Zeichen begrenzt), also stelle den wichtigsten Einsatzzweck an den Anfang.
- Schreibe Anweisungen, die für die ganze Sitzung gelten. Claude Code fügt den Inhalt des Skills einmal in die Unterhaltung ein und liest die Datei in späteren Runden nicht erneut.
- Halte ihn kurz. Peile weniger als 500 Zeilen in
SKILL.mdan und lagere Details in eigene Dateien aus.
Schritt 4: Bei Bedarf Skripte und Referenzdateien ergänzen
Längeres Referenzmaterial gehört in eine eigene Datei, die du aus SKILL.md verlinkst, damit Claude weiß, wann es sie öffnen soll:
release-notes/
├── SKILL.md
├── references/style-guide.md
└── scripts/list_merged_prs.py
Skripte eignen sich für Schritte, die jedes Mal dasselbe Ergebnis liefern müssen. Claude führt sie aus und sieht nur die Ausgabe. Verweise in Claude Code mit der Variablen ${CLAUDE_SKILL_DIR} auf mitgelieferte Dateien. So funktioniert der Pfad, egal ob der Skill persönlich, pro Projekt oder in einem Plugin installiert ist. Die Agent-Skills-Spezifikation empfiehlt, dass Skripte ihre Abhängigkeiten angeben und verständliche Fehlermeldungen ausgeben.
Schritt 5: Festlegen, wer ihn starten darf
Standardmäßig können sowohl du als auch Claude einen Skill starten. Zwei Felder von Claude Code ändern das:
| Feld | Wirkung | Typischer Einsatz |
|---|---|---|
disable-model-invocation: true |
Nur du kannst ihn starten, mit /name |
Deploys, Nachrichten senden, alles mit Nebenwirkungen |
user-invocable: false |
Im /-Menü ausgeblendet; nur Claude lädt ihn |
Hintergrundwissen, etwa ein Styleguide |
Das Feld allowed-tools gibt die genannten Tools für die Runde, in der der Skill läuft, vorab frei. Gib nur so viel frei, wie die Aufgabe braucht.
Schritt 6: Testen
- Starte Claude Code und frage „Welche Skills sind verfügbar?“. Dein Skill sollte in der Liste stehen.
- Stelle eine Anfrage, die zur Beschreibung passt, ohne den Skill zu nennen, und prüfe, ob Claude ihn lädt.
- Führe ihn direkt mit
/release-notesaus.
Claude Code überwacht die Skill-Ordner, sodass Änderungen noch in derselben Sitzung greifen; für einen Skills-Ordner, der beim Start der Sitzung noch nicht existierte, brauchst du /reload-skills. Ist das YAML fehlerhaft, funktioniert der Slash-Befehl zwar weiterhin, aber Claude kann deine Beschreibung nicht zuordnen. claude --debug zeigt den Parse-Fehler, und claude plugin validate ~/.claude/skills prüft das Front Matter (ab Claude Code v2.1.233). Für Skills, die auch mit anderen Agenten funktionieren sollen, prüft der Befehl skills-ref validate ./my-skill aus der Spezifikation die Standardfelder.
skill-creator nutzen
Anthropic veröffentlicht in seinem Repository anthropics/skills einen Skill namens skill-creator. Laut seiner eigenen Beschreibung erstellt er neue Skills, verbessert bestehende und misst, wie gut sie funktionieren. Er geht so vor:
- Er fragt, was der Skill tun soll, wann er greifen soll und wie eine gute Ausgabe aussieht.
- Er entwirft
SKILL.mdund alle mitgelieferten Dateien. - Er schreibt zwei oder drei realistische Test-Prompts und speichert sie in
evals/evals.json. - Er führt jeden Prompt mit und ohne den Skill (oder mit der vorherigen Version) aus, bewertet die Ergebnisse und zeigt sie dir zur Prüfung.
- Er überarbeitet und wiederholt das, bis du zufrieden bist.
- Er erzeugt Prompts, die den Skill auslösen sollen und die ihn nicht auslösen sollen, und passt dann die Beschreibung an, um die Trefferquote zu verbessern.
Installiere ihn in Claude Code als Plugin mit /plugin install skill-creator@claude-plugins-official und bitte dann zum Beispiel: „Bewerte meinen Skill release-notes mit skill-creator“. Laut der Dokumentation von Claude Code läuft jeder Test in einem eigenen Subagenten mit leerem Kontext, und die Ergebnisse zeigen Erfolgsquote, Zeit und Tokens mit und ohne den Skill.
Codex bringt einen eigenen, eingebauten skill-creator mit, den du mit $skill-creator startest. Den Skill findest du auch in unseren Skill-Einträgen.
Deinen Skill teilen
- Mit deinem Team: Committe
.claude/skills/ins Repository. - Über mehrere Repositorys: Verpacke Skills in ein Claude-Code-Plugin.
- In claude.ai: Lade den Ordner als ZIP-Datei hoch. Dort werden nur die Standardfelder im Front Matter akzeptiert.
- In anderen Agenten: Beschränke dich auf die Standardfelder und sieh in der Dokumentation des jeweiligen Agenten nach, welchen Skills-Ordner er nutzt.
Eigene Skills werden zwischen Claude Code, claude.ai und der API nicht synchronisiert; füge sie also an jedem Ort einzeln hinzu.
Sicherheitshinweis
Ein Skill mit Skripten führt Code auf deinem Rechner aus, und laut der Dokumentation von Claude Code greift die Einstellung allowed-tools eines Projekt-Skills sogar in einem Ordner, den du nicht als vertrauenswürdig markiert hast. Prüfe Skills, die mit einem Repository kommen, so sorgfältig wie jeden anderen Code, und lies unsere Sicherheitsfragen vor der Installation eines Servers oder Skills.
Nächste Schritte
Wenn dein Skill Live-Daten aus einer anderen App braucht, kombiniere ihn mit einem MCP-Server: Unsere Anleitung MCP vs. Skills erklärt, wie beides zusammenpasst. Anregungen findest du bei den Skills für Code-Review oder Dokumentation.
Fragen
- Wo speichere ich einen eigenen Skill für Claude Code?
- Lege ihn unter ~/.claude/skills/<skill-name>/SKILL.md ab, um ihn in allen deinen Projekten zu nutzen, oder unter .claude/skills/<skill-name>/SKILL.md in einem Repository, um ihn mit dem Team dieses Projekts zu teilen.
- Was ist der Claude Skill Creator?
- skill-creator ist ein von Anthropic veröffentlichter Skill. Er hilft dir, einen neuen Skill zu entwerfen, Test-Prompts zu schreiben, Ergebnisse mit und ohne den Skill zu vergleichen und die Beschreibung abzustimmen. In Claude Code ist er als Plugin verfügbar.
- Warum nutzt Claude meinen Skill nicht?
- Meistens passt die Beschreibung nicht dazu, wie du deine Anfragen formulierst. Ergänze die Wörter, die tatsächlich verwendet werden, prüfe, ob der Skill erscheint, wenn du nach den verfügbaren Skills fragst, oder starte ihn direkt mit /skill-name.
- Kann ich denselben Skill in claude.ai oder Codex nutzen?
- Oft ja, wenn du dich an die Standardfelder im Front Matter hältst. claude.ai nimmt Skills als ZIP-Upload an und lehnt unbekannte Schlüssel ab, und Codex liest Skills aus .agents/skills-Ordnern.
Quellen
- Extend Claude with skills (Claude Code docs)geprüft am 14. Nov. 2026
- Agent Skills specificationgeprüft am 14. Nov. 2026
- Agent Skills (Claude Platform docs)geprüft am 14. Nov. 2026
- skill-creator SKILL.md (anthropics/skills)geprüft am 14. Nov. 2026
- anthropics/skills repositorygeprüft am 14. Nov. 2026
- Build skills (Codex docs)geprüft am 14. Nov. 2026
Weitere Anleitungen
- So verbindest du MCP-Server mit Claude, ChatGPT und Cursor
- So baust du einen MCP-Server
- MCP-Sicherheit: Was du vor der Installation eines Servers oder Skills prüfen solltest
- MCP vs. API: Was ist der Unterschied?
- MCP vs. Skills: So unterscheiden sich MCP-Server und Agent Skills
- Was ist ein Claude Skill?
- Was ist ein MCP-Server?