SKILL.md — Das Format für Agenten-Skills

SKILL.md ist ein offener Standard zum Bündeln wiederverwendbarer Fähigkeiten, die KI-Coding-Agenten bei Bedarf entdecken und aktivieren können. Entwickelt von Anthropic und standardisiert auf agentskills.io, wird das Format von über 27 KI-Agenten unterstützt, darunter Claude Code, Cursor, Codex, Gemini CLI und VS Code.

Welches Problem löst es?

Ohne Skills wiederholst du jedes Mal die gleichen komplexen Prompts, wenn dein Agent etwas Bestimmtes tun soll — ein PDF generieren, ein Design-System aufbauen, Playwright-Tests schreiben. SKILL.md bündelt diese Anweisungen einmalig, sodass jeder kompatible Agent sie automatisch nutzen kann. Skills werden bei Bedarf geladen und belasten dadurch nicht das Kontextfenster deines Agenten.

So funktioniert es

Ein Skill ist ein Ordner mit einer SKILL.md-Datei, die YAML-Frontmatter und Markdown-Anweisungen enthält. Mindestens benötigt ein Skill einen Namen und eine Beschreibung.

---

name: pdf-processing

description: Extract text and tables from PDF files,

merge documents, fill forms, and convert to images.

license: MIT

compatibility:

- Claude Code

- Cursor

allowed-tools: Bash(python:*) Read Write

---

# PDF Processing

When the user asks you to work with PDF files, follow

these instructions...

Frontmatter-Felder

Feld	Erforderlich	Beschreibung
name	Ja	Eindeutiger Bezeichner. Max. 64 Zeichen, Kleinbuchstaben, Zahlen, Bindestriche.
description	Ja	Was der Skill tut und wann er aktiviert werden soll. Max. 1024 Zeichen.
license	Nein	SPDX-Lizenzbezeichner oder Verweis auf eine Lizenzdatei.
compatibility	Nein	Liste kompatibler Agenten und Umgebungsanforderungen.
metadata	Nein	Beliebige Schlüssel-Wert-Paare (Autor, Version, Tags).
allowed-tools	Nein	Durch Leerzeichen getrennte Liste vorab genehmigter Tools für den Agenten.

Progressive Offenlegung

Skills verwenden ein dreiphasiges Lademodell, um das Kontextfenster effizient zu halten:

Entdeckung — Der Agent liest nur den Namen und die Beschreibung (~100 Token)
Aktivierung — Wenn eine Aufgabe passt, wird die vollständige SKILL.md geladen (<5000 Token)
Ausführung — Der Agent folgt den Anweisungen und lädt bei Bedarf referenzierte Dateien nach

Wer unterstützt es

Das SKILL.md-Format wird unterstützt von Claude Code, Cursor, OpenAI Codex, Gemini CLI, VS Code, GitHub Copilot, Amp, Roo Code, Goose, Windsurf, Continue und vielen weiteren. Die vollständige Liste kompatibler Agenten wird gepflegt auf agentskills.io.