Frontmatter

Frontmatter ist der YAML-Block, der durch --- am Anfang einer SKILL.md-Datei abgegrenzt wird. Er dient als Konfiguration für den Skill und steuert seine Metadaten und sein Ausführungsverhalten.

Wichtige Felder innerhalb des Frontmatters ermöglichen eine detaillierte Steuerung:

• name: Der Anzeigename für den Skill. Wenn weggelassen, wird der Verzeichnisname des Skills verwendet.
• description: Ein entscheidendes Feld, das erklärt, was der Skill tut und für welchen Anwendungsfall er bestimmt ist. Wenn dieses Feld fehlt, greift der Skill auf den ersten Absatz des Markdown-Inhalts zurück. Dieses Feld ist für die automatische Invocation entscheidend.
• when_to_use: Bietet zusätzlichen Kontext für die Auslösung des Skills und wird an die description angehängt.
• argument-hint: Bietet einen Hinweis, der während der Autovervollständigung angezeigt wird, z. B. [issue-number].
• arguments: Definiert benannte positionelle Argumente, die mit $name-Substitution verwendet werden können.
• disable-model-invocation: Wenn dies auf true gesetzt ist, wird verhindert, dass Claude den Skill automatisch aufruft.
• user-invocable: Wenn auf false gesetzt, wird der Skill aus dem /-Befehlsmenü ausgeblendet. Beachten Sie, dass die korrekte Schreibweise user-invocable mit 'c' ist.
• allowed-tools: Gibt Werkzeuge an, die ohne ausdrückliche Erlaubnis verwendet werden können, während der Skill aktiv ist.
• disallowed-tools: Listet Werkzeuge auf, die aus dem verfügbaren Pool entfernt werden, wenn der Skill aktiv ist.
• model: Bestimmt, welches Modell Claude verwendet, während der Skill aktiv ist.
• effort: Kategorisiert die Komplexität des Skills mit Stufen wie low, medium, high, xhigh oder max.
• context: Wenn dies auf fork gesetzt ist, wird der Skill in einem gegabelten Subagenten-Kontext ausgeführt.
• agent: Gibt den zu verwendenden Subagenten-Typ an, wenn context auf fork gesetzt ist.
• hooks: Ermöglicht die Definition von Hooks, die auf den Lebenszyklus des Skills beschränkt sind.
• paths: Verwendet Glob-Muster, um zu begrenzen, wann der Skill automatisch aktiviert wird.
• shell: Definiert die zu verwendende Shell, entweder bash oder powershell.

Während viele Felder eine feingranulare Kontrolle bieten, ist das Feld description besonders wichtig für die Aktivierung der automatischen Skill-Invocation. Zum Beispiel verwendet der Skill Creator-Skill Frontmatter, um seinen Namen, seine Beschreibung und seine Argumente zu definieren und den Benutzern Anleitungen zur Erstellung neuer Skills zu geben.