Eigene Skills erstellen: SKILL.md einfach erklärt

Was ist ein KI-Skill und wie erstelle ich selbst einen? Ein Skill ist ein Ordner mit einer SKILL.md-Datei, die einem KI-Agenten Schritt für Schritt beibringt, eine Aufgabe zu erledigen. Gebraucht werden nur zwei YAML-Felder im Frontmatter – name und description – plus eine Anleitung im Markdown-Teil. So entsteht in wenigen Minuten ein wiederverwendbarer Skill, etwa für Berichte, Code-Reviews oder Dokumente.

Was ist ein Skill?

Ein Skill ist kein Programm, sondern Wissen in Markdown-Form: Während der Arbeit durchsucht der Agent verfügbare Skills und aktiviert den passenden. Die Grundstruktur ist bewusst simpel:

SKILL.md – Pflicht: Metadaten plus Anleitung
scripts/ – optional: ausführbarer Code (Python, Bash, JavaScript)
references/ – optional: Zusatzdokumentation, die der Agent bei Bedarf lädt
assets/ – optional: Vorlagen und Ressourcen

Die SKILL.md: Zwei Teile, zwei Pflichtfelder

Die Datei besteht aus YAML-Frontmatter (zwischen ----Markierungen) und einem Markdown-Body. Laut offizieller Agent-Skills-Spezifikation sind nur zwei Felder Pflicht:

name – max. 64 Zeichen, nur Kleinbuchstaben, Ziffern und Bindestriche; muss dem Ordnernamen entsprechen
description – max. 1.024 Zeichen, beschreibt was der Skill tut und wann er genutzt werden soll; konkrete Keywords erhöhen die Trefferquote

Optional erlaubt die Spezifikation license, compatibility, metadata und das experimentelle Feld allowed-tools. Achtung bei der Großschreibung: Die Datei heißt SKILL.md, nicht skill.md.

So baust du deinen ersten Skill

Ordner anlegen, z. B. report-generator/, darin SKILL.md erstellen
Frontmatter mit name und description schreiben
Im Body: Schritt-für-Schritt-Anleitung, Beispiele für Eingabe/Ausgabe und häufige Fehlerfälle
Komplexere Logik in scripts/ auslagern – Skripte sollten eigenständig laufen und klare Fehlermeldungen liefern

Progressive Disclosure: Weniger Kontext, bessere Ergebnisse

Skills laden nicht alles auf einmal: Der Agent sieht zuerst nur die Metadaten und aktiviert den Skill erst bei passender Aufgabe. Danach wird der Body geladen – weitere Dateien wie references/ aber nur bei Bedarf. Das spart Kontextfenster und macht Skills effizient. Halte deshalb die SKILL.md schlank und lagere Details aus.

Wer lieber fertige Beispiele studiert, findet im Anthropic-Skills-Repo mit 19 fertigen Skills eine gute Vorlage. Die technischen Grundlagen des offenen Skills-Standards und ein konkretes Muster wie den Skill „Code ausführen“ runden den Einstieg ab.

Quellen

Agent Skills: Offizielle Spezifikation des offenen Skills-Standards
Anthropic: Offizielles Anthropic-Skills-Repository
Anthropic Engineering: Equipping agents for the real world with Agent Skills (Einführung des Formats)

Stand: 7. September 2026. Abgerufen am 7. September 2026.