Frontmatter

Frontmatter er YAML-blokken avgrenset av --- øverst i en SKILL.md-fil. Den fungerer som konfigurasjonen for ferdigheten, og kontrollerer dens metadata og utførelsesatferd.

Viktige felt innenfor frontmatter tillater detaljert kontroll:

• name: Visningsnavnet for ferdigheten. Hvis utelatt, brukes ferdighetens katalognavn.
• description: Et avgjørende felt som forklarer hva ferdigheten gjør og dens tiltenkte bruk. Hvis dette mangler, faller ferdigheten tilbake på å bruke det første avsnittet av markdown-innholdet. Dette feltet er lastbærende for automatisk påkalling.
• when_to_use: Gir tilleggskontekst for å utløse ferdigheten, lagt til description.
• argument-hint: Gir et hint som vises under autocompletion, for eksempel [issue-number].
• arguments: Definerer navngitte posisjonelle argumenter som kan brukes med $name substitusjon.
• disable-model-invocation: Å sette dette til true forhindrer Claude i å automatisk påkalle ferdigheten.
• user-invocable: Sett til false for å skjule ferdigheten fra /-kommandomenyen. Merk at riktig stavemåte er user-invocable med en 'c'.
• allowed-tools: Spesifiserer verktøy som kan brukes uten eksplisitt tillatelse mens ferdigheten er aktiv.
• disallowed-tools: Lister opp verktøy som fjernes fra den tilgjengelige poolen når ferdigheten er aktiv.
• model: Bestemmer hvilken modell Claude bruker mens ferdigheten er aktiv.
• effort: Kategoriserer ferdighetens kompleksitet med nivåer som low, medium, high, xhigh, eller max.
• context: Å sette dette til fork kjører ferdigheten i en forket subagent-kontekst.
• agent: Spesifiserer subagent-typen som skal brukes når context er satt til fork.
• hooks: Tillater definisjon av hooks som er begrenset til ferdighetens livssyklus.
• paths: Bruker glob-mønstre for å begrense når ferdigheten automatisk aktiveres.
• shell: Definerer skallet som skal brukes, enten bash eller powershell.

Selv om mange felt tilbyr finkornet kontroll, er description-feltet spesielt viktig for å muliggjøre automatisk ferdighetspåkalling. For eksempel bruker Skill Creator-ferdigheten frontmatter for å definere sitt navn, beskrivelse og argumenter, og veileder brukere om hvordan de kan bygge nye ferdigheter.