Claude Code Skills und Slash Commands sind wiederverwendbare, benannte Workflows: Statt dieselben mehrstufigen Anweisungen neu zu tippen, rufst du einen auf, und der Agent führt deine bewährten Schritte mit dem richtigen Kontext bereits geladen aus. Stand 2026 sind Custom Slash Commands in Skills aufgegangen: Eine Datei unter .claude/commands/deploy.md und ein Skill unter .claude/skills/deploy/SKILL.md erstellen beide den /deploy-Befehl und funktionieren gleich. Dieser Guide zeigt dir, wie du einen Slash Command und eine SKILL.md erstellst, wie Argumente und dynamischer Kontext funktionieren, wo sie leben und wann Claude einen Skill automatisch lädt versus wann du ihn selbst auslöst.
Teil von: Claude Code Tutorial fuer Einsteiger
Skills und Commands sind jetzt eins
Jahrelang hatte Claude Code zwei getrennte Features: Slash Commands (eine Markdown-Datei, die du mit /name ausgelöst hast) und Skills (eine reichere, in sich geschlossene Fähigkeit). 2026 wurden sie vereinheitlicht. Custom Commands sind in Skills aufgegangen, sodass beide einen Slash Command erstellen und gleich funktionieren. Deine bestehenden .claude/commands/-Dateien funktionieren weiter, und Skills fügen einfach optionale Features obendrauf hinzu: ein Verzeichnis für Begleitdateien, Frontmatter, um zu steuern, wer sie aufruft, und die Fähigkeit, dass Claude sie automatisch lädt, wenn sie relevant sind. Claude Code Skills folgen dem offenen Agent-Skills-Standard, sodass derselbe Skill über Tools hinweg funktionieren kann.
- Eine Datei unter .claude/commands/deploy.md erstellt /deploy.
- Ein Skill unter .claude/skills/deploy/SKILL.md erstellt ebenfalls /deploy.
- Skills ergänzen: Begleitdateien, Invocation-Kontrolle und automatisches Laden per description.
- Bestehende .claude/commands/-Dateien funktionieren weiter; Skills sind der empfohlene Weg nach vorn.
Einen Slash Command erstellen
Der einfachste wiederverwendbare Workflow ist eine Markdown-Datei, deren Name zum Befehl wird. Leg eine Datei in .claude/commands/ (Projekt) oder ~/.claude/commands/ (persönlich) ab, und Claude Code stellt sie als Slash Command bereit. Nutze den $ARGUMENTS-Platzhalter, um alles zu erfassen, was du nach dem Befehl tippst, oder positionale $1, $2 für einzelne Argumente. Eine description im YAML-Frontmatter erscheint als Hilfetext. Das ist perfekt für eine einzelne, klar definierte Aktion, die du oft auslöst.
<!-- .claude/commands/fix-issue.md -->
---
description: Investigate and fix a GitHub issue by number.
argument-hint: [issue-number]
---
Fix GitHub issue #$ARGUMENTS. First read the issue with the gh CLI, then
find the relevant code, propose a fix in plan mode, and only implement
after I approve. Run the test suite before you say it is done.Eine SKILL.md schreiben
Ein Skill ist ein Verzeichnis mit einer SKILL.md-Datei in der Wurzel: YAML-Frontmatter plus Markdown-Anweisungen und optional gebündelte Skripte, Templates oder Referenzdateien. Der Verzeichnisname wird zum Befehl, den du tippst, und die description ist das, was Claude liest, um zu entscheiden, wann er den Skill automatisch lädt, also ist eine scharfe description die halbe Miete. Nur die description ist empfohlen; alles andere ist optional. Skills glänzen, wenn ein Workflow mehrstufig ist, eigene Assets hat, oder du willst, dass Claude ihn von selbst aufruft, wenn der Moment passt.
<!-- .claude/skills/summarize-changes/SKILL.md -->
---
description: Summarise uncommitted changes and flag risks. Use when the user asks what changed or wants a commit message.
allowed-tools: Read, Grep
---
## Current changes
!`git diff HEAD`
## Instructions
Summarise the changes above in two or three bullet points, then list any
risks such as missing error handling, hardcoded values, or tests that need
updating. If the diff is empty, say there are no uncommitted changes.Die Zeile mit !`git diff HEAD` ist dynamische Kontext-Injektion: Claude Code führt den Befehl aus und ersetzt die Zeile durch dessen Output, bevor das Modell den Skill sieht, sodass die Anweisungen mit deinem echten Diff bereits eingefügt ankommen. Halte den Body knapp, denn sobald ein Skill geladen ist, bleibt sein Inhalt über die Runden hinweg im Kontext.
Wo sie leben und wer sie aufruft
Projekt-Skills leben in .claude/skills/<name>/SKILL.md und gelten für dieses Repo; persönliche Skills leben in ~/.claude/skills/<name>/SKILL.md und folgen dir überallhin. Claude kann einen Skill automatisch aufrufen, wenn deine Anfrage zu seiner description passt, oder du löst ihn direkt mit /name aus. Wenn ein Workflow nur laufen soll, wenn du danach fragst (etwa ein Deploy), setze disable-model-invocation: true, damit Claude ihn nie von selbst auslöst. Um einen reinen Wissens-Skill aus dem Slash-Menü auszublenden, setze user-invocable: false.
- Projekt: .claude/skills/<name>/SKILL.md - mit dem Repo geteilt.
- Persönlich: ~/.claude/skills/<name>/SKILL.md - all deine Projekte.
- Automatisch per description aufgerufen oder direkt mit /name ausgelöst.
- disable-model-invocation: true macht einen Skill manuell-only; user-invocable: false blendet ihn aus dem /-Menü aus.
Wann was passt
Das Signal, irgendetwas zu verpacken, ist Wiederholung: Beim zweiten Mal, dass du den Agenten auf dieselbe Sequenz briefst, halte sie fest. Dann wähle die Form danach, wie reich sie ist. Eine einzelne klare Aktion ohne Assets ist eine reine Command-Datei. Ein mehrstufiger Prozess mit eigenen Templates, Skripten oder Referenzdocs, oder einer, den Claude automatisch laden soll, ist ein Skill. Du kannst mit einem Command starten und ihn später zu einem Skill ausbauen. Halte deine Library klein und fokussiert: zwei oder drei, zu denen du wirklich greifst, schlagen zwanzig, die du vergisst.
Schritt für Schritt
Wähle einen Workflow, den du wiederholst
Wähle die mehrstufige Anweisung, die du immer wieder neu tippst, etwa ein Deploy, einen Commit-und-PR-Ablauf oder eine Scaffold-und-Test-Routine.
Starte mit einer Command-Datei
Erstelle .claude/commands/<name>.md mit deinem Prompt und einer description im Frontmatter. Nutze $ARGUMENTS, um Input anzunehmen. Rufe sie als /<name> auf.
Befördere sie zu einer SKILL.md, wenn sie wächst
Wenn der Workflow gebündelte Dateien braucht oder du willst, dass Claude ihn automatisch lädt, erstelle .claude/skills/<name>/SKILL.md mit einer scharfen description. Der Verzeichnisname wird zum Befehl.
Füge dynamischen Kontext hinzu, falls nützlich
Inline live Daten mit einer !`command`-Zeile (zum Beispiel !`git diff HEAD`), damit der Skill mit echtem Kontext bereits gefüllt ankommt.
Setze die Invocation-Kontrolle
Für Workflows, die nur auf Anfrage laufen sollen, füge disable-model-invocation: true hinzu, damit Claude sie nie von selbst auslöst. Halte den Body knapp, um die Kontextkosten zu begrenzen.