Ein Agent Skill kann Anweisungen und Code bündeln

Ein Agent Skill ist ein Verzeichnis mit einer Datei SKILL.md. Diese enthält mindestens Metadaten und Anweisungen für eine konkrete Aufgabe. Das Paket kann zusätzlich Skripte, Referenzen, Vorlagen und andere Ressourcen bündeln. Die Formatübersicht (Stand 3. Oktober 2026) unterscheidet diese Bestandteile ausdrücklich.

Ein kurzer Haupttext beschreibt daher nicht zwingend den gesamten Umfang des Pakets. Ein referenziertes Dokument kann zusätzliche Vorgaben liefern. Ein mitgeliefertes Skript kann dagegen Code ausführen und benötigt einen zur Aufgabe passenden Ausführungskontext. Beide gehören zur Auswahl, haben aber andere mögliche Folgen.

Das Paket kann unterschiedliche Bestandteile enthalten:

• Anweisungen zur Aufgabe;
• ausführbare Skripte;
• Referenzdokumente;
• Vorlagen und weitere Ressourcen.

Ein referenzierter Text und ein ausführbares Skript haben verschiedene Wirkungen. Eine Prüfung muss diese Unterschiede am tatsächlichen Paketstand erkennen können.

Was wird bei Bedarf geladen?#

Die Übersicht beschreibt zunächst das Laden von Name und Beschreibung. Bei einer passenden Aufgabe kommen die vollständigen Anweisungen hinzu. Weitere Dateien werden bei Bedarf geladen. Dieses Vorgehen hilft, Aufgabenwissen bereitzustellen, ohne jede Ressource von Anfang an vollständig in den Kontext zu nehmen.

Für eine Freigabe muss deshalb das gesamte konkrete Paket bekannt sein. Eine Prüfung nur der sichtbaren Kurzbeschreibung kann eine zusätzliche Datei oder eine spätere Änderung am Skript übersehen. Der Paketstand und die verfügbaren Dateien sind aussagekräftiger als die bloße Bezeichnung der Sammlung.

Herkunft und Zugang werden bei der Auswahl getrennt betrachtet. Im Skill-Verzeichnis sollten Herkunft, Ressourcen und benötigter Zugang getrennt erkennbar bleiben. Für einen konkreten Paketstand lässt sich damit nachvollziehen, welche Anleitung und welche zusätzlichen Dateien für die Aufgabe bereitstehen.