Agent Skill (SKILL.md)

Wenn du jede Woche denselben langen Prompt in den Chat kopierst, sollte daraus wahrscheinlich ein Skill werden. Laut agentskills.io hat Anthropic das Format ursprünglich entwickelt und als offenen Standard veröffentlicht. Dieselbe Seite listet Dutzende Agent-Produkte, die es unterstützen, darunter Claude Code.

So funktioniert es

Am Anfang der SKILL.md steht ein kurzer Kopfbereich mit Name und Beschreibung: was der Skill tut und wann er zum Einsatz kommt. Danach folgen Anweisungen in Markdown. Optionale Ordner können Skripte und Referenzdateien enthalten.

Geladen wird in Stufen. Name und Beschreibung sieht der Agent immer. Die vollständigen Anweisungen lädt er erst, wenn eine Aufgabe zur Beschreibung passt. Zusatzdateien lädt er erst, wenn die Anweisungen auf sie verweisen. Durch diese Stufen kann ein Agent viele Skills installiert haben, ohne sein Kontextfenster zu füllen.

Beispiel

Eine Marketingleiterin schreibt einen Skill für ihren wöchentlichen Paid-Media-Report: welche Spalten sie braucht, wie Veränderungen zur Vorwoche beschriftet werden, welches E-Mail-Format ihr Geschäftsführer will, dazu ein fertiger Report als Muster. Laut Beschreibung greift der Skill, wenn jemand nach dem wöchentlichen Paid-Media-Report oder den „Montagszahlen“ fragt. Tippt sie jetzt in einer Sitzung mit installiertem Skill „Montagszahlen“, kommt der Report im gewohnten Format.

Häufiger Fehler

Eine vage Beschreibung wie „hilft bei Reports“ schreiben, durch die der Skill nie greift, oder Regeln wie „sei gründlich“, die niemand prüfen kann. Schreib die Beschreibung als Auslösebedingungen und jede Regel so, dass jemand beim Prüfen „erfüllt“ oder „nicht erfüllt“ ankreuzen kann.