Was ist ein Agent-Skill (SKILL.md) und wie prüft man eines

Ein Skill ist ein Ordner mit einer SKILL.md-Datei, die dort liegt, wo dein Coding-Agent danach sucht. Der Agent liest die Datei nur, wenn deine Anfrage dazu passt. Bis dahin kostet das Skill etwa hundert Tokens, während ein Prompt mit jeder Nachricht mitreist, in die du ihn einfügst.

Du hast das Wort wahrscheinlich schon in einer README getroffen: „installiere das Skill und bitte den Agenten dann, ...“. Dahinter steckt nichts Geheimnisvolles. Unten: was drinsteckt, wann es ins Kontextfenster gelangt und wie du dir eines ansiehst, bevor du es auf deinen Rechner lässt.

Was ein Skill ist und wie es sich von einem Prompt unterscheidet#

Anthropics Agent-Skills-Dokumentation (geprüft am 30. Oktober 2026) beschreibt ein Skill als wiederverwendbare, dateisystembasierte Ressource: ein Verzeichnis mit einer SKILL.md-Datei plus optionalen Skripten, Vorlagen und Referenzdateien. SKILL.md beginnt mit einem kleinen YAML-Header (ein Name und eine Beschreibung) und fährt mit einfachen Anweisungen fort.

Denk an eine neue Kollegin. Ein Prompt bedeutet, dass du hinter ihrem Stuhl stehst und jeden Morgen die Regeln wiederholst. Ein Skill ist ein Ordner im Regal mit einem Etikett auf dem Rücken: „Commit-Message-Stil. Lies ihn, wenn dich jemand um einen Commit bittet.“ Sie nimmt ihn nur herunter, wenn er gebraucht wird.

Zwei Header-Felder sind erforderlich, und das Format hat Regeln. Im Skills-Format von Claude hat der name höchstens 64 Zeichen: Kleinbuchstaben, Ziffern und Bindestriche, und er darf die Wörter „anthropic“ oder „claude“ nicht enthalten. Die description darf nicht leer sein, ist auf 1.024 Zeichen begrenzt und muss sowohl sagen, was das Skill tut, als auch, wann man es verwendet.

Wie ein Skill ins Kontextfenster gelangt#

Die Dokumentation nennt das progressive Offenlegung: Der Agent liest ein Skill in drei Stufen, und jede Stufe wird nur bezahlt, wenn sie erreicht wird.

• Stufe 1, immer geladen. Name und Beschreibung jedes installierten Skills, etwa 100 Tokens pro Skill.
• Stufe 2, wenn ausgelöst. Der Textkörper von SKILL.md, unter 5.000 Tokens.
• Stufe 3, nur wenn nötig. Mitgelieferte Dateien und Skripte. Wenn der Agent ein Skript ausführt, gelangt der Skriptcode nicht in den Kontext, nur seine Ausgabe.

Die Token-Zahlen sind Näherungen aus der Dokumentation, keine exakten Zählungen.

Hier ist, warum das für deine Rechnung zählt. Angenommen, du hast 20 Skills installiert. 20 × 100 = 2.000 Tokens reisen ab der ersten Nachricht mit. Ein Agent sendet seinen Kontext bei jedem Schritt erneut (das 20-Schritte-Beispiel zeigt warum), also trägt eine Sitzung mit 50 Schritten 50 × 2.000 = 100.000 Input-Tokens an Skill-Labels mit sich. Bei DeepSeek-V4-Flash sind das $0.0015 zu aktuellen Preisen.

Jetzt andersherum. Würden diese zwanzig Skills als ein großer Prompt eingefügt, läge jeder Textkörper in jeder Anfrage: bis zu 20 × 5.000 = 100.000 Tokens pro Anfrage, nicht pro Sitzung. Diese Lücke ist der ganze Sinn des Ladens auf Abruf. Wenn dir der Begriff „Kontextfenster“ noch unklar ist, diese Erklärung behandelt, was es füllt.

Skills leben im Kontext, also braucht das Modell hinter dem Agenten Platz dafür. DeepSeek-V4-Flash auf CheapTokens (id deepseek-ai/DeepSeek-V4-Flash-0731) hat ein Kontextfenster von 380K und bis zu 32.768 Output-Tokens pro Antwort, einen Preis zu jeder Tageszeit und eine OpenAI- und Anthropic-kompatible API. Für den Terminal-Agenten folge so verbindest du Claude Code mit CheapTokens; für jedes andere Tool beginne bei der Doku. Die Seite des Modells selbst ist hier.

Schreibe in zwei Minuten ein minimales Skill#

Lesen ist leichter, nachdem man eines geschrieben hat. Dieses Skill bringt den Agenten dazu, Commit-Messages in einem festen Format zu schreiben. In Claude Code liegen persönliche Skills in ~/.claude/skills/ und Projekt-Skills in .claude/skills/, sodass ein Projekt-Skill mit dem Repository mitreisen kann.

mkdir -p ~/.claude/skills/commit-message-style
nano ~/.claude/skills/commit-message-style/SKILL.md   # or any editor

Füge dies in die Datei ein:

---
name: commit-message-style
description: Writes git commit messages in this project's format. Use when the user asks to commit, to write a commit message, or to summarize staged changes.
---

# Commit message style

1. Run `git diff --staged` and read it.
2. First line: `type(scope): summary`, at most 72 characters. Types: feat, fix, docs, refactor, test.
3. Blank line, then up to three bullets that say why the change was made, not what changed.
4. Do not put file names in the first line.

Öffne nun den Agenten in einem Repository mit gestagten Änderungen und frage: „schreibe eine Commit-Message für das, was ich gestagt habe“. Der Agent sieht die Beschreibung, entscheidet, dass sie passt, liest die vier Regeln und befolgt sie. Wenn er das Skill ignoriert, schau zuerst auf description: Sie muss die Situation benennen, hier „commit“, und zwar mit den Worten, die du tatsächlich verwenden würdest.

Ein Haken: Skills werden nicht zwischen claude.ai, der API und Claude Code synchronisiert. Ein Skill, das du an einer Stelle erstellt hast, muss an den anderen separat hinzugefügt werden.

Skill, AGENTS.md, MCP: was ist was#

Diese drei werden ständig verwechselt. Eine Regeldatei wie AGENTS.md oder CLAUDE.md wird zu Beginn einer Sitzung gelesen und enthält Fakten über das Projekt (wie diese Datei in einem Downloads-Ordner schiefgehen kann). Ein MCP-Server gibt dem Agenten neue Tools und Daten, die er erreichen kann (MCP auf gut Deutsch). Ein Skill ist ein Verfahren: wie man eine Art von Aufgabe erledigt, geladen, wenn diese Aufgabe auftaucht.

Prüfe ein Fremd-Skill, bevor du es installierst#

Ein Skill ist Text, dem der Agent folgt, und manchmal Code, den der Agent ausführt. Die Dokumentation sagt, man solle Skills nur aus vertrauenswürdigen Quellen verwenden, jede mitgelieferte Datei prüfen (SKILL.md, Skripte, Ressourcen) und nach unerwarteten Netzwerkaufrufen oder Dateizugriffen Ausschau halten. Skills, die externe URLs abrufen, sind riskanter. In Claude Code hat ein Skill denselben Netzwerkzugriff wie jedes Programm auf deinem Computer, also behandle die Installation wie das Installieren von Software.

Ein gutes Exemplar ist universal-modder, ein Toolkit zum Modden von Spielen. Seine README (geprüft am 30. Oktober 2026) beschreibt eine MIT-lizenzierte Sammlung von Skills im Agent-Skills-Format, eine Python-CLI namens um, einen MCP-Server zur Asset-Generierung über fal und eine gemeinsame Wissensbasis aus Feldnotizen. Das Haupt-Skill, mod-any-game, deckt Recon, Reverse Engineering, Asset-Generierung, In-Game-Tests und Packaging ab. Die README listet Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot und OpenCode als unterstützte Tools und sagt, das Toolkit weigere sich, Anti-Cheat oder DRM zu umgehen. In Claude Code installiert es sich mit /plugin marketplace add rehan-remade/universal-modder, und die Asset-Generierung braucht einen separaten fal-API-Schlüssel.

Beachte, was diese Liste enthält: Skills, ein Kommandozeilenprogramm und einen Server. Eine einzige SKILL.md zu lesen würde nur einen Ausschnitt dessen abdecken, was du installierst. Geh also die Teile durch:

Die entscheidende Regel steht in wie man einen API-Schlüssel sicher speichert. Die Repository-Seite zeigt kein Datum des letzten Commits, also prüfe, wie kürzlich das Projekt aktualisiert wurde, bevor du dich darauf verlässt.