Skills und Commands: Wiederverwendbare Superkräfte

Überblick

Skills und Slash Commands sind wiederverwendbare, benannte Workflows. Statt dieselbe Aufgabe jedes Mal von Grund auf zu beschreiben, rufst du einen auf, und der Agent führt deine bewährten Schritte mit bereits geladenem Kontext aus. Ein Slash Command ist ein schneller Auslöser für einen Prompt, den du wiederverwendest. Ein Skill ist eine reichhaltigere, in sich geschlossene Fähigkeit, die der Agent heranziehen kann, wenn sie relevant ist. Beide sind der Weg, aufzuhören, deine besten Workflows neu zu tippen, und anzufangen, sie als dauerhafte Vermögenswerte im Repo anzulegen.

Was du lernst

Du lernst den konkreten Unterschied zwischen einem Slash Command und einem Skill, was tatsächlich in einer SKILL.md-Datei steht, inklusive ihres Frontmatters, wie du einen Workflow festhältst, den du immer wieder wiederholst, und wie du eine fokussierte Bibliothek aus zwei oder drei Skills baust, die zu deiner eigenen Arbeitsweise passen, statt einer wuchernden Sammlung, die du vergisst.

Voraussetzungen

Ein funktionierendes Claude-Code-Setup und eine CLAUDE.md aus der vorigen Lektion, denn Skills und Commands bauen auf den dort definierten Konventionen auf - ein Skill, der eine Komponente scaffoldet, sollte denselben Namens- und Stilregeln folgen, die deine Projekt-Datei bereits festlegt.

Das Problem

Du hast einen Workflow, dem du vertraust. Vielleicht ist es "eine neue Seite scaffolden, sie zum Router hinzufügen, einen Smoke-Test schreiben, das Quality Gate ausführen". Du tippst jedes Mal denselben Absatz, der ihn beschreibt, etwas anders, und bekommst etwas andere Ergebnisse. Das Wissen steckt in deinem Kopf und deinen Fingern, nirgends Wiederverwendbarem. Wenn du müde bist, vergisst du einen Schritt. Wenn ein Teammitglied es tut, tut es das auf seine eigene Weise. Der Workflow ist echt und bewährt, aber er ist nicht festgehalten, also ist er fragil und inkonsistent.

Slash Commands: ein wiederverwendbarer Prompt

Ein Slash Command ist die einfachste Form der Wiederverwendung: eine Markdown-Datei, die einen Prompt enthält, den du durch Tippen eines Slashs und seines Namens aufrufst. Leg eine Datei in den Commands-Ordner, und Claude Code stellt sie als Command bereit. Er ist perfekt für eine einzelne, klar definierte Aktion, die du oft auslöst - das Quality Gate ausführen, einen Pull Request mit deiner Standardbeschreibung öffnen, zusammenfassen, was sich seit dem letzten Commit geändert hat. Die Datei kann Argumente annehmen, sodass ein Command über Fälle hinweg flexibel ist. Greif zu einem Command, wenn du Tempo und eine einzelne klare Aktion willst.

<!-- .claude/commands/ship-check.md -->
---
description: Run the full pre-push quality gate and report failures clearly.
---

Run these in order and stop at the first failure:

1. bun run lint
2. bun run typecheck
3. bun run test

If anything fails, show me the exact error and the file it points to,
then propose the smallest fix. Do not push.

Skills: eine verpackte Fähigkeit

Ein Skill ist mehr als ein Prompt. Es ist ein Ordner mit einer SKILL.md-Datei in seiner Wurzel, die Frontmatter (einen Namen und eine Beschreibung) plus Anweisungen trägt und optional gebündelte Skripte, Templates oder Referenzdateien, die der Agent nutzen kann. Die Beschreibung zählt enorm: der Agent liest sie, um zu entscheiden, wann der Skill relevant ist, und zieht den Skill automatisch heran, also ist eine scharfe Beschreibung das, was einen Skill auffindbar macht. Nutze einen Skill, wenn ein Workflow mehrschrittig ist, eigenen Kontext oder Assets hat und davon profitiert, eine in sich geschlossene Einheit zu sein, die du an einem Ort pflegst. Hier ist ein echtes SKILL.md-Frontmatter und ein Body für einen Skill, der eine Komponente scaffoldet.

<!-- .claude/skills/new-component/SKILL.md -->
---
name: new-component
description: Scaffold a new React component with its test and story. Use when the user asks to create, add or scaffold a component.
---

# New Component

When creating a component:

1. Create the component in src/components as a PascalCase .tsx file.
2. Use rounded-sm and the existing button/card styles - never invent new tokens.
3. Create a colocated <name>.test.tsx with a render smoke test.
4. Export it from the components barrel file.
5. Run bun run typecheck on just the new files and fix any errors.

Follow all rules in the project CLAUDE.md. Never add a new UI dependency.

Einen Workflow festhalten und die Form wählen

Das Signal, etwas zu verpacken, ist einfach: beim zweiten Mal, wenn du den Agent über dieselbe Abfolge briefst, ist diese Abfolge ein Kandidat. Schreib die Schritte einmal auf. Wähl dann die Form, indem du fragst, wie reichhaltig sie ist. Eine einzelne klare Aktion ohne Assets ist ein Slash Command. Ein mehrschrittiger Prozess mit eigenem Kontext, Templates oder gebündelten Skripten ist ein Skill. Denk nicht zu viel nach - du kannst mit einem Command starten und ihn später zum Skill befördern, wenn er wächst. Der Gewinn ist, den Workflow überhaupt festzuhalten, dieselbe Gewohnheit kontinuierlichen Lernens aus der letzten Lektion, auf Prozesse statt Regeln angewandt.

• Zweimal wiederholt = Kandidat zum Verpacken. Warte nicht aufs zehnte Mal.
• Einzelne Aktion, keine Assets, Tempo gewünscht: Slash Command.
• Mehrschrittig, eigener Kontext oder gebündelte Dateien, in sich geschlossene Einheit gewünscht: Skill.
• Eine grossartige Skill-Beschreibung ist die halbe Arbeit - sie ist, woran der Agent erkennt, wann er ihn nutzt.

Eine fokussierte persönliche Bibliothek

Starte klein und bewusst. Zwei oder drei Skills und Commands für die Workflows, die du am häufigsten machst - dein Quality Gate, eine Komponente scaffolden, einen Standard-Pull-Request öffnen - schlagen eine wuchernde Sammlung aus zwanzig, an die du dich halb erinnerst. Eine fokussierte Bibliothek ist eine, zu der du tatsächlich greifst, und jeder Eintrag verdient seinen Platz, indem er dir ein echtes, wiederholtes Brief erspart. Wie bei der Regel-Datei streiche, was du nicht mehr nutzt, und befördere, was du von Hand einfügst. Das Ziel ist nicht maximale Anzahl Skills, es ist maximale Hebelwirkung pro Skill.

Typische Fehler

Die üblichen Fallen: einen Skill bauen, bevor du den Workflow oft genug gefahren bist, um die richtigen Schritte zu kennen, sodass du einen schlechten Prozess festbackst; eine vage Skill-Beschreibung schreiben, sodass der Agent nie herausfindet, wann er ihn aufrufen soll; Dutzende Skills horten, deren Existenz du vergisst; und Logik duplizieren, die längst in die CLAUDE.md gehört. Skills sind für Workflows, die Regel-Datei ist für Standards - halt sie in ihren Spuren.

Business-ROI

Ein verpackter Workflow ist ein Prozess, der nicht mehr von der Person abhängt, die ihn erfunden hat. Dein bester Weg, zu scaffolden, zu testen oder zu shippen, wird zu einem Ein-Wort-Auslöser, der für dich, für ein Teammitglied und für einen Freelancer am ersten Tag gleich läuft. So schlägt ein kleines Team über seinem Gewicht: die Gründerin codiert den richtigen Weg, etwas zu tun, einmal, und alle führen ihn für immer konstant aus. Inkonsistente Prozesse sind eine stille Steuer auf die Qualität, und eine kleine Skills-Bibliothek entfernt sie zum Preis weniger Markdown-Dateien.

Checkliste

Du bist bereit weiterzugehen, wenn jedes davon stimmt. Die nächste Lektion automatisiert die Checks, mit denen diese Workflows oft enden.

• Du kannst erklären, wann ein Slash Command einen Skill schlägt und umgekehrt.
• Du hast mindestens einen Slash Command für einen Workflow geschrieben, den du wiederholst.
• Du kannst beschreiben, was in einer SKILL.md steht, inklusive warum die Beschreibung zählt.
• Deine Bibliothek ist klein und fokussiert, kein Haufen ungenutzter Einträge.

Ressourcen

Halt die offiziellen Claude-Code-Docs zu Skills und Slash Commands als Lesezeichen für die genauen Ordner-Speicherorte und Frontmatter-Felder, die sich mit der Zeit entwickeln. Die Ressourcen-Bibliothek hat ein Starter-Pack aus Command- und Skill-Templates, die du kopieren kannst. Paare jeden Skill mit deiner CLAUDE.md, damit verpackte Workflows automatisch deine Projektstandards erben.

Deine Aufgabe

Wähle den einen Workflow, über den du den Agent am häufigsten briefst. Schreib ihn zuerst als Slash Command - nur den Prompt in einer Markdown-Datei in deinem Commands-Ordner. Ruf ihn zweimal bei echter Arbeit auf. Wenn er Schritte gewinnt oder eigene Assets braucht, befördere ihn mit einer scharfen Beschreibung zum Skill. Du hast jetzt deine erste wiederverwendbare Superkraft im Repo angelegt.

Nächste Lektion

Skills und Commands laufen, wenn du sie auslöst. Die nächste Lektion geht eine Stufe weiter: Hooks und Skripte, die automatisch zu Schlüsselmomenten laufen, sodass deine Quality Gates feuern, ohne dass du je daran denkst, sie aufzurufen.