when_to_use

when_to_use är ett valfritt SKILL.md frontmatter-fält som innehåller ytterligare kontext för när Claude ska utlösa färdigheten — utlösarfraser eller exempelbegäranden.

Mekaniskt läggs det till fältet description i färdighetslistan. Denna kombinerade text räknas mot samma 1 536-teckensgräns som texten i description och when_to_use trunkeras vid. Därför är det inte gratis extra utrymme; det är samma budget, spenderad på ett annat sätt.

Använd when_to_use när det naturliga sättet att beskriva vad en färdighet gör och det naturliga sättet en användare skulle fråga efter det är olika meningar. description bär 'vad', och when_to_use bär de specifika formuleringar en användare kan använda. Eftersom båda fälten trunkeras tillsammans bör du prioritera att placera det viktigaste användningsfallet först i din description snarare än att förlita dig på when_to_use för att rädda en vag primär förklaring.

Observera att understrykningsstavningen är korrekt här (when_to_use). Detta skiljer sig från fält med bindestreck som argument-hint och allowed-tools. Denna inkonsekvens är verklig och värd att dubbelkolla när du skriver frontmatter manuellt. Till exempel använder Skill Audit-färdigheten when_to_use för att klargöra hur användare kan begära en kodgranskning, separat från dess kärnbeskrivning.

Detta fält är skilt från det allmänna konceptet model-invocation, som hänvisar till den bredare processen för hur Claude beslutar att använda ett verktyg eller en färdighet baserat på prompten och tillgänglig kontext. when_to_use ger specifik vägledning för den anropningsprocessen för en viss färdighet.