Frontmatter

Frontmatter is het YAML-blok, afgebakend door --- aan de bovenkant van een SKILL.md bestand. Het dient als de configuratie voor de skill en regelt de metadata en het uitvoeringsgedrag ervan.

Belangrijke velden binnen de frontmatter bieden gedetailleerde controle:

• name: De weergavenaam voor de skill. Indien weggelaten, wordt de mapnaam van de skill gebruikt.
• description: Een cruciaal veld dat uitlegt wat de skill doet en wat het beoogde gebruiksscenario is. Als dit ontbreekt, valt de skill terug op het gebruik van de eerste paragraaf van de markdowninhoud. Dit veld is essentieel voor automatische aanroep.
• when_to_use: Biedt aanvullende context voor het activeren van de skill, toegevoegd aan de description.
• argument-hint: Biedt een hint die wordt weergegeven tijdens autocompletie, zoals [issue-number].
• arguments: Definieert benoemde positionele argumenten die kunnen worden gebruikt met $name substitutie.
• disable-model-invocation: Als dit op true wordt ingesteld, wordt voorkomen dat Claude de skill automatisch aanroept.
• user-invocable: Wordt ingesteld op false om de skill te verbergen voor het / commandomenu. Merk op dat de juiste spelling user-invocable is met een 'c'.
• allowed-tools: Specificeert tools die zonder expliciete toestemming mogen worden gebruikt terwijl de skill actief is.
• disallowed-tools: Vermeldt tools die uit de beschikbare pool worden verwijderd wanneer de skill actief is.
• model: Bepaalt welk model Claude gebruikt terwijl de skill actief is.
• effort: Categoriseert de complexiteit van de skill met niveaus zoals low, medium, high, xhigh, of max.
• context: Als dit op fork wordt ingesteld, wordt de skill uitgevoerd in een geforkte subagentcontext.
• agent: Specificeert het subagenttype dat moet worden gebruikt wanneer context is ingesteld op fork.
• hooks: Maakt het mogelijk om hooks te definiëren die zijn afgestemd op de levenscyclus van de skill.
• paths: Gebruikt glob-patronen om te beperken wanneer de skill automatisch wordt geactiveerd.
• shell: Definieert de shell die moet worden gebruikt, bash of powershell.

Hoewel veel velden fijne controle bieden, is het description veld bijzonder belangrijk voor het inschakelen van automatische skillaanroep. De Skill Creator skill gebruikt bijvoorbeeld frontmatter om zijn naam, beschrijving en argumenten te definiëren, en begeleidt gebruikers bij het bouwen van nieuwe skills.