when_to_use

when_to_use to opcjonalne pole frontmatter w SKILL.md zawierające dodatkowy kontekst, kiedy Claude powinien wywołać umiejętność — frazy wyzwalające lub przykładowe zapytania.

Machinalnie jest ono dołączane do pola description na liście umiejętności. Ta połączona treść liczy się w ramach tego samego limitu 1536 znaków, do którego przycinana jest treść description i when_to_use. Dlatego nie jest to dodatkowe miejsce; to ten sam budżet, wydany inaczej.

Użyj when_to_use, gdy naturalny sposób opisania tego, co robi umiejętność, i naturalny sposób, w jaki użytkownik o nią zapyta, to różne zdania. description niesie 'co', a when_to_use niesie konkretne sformułowania, których użytkownik może użyć. Ponieważ oba pola są przycinane razem, powinieneś nadać priorytet umieszczeniu kluczowego przypadku użycia na początku description, zamiast polegać na when_to_use, aby uratować niejasne podstawowe wyjaśnienie.

Zauważ, że pisownia z podkreśleniem jest tutaj poprawna (when_to_use). Różni się to od pól z łącznikami, takich jak argument-hint i allowed-tools. Ta niekonsekwencja jest rzeczywista i warto ją dwukrotnie sprawdzić podczas ręcznego pisania frontmatter. Na przykład umiejętność Skill Audit używa when_to_use, aby wyjaśnić, jak użytkownicy mogą poprosić o przegląd kodu, oddzielnie od jej podstawowego opisu.

Pole to jest odrębne od ogólnego pojęcia model-invocation, które odnosi się do szerszego procesu decydowania przez Claude, jak używać dowolnego narzędzia lub umiejętności na podstawie promptu i dostępnego kontekstu. when_to_use dostarcza specyficznych wskazówek dla tego procesu wywoływania dla konkretnej umiejętności.