Skill description

Le champ frontmatter description est ce que Claude utilise pour décider quand appliquer un skill. C'est la ligne la plus importante d'un fichier SKILL.md, car c'est la seule partie du skill qui est toujours dans le contexte. Si description est omis, Claude Code utilise le premier paragraphe du contenu markdown.

Mettez le cas d'utilisation clé EN PREMIER. Le texte combiné de description et when-to-use est tronqué à 1 536 caractères dans la liste des skills pour réduire l'utilisation du contexte. Ce plafond est configurable avec le paramètre skillListingMaxDescChars. Il existe également un budget global de liste pour tous les skills, ajustable via le paramètre skillListingBudgetFraction ou la variable d'environnement SLASH_COMMAND_TOOL_CHAR_BUDGET. Pour libérer du budget, les entrées de faible priorité peuvent être définies sur 'nom uniquement' dans skillOverrides afin qu'elles apparaissent sans description.

Une bonne description indique ce que fait le skill ET quand l'utiliser, dans les mots de l'utilisateur plutôt que dans ceux de l'auteur. Le protocole de test de SkillProof note cela directement : l'étape de déclenchement écrit trois formulations qui DEVRAIENT activer le skill et deux formulations adjacentes qui ne devraient PAS, puis juge honnêtement si la description gagnerait la charge. Les descriptions vagues sont la raison la plus fréquente pour laquelle un skill techniquement correct ne se déclenche jamais. Par exemple, la description du skill Skill Audit indique clairement son objectif : "Audite une base de code pour la qualité, la cohérence et les modèles cassés avant la publication."