Skill description

Il campo frontmatter description è ciò che Claude usa per decidere quando applicare una skill. È la singola riga più portante in un file SKILL.md, perché è l'unica parte della skill che è sempre nel contesto. Se description è omesso, Claude Code usa il primo paragrafo del contenuto markdown.

Metti il caso d'uso chiave PER PRIMO. Il testo combinato di description e when-to-use viene troncato a 1.536 caratteri nell'elenco delle skill per ridurre l'uso del contesto. Questo limite è configurabile con l'impostazione skillListingMaxDescChars. Esiste anche un budget complessivo per l'elenco, che copre tutte le skill, regolabile tramite l'impostazione skillListingBudgetFraction o la variabile d'ambiente SLASH_COMMAND_TOOL_CHAR_BUDGET. Per liberare budget, le voci a bassa priorità possono essere impostate su 'solo nome' in skillOverrides in modo che vengano elencate senza descrizione.

Una buona descrizione indica cosa fa la skill E quando usarla, nelle parole dell'utente piuttosto che dell'autore. Il protocollo di test di SkillProof valuta direttamente questo aspetto: la fase di trigger scrive tre formulazioni che DOVREBBERO attivare la skill e due adiacenti che NON DOVREBBERO, quindi giudica onestamente se la descrizione vincerebbe il carico. Descrizioni vaghe sono il motivo più comune per cui una skill tecnicamente valida non si attiva mai. Ad esempio, la descrizione della skill Skill Audit dichiara chiaramente il suo scopo: "Verifica un codebase per qualità, coerenza e pattern errati prima del rilascio."