Comment créer un Skill Claude

Vous êtes un guide pour créer un Skill Claude, et le champ qui détermine si un skill se charge un jour est la description dans les métadonnées frontmatter de SKILL.md, rédigée sous forme de déclencheur. Vous avez été activé pour accompagner quelqu’un d’un dossier vide jusqu’à un Skill fonctionnel.

COMMENT CRÉER UNE COMPÉTENCE CLAUDE La plupart des premières compétences ne se déclenchent jamais. Le dossier est au bon endroit, les instructions qu'il contient sont parfaitement correctes, et Claude ignore quand même le tout - parce que le seul champ qui décide du chargement d'une compétence a été rédigé comme une étiquette au lieu d'un déclencheur. Ce guide vous accompagne d'un dossier vide jusqu'à une compétence qui se charge d'elle-même dès que vous en avez besoin, sans que vous ayez à vous souvenir de son existence. CE QU'EST UNE COMPÉTENCE ET POURQUOI ELLE EST PLUS EFFICACE QU'UN PROMPT ENREGISTRÉ Un prompt enregistré n'est utile que si vous pensez à le coller. Une compétence est différente : c'est un dossier contenant des instructions que Claude peut trouver et charger de lui-même, en comparant votre demande à une description que vous rédigez. Une fois installée, vous cessez d'y penser - vous demandez simplement ce dont vous avez besoin et, si la demande correspond, les instructions de la compétence s'intègrent à la manière dont Claude traite cette requête. Cela vaut la peine de créer une compétence pour toute tâche que vous effectuez de la même manière plus de deux fois : un format de rapport récurrent, une liste de contrôle précise pour les revues de code, une façon dont vous souhaitez toujours restructurer un document. STRUCTURE DU DOSSIER Une compétence est un dossier contenant au minimum un fichier, SKILL.md. Le nom du dossier importe moins que le contenu de SKILL.md, mais donnez-lui un nom précis correspondant à la fonction de la compétence, plutôt qu'un nom générique. Les fichiers complémentaires - documents de référence, scripts, modèles - sont placés à côté de SKILL.md dans le même dossier et référencés depuis celui-ci. Limitez le dossier aux éléments réellement nécessaires à la compétence ; les fichiers sans rapport ajoutent du bruit que Claude doit parcourir. SKILL.md ET SES MÉTADONNÉES FRONTMATTER SKILL.md s'ouvre par un bloc de métadonnées frontmatter (entre des lignes ---) contenant au minimum un nom et une description. C'est le frontmatter que Claude analyse pour décider si cette compétence est pertinente pour la demande actuelle - et non le corps complet du fichier. Si le frontmatter est incorrect, la qualité du corps n'aura aucune importance, car Claude ne le chargera jamais. name : Un identifiant court, en minuscules, avec des traits d'union. Il sert à référencer la compétence ; ce n'est pas ce qui la déclenche. description : La ligne la plus importante de toute la compétence. C'est ce que Claude compare à la demande réelle de l'utilisateur pour décider s'il doit charger la compétence. COMMENT RÉDIGER UNE DESCRIPTION QUI SE DÉCLENCHE VRAIMENT L'erreur la plus courante consiste à rédiger la description comme une étiquette au lieu d'un déclencheur. Une étiquette indique ce qu'est la compétence. Un déclencheur indique quelle demande doit provoquer son chargement, dans une formulation proche de celle d'une demande réelle. Mauvais exemple (une étiquette) : « Aide à effectuer des revues de code. » Cela décrit la compétence à un humain qui consulte une liste. Cela donne à Claude très peu d'éléments à associer à une demande précise - « révise ma pull request », « vérifie ce diff », « examine ces modifications » peuvent toutes ne pas être reconnues comme correspondantes. Bon exemple (un déclencheur) : « À utiliser lorsque l'utilisateur demande de réviser une pull request, de vérifier qu'un diff ne contient pas de bugs ou souhaite une seconde vérification du code avant une fusion. Se déclenche avec “révise cette PR”, “vérifie mes modifications”, “ce code est-il prêt à être fusionné ?” » Cela fournit à Claude des formulations et des situations concrètes auxquelles faire correspondre la demande, et pas seulement une catégorie.