when_to_use

when_to_use è un campo frontmatter opzionale di SKILL.md che contiene contesto aggiuntivo su quando Claude dovrebbe invocare la skill — frasi trigger o richieste di esempio.

Meccanicamente, viene aggiunto al campo description nell'elenco delle skill. Questo testo combinato contribuisce allo stesso limite di 1.536 caratteri al quale il testo di description e when_to_use viene troncato. Pertanto, non è spazio extra gratuito; è lo stesso budget, speso in modo diverso.

Usa when_to_use quando il modo naturale per descrivere cosa fa una skill e il modo naturale in cui un utente la chiederebbe sono frasi diverse. La description porta il 'cosa', e when_to_use porta le formulazioni specifiche che un utente potrebbe impiegare. Poiché entrambi i campi vengono troncati insieme, dovresti dare priorità a mettere il caso d'uso chiave per primo nella tua description piuttosto che affidarti a when_to_use per salvare una spiegazione primaria vaga.

Nota che la grafia con l'underscore è corretta qui (when_to_use). Questo differisce dai campi con trattino come argument-hint e allowed-tools. Questa inconsistenza è reale e vale la pena ricontrollarla quando scrivi frontmatter manualmente. Ad esempio, la skill Skill Audit usa when_to_use per chiarire how users might ask for a code review, separatamente dalla sua descrizione principale.

Questo campo è distinto dal concetto generale di model-invocation, che si riferisce al processo più ampio di come Claude decide di usare qualsiasi strumento o skill basandosi sul prompt e sul contesto disponibile. when_to_use fornisce una guida specifica per quel processo di invocazione per una particolare skill.