when_to_use

when_to_use ist ein optionales SKILL.md frontmatter-Feld, das zusätzlichen Kontext dafür enthält, wann Claude den Skill auslösen soll – Trigger-Phrasen oder Beispielanfragen.

Mechanisch wird es an das description-Feld in der Skill-Liste angehängt. Dieser kombinierte Text zählt für denselben 1.536-Zeichen-Grenzwert, auf den die Texte für description und when_to_use gekürzt werden. Daher ist es kein kostenloser zusätzlicher Platz; es ist dasselbe Budget, das anders ausgegeben wird.

Verwenden Sie when_to_use, wenn die natürliche Art, was ein Skill tut, zu beschreiben und die natürliche Art, wie ein Benutzer danach fragen würde, unterschiedliche Sätze sind. Die description trägt das 'Was', und when_to_use trägt die spezifischen Formulierungen, die ein Benutzer verwenden könnte. Da beide Felder zusammen gekürzt werden, sollten Sie den wichtigsten Anwendungsfall zuerst in Ihrer description platzieren, anstatt sich auf when_to_use zu verlassen, um eine vage primäre Erklärung zu retten.

Beachten Sie, dass die Unterstrich-Schreibweise hier korrekt ist (when_to_use). Dies unterscheidet sich von Bindestrich-Feldern wie argument-hint und allowed-tools. Diese Inkonsistenz ist real und es lohnt sich, sie beim manuellen Schreiben von frontmatter zu überprüfen. Zum Beispiel verwendet der Skill Skill Audit when_to_use, um zu klären, wie Benutzer nach einer Code-Überprüfung fragen könnten, getrennt von seiner Kernbeschreibung.

Dieses Feld ist vom allgemeinen Konzept von model-invocation zu unterscheiden, das sich auf den breiteren Prozess bezieht, wie Claude entscheidet, jedes Tool oder jeden Skill basierend auf dem Prompt und dem verfügbaren Kontext zu verwenden. when_to_use liefert spezifische Anleitungen für diesen Invocation-Prozess für einen bestimmten Skill.