when_to_use

when_to_use je volitelné pole frontmatter v SKILL.md obsahující dodatečný kontext pro to, kdy by Claude měl skill spustit — spouštěcí fráze nebo příkladové požadavky.

Mechanicky se připojuje k poli description v seznamu skillů. Tento kombinovaný text se počítá do stejného limitu 1 536 znaků, na který se text description a when_to_use zkracuje. Proto to není volné místo navíc; je to stejný rozpočet, utracený jinak.

Použijte when_to_use, když se přirozený způsob popisu toho, co skill dělá, a přirozený způsob, jakým by o něj uživatel požádal, liší ve větách. description nese 'co', a when_to_use nese konkrétní formulace, které může uživatel použít. Protože se obě pole zkracují společně, měli byste dát klíčový případ použití na první místo ve svém description místo spoléhání se na when_to_use, které by zachránilo vágní primární vysvětlení.

Poznamenejte si, že pravopis s podtržítkem je zde správný (when_to_use). To se liší od polí s pomlčkou, jako jsou argument-hint a allowed-tools. Tato nekonzistence je skutečná a stojí za dvojitou kontrolu, když píšete frontmatter ručně. Například skill Skill Audit používá when_to_use k objasnění, jak uživatelé mohou požádat o revizi kódu, odděleně od jeho základního popisu.

Toto pole je odlišné od obecného konceptu model-invocation, který odkazuje na širší proces, jak Claude rozhoduje o použití jakéhokoli nástroje nebo skillu na základě promptu a dostupného kontextu. when_to_use poskytuje specifické pokyny pro tento proces spouštění pro konkrétní skill.