La description fait tout le tri

La description est la seule partie que Claude lit avant de décider de charger une Skill. Vague, elle laisse la Skill muette ou la déclenche à tort. Elle doit dire deux choses : ce que fait la Skill et quand l’utiliser.

Cinq règles

1. Commencez par l’usage principal. Claude Code coupe chaque description à 1 536 caractères dans sa liste, et en retire quand vous avez beaucoup de Skills.
2. Écrivez à la troisième personne : « Rédige… », « Contrôle… », jamais « Je peux vous aider ». La description est injectée dans le prompt système, et un changement de point de vue gêne la sélection.
3. Reprenez les mots de vos utilisateurs : « CR », « récap », « synthèse de réunion », et les types de fichiers concernés.
4. Soyez un peu insistant. Anthropic constate que Claude a tendance à sous-utiliser les Skills : « À utiliser dès qu’on demande… » l’aide à oser.
5. Mettez tout le « quand » dans la description, rien dans le corps : le corps n’est lu qu’après la décision.