when_to_use

when_to_use is een optioneel SKILL.md frontmatter veld dat aanvullende context bevat voor wanneer Claude de skill moet triggeren — trigger zinnen of voorbeeldverzoeken.

Mechanisch wordt het toegevoegd aan het description veld in de skill-lijst. Deze gecombineerde tekst telt mee voor dezelfde limiet van 1.536 tekens waar de description en when_to_use tekst wordt afgekapt. Daarom is het geen gratis extra ruimte; het is hetzelfde budget, anders besteed.

Gebruik when_to_use wanneer de natuurlijke manier om te beschrijven wat een skill doet en de natuurlijke manier waarop een gebruiker ernaar zou vragen verschillende zinnen zijn. De description bevat de 'wat', en when_to_use bevat de specifieke formuleringen die een gebruiker zou kunnen gebruiken. Omdat beide velden samen worden afgekapt, moet je prioriteit geven aan het plaatsen van het belangrijkste gebruiksscenario eerst in je description in plaats van te vertrouwen op when_to_use om een vage primaire uitleg te redden.

Let op: de spelling met underscore is hier correct (when_to_use). Dit verschilt van velden met een koppelteken zoals argument-hint en allowed-tools. Deze inconsistentie is echt en de moeite waard om dubbel te controleren wanneer je frontmatter handmatig schrijft. De Skill Audit skill gebruikt bijvoorbeeld when_to_use om te verduidelijken hoe gebruikers om een code review kunnen vragen, gescheiden van de kernbeschrijving.

Dit veld is onderscheiden van het algemene concept van model-invocation, dat verwijst naar het bredere proces van hoe Claude besluit om enig gereedschap of enige skill te gebruiken op basis van de prompt en beschikbare context. when_to_use biedt specifieke begeleiding voor dat invocatieproces voor een bepaalde skill.