Claude Skills erklärt: Die drei Ebenen der progressiven Offenlegung

Ein Claude Skill ist physisch betrachtet ein Ordner. Kein gehosteter Dienst, keine Binärdatei, kein Textblock, den man oben in eine Konversation einfügt – sondern ein Verzeichnis mit einer {{1}}SKILL.md{{/1}}-Datei und allem anderen, was die Aufgabe erfordert. Fast alles Interessante an Skills folgt aus dieser einen Entscheidung, denn ein Ordner ist etwas, das ein Agent selektiv öffnen kann. Ein Prompt lässt sich nicht selektiv öffnen. Er ist entweder in der Konversation oder nicht.

Anthropics Dokumentation beschreibt die Anordnung als so organisiert wie einen Onboarding-Leitfaden, den man für ein neues Teammitglied erstellen würde, und die Analogie trägt weiter, als es zunächst scheint. Niemand liest einen Onboarding-Leitfaden von vorne bis hinten, bevor er mit der Arbeit beginnt. Man liest die Seite, die zu der Frage passt, die gerade vor einem liegt, und vertraut darauf, dass der Rest noch da ist, wenn man ihn braucht. Ein Skill beruht auf derselben Wette: dass der größte Teil einer Prozedur die meiste Zeit auf der Festplatte bleiben kann.

Dateisystem zuerst, Fähigkeit zweitens

Claude arbeitet in einer virtuellen Maschine mit Dateisystemzugriff. Das ist die Voraussetzung dafür, dass ein Skill ein Verzeichnis und kein Konfigurationseintrag ist, denn es ermöglicht dem Agenten, einen Ordner aufzulisten, eine Datei zu lesen und einem Verweis auf eine andere Datei zu folgen – mit denselben Operationen, die auch ein Mensch verwenden würde. Darauf aufbauend bündelt ein Skill Anweisungen, Metadaten und optionale Ressourcen wie Skripte und Vorlagen.

Das Ergebnis ist eine Fähigkeit, die größer ist als jede einzelne Datei im Ordner. Die Anweisungen geben an, wie die Aufgabe zu erledigen ist. Ein mitgeliefertes Skript kann einen Teil davon ausführen, ohne in Prosa beschrieben zu werden. Ein Referenzdokument kann Material enthalten, das nachgeschlagen statt auswendig gelernt wird. Was diese drei Dinge zu einem System statt zu einem Haufen macht, ist die Reihenfolge, in der sie sichtbar werden – der Teil, den Anthropic progressive disclosure nennt: Informationen schrittweise zu laden, wenn sie gebraucht werden, statt Kontext im Voraus zu verbrauchen.

Level 1: Die beiden Felder, die immer geladen werden

Jeder Skill beginnt mit YAML-Frontmatter, das einen Namen und eine Beschreibung enthält. Claude lädt diese Metadaten beim Start und fügt sie in den System-Prompt ein. Dies ist der einzige Teil des Skills, der vorhanden ist, bevor jemand etwas anfordert, und bis ein Skill ausgelöst wird, belegen nur sein Name und seine Beschreibung den Kontext.

Die Beschreibung erfüllt drei Aufgaben gleichzeitig, und wenn man sie trennt, erklärt das, warum so viele Skills stillschweigend ignoriert werden. Sie ist ein Etikett, das angibt, wie die Sache heißt. Sie ist ein Indexeintrag – der Text, mit dem eine Anfrage abgeglichen wird, wenn Claude entscheidet, ob der Skill relevant ist. Und sie ist eine Aussage zum Geltungsbereich, weshalb Anthropics Vorgabe lautet, dass sie sowohl angeben muss, was der Skill tut, als auch, wann er zu verwenden ist. Eine Beschreibung, die nur die erste Aufgabe bewältigt, gibt dem Matcher nichts zum Abgleichen.

Nehmen Sie zwei Versionen derselben Fähigkeit. Die eine wird als Ausfüllen und Validieren von PDF-Formularen beschrieben und soll verwendet werden, wenn eine Anfrage das Ausfüllen oder Prüfen eines PDF-Formulars betrifft. Die andere wird als Hilfe bei Dokumenten beschrieben. Die erste nennt eine Aktion und eine Situation; die zweite nennt keines von beiden. Eine Fähigkeit, deren Beschreibung keines von beiden nennt, bleibt ungelesen auf der Festplatte liegen, während der Agent die Aufgabe auf dem umständlichen Weg erledigt – nicht weil die Fähigkeit versagt hat, sondern weil sie nie gefunden wurde.

Level 2: der Hauptteil, zu lesen, wenn die Beschreibung übereinstimmt

Wenn eine Anfrage der Beschreibung entspricht, öffnet sich die zweite Ebene: der Hauptteil von SKILL.md. Das ist die Vorgehensweise – Workflows, Best Practices, Anleitungen – und sie ist für einen Agenten geschrieben, der bereits entschieden hat, dass dieser Skill das richtige Werkzeug für die Aufgabe ist. Hier schreibt ein Team die Schritte auf, die es sonst in jedem Gespräch wiederholen würde, und hier befinden sich die Verweise auf tiefergehendes Material.

Die Reihenfolge ist hier genauso wichtig wie auf Ebene 1. Der Body wird beim Start nicht geladen, und er wird auch nicht vorsichtshalber geladen. Er trifft erst ein, nachdem eine Entscheidung getroffen wurde, was bedeutet, dass die Entscheidung allein anhand von Ebene 1 möglich sein muss. Ein Skill mit einer vagen Beschreibung kann auf Ebene 2 nichts mehr retten, weil Ebene 2 nie gelesen wird.

Level 3: Dateien, die sich öffnen, weil etwas auf sie verwiesen hat

Die dritte Ebene ist der Rest des Ordners: zusätzliche Dateien, auf die von SKILL.md aus verwiesen wird. Anthropics Beispiel ist eine FORMS.md mit weiterführenden Hinweisen zum Ausfüllen von Formularen, die aus den Hauptanweisungen herausgehalten wird, damit diese Anweisungen kurz bleiben und die Details nur dann verfügbar sind, wenn eine Aufgabe sie benötigt. Auch Skripte und Vorlagen gehören auf diese Ebene.

Der strukturelle Effekt ist, dass ein Skill sehr viel Material tragen kann, ohne es alles auf einmal tragen zu müssen. Ein Ordner könnte eine Hauptanweisungsdatei, eine ausführliche Referenz, eine Reihe von Vorlagen und ein Skript enthalten, und eine gegebene Aufgabe berührt möglicherweise nur eine davon. Was von nichts referenziert wird, bleibt auf der Festplatte, und die Festplatte ist in einem Agenten nicht die knappe Ressource. Der Kontext ist es.

Das ist auch der Punkt, an dem das Format die Obergrenze aufhebt, an die Prompts stoßen. Ein Prompt muss kurz genug sein, dass es sich lohnt, ihn einzufügen. Das gebündelte Material eines Skills ist dadurch begrenzt, was ein Verzeichnis fassen kann, weil nur der Teil das Modell erreicht, den die Aufgabe tatsächlich berührt hat.

Warum die Reihenfolge das Design ist, nicht ein Detail

Daraus ergeben sich drei Konsequenzen, und zusammen sind sie der Grund, warum es sich lohnt, dies zu verstehen, statt es bloß zu wissen.

• Kontext ist ein Budget, und immer geladene Inhalte sind Fixkosten.Alles in einem System-Prompt wird bei jeder Anfrage bezahlt, auch bei Anfragen, die nichts mit dieser Fähigkeit zu tun haben. Progressive Offenlegung macht aus Fixkosten bedingte Kosten: immer eine Beschreibung, Anweisungen, wenn relevant, Referenzen, wenn darauf verwiesen wird.

• Die Beschreibung ist eine Schnittstelle. Sie ist der einzige Teil eines Skills, der garantiert gesehen wird, daher muss ein Autor hier über das Auslösen nachdenken und nicht nur über den Inhalt.

• Ein Skill hat drei Wartungsgeschwindigkeiten.Metadaten ändern sich, wenn der Skill anders ausgelöst werden soll, der Hauptteil ändert sich, wenn sich der Workflow ändert, und Referenzen ändern sich, wenn sich das zugrunde liegende Material ändert. Sie getrennt zu halten verhindert, dass eine Referenzaktualisierung zu einer Neufassung der Anweisungen wird.

Die Kosten sind das Spiegelbild des Nutzens. Jede Grenze zwischen Ebenen ist eine Stelle, an der das Modell eine Entscheidung richtig treffen muss. Eine zu enge Beschreibung bedeutet, dass der Skill nie ausgelöst wird und der Ordner nur Ballast ist. Eine zu breite bedeutet, dass er bei Arbeiten ausgelöst wird, für die er nicht entwickelt wurde, und seine Anweisungen zu einer Belastung für nicht damit zusammenhängende Aufgaben werden. Progressive Offenlegung verleiht der Beschreibung eine tragende Rolle – auf eine Weise, wie es ein langer, stets vorhandener Prompt nie tut.

What Anthropic already ships, and where your own skills come from

Anthropic bietet vorgefertigte Skills für PowerPoint, Excel, Word und PDF — Präsentationen, Tabellenkalkulationen, Dokumente und formatierte PDF-Ausgaben. Sie sind auf claude.ai, der Claude API, Claude Platform on AWS und Microsoft Foundry verfügbar, mit der Einschränkung, dass sie auf Foundry eine Bereitstellung vom Typ „Hosted on Anthropic“ erfordern.

Diese sind der schnellste Weg, den Mechanismus zu sehen, statt darüber zu lesen. Die Ladereihenfolge ist identisch mit der von allem, was Sie selbst schreiben; der Unterschied zwischen einem vorgefertigten Skill und einem benutzerdefinierten liegt darin, wer den Ordner erstellt hat, nicht darin, wie er das Modell erreicht.

Benutzerdefinierte Skills können in Claude Code erstellt, über die Claude API hochgeladen oder in den Einstellungen von claude.ai hinzugefügt werden. Die von Anthropic genannten Vorteile sind die, die man von allem Wiederverwendbaren erwarten würde: Claude für Fachaufgaben zu spezialisieren, Anleitungen einmal zu erstellen, statt sie zu wiederholen, und mehrere Skills für mehrstufige Arbeiten zu kombinieren. Der letzte Punkt ergibt sich am direktesten aus der Architektur, denn wenn jeder Skill ein Ordner ist, der bei Bedarf geöffnet wird, kostet ein Stapel von Skills sehr wenig, bis die Arbeit sie tatsächlich braucht.

Ein Skill ist kein Prompt und kein Connector.

In Gesprächen werden drei Dinge vermengt, und die Ladereihenfolge macht es leicht, die Unterscheidungen beizubehalten.

Ein Prompt ist auf Konversationsebene angesiedelt. Er ist vom ersten Turn an präsent, er färbt alles in dieser Konversation und verschwindet mit der Konversation. Ein Skill ist bedarfsgesteuert: Er existiert, bevor die Konversation beginnt, das meiste davon gelangt nie in die Konversation, und der Teil, der ankommt, kommt an, weil eine Beschreibung gepasst hat. Das ist der Unterschied zwischen dem Anweisen eines Agenten, wie er sich verhalten soll, und dem Geben von etwas, das er aufgreifen kann.

Bei einem Connector geht es um Reichweite. Connectoren bedeuten App-Zugriff, das heißt, sie bestimmen, worauf ein Agent zugreifen kann; ein Skill bestimmt, wie der Agent etwas tun soll, sobald er darauf zugreifen kann. Ein Team kann über hervorragende Connectoren verfügen und trotzdem inkonsistente Dokumente erstellen, denn Zugriff ist keine Vorgehensweise. Es kann auch über hervorragende Skills verfügen und die Daten trotzdem nicht sehen, denn Vorgehensweise ist kein Zugriff.

Anthropics Dokumentation behandelt Skills und das Model Context Protocol als unterschiedliche Ebenen, und der dreistufige Mechanismus zeigt, warum die Trennung sauber ist. Die Ladereihenfolge betrifft, wann Informationen ankommen, nicht, woher sie stammen.

Wo die Spende passt – in einem Absatz

Am 22. Oktober 2026 spendete Anthropic den Agent Skills-Standard an die Agentic AI Foundation unter der Linux Foundation – den Namen, das Logo, die GitHub-Organisation und die Domain agentskills.io – wobei Ingenieure von Anthropic, Google, OpenAI und anderen Unternehmen ihn als Einzelpersonen pflegen. Nichts davon ändert den oben beschriebenen Mechanismus. Das Ordnerformat, das YAML-Frontmatter, die Ladereihenfolge und die vorgefertigten Dokument-Skills sind genau so, wie sie am Tag zuvor waren. Geändert hat sich, wer den Namen besitzt, was für die langfristige Stabilität eines Standards sehr wichtig ist und überhaupt nicht dafür, wie Sie heute Nachmittag einen Skill schreiben.

Eine Fähigkeit lesen, bevor du sie installierst

Wenn die drei Ebenen die Architektur sind, ergeben sie auch eine kurze Prüfliste. Lesen Sie zuerst die Beschreibung, denn sie entscheidet darüber, ob überhaupt etwas anderes geschieht: Sie sollte benennen, was der Skill tut und wann er verwendet werden sollte – in Worten, die eine Anfrage plausibel verwenden würde. Lesen Sie SKILL.md als Zweites, denn es ist die Prozedur, der der Agent folgen wird, und es sollte wie Anweisungen an eine kompetente Kollegin oder einen kompetenten Kollegen klingen und nicht wie eine Zusammenfassung dessen, von dem Sie hoffen, dass es geschieht. Lesen Sie als Drittes, worauf es verweist. Lesen Sie dann die Skripte.

Der letzte Punkt ist keine Paranoia. Das Format erlaubt es einem Skill, Anweisungen zusammen mit optionalen Ressourcen mitzuführen, und Ressourcen können ausführbaren Code enthalten. Ein Skill, den Sie installieren, ist daher nicht nur Text, der ein Gespräch prägt; es ist ein Ordner, aus dem ein leistungsfähiger Agent Dateien öffnet und auf deren Grundlage handelt. Das Ebene-für-Ebene-Modell sagt Ihnen genau, wo Sie nachsehen müssen – mehr, als die meisten installierten Dinge zu bieten haben.

Eine Abgrenzung ist es wert, für Leser klarzustellen, die über unsere eigenen Seiten zu uns kommen. OrcaRouter leitet Modellaufrufe weiter, und wir hosten keine der Apps von Anthropic oder deren Skill-Oberflächen – ein Skill läuft dort, wo das Dateisystem des Agenten liegt, und das ist nicht unsere Ebene. Was wir tun, liegt unterhalb der Modellauswahl: mehr als 200 Modelle hinter einem OpenAI-kompatiblen Schlüssel, der Listenpreis der Anbieter ohne Aufschlag durchgereicht und automatisches Failover zwischen Anbietern, wenn einer nicht verfügbar ist. Ein Skill entscheidet, wie eine Aufgabe erledigt werden sollte. Ein Router entscheidet, welches Modell sie erledigt, und keine der beiden Ebenen sollte viel über die andere wissen müssen.

Progressive Offenlegung ist ehrlich in Bezug auf die Einschränkung, die sie löst. Der Kontext ist endlich, Prozeduren sind lang, und der größte Teil jeder gegebenen Prozedur ist für die Aufgabe, die vor Ihnen liegt, irrelevant. Ein Name, ein Inhalt und eine Reihe von Dateien sind kein kompliziertes Design; es ist das kleinste, das es einem Agenten ermöglicht, eine große Menge Wissen mit sich zu tragen und dabei nur den Teil zu halten, den er benötigt.

Deshalb ist die folgenreichste Zeile in einem gut gebauten Skill zugleich die kürzeste. Alles andere im Ordner ist eine Bibliothek. Die Beschreibung ist der Zettelkatalog, und wenn der Katalog falsch ist, könnte die Bibliothek genauso gut nicht existieren.