Claude · Ausbaustufen · Kapitel 12 · 5 Min.

Skills — einen Handgriff beibringen

Eine Textdatei, die Claude sich holt, wenn er sie braucht. Der Unterschied zur CLAUDE.md ist der ganze Trick.

Stell dir einen Ordner an der Werkstattwand vor. Vorne drauf steht: „Aufmaß nehmen — bei allen Innenausbau-Aufträgen“. Was drinsteht, weiß man nicht auswendig. Man holt ihn sich, wenn ein Aufmaß ansteht.

Genau das ist ein Skill.

Warum das der Kern ist

Erinnere dich an Kapitel 9: Die CLAUDE.md wird immer vollständig mitgeschickt. Jede Zeile kostet dauerhaft Platz.

Beim Skill ist es anders. Von einem Skill mit 200 Zeilen liegen zwei Zeilen im Kontext: sein Name und seine Beschreibung. Die restlichen 198 werden geladen, wenn sie dran sind — und sonst nie.

Merke

Immer nötig → CLAUDE.md. Manchmal nötig → Skill.
Das ist die ganze Entscheidungsregel. Du kannst zwanzig Skills haben, ohne dass dein Kontext darunter leidet. Du kannst keine zwanzig Absätze in der CLAUDE.md haben.

Wie ein Skill aussieht

Ein Ordner mit einer Datei SKILL.md darin. Oben ein kleiner Kopf zwischen zwei Linien, darunter normaler Text.

---
name: aufmass-protokoll
description: Erstellt ein Aufmaßprotokoll aus Rohnotizen.
  Verwenden, wenn von Aufmaß, Raumbuch oder Mengenermittlung
  die Rede ist.
---

# Aufmaßprotokoll

## Aufbau
Immer diese Spalten, immer in dieser Reihenfolge:
Raum | Bauteil | Länge | Breite | Höhe | Menge | Einheit

## Regeln
- Maße in Metern, zwei Nachkommastellen
- Öffnungen über 2,5 m² werden abgezogen, darunter nicht
- Jede Zeile bekommt eine laufende Nummer

## Am Ende
Summenzeile je Raum, darunter eine Gesamtsumme.

Das ist alles. Kein Programmieren. Eine Anleitung, wie du sie einem neuen Kollegen aufschreiben würdest.

Die Beschreibung ist das Wichtigste

Das ist die Stelle, an der die meisten Skills scheitern. Die description ist das Einzige, was Claude dauerhaft sieht. Danach entscheidet er, ob er den Skill überhaupt aufschlägt.

Schreib in die Beschreibung die Wörter, die du selbst benutzen würdest, wenn du die Aufgabe stellst. Das sind die Haken, an denen der Skill hängen bleibt.

Wo Skills liegen

Einen Skill schreiben lassen

Du musst nicht selbst tippen. Beschreib die Sache und lass sie anlegen:

Leg mir einen Skill an, der Angebotstexte für Trockenbauarbeiten schreibt. Immer mit Vorbemerkung, Leistungspositionen und Hinweis auf Nebenleistungen. Preise nie erfinden, sondern als Platzhalter lassen. Er soll greifen, wenn von Angebot, LV oder Leistungsverzeichnis die Rede ist.

Und dann das Wichtigste: lies durch, was er geschrieben hat. Es ist ein Vorschlag, kein Ergebnis.

Ein Skill darf mehr sein als eine Datei

Neben der SKILL.md dürfen im Ordner weitere Dateien liegen — Vorlagen, Beispiele, Nachschlagelisten, sogar kleine Skripte. In der SKILL.md verweist du darauf.

Der Vorteil: Claude liest die Zusatzdatei nur, wenn er wirklich an die Stelle kommt. So kann ein Skill sehr viel Wissen mitbringen, ohne Platz zu kosten.

Fertige Skills

Es gibt welche zum Mitnehmen — über Plugins (Kapitel 16) oder aus öffentlichen Sammlungen.

Womit du anfängst

Nicht mit dem großen Wurf. Mit dem, was dich nervt:

1. Was erklärst du zum dritten Mal? Das wird dein erster Skill.
2. Schreib auf, wie du es machst. In deinen Worten, mit einem Beispiel.
3. Beschreibung sorgfältig formulieren, mit den Wörtern, die du selbst benutzt.
4. Ausprobieren. Aufgabe stellen und schauen, ob er den Skill von selbst zieht. Wenn nicht, ist die Beschreibung zu vage.

Ein echter Skill aus diesem Projekt

Diese Seite hier hat ein Problem, das jede Anleitung hat: Sie veraltet, ohne dass es jemand merkt. Kein Fehler, keine Meldung — ein Befehl tut irgendwann etwas anderes, und im Text steht weiter das Alte.

Genau das ist mir passiert. In Kapitel 13 stand monatelang, ein bestimmter Befehl öffne einen Einrichtungsassistenten. Der war längst entfernt. Aufgefallen ist es nur, weil zufällig ein anderer Befehl nicht ging.

Die Antwort darauf ist ein Skill. Er heißt KI-Lernwerkstatt-pruefen und tut vier Dinge: alle Kapitel nach prüfbaren Behauptungen durchsuchen — Befehle, Dateipfade, Modellnamen, Adressen — jede davon gegen die offizielle Dokumentation halten, das Ergebnis als Tabelle nach Schwere sortiert melden, und erst nach meiner Zustimmung korrigieren.

In der Beschreibung stehen die Sätze, die ich tatsächlich sagen würde: „prüf die KI-Lernwerkstatt“, „ist das noch aktuell“. Mehr braucht es nicht, damit er von selbst greift.

In einem Satz

Immer nötig gehört in die CLAUDE.md, manchmal nötig in einen Skill. Deshalb kannst du zwanzig Skills haben, aber keine zwanzig Absätze Hausregeln.