Claude Code Glossar
Skill description
Das Frontmatter-Feld 'description' teilt Claude Code mit, wann ein Skill angewendet werden soll.
Auch genannt: skill trigger description, description frontmatter, when does a skill trigger
Das description-Frontmatter-Feld ist das, was Claude verwendet, um zu entscheiden, wann ein Skill angewendet werden soll. Es ist die wichtigste Zeile in einer SKILL.md-Datei, da sie der einzige Teil des Skills ist, der immer im Kontext steht. Wenn description weggelassen wird, verwendet Claude Code den ersten Absatz des Markdown-Inhalts.
Stellen Sie den wichtigsten Anwendungsfall ZUERST. Die kombinierte description und when-to-use-Text wird in der Skill-Liste auf 1.536 Zeichen gekürzt, um die Kontextnutzung zu reduzieren. Diese Obergrenze ist mit der Einstellung skillListingMaxDescChars konfigurierbar. Es gibt auch ein Gesamtbudget für die Auflistung über alle Skills hinweg, das über die Einstellung skillListingBudgetFraction oder die Umgebungsvariable SLASH_COMMAND_TOOL_CHAR_BUDGET angepasst werden kann. Um Budget freizugeben, können niedrig priorisierte Einträge in skillOverrides auf 'nur Name' gesetzt werden, damit sie ohne Beschreibung aufgeführt werden.
Eine gute Beschreibung sagt, was der Skill tut UND wann er verwendet werden soll, in den Worten des Benutzers und nicht des Autors. Das Testprotokoll von SkillProof bewertet dies direkt: Die Trigger-Phase schreibt drei Formulierungen, die den Skill aktivieren SOLLTEN, und zwei benachbarte, die dies NICHT tun sollten, und beurteilt dann ehrlich, ob die Beschreibung den Load gewinnen würde. Vage Beschreibungen sind der häufigste Grund, warum ein technisch einwandfreier Skill nie ausgelöst wird. Zum Beispiel gibt der Skill Audit-Skill in seiner Beschreibung klar seinen Zweck an: "Auditiert einen Codebestand auf Qualität, Konsistenz und fehlerhafte Muster vor der Veröffentlichung."