SKILL.md

Un SKILL.md est un fichier markdown qui sert d'unité fondamentale pour une compétence Claude Code. Il se compose de deux parties distinctes : un frontmatter YAML délimité par des marqueurs ---, et un contenu markdown qui fournit les instructions que Claude suit lorsque la compétence est exécutée.

Le fichier SKILL.md réside dans une structure de répertoire spécifique. Pour les compétences personnelles disponibles dans tous vos projets, il se trouve à ~/.claude/skills/<nom-de-la-competence>/SKILL.md. Pour les compétences spécifiques à un projet, le chemin est .claude/skills/<nom-de-la-competence>/SKILL.md. Si la compétence fait partie d'un plugin, elle se trouvera à <plugin>/skills/<nom-de-la-competence>/SKILL.md.

Le nom du répertoire contenant le fichier SKILL.md dicte la commande que vous utilisez pour invoquer la compétence via une commande slash (par exemple, /nom-de-la-competence). Le champ name dans le frontmatter YAML, cependant, définit l'étiquette d'affichage qui apparaît dans les listes de compétences. Une exception se produit avec les fichiers SKILL.md racine de plugin, où le champ name détermine directement le nom de la commande, car il n'y a pas de répertoire de compétence dédié pour en dériver.

Au-delà du fichier SKILL.md lui-même, le répertoire de compétence peut abriter des fichiers supplémentaires tels que de la documentation de référence ou des scripts. Ces fichiers supplémentaires sont chargés par Claude Code uniquement lorsqu'ils sont nécessaires pendant le fonctionnement de la compétence. Claude Code surveille activement ces répertoires de compétences. Par conséquent, les modifications apportées à un fichier SKILL.md ou l'ajout de nouveaux fichiers prendront effet dans la session en cours sans nécessiter de redémarrage. Cependant, la création d'un répertoire de compétences de niveau supérieur qui n'existait pas au début de la session nécessitera un redémarrage pour que Claude Code le reconnaisse.

Les compétences Claude Code adhèrent à la norme ouverte Agent Skills, favorisant l'interopérabilité et une approche cohérente du développement de compétences. Pour obtenir des conseils sur la création de fichiers de compétences bien structurés, consultez Authoring Skills.