Claude Code Skills

Dein Skill macht Murks? Das liegt nicht am Skill.

Die meisten Claude-Code-Nutzer kennen nur eine Schublade ihres Werkzeugkastens. Dieses Framework zeigt dir alle vier — vom Einzeiler bis zum eigenständigen Agent. Kostenlos. Als PDF. Sofort in deinem Postfach.

4 Stufen, 1 Framework
Copy-Paste Frontmatter
Entscheidungsbaum inklusive
Verifiziert für Claude Code v2.1+
Das Problem

Ein Messer, wo du eine Säge brauchst

Dein Skill funktioniert manchmal perfekt — und manchmal produziert er Unsinn. Die Ursache ist fast immer dieselbe: falscher Isolationsgrad.

Das ist, als hättest du einen Werkzeugkasten mit 4 Schubladen. Aber du öffnest immer nur die oberste.

Die Markdown-Datei mit Anweisungen. Stufe 1. Und für manche Aufgaben reicht das völlig. Für andere ist es wie ein Butterbrot mit der Kreissäge schneiden. Oder umgekehrt: eine Eiche mit dem Buttermesser fällen.

Chat läuft voll

Dein Skill liest 5 große Dateien und danach wird Claude Code vergesslich. Dein Kontext-Fenster ist wie ein Schreibtisch — irgendwann liegt zu viel drauf.

Kosten explodieren

200 Aufrufe pro Tag mit Opus, obwohl Haiku reichen würde. Das sind 6 Euro statt 36 Cent. Pro Monat. Pro Skill. Rechne das mal hoch.

Kein Hintergrund-Modus

Du willst, dass der Skill eigenständig arbeitet, während du Kaffee trinkst. Aber er blockiert deinen Chat, bis er fertig ist.

Keine Tool-Kontrolle

Dein Agent darf alles: Dateien löschen, Code ausführen, E-Mails senden. Das ist kein System. Das ist ein Risiko.

Das Framework

4 Stufen, 1 Prinzip

Skills sind kein Ein/Aus-Schalter. Sie sind ein Spektrum. Die Frage ist nie "Skill oder Agent?" — die Frage ist: Welchen Isolationsgrad braucht diese Aufgabe?

Stufe Was es ist Frontmatter Wann du es brauchst
1 Pure Instruction name + description Quick Wins, Notizen, Routine
2 Eigenes Modell + model: haiku/sonnet/opus Cost-Optimierung, billigere Routine-Tasks
3 Context Fork + context: fork Sauber bleiben bei großen Datenmengen
4 Subagent Agent + Tool-Restrictions Multi-AI, Background-Tasks, Parallelität
Stufe 1
Pure Instruction
Eine Markdown-Datei. Sonst nichts. Für Quick Wins, Notizen und Routine-Tasks unter 5 Minuten.
Stufe 2
Eigenes Modell
Derselbe Skill — aber du sagst, welches Modell es nutzen soll. Haiku statt Opus kann den Faktor 20 ausmachen.
Stufe 3
Context Fork
Eigener Kontext. Dein Chat bleibt sauber. Pflicht wenn der Skill mehr als 3 Dateien liest.
Stufe 4
Subagent
Eigenständiger Agent mit eigenen Tools, eigener Session, eigenen Entscheidungen. Arbeitet parallel.
Im Detail

Drei Zeilen Frontmatter. Der ganze Unterschied.

Vom Post-it zum Mitarbeiter. Jede Stufe löst ein konkretes Problem. Im Framework bekommst du Code-Beispiele aus echten Projekten — kein Theorie-Gedöns.

Stufe 1

Pure Instruction

Eine Markdown-Datei mit Name und Description. Mehr nicht. Reicht für alles unter 5 Minuten — wenn du das Ergebnis sofort sehen und korrigieren willst.

name: journal
description: Tages-Reflexion schreiben
Stufe 2

Eigenes Modell

Nicht jede Aufgabe braucht Opus. Dateien umbenennen, Listen sortieren, Templates ausfüllen — das kann Haiku. Für einen Bruchteil.

model: haiku
Stufe 3

Context Fork

Der Skill bekommt seinen eigenen Schreibtisch. Er arbeitet, liefert das Ergebnis — und räumt ab. Dein Chat: sauber wie vorher.

context: fork
Stufe 4

Subagent

Kein Skill mehr. Ein eigenständiger Agent mit eigener Session, eigenen Tools und eigenen Entscheidungen. Arbeitet im Hintergrund.

Agent + Tool-Restrictions + Entscheidungslogik

Nicht alles muss ein Agent sein. Nicht alles muss Opus nutzen. Und nicht alles braucht einen Context Fork.

Entscheidungsbaum

5 Fragen. Fertig.

Du sitzt vor einer Aufgabe und fragst dich: Welche Stufe? Drei Fragen reichen meistens. Fang bei Frage 1 an.

  1. 01
    Wie lange dauert die Aufgabe? Unter 2 Minuten, 2–10 Minuten oder über 10 Minuten — das allein grenzt schon ein.
    → Unter 2 Min? Stufe 1. Fertig.
  2. 02
    Braucht es Kreativität? Routine, Listen, Templates → Haiku reicht. Urteilsvermögen → Sonnet/Opus.
    → Nein? Stufe 2 mit Haiku.
  3. 03
    Liest der Skill mehr als 3 Dateien? Wenn ja, müllet er deinen Chat zu. Dein Kontext-Fenster dankt dir für den Fork.
    → Ja? Stufe 3.
  4. 04
    Soll er eigenständig entscheiden? Nicht nur Schritte abarbeiten, sondern eigene Entscheidungen treffen und Fehler behandeln.
    → Ja? Stufe 4.
  5. 05
    Willst du parallel arbeiten? Wenn der Skill läuft und du was anderes machen willst — brauchst du einen Agent.
    → Ja? Stufe 4.
Häufige Fehler

4 Fehler, die fast jeder macht

Im vollständigen Framework erkläre ich jeden Fehler im Detail — mit Beispielen, warum er passiert und wie du ihn vermeidest. Hier die Kurzversion.

Alles ist Stufe 4

Du hast gelernt, dass Agents existieren — und jetzt ist alles ein Agent. Dein Journal-Skill. Dein Datei-Umbenenner. Ein Agent für eine 30-Sekunden-Aufgabe ist eine Kreissäge fürs Butterbrot.

Nie über Stufe 1 hinaus

20 Stufe-1-Skills und du wunderst dich, warum dein Kontext-Fenster ständig vollläuft und Claude Code vergesslich wird.

Opus für alles

Opus ist brilliant. Und teuer. Für einen Analytics-Report, der CSV-Zeilen zählt, absoluter Overkill. Haiku kann das. Für ein Zwanzigstel der Kosten.

Keine Tool-Restrictions

Wenn dein Agent alles darf — Dateien löschen, Code ausführen, E-Mails senden — baust du kein System. Du baust ein Risiko.

Was du bekommst

Das komplette Stufen-Framework

Im PDF findest du:

  • Alle 4 Stufen mit echten Code-Beispielen aus der Praxis
  • Frontmatter-Referenz zum Rauskopieren
  • Der vollständige Entscheidungsbaum (5 Fragen)
  • Die Schachtelungs-Regel: Wie Stufe 4 intern Stufe 2 nutzt
  • Kosten-Vergleich: Haiku vs. Sonnet vs. Opus pro Aufruf
  • Die 4 häufigsten Fehler — und wie du sie vermeidest
  • Verifiziert für Claude Code v2.1.119+
Kostenlos

Hör auf zu raten. Bau richtig.

Nimm einen Skill, den du schon gebaut hast. Einen, der funktioniert, aber irgendwie nicht perfekt. Stell die 5 Fragen. Ändere eine Sache. Testen. Dann die nächste.