Viele Teams schreiben dieselben Prompts immer wieder: ein Review nach festen Kriterien, ein Release vorbereiten, eine neue API-Route nach Hausstandard anlegen. Claude Code bietet dafür zwei Bausteine. Eigene Slash Commands sind gespeicherte Prompts, die Sie gezielt aufrufen. Skills sind gebündeltes Fachwissen mit Anleitungen und Hilfsdateien, das der Agent selbstständig lädt, wenn es zur Aufgabe passt. Zusammen machen sie aus individuellem Prompt-Wissen einen geteilten Teamstandard. Dieser Artikel zeigt, wann Sie welchen Baustein nutzen.
Slash Commands: wiederholbare Abläufe auf Knopfdruck
Ein eigener Slash Command ist eine Markdown-Datei im Ordner .claude/commands. Der Dateiname wird zum Befehl, aus review.md wird also /review. Mit dem Platzhalter $ARGUMENTS übergeben Sie Parameter, etwa eine Ticketnummer. Im Frontmatter können Sie eine Beschreibung, erlaubte Tools und ein Modell festlegen.
Slash Commands eignen sich für Abläufe, die ein Mensch bewusst startet: einen Pull Request zusammenfassen, einen Commit nach Konvention vorbereiten, ein Issue analysieren und einen Umsetzungsplan vorschlagen. Weil sie im Repository liegen, profitieren neue Teammitglieder ab dem ersten Tag davon.
Ein bewährtes Muster ist ein Command, der zuerst nur analysiert und einen Plan ausgibt, und ein zweiter, der die Umsetzung startet. So bleibt der Mensch an der entscheidenden Stelle in der Schleife. Persönliche Commands, die nicht für alle gedacht sind, legen Sie im Benutzerverzeichnis ab, damit das Repository übersichtlich bleibt.
Skills: Wissen, das der Agent selbst abruft
Ein Skill ist ein Ordner mit einer SKILL.md, die Name und Beschreibung im Frontmatter trägt, plus optionalen Skripten, Vorlagen oder Referenzdokumenten. Claude Code sieht zunächst nur die kurze Beschreibung und lädt den vollständigen Inhalt erst, wenn die Aufgabe dazu passt. So bleiben auch viele Skills kontextschonend.
Typische Skills sind Ihr Styleguide für Datenbankmigrationen, das Vorgehen beim Anlegen eines neuen Microservice oder die Regeln für Barrierefreiheit im Frontend. Der Unterschied zum Slash Command: Niemand muss daran denken, ihn aufzurufen.
Besonders wertvoll werden Skills durch beigelegte Skripte. Statt dem Agenten zu erklären, wie ein Datenexport korrekt aufgebaut wird, legen Sie ein geprüftes Skript in den Skill-Ordner und beschreiben nur, wann und wie es aufzurufen ist. Das spart Token und macht das Ergebnis reproduzierbar, weil der Agent nicht jedes Mal eigenen Code dafür erzeugt.
Entscheidungshilfe: Command, Skill oder CLAUDE.md?
Gehört eine Regel zu jeder Aufgabe, etwa Build-Befehle oder Namenskonventionen, steht sie in der CLAUDE.md. Ist es ein Ablauf, den jemand gezielt anstößt, wird es ein Slash Command. Ist es Spezialwissen, das nur bei bestimmten Aufgaben gebraucht wird und Platz kostet, wird es ein Skill. Muss etwas garantiert passieren, ist ein Hook die richtige Wahl.
Diese Trennung verhindert die häufigste Fehlentwicklung: eine CLAUDE.md, die auf Hunderte Zeilen anwächst und bei jeder Aufgabe den Kontext verstopft.
Ein Praxisbeispiel: Die Anweisung, Tests mit einem bestimmten Befehl zu starten, bleibt in der CLAUDE.md. Die ausführliche Anleitung für Datenbankmigrationen mit Rollback-Strategie wandert in einen Skill. Der Ablauf, einen Release-Branch vorzubereiten, wird ein Command namens release, und das automatische Formatieren übernimmt ein Hook.
Einführung im Team in fünf Schritten
- Sammeln Sie die fünf Prompts, die im Team am häufigsten wiederholt werden.
- Formulieren Sie daraus Slash Commands mit klarer Beschreibung und, wo nötig, Argumenten.
- Lagern Sie umfangreiches Spezialwissen aus der CLAUDE.md in Skills aus.
- Legen Sie alles im Repository ab und behandeln Sie Änderungen wie Code mit Review.
- Bündeln Sie bewährte Commands, Skills und Hooks bei Bedarf als Plugin, um sie über mehrere Repositories zu verteilen.
Stolpersteine und Unterstützung
Zu viele ähnlich beschriebene Skills führen dazu, dass der Agent den falschen lädt. Commands ohne Beschreibung tauchen in der Befehlsliste kaum auf. Und Inhalte, die niemand pflegt, veralten schneller als der Code. Planen Sie deshalb eine feste Verantwortung für die Pflege ein.
In den Workshops von neooutput entwickeln unsere AI Code Engineers gemeinsam mit Ihrem Team eine erste Bibliothek aus Commands und Skills für Ihre echte Codebasis. Klären Sie in einem kostenlosen 15-Minuten-Erstgespräch, welcher Einstieg zu Ihnen passt.
Häufige Fragen
Funktionieren eigene Slash Commands auch im Headless-Modus?
Ja, Sie können sie auch beim nicht interaktiven Aufruf von Claude Code verwenden. Damit lassen sich dieselben Abläufe lokal und in CI-Pipelines nutzen.
Wie viele Skills sind sinnvoll?
Es gibt keine feste Grenze, weil zunächst nur die Beschreibungen geladen werden. Entscheidend ist, dass sich die Beschreibungen klar unterscheiden. Starten Sie mit wenigen gut gepflegten Skills.
Kann ich Skills auch außerhalb von Claude Code nutzen?
Skills sind ein Konzept von Anthropic und werden auch in anderen Claude-Produkten unterstützt. Für andere Agenten wie Codex oder Cursor übertragen Sie die Inhalte besser in AGENTS.md oder die jeweiligen Regeldateien.