Frontmatter

Il frontmatter è il blocco YAML delimitato da --- all'inizio di un file SKILL.md. Serve come configurazione per la skill, controllando i suoi metadati e il comportamento di esecuzione.

Campi chiave all'interno del frontmatter consentono un controllo granulare:

• name: Il nome visualizzato per la skill. Se omesso, viene utilizzato il nome della directory della skill.
• description: Un campo cruciale che spiega cosa fa la skill e il suo caso d'uso previsto. Se questo manca, la skill utilizza il primo paragrafo del contenuto markdown. Questo campo è portante per l'invocazione automatica.
• when_to_use: Fornisce contesto aggiuntivo per l'attivazione della skill, aggiunto alla description.
• argument-hint: Offre un suggerimento visualizzato durante l'autocompletamento, come [issue-number].
• arguments: Definisce argomenti posizionali nominati che possono essere utilizzati con la sostituzione $name.
• disable-model-invocation: Impostare questo su true impedisce a Claude di invocare automaticamente la skill.
• user-invocable: Impostare su false per nascondere la skill dal menu dei comandi /. Nota che l'ortografia corretta è user-invocable con una 'c'.
• allowed-tools: Specifica gli strumenti che possono essere utilizzati senza permesso esplicito mentre la skill è attiva.
• disallowed-tools: Elenca gli strumenti che vengono rimossi dal pool disponibile quando la skill è attiva.
• model: Determina quale modello utilizza Claude mentre la skill è attiva.
• effort: Categorizza la complessità della skill con livelli come low, medium, high, xhigh, o max.
• context: Impostare questo su fork esegue la skill in un contesto di sottoagente forked.
• agent: Specifica il tipo di sottoagente da utilizzare quando context è impostato su fork.
• hooks: Consente la definizione di hook con ambito al ciclo di vita della skill.
• paths: Utilizza pattern glob per limitare quando la skill si attiva automaticamente.
• shell: Definisce la shell da utilizzare, bash o powershell.

Sebbene molti campi offrano un controllo granulare, il campo description è particolarmente importante per abilitare l'invocazione automatica della skill. Ad esempio, la skill Skill Creator utilizza il frontmatter per definire il suo nome, la descrizione e gli argomenti, guidando gli utenti su come creare nuove skill.