Konfiguration und Multi-Datei-Skills

Was du lernen wirst

Geschätzter Zeitaufwand: 20 Minuten

Am Ende dieser Lektion kannst du:

Erweiterte Skill-Metadaten-Felder konfigurieren, einschließlich allowed-tools und model
Effektive Skill-Beschreibungen schreiben, die zuverlässig bei den richtigen Anfragen ausgelöst werden
allowed-tools verwenden, um einzuschränken, was Claude tun kann, wenn ein Skill aktiv ist
Komplexe Skills mit progressiver Offenlegung und Multi-Datei-Strukturen organisieren

(4 Minuten)

Dieses Video behandelt die fortgeschrittenen Techniken, die Skills leistungsstarker machen: die vollständige Palette von Metadaten-Feldern, wie man Beschreibungen schreibt, die zuverlässig ausgelöst werden, die Einschränkung des Tool-Zugriffs für sicherheitssensible Workflows und die Organisation größerer Skills über mehrere Dateien hinweg mit progressiver Offenlegung. Du lernst, wie du deine Skills effizient hältst und gleichzeitig komplexe Anwendungsfälle unterstützt.

Wichtigste Erkenntnisse

name und description sind erforderlich — allowed-tools und model sind optional, aber kraftvolle Ergänzungen
Eine gute Beschreibung beantwortet zwei Fragen : Was macht der Skill? Wann sollte Claude ihn verwenden?
allowed-tools schränkt ein, welche Tools Claude verwenden kann, wenn der Skill aktiv ist — nützlich für schreibgeschützte oder sicherheitssensible Workflows
Progressive Offenlegung : Halte SKILL. md unter 500 Zeilen und verlinke auf unterstützende Dateien (Referenzen, Skripte, Assets), die Claude nur bei Bedarf liest
Skripte werden ausgeführt, ohne ihren Inhalt in den Kontext zu laden — nur die Ausgabe verbraucht Token und hält den Kontext effizient

Ein grundlegender Skill funktioniert nur mit einem Namen und einer Beschreibung, aber es gibt mehrere fortgeschrittene Techniken, die deine Skills in Claude Code viel effektiver machen können. Lass uns die wichtigsten Felder, Best Practices für Beschreibungen, Tool-Einschränkungen und die Strukturierung größerer Skills durchgehen.

Skill-Metadaten-Felder

Der Agent Skills Open Standard unterstützt mehrere Felder in der SKILL. md-Frontmatter. Zwei sind erforderlich, der Rest ist optional:

name (erforderlich) — Identifiziert deinen Skill. Verwende nur Kleinbuchstaben, Zahlen und Bindestriche. Maximal 64 Zeichen. Sollte deinem Verzeichnisnamen entsprechen.
description (erforderlich) — Teilt Claude mit, wann der Skill verwendet werden soll. Maximal 1. 024 Zeichen. Dies ist das wichtigste Feld, da Claude es für die Zuordnung verwendet.
allowed-tools (optional) — Schränkt ein, welche Tools Claude verwenden kann, wenn der Skill aktiv ist.
model (optional) — Gibt an, welches Claude-Modell für den Skill verwendet werden soll.

Effektive Beschreibungen schreiben

Sei explizit mit deinen Anweisungen. Wenn dir jemand sagte „dein Job ist es, bei Dokumenten zu helfen", würdest du nicht wissen, was du tun sollst — und Claude denkt genauso.

Eine gute Beschreibung beantwortet zwei Fragen:

Was macht der Skill?
Wann sollte Claude ihn verwenden?

Wenn dein Skill nicht ausgelöst wird, wenn du es erwartest, versuche, mehr Schlüsselwörter hinzuzufügen, die der Art entsprechen, wie du deine Anfragen tatsächlich formulierst. Die Beschreibung ist das, was Claude verwendet, um zu entscheiden, ob ein Skill relevant ist, daher ist die Sprache wichtig.

Tools mit allowed-tools einschränken

Manchmal möchtest du einen Skill, der nur Dateien lesen kann, sie aber nicht ändern darf. Dies ist nützlich für sicherheitssensible Workflows, schreibgeschützte Aufgaben oder jede Situation, in der du Schutzmaßnahmen möchtest.

In diesem Beispiel ist das allowed-tools-Feld auf Read, Grep, Glob, Bash gesetzt. Wenn dieser Skill aktiv ist, kann Claude nur diese Tools verwenden, ohne um Erlaubnis zu fragen — kein Bearbeiten, kein Schreiben.

--- name: codebase-onboarding description: Helps new developers understand the system works. allowed-tools: Read, Grep, Glob, Bash model: sonnet ---

Wenn du allowed-tools ganz weglässt, schränkt der Skill nichts ein. Claude verwendet sein normales Berechtigungsmodell.

Progressive Offenlegung

Skills teilen sich Claudes Kontextfenster mit deinem Gespräch. Wenn Claude einen Skill aktiviert, lädt es den Inhalt dieser SKILL. md in den Kontext. Aber manchmal brauchst du Referenzen, Beispiele oder Utility-Skripte, auf die der Skill angewiesen ist.

Alles in eine 2. 000-Zeilen-Datei zu packen, hat zwei Probleme: Es nimmt viel Kontextfensterplatz in Anspruch, und es macht keinen Spaß, es zu verwalten.

Progressive Offenlegung löst dies. Halte wesentliche Anweisungen in SKILL. md und lege detailliertes Referenzmaterial in separate Dateien, die Claude nur bei Bedarf liest.

Der Open Standard schlägt vor, dein Skill-Verzeichnis wie folgt zu organisieren:

scripts/ — Ausführbarer Code
references/ — Zusätzliche Dokumentation
assets/ — Bilder, Vorlagen oder andere Datendateien

Verlinke dann in SKILL. md auf die unterstützenden Dateien mit klaren Anweisungen, wann sie geladen werden sollen:

In diesem Beispiel liest Claude architecture-guide. md nur, wenn jemand nach Systemdesign fragt. Wenn sie fragen, wo eine Komponente hinzugefügt werden soll, wird diese Datei nie geladen. Es ist wie ein Inhaltsverzeichnis im Kontextfenster statt des gesamten Dokuments.

Eine gute Faustregel: **Halte SKILL. md unter 500 Zeilen**. Wenn du diesen Umfang überschreitest, überlege, ob der Inhalt in separate Referenzdateien aufgeteilt werden sollte.

Skripte effizient verwenden

Skripte in deinem Skill-Verzeichnis können ausgeführt werden, ohne ihren Inhalt in den Kontext zu laden. Das Skript wird ausgeführt und nur die Ausgabe verbraucht Token. Die wichtigste Anweisung, die du in deine SKILL. md aufnehmen solltest, ist, Claude anzuweisen, das Skript auszuführen, nicht es zu lesen.

Dies ist besonders nützlich für:

Umgebungsvalidierung
Datentransformationen, die konsistent sein müssen
Operationen, die als getesteter Code zuverlässiger sind als generierter Code

Lektionsreflexion

Denke über einen Skill nach, den du erstellen möchtest und der mehrere Dateien umfasst. Wie würdest du SKILL. md im Vergleich zu unterstützenden Referenzdateien strukturieren?
Gibt es Workflows in deinem Team, bei denen die Einschränkung des Tool-Zugriffs mit allowed-tools eine wichtige Sicherheitsebene hinzufügen würde?

Was kommt als Nächstes

In der nächsten Lektion vergleichen wir Skills mit den anderen Möglichkeiten, Claude Code anzupassen — CLAUDE. md, Subagents, Hooks und MCP-Server — damit du das richtige Tool für jede Situation wählen kannst.

Feedback

Während du den Kurs durcharbeitest, würden wir gerne hören, wie du Skills in deiner Arbeit verwendest, sowie dein Feedback. Teile dein Feedback hier.