Skills und Slash-Commands

Lernziele

Du trennst Verhalten, das in einen Skill · engl. skillEin Ordner mit einer Datei SKILL.md, die einem Agenten eine wiederkehrende Aufgabe beschreibt. Claude Code lädt den Skill, wenn die Aufgabe passt oder du ihn mit seinem Namen aufrufst.Im Glossar gehört, von Abkürzungen, die ein Slash-Command · engl. slash commandEin Befehl, den du in Claude Code mit einem Schrägstrich aufrufst, etwa /ingest. Eigene Befehle sind Markdown-Dateien im Projektordner .claude/.Im Glossar sind.
Du installierst Skills und Befehle im Vault und erkennst Befehle, deren Namen mit eingebauten Befehlen von Claude Code kollidieren.
Du schreibst einen eigenen Skill mit einer Beschreibung, die zuverlässig auslöst, und mit Regeln, die ihren Grund nennen.

Zwei Mechanismen sehen ähnlich aus und erledigen verschiedene Aufgaben.

Ein Skill bringt dem Agenten ein wiederholbares Verhalten bei. Er lädt, wenn er passt, und prägt, wie der Agent etwas tut. Das gilt, ob du ihn ausdrücklich aufrufst oder die Aufgabe nur beschreibst. Claude Code hält dafür die Beschreibung jedes Skills im Kontext und lädt den vollständigen Text erst, wenn der Skill gebraucht wird.

Ein Befehl ist eine Abkürzung für eine Aufgabe, die du oft startest. Er verweist auf einen Skill und erspart dir das Eintippen der Anweisungen.

Das Verhalten gehört in den Skill. Dann läuft der Import gleich ab, egal ob ihn /ingest gestartet hat, eine geplante Aufgabe oder dein Satz „Nimm das in meinen Vault auf“. In Claude Code sind Befehle inzwischen in Skills aufgegangen. Eine Datei in .claude/commands/ funktioniert weiter, und jeder Skill lässt sich auch mit /name aufrufen.

Skill

Datei: .claude/skills/<name>/SKILL.md
Enthält: wie eine Aufgabe erledigt wird, mit Gründen, Ablauf und Ausgabeformat
Lädt: wenn die Aufgabe zur Beschreibung passt oder du ihn aufrufst
Anzahl: wenige, gut geschrieben

Befehl

Datei: .claude/commands/<name>.md
Enthält: ein paar Zeilen, die auf einen Skill zeigen und den Umfang setzen
Lädt: wenn du /name tippst
Anzahl: beliebig viele, sie kosten fast nichts

Was der Werkzeugkasten mitbringt

Der Werkzeugkasten des Kurses enthält achtzehn Skills, einen für jeden Arbeitsablauf aus diesem Praxisprojekt, und zweiundsiebzig Befehle. Jeder Befehl besteht aus wenigen Zeilen, die auf einen Skill verweisen und seinen Umfang festlegen. So sieht der Befehl /vault-review aus:

---
description: Periodic review of what the vault learned
---

Review the period in $ARGUMENTS, defaulting to seven days.

Follow the `second-brain-review` skill.

$ARGUMENTS ersetzt Claude Code durch das, was du hinter den Befehl schreibst. Mit /vault-review 30 days blickt der Rückblick auf dreißig Tage.

Das Verhältnis ist Absicht. Verhalten gehört in wenige, gut geschriebene Skills. Befehle sind billig. Du sollst dir nicht merken müssen, wie du eine Bitte formulierst, die du jede Woche stellst.

Installiere beides im Vault unter .claude/skills/ und .claude/commands/. Dann liegen Skills und Befehle in Git neben deinen Notizen und ziehen mit dem Vault um. Claude Code macht aus jeder Datei in .claude/commands/ einen Befehl. Leg dort also keine README und keine Notizen ab, sonst entsteht ein Befehl /README.

Skill oder Befehl?

Entscheide für jeden Inhalt, ob er in einen Skill gehört oder in einen Befehl.

Noch offen (5)

Regel: Jede neue Konzeptseite bekommt Links zu mindestens zwei bestehenden Seiten
„Rückblick über die letzten dreißig Tage“ als Kurzform
Das Format des Berichts nach jedem Import
Den Import auf YouTube-Transkripte begrenzen
Der Grund, warum Widersprüche nie überschrieben werden

Skill (0)

Befehl (0)

Einen eigenen Skill schreiben

Ein Skill lohnt sich, wenn drei Dinge zusammenkommen: Du tust etwas wiederholt, du hast eine Meinung dazu, wie, und diese Meinung ist nicht so naheliegend, dass das Modell sie errät.

Dieser Aufbau funktioniert nach unserer Einschätzung gut:

---
name: skill-name
description: >-
  What it does. When to use it, written pushy, because agents under-trigger
  skills. Do NOT use for the tempting near-misses.
---

# Name

[Why this skill exists: what failure it prevents. This paragraph is the rubric
for every case the rules below do not cover.]

## Core rule
## Workflow
## Output format
## Calibration
## Example

Die Beschreibung entscheidet, ob der Skill überhaupt lädt. Anthropic schreibt im Skill skill-creator, dass Claude Skills derzeit oft nicht einsetzt, obwohl sie nützlich wären, und empfiehlt, Beschreibungen „ein wenig aufdringlich“ zu formulieren: was der Skill tut, und ausdrücklich, in welchen Lagen er greifen soll. Der offene Standard Agent Skills erlaubt für name bis zu 64 Zeichen und für description bis zu 1.024. Die Beschreibung des Import-Skills aus dem Werkzeugkasten zeigt das Muster:

description: >-
  Turn raw source material in a second-brain vault into linked wiki pages:
  read the source, split it into concepts and entities, write or update pages,
  connect them to existing pages, and record the run in the log. Use this skill
  whenever the user drops a file into raw/, pastes an article, transcript or
  PDF and asks to add it to the vault, says "ingest this", "add this to my
  second brain", "process raw", or asks to catch up on unprocessed sources,
  even if they do not name the ingest command. Do NOT use for answering
  questions from an existing vault, for linting or repairing pages, or for
  editing notes the user wrote by hand.

Der erste Absatz unter der Überschrift leistet mehr als die Regeln. Regeln decken die Fälle ab, an die du gedacht hast. Der Grund deckt den Rest ab.

Das Warum erklären

„Überschreib nie einen Widerspruch“ wird wörtlich angewendet und scheitert an Randfällen. „Überschreib nie einen Widerspruch, denn die Geschichte dessen, was du geglaubt hast, ist das, was dieser Vault einer Suchmaschine voraushat“ trägt auch in Lagen, die du nie beschrieben hast.

Ein großgeschriebenes NIE ohne Grund ist nach unserer Einschätzung meist eine fehlende Erklärung. Anthropic rät im Skill skill-creator dasselbe: dem Modell erklären, warum etwas wichtig ist, und großgeschriebenes ALWAYS oder NEVER als Warnzeichen lesen. Die Skill-Dokumentation von Claude Code betont eine zweite Seite: Ein geladener Skill bleibt im Kontext, jede Zeile kostet bei jeder Runde Tokens. Halte den Grund deshalb kurz, ein Satz pro harter Regel reicht.

Versionierung

Skills liegen im Vault, also verfolgt Git sie. Ändert sich die Qualität der Ergebnisse, ist der Diff des Skills der erste Ort, an dem du nachsiehst.

Teste einen Skill an drei oder vier echten Fällen, bevor eine geplante Aufgabe ihn nutzt. Ein Fehler in einem Skill, der jede Nacht läuft, steckt nach einem Jahr in dreihundert Seiten.

Merksätze

Ein Skill legt Verhalten fest und lädt, wenn er passt. Ein Befehl ist eine Abkürzung, die auf einen Skill zeigt.
Skills und Befehle liegen im Vault unter .claude/.
Sechs Befehle aus dem Werkzeugkasten tragen die Vorsilbe vault-, weil Claude Code die kurzen Namen selbst belegt.
Die Beschreibung entscheidet, ob ein Skill lädt: konkret, mit Auslösern und mit Abgrenzung.
Jede harte Regel bekommt einen kurzen Grund. Getestet wird an echten Fällen, bevor ein Zeitplan den Skill nutzt.

Prüf dich selbst

Denkfrage

Warum gehört das Verhalten in den Skill und nicht in den Befehl?

Denkfrage

Dein neuer Skill lädt nie, obwohl die Aufgabe genau passt. Wo setzt du an?

Quellen

Extend Claude with skills · Anthropic, Stand: Nov. 2026
Befehle in Skills aufgegangen, Vorrang bei gleichen Namen, Beschreibung im Kontext, Text kurz halten.
Commands · Anthropic, Stand: Nov. 2026
Eingebaute Befehle, /review als Zweitname von /code-review.
skill-creator · Anthropic, Stand: Nov. 2026
Beschreibungen „a little bit pushy“, das Warum erklären, MUST in Großbuchstaben als Warnzeichen.
Agent Skills: Specification · Agent Skills, Stand: Nov. 2026
name bis 64, description bis 1.024 Zeichen.