KI-Wissen Skill

Deinen ersten Claude-Skill bauen: fertige SKILL.md zum Kopieren

Skill Claude Code Getestet am

Was es macht

Ein Ordner und eine Datei namens SKILL.md genügen, damit Claude Code für eine wiederkehrende Aufgabe ein festes Rezept hat. Claude zieht es sich selbst, sobald die Aufgabe passt, oder du rufst es mit /summarize-changes auf.

Wann sich das lohnt

Lohnt sich für alles, was du mit Claude Code immer wieder auf dieselbe Art machst; für eine Aufgabe, die du genau einmal hast, lohnt der Aufwand nicht. Voraussetzung ist Claude Code auf deinem Rechner, für das Beispiel unten zusätzlich ein Projekt mit git. Halt Claude Code dabei aktuell: Mit Version 2.1.232 brach der Start mit dem voreingestellten Modell ab („version 2.1.251 or newer is required“), erst ein anderes Modell lief. Der fertige Skill fasst zusammen und nennt Risiken, eine Commit-Nachricht schreibt er nicht von allein, obwohl seine Beschreibung sie erwähnt. Diese Beschreibung ist englisch, ob eine deutsche genauso zuverlässig auslöst, ist offen. Der Eintrag führt nur den Weg über Claude Code; auf claude.ai im Browser lädst du Skills als ZIP hoch, und dafür passt die Datei unten nicht unverändert.

Die Datei

SKILL.md für den Ordner ~/.claude/skills/summarize-changes/

---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in two or three bullet points, then list any risks you notice such as missing error handling, hardcoded values, or tests that need updating. If the diff is empty, say there are no uncommitted changes.

So baust du es ein

  1. Ordner anlegen: Gib im Terminal mkdir -p ~/.claude/skills/summarize-changes ein. Was dort liegt, gilt laut Doku in allen deinen Projekten.
  2. Datei speichern: Übernimm den Inhalt oben unverändert und speicher ihn unter ~/.claude/skills/summarize-changes/SKILL.md. Der Ordnername wird zum Befehl, den du später tippst.
  3. Claude Code starten: Änder in einem Projekt eine Datei, die git schon kennt, und tipp claude. Eine frisch angelegte Datei taucht in git diff HEAD erst nach git add auf.
  4. Weicher Test: Schreib in den Chat „What did I change?“, so steht der Satz in der Doku. Er zeigt nur, ob die Beschreibung von allein greift.
  5. Harter Nachweis: Tipp /summarize-changes ein. Nimmt Claude Code den Befehl an und legt los, ist der Skill geladen.
  6. Optional, wenn Claude deinen nächsten Skill schreiben und prüfen soll: Tipp /plugin install skill-creator@claude-plugins-official ein, beim Hinweis „Run /reload-plugins to activate.“ zusätzlich /reload-plugins. Danach: „evaluate my summarize-changes skill with skill-creator“.

Womit ich das geprüft habe

Am 07.09.2026 wirklich durchgespielt: Die Datei oben unverändert als SKILL.md gespeichert, aus Vorsicht im projekt-lokalen Ordner .claude/skills/summarize-changes eines Wegwerf-Projekts statt unter ~/.claude, wo Claude Code sie genauso findet; dass ein Skill in allen Projekten gilt, steht damit weiter nur in der Doku. Beide Tests sind bestanden, mit dem Modell Sonnet und als einzelne Aufrufe statt getippt im laufenden Fenster: Auf „What did I change?“ zog Claude Code den Skill von allein und nannte den hartcodierten Schlüssel sk-live-12345 als Risiko, /summarize-changes wurde als Befehl angenommen und ausgeführt, der Kopf ohne name-Zeile akzeptiert. Dass die Zeile !`git diff HEAD` wirklich läuft, zeigte eine nicht erratbare Markierung im Code: Claude gab sie in drei Läufen wieder, ohne git ein einziges Mal selbst aufzurufen. Schritt 3 stimmt, gemessen mit git 2.50.1 unter macOS 26.5.2: Die frisch angelegte Datei liefert vor git add null Treffer im Diff, danach zwei. Statt Schritt 6 zu installieren, habe ich skill-creator aus der lokalen Marktplatz-Kopie laufen lassen; er prüfte die SKILL.md und fand die fehlende Anweisung zur Commit-Nachricht. Nur gelesen, nicht ausgeführt: der Eintrag skill-creator@claude-plugins-official im Marktplatz-Katalog und der Satz „Run /reload-plugins to activate.“ wörtlich im Programm. Nachgelesen statt ausprobiert ist auch der Weg über claude.ai: Die Hilfeseite support.claude.com/en/articles/12512198 sagt wörtlich, die ZIP-Datei muss den Skill-Ordner als Wurzel enthalten und nicht in einem Unterordner, und sie führt name und description als Pflichtfelder auf; deshalb passt die Datei oben dort nicht unverändert. Einen Klickweg für den Upload nennt die Seite nicht, sie sagt nur, dass du den Skill danach unter „Customize > Skills“ einschaltest. Hochgeladen habe ich nichts.

Nächster Eintrag Jev in Claude Code: das TypeSafe-Plugin mit zwei Befehlen installieren →