Frontmatter

Frontmatter er YAML-blokken, der er afgrænset af --- øverst i en SKILL.md-fil. Den fungerer som konfigurationen for færdigheden og styrer dens metadata og udførelsesadfærd.

Vigtige felter inden for frontmatter giver detaljeret kontrol:

• name: Visningsnavnet for færdigheden. Hvis det udelades, bruges færdighedens mappenavn.
• description: Et afgørende felt, der forklarer, hvad færdigheden gør, og dens tilsigtede anvendelsesscenarie. Hvis dette mangler, falder færdigheden tilbage på at bruge det første afsnit af markdown-indholdet. Dette felt er load-bearing for automatisk kald.
• when_to_use: Giver yderligere kontekst til at udløse færdigheden, tilføjet til description.
• argument-hint: Giver et hint vist under autocompletion, f.eks. [issue-number].
• arguments: Definerer navngivne positionelle argumenter, der kan bruges med $name substitution.
• disable-model-invocation: Indstilling af dette til true forhindrer Claude i automatisk at kalde færdigheden.
• user-invocable: Indstillet til false for at skjule færdigheden fra / kommandomenuen. Bemærk, at den korrekte stavning er user-invocable med et 'c'.
• allowed-tools: Angiver værktøjer, der kan bruges uden eksplicit tilladelse, mens færdigheden er aktiv.
• disallowed-tools: Lister værktøjer, der fjernes fra den tilgængelige pulje, når færdigheden er aktiv.
• model: Bestemmer, hvilken model Claude bruger, mens færdigheden er aktiv.
• effort: Kategoriserer færdighedens kompleksitet med niveauer som low, medium, high, xhigh eller max.
• context: Indstilling af dette til fork kører færdigheden i en forket subagent-kontekst.
• agent: Angiver den subagent-type, der skal bruges, når context er indstillet til fork.
• hooks: Tillader definition af hooks, der er omfanget til færdighedens livscyklus.
• paths: Bruger glob-mønstre til at begrænse, hvornår færdigheden automatisk aktiveres.
• shell: Definerer den shell, der skal bruges, enten bash eller powershell.

Selvom mange felter tilbyder finkornet kontrol, er description-feltet særligt vigtigt for at muliggøre automatisk færdighedskald. For eksempel bruger Skill Creator-færdigheden frontmatter til at definere sit navn, beskrivelse og argumenter, hvilket guider brugerne om, hvordan man bygger nye færdigheder.