Claude Code woordenlijst
Skill description
Het frontmatter-veld `description` vertelt Claude Code wanneer een skill moet worden toegepast.
Ook wel genoemd: skill trigger description, description frontmatter, when does a skill trigger
Het description frontmatter-veld is wat Claude gebruikt om te beslissen wanneer een skill moet worden toegepast. Het is de meest cruciale regel in een SKILL.md bestand, omdat het het enige deel van de skill is dat altijd in context is. Als description wordt weggelaten, gebruikt Claude Code de eerste paragraaf van de markdown-inhoud.
Plaats het belangrijkste gebruikscase EERST. De gecombineerde description en when-to-use tekst wordt afgekapt tot 1.536 tekens in de skill-lijst om het contextgebruik te verminderen. Deze limiet is configureerbaar met de skillListingMaxDescChars instelling. Er is ook een algemeen budget voor de lijst over alle skills, aanpasbaar via de skillListingBudgetFraction instelling of de SLASH_COMMAND_TOOL_CHAR_BUDGET omgevingsvariabele. Om budget vrij te maken, kunnen laag-prioriteits items worden ingesteld op 'name-only' in skillOverrides, zodat ze worden vermeld zonder beschrijving.
Een goede beschrijving zegt wat de skill doet EN wanneer deze moet worden gebruikt, in de woorden van de gebruiker in plaats van de auteur. Het testprotocol van SkillProof beoordeelt dit direct: de triggerfase schrijft drie formuleringen die de skill ZOUDEN moeten activeren en twee aangrenzende die dat NIET zouden moeten doen, en beoordeelt dan eerlijk of de beschrijving de load zou winnen. Vage beschrijvingen zijn de meest voorkomende reden dat een technisch prima skill nooit wordt geactiveerd. De Skill Audit skill's beschrijving stelt bijvoorbeeld duidelijk zijn doel: "Auditeert een codebase op kwaliteit, consistentie en gebroken patronen vóór release."