Claude Code Skills: So legst du sie an, mit Beispielen und Best Practices

Was Claude Code Skills sind

Leg einen Skill an, wenn du immer wieder dieselben Anweisungen, dieselbe Checkliste oder denselben mehrstufigen Ablauf in den Chat kopierst, oder wenn ein Teil deiner CLAUDE.md von einer Tatsache zu einem Ablauf gewachsen ist. Skills folgen dem offenen Standard Agent Skills (agentskills.io), den auch andere KI-Tools lesen; Claude Code ergänzt Extras wie die Steuerung des Aufrufs, Ausführung als Subagent und Live-Shell-Ausgabe im Prompt.

• Zwei Wege, einen auszuführen: Claude lädt ihn, wenn deine Anfrage zu seiner description passt, oder du tippst /skill-name.
• Günstig, bis er gebraucht wird: Nur Name und Beschreibung stehen im Kontext; der Inhalt lädt erst, wenn der Skill läuft. Ein Skill, der nur von Hand gestartet werden darf, listet seine Beschreibung gar nicht erst auf.
• Eigene Slash-Commands sind jetzt Skills: .claude/commands/<name>.md funktioniert weiterhin, aber ein Skill-Ordner kann zusätzlich weitere Dateien enthalten. Siehe Claude Code Slash-Commands.
• Claude Code bringt auch mitgelieferte Skills mit, etwa /simplify, /loop, /batch und /debug.

Skills vs. CLAUDE.md vs. Subagents vs. Plugins vs. MCP

So legst du einen Claude Code Skill an

1. Wähle, wo er liegt

   ~/.claude/skills/<name>/ für dich selbst in allen Projekten; .claude/skills/<name>/ in einem Repository, committet, für alle, die dort arbeiten. Der Ordnername wird zum Command: summarize-changes ergibt /summarize-changes.

2. Schreib die SKILL.md: eine Beschreibung, dann die Anweisungen

   Das Frontmatter steht zwischen zwei ----Zeilen ganz oben. Empfohlen ist nur description: Stell den Anwendungsfall und die Worte, die man tatsächlich sagen würde, an den Anfang. Darunter schreibst du die Anweisungen in Markdown. Eine Zeile, die mit ` !command ` beginnt, führt zuerst diesen Befehl aus und fügt seine Ausgabe ein, sodass der Skill von deinem echten Stand ausgeht.

   ---
   description: Fasst nicht committete Änderungen zusammen und markiert alles Riskante. Verwenden, wenn der Nutzer fragt, was sich geändert hat, eine Commit-Nachricht möchte oder seinen Diff prüfen lassen will.
   ---
   
   ## Aktuelle Änderungen
   
   !`git diff HEAD`
   
   ## Anweisungen
   
   Fasse die Änderungen oben in zwei oder drei Stichpunkten zusammen und liste dann
   Risiken auf, etwa fehlende Fehlerbehandlung, hartkodierte Werte oder anzupassende Tests.

3. Teste beide Wege

   Starte claude in einem Git-Projekt mit einer nicht committeten Änderung. Frag "Was habe ich geändert?", um zu sehen, ob Claude den Skill von selbst aufgreift, und tippe dann /summarize-changes, um ihn direkt auszuführen. Skills, die du während einer Session hinzufügst, laden von selbst; führe /reload-skills aus, wenn einer nicht auftaucht.

4. Leg fest, wer ihn ausführen darf

   Ergänze disable-model-invocation: true bei allem mit Nebenwirkungen, etwa Deploys oder dem Versenden von Nachrichten, damit nur du ihn starten kannst. Ergänze user-invocable: false für Hintergrundwissen, das nur Claude laden soll. Eingaben übergibst du mit $ARGUMENTS, wie in der Anleitung zu Slash-Commands gezeigt.

5. Teile ihn

   Committe .claude/skills/ ins Repository oder pack Skills als Plugin für mehrere Repositories oder Teams.

Quelle: Claude-Code-Dokumentation, Extend Claude with skills

Beispiele für Claude Code Skills

1. Ein Referenz-Skill, der nur für passende Dateien lädt

   Referenz-Skills enthalten Konventionen, die Claude bei der Arbeit anwendet. paths beschränkt das automatische Laden auf Dateien, die zu den Globs passen.

   ---
   description: API-Design-Konventionen dieser Codebasis. Verwenden beim Schreiben oder Prüfen von HTTP-Endpoints.
   paths: ["src/api/**"]
   ---
   
   Beim Schreiben von API-Endpoints:
   - Verwende REST-konforme Namen und Ressourcen im Plural
   - Gib Fehler als { error: { code, message } } zurück
   - Validiere den Request-Body mit den Schemas in src/api/schemas/

2. Ein Aufgaben-Skill mit zusätzlichen Dateien

   Halte die SKILL.md kurz und verweise auf den Rest. Claude liest checklist.md nur, wenn die SKILL.md es dazu auffordert, und führt bump.sh aus, ohne es zu lesen. Die Details kosten also nichts, bis sie gebraucht werden.

   release/
   ├── SKILL.md          # die Schritte, und wann die anderen Dateien zu lesen sind
   ├── checklist.md      # wird nur geladen, wenn SKILL.md Claude darauf verweist
   └── scripts/
       └── bump.sh       # wird ausgeführt, nicht in den Kontext gelesen

3. Ein Skill, der in seinem eigenen Subagent läuft

   context: fork startet einen Subagent (hier vom schreibgeschützten Typ Explore) mit dem Skill als Prompt. Er sieht deine Unterhaltung nicht, die Anweisungen müssen also für sich allein stehen; er läuft im Hintergrund, außer du setzt background: false.

   ---
   description: Abhängigkeiten auf bekannte Sicherheitslücken und veraltete Major-Versionen prüfen
   context: fork
   agent: Explore
   disable-model-invocation: true
   ---
   
   Führe das Audit des Paketmanagers aus, liste jeden Befund mit Schweregrad hoch oder
   kritisch samt Fix-Version auf und berichte, welche Major-Versionen hinterherhinken. Ändere keine Dateien.

Skills aus Plugins und Marketplaces installieren

Skills, die andere geschrieben haben, kommen meist in Plugins. Claude Code registriert Anthropics offiziellen Marketplace (claude-plugins-official), wenn du zum ersten Mal eine interaktive Session startest; durchstöbere ihn mit /plugin oder installiere direkt, zum Beispiel /plugin install skill-creator@claude-plugins-official. Einen Team- oder Community-Marketplace fügst du zuerst mit /plugin marketplace add owner/repo hinzu.

• Plugin-Skills heißen /plugin-name:skill-name.
• Der offizielle Marketplace zeigt für jedes Plugin die Kontextkosten pro Turn und beim Aufruf.
• Das Plugin skill-creator hilft beim Schreiben eines Skills und führt Evals aus, die Ergebnisse mit und ohne ihn vergleichen.
• Lies die Skills eines Repositorys oder Plugins, bevor du ihnen vertraust: allowed-tools kann Tools für den Turn, in dem ein Skill läuft, vorab freigeben.

Best Practices, und wenn Claude einen Skill ignoriert

• Schreib die Beschreibung so, dass sie gefunden wird: Beginne mit der Aufgabe und den Formulierungen, die Nutzer verwenden. Beschreibung plus when_to_use werden in der Liste nach 1.536 Zeichen abgeschnitten.
• Stell die wichtigsten Anweisungen nach oben: Nachdem die Unterhaltung komprimiert wurde, behält Claude Code eventuell nur den Anfang eines aufgerufenen Skills. Ruf ihn erneut auf, um ihn wiederherzustellen.
• Formuliere Vorgaben für die ganze Aufgabe ("führe nach jeder Änderung die Tests aus"), denn die Skill-Datei wird in späteren Turns nicht erneut gelesen. Eine Regel, die nie übersprungen werden darf, gehört in einen Hook.
• Um Tokens zu sparen, verschiebe Abläufe aus der CLAUDE.md in Skills, setze disable-model-invocation: true bei Skills, die du von Hand startest, und prüfe mit /skill-doctor, welche Skills Kontext kosten, aber selten genutzt werden.
• Er wird nicht ausgelöst? Prüfe, ob die Beschreibung die richtigen Schlüsselwörter enthält, frag "Welche Skills sind verfügbar?" und führe claude plugin validate .claude/skills aus, um Frontmatter zu finden, das sich nicht parsen lässt.
• Er wird zu oft ausgelöst? Fasse die Beschreibung enger oder stell den Skill mit disable-model-invocation: true auf manuell um.

Skills bringen Claude Code bei, wie es geht. Crewmark gibt ihm jede Stunde etwas zu tun.

Eine Sammlung von Skills macht jede Session fähiger, aber sie wartet trotzdem darauf, dass du fragst. Crewmark macht aus einer Session von Claude Code, Codex, DeepSeek Harness oder OpenCode einen KI-Mitarbeiter mit Rolle, Ziel und Arbeitszeiten und weckt ihn per Heartbeat, damit er das nächste Issue von einem Board übernimmt, mit den Skills deines Projekts geladen.

1. Behalte deine Skills im Repository

   Die Session des Mitarbeiters liest .claude/skills/ und die CLAUDE.md genau wie deine, ein Release-Skill oder eine Review-Checkliste kommen also mit.

2. Lass den Heartbeat die Arbeit starten

   Während seiner Arbeitszeiten wacht der Mitarbeiter alle 15, 30 oder 60 Minuten in derselben Unterhaltung auf und übernimmt das nächste Issue; siehe wie du Claude Code proaktiv machst.

3. Weise Issues zu und beantworte seine Nachrichten

   Lege Arbeit auf das Board; der Mitarbeiter kommentiert laufend und schreibt dir, wenn er eine Entscheidung braucht. Lies, was ein KI-Mitarbeiter ist.

FAQ zu Claude Code Skills