Claude Skills bauen: Einen Ablauf einmal beschreiben

Viele Aufgaben erklärst du Claude immer wieder gleich: wie ein Angebot aufgebaut ist, wie ein Protokoll aussehen soll, welche Schritte eine Auswertung hat. Mit einem Skill beschreibst du so einen Ablauf einmal. Claude erkennt danach selbst, wann der Skill passt, und arbeitet nach deiner Anleitung. Hier baust du deinen ersten Skill, vom Aufbau der Datei bis zum Einsatz in Claude und Claude Code.

Was ein Skill ist

Ein Skill ist ein Ordner mit einer Datei namens SKILL.md. Darin stehen oben ein Name und eine Beschreibung, darunter die eigentliche Anleitung. Zusätzlich kann der Ordner weitere Dateien enthalten, etwa Vorlagen, Preislisten oder Beispiele, auf die die Anleitung verweist.

Der Unterschied zu einem Projekt: Ein Projekt gibt Claude Kontext zu einem Thema. Ein Skill beschreibt einen Ablauf, den Claude in jedem passenden Chat anwenden kann. Claude liest zunächst nur die Beschreibung und lädt die volle Anleitung erst, wenn eine Aufgabe dazu passt.

Welcher Ablauf sich als Skill eignet

• Du erklärst ihn mindestens einmal pro Woche neu.
• Er hat feste Schritte und ein klares Ergebnis.
• Es gibt Regeln, die Claude ohne Hinweis falsch machen würde.

Gute erste Kandidaten sind Angebote aus Gesprächsnotizen, Protokolle aus Besprechungen, Wochenberichte aus Zahlen oder Beiträge aus einem Transkript.

Der Aufbau der SKILL.md

Die Datei beginnt mit einem Kopfbereich zwischen zwei Zeilen mit drei Bindestrichen. Laut Dokumentation von Anthropic gilt:

• name: Kleinbuchstaben, Zahlen und Bindestriche, passend zum Ordnernamen.
• Die Wörter „anthropic“ und „claude“ sind im Namen nicht erlaubt.
• description: was der Skill tut und wann Claude ihn nutzen soll.

Die Anleitung darunter hältst du laut Dokumentation am besten unter 500 Zeilen. Längeres Material, etwa eine ausführliche Preisliste, legst du als eigene Datei in den Ordner und verweist darauf.

Ein vollständiges Beispiel

---
name: angebot-aus-notiz
description: Erstellt aus einer Gesprächsnotiz ein Angebot im
  Format unserer Vorlage. Nutzen, wenn der Nutzer eine
  Gesprächsnotiz, ein Erstgespräch oder eine Anfrage schickt
  und ein Angebot, Kostenvoranschlag oder Preisvorschlag will.
---

# Angebot aus Gesprächsnotiz

## Ablauf
1. Lies die Notiz und liste die genannten Leistungen auf.
2. Gleiche jede Leistung mit preise.md in diesem Ordner ab.
3. Fehlt ein Preis, frag nach. Schätze nie selbst.
4. Fülle vorlage.md aus: Anrede, Leistungen, Summe, Frist.
5. Nenne am Ende offene Punkte für das Rückfragegespräch.

## Regeln
- Per Sie, sachlich, höchstens eine Seite.
- Angebot gilt 30 Tage, steht immer am Ende.

Auf die Beschreibung kommt es an

Die Beschreibung ist der wichtigste Teil des Skills. Claude entscheidet anhand dieser Zeilen, ob der Skill zur aktuellen Aufgabe passt. Ist sie zu allgemein, lädt Claude den Skill nie oder ständig.

• Nenne das Ergebnis: „Erstellt ein Angebot im Format unserer Vorlage“.
• Nenne die Auslöser: welche Wörter Nutzer typischerweise schreiben.
• Grenze ab, wenn es ähnliche Skills gibt, etwa für Rechnungen.

Den Skill in Claude nutzen

In Claude im Browser oder in der App lädst du eigene Skills laut Hilfebereich als ZIP-Datei in den Einstellungen hoch. Die ZIP-Datei muss den Skill-Ordner enthalten, nicht nur die einzelnen Dateien. Voraussetzung ist ein bezahlter Plan mit aktivierter Code-Ausführung. Eigene Skills gelten zunächst nur für dein Konto.

Den Skill in Claude Code nutzen

In Claude Code legst du den Ordner einfach in dein Projekt, unter .claude/skills/. Für Skills, die in allen Projekten gelten sollen, nutzt du den gleichnamigen Ordner in deinem Benutzerverzeichnis unter ~/.claude/skills/. So sieht das für das Beispiel aus:

.claude/skills/angebot-aus-notiz/
├── SKILL.md
├── preise.md
└── vorlage.md

Claude Code erkennt den Skill beim nächsten Start. Du kannst ihn über die Beschreibung automatisch auslösen lassen oder direkt mit einem Schrägstrich und dem Namen aufrufen, hier also /angebot-aus-notiz.

Skill, Projekt oder CLAUDE.md?

Die drei Bausteine ergänzen sich. Wohin eine Information gehört, zeigt diese Übersicht:

Ein Beispiel aus der Praxis: Die Preisliste liegt im Projekt oder im Ordner, die Regel „Preise nie schätzen“ steht in der CLAUDE.md, und der Ablauf „aus Notiz wird Angebot“ ist ein Skill, der beides nutzt.

Testen und verbessern

1. Stelle drei echte Aufgaben, ohne den Skill zu erwähnen.
2. Prüfe, ob Claude den Skill lädt und die Schritte einhält.
3. Schärfe Beschreibung oder Regeln nach, wo es hakt.

Nach zwei, drei Runden läuft ein Skill meistens stabil. Ab dann sparst du bei jeder Wiederholung das Erklären und bekommst Ergebnisse, die immer gleich aufgebaut sind.

Häufige Fragen

Muss ich für einen Skill programmieren?

Nein. Eine SKILL.md ist ein Textdokument mit einem kurzen Kopfbereich. Wenn du einen Ablauf in klaren Schritten aufschreiben kannst, kannst du auch einen Skill bauen.

Wie viele Skills sind sinnvoll?

Starte mit einem einzigen Skill für den Ablauf, der dich am meisten Zeit kostet. Erst wenn er sauber läuft, kommt der nächste dazu. Viele ähnliche Skills mit unklaren Beschreibungen machen es Claude schwerer, den richtigen zu wählen.

Wie es weitergeht

Wo Skills überall laufen, welche fertigen Skills es gibt und wie ihr sie im Team teilt, steht in Claude Skills erklärt. Ihre Stärke spielen sie vor allem in Claude Code aus, zusammen mit einer guten CLAUDE.md. Wie beides im Alltag zusammenwirkt und wie du ganze Projekte damit umsetzt, zeigt die Claude Code Masterclass Schritt für Schritt.