Agentenprotokolle, Skills und Kontextinfrastruktur
SKILL.md
Zentrale Beschreibungs- und Anweisungsdatei eines Agent Skills.
SKILL.md ist die Hauptdatei eines Skills: eine Markdown-Datei mit einem Kopfbereich für Name und Beschreibung und darunter den eigentlichen Anweisungen. Ein Skill ist ein Verzeichnis, das genau diese Datei enthält, dazu gegebenenfalls weitere Dateien. Anthropic: Agent Skills
Der Kopf entscheidet, ob der Skill benutzt wird
Name und Beschreibung aus dem Kopfbereich werden beim Start in die Systemanweisung geladen, der Rest der Datei erst, wenn der Skill gebraucht wird. Die Beschreibung ist damit die Stelle, an der sich entscheidet, ob ein Agent den Skill für eine Aufgabe überhaupt in Betracht zieht.
Im Textteil stehen die Anweisungen. Verweise auf weitere Dateien im selben Ordner erlauben, Nachschlagewerke, Beispiele oder Vorlagen erst bei Bedarf nachzuladen. Claude Docs: Skills
So kannst du dir das vorstellen
Der Ordnerrücken und das erste Blatt einer Mappe. Auf dem Rücken steht, wofür die Mappe gut ist, auf dem ersten Blatt, wie vorzugehen ist. Alles Weitere liegt dahinter. Das Bild erklärt den Aufbau, nicht die Wirkung der Anweisungen.
Was es in der Praxis bedeutet
Schreib die Beschreibung so, wie jemand die Aufgabe benennen würde, nicht wie eine Überschrift im Handbuch. „Prüft Eingangsrechnungen auf Pflichtangaben nach deutschem Umsatzsteuerrecht" wird zuverlässiger gefunden als „Rechnungsskill".
Für den Textteil gilt dasselbe wie für jede Arbeitsanweisung: knapp, in Schritten, mit Beispielen für Grenzfälle. Lange Sammeldateien sind schlechter als mehrere schmale Skills mit klarer Zuständigkeit.
Wo es verwechselt wird
Die Datei ist keine Konfiguration im technischen Sinn, sondern eine Anleitung für ein Modell. Und sie ist nicht dasselbe wie eine Projektdatei mit allgemeinen Vorgaben, die immer gilt.
Verwandte Begriffe
Agent Skills, Skill Discovery, AGENTS.md, CLAUDE.md, System Prompt.