Skills Claude Code : 5 points de la doc et 3 prompts à copier

La documentation le dit simplement : créez un fichier SKILL.md avec des instructions, et Claude l’ajoute à sa boîte à outils. Le fichier commence par un en-tête de deux lignes, le nom et la description. Puis vient le corps : la procédure que Claude suit quand le skill s’exécute. À côté, dans le même dossier, des fichiers de support : des références, des exemples, des scripts.

Créez un skill quand une section de votre fichier CLAUDE.md est devenue une procédure complète, ou quand la même consigne revient d’un projet à l’autre. Un détail qui compte pour une PME : les skills Claude Code suivent la norme ouverte Agent Skills (agentskills.io), reprise par d’autres outils d’IA. Le même dossier que nous écrivons pour Claude Code, nous le donnons aux agents Hermes que nous opérons pour nos clients. Claude Code ajoute quelques champs qui lui sont propres, comme les verrous du point 5 ; le reste voyage tel quel.

Claude ne lit pas tous vos skills à chaque message. La documentation décrit une divulgation progressive à trois niveaux. Au démarrage, seules les métadonnées de chaque skill sont chargées, une centaine de tokens par skill. Le corps du fichier n’est lu que lorsque le skill se déclenche. Les fichiers de support ne sont ouverts qu’à la demande.

Tout repose donc sur la description. Une bonne description dit ce que le skill fait et quand l’utiliser, avec les mots que quelqu’un emploierait vraiment. Elle est écrite à la troisième personne, parce qu’elle est injectée dans l’invite système. Et sans nom vague : la documentation cite “helper”, “utils” et “tools” comme noms à éviter. Pour notre skill de carrousels LinkedIn : créer des carrousels à partir d’un sujet, d’une transcription ou d’un plan ; utiliser dès qu’on demande un carrousel, des slides carrousel ou un post LinkedIn. Les mots exacts de nos clients, pas les nôtres.

La documentation liste sept emplacements. Les quatre à connaître : le skill personnel vit dans votre dossier utilisateur et vous suit sur tous vos projets ; le skill de projet vit dans le dépôt, dans le dossier .claude/skills, et part avec le code, toute l’équipe l’a en clonant ; le skill de plugin arrive avec un plugin installé ; le skill d’entreprise est déployé par l’administrateur sur tous les postes. Les trois autres couvrent les sous-dossiers d’un monorepo, les répertoires ajoutés au lancement et les skills activés dans un compte claude.ai.

Quand deux skills portent le même nom, la priorité va à l’entreprise, puis au skill personnel, puis au skill de projet. Un skill personnel ou de projet ajouté ou modifié est pris en compte dans la session en cours, sans redémarrer ; un skill fourni par un plugin demande de recharger les plugins. Notre règle maison : tout ce qui concerne un client vit dans le projet du client. Le skill part avec le dépôt, et personne ne dépend d’un poste en particulier.

Concision d’abord. La documentation rappelle que Claude est déjà intelligent : un skill n’explique pas ce que Claude sait faire, il ajoute ce que Claude ne peut pas deviner, en moins de 500 lignes. Ensuite, les degrés de liberté : pour une opération fragile, un pont étroit avec des étapes précises ; pour une tâche de jugement, un champ ouvert avec des principes.

Les scripts : quand une étape est déterministe, mettez-la dans un script que Claude exécute. Le code tourne hors du contexte, et l’erreur est résolue par le script plutôt que déléguée au modèle. Les boucles de vérification : un skill fiable produit quelque chose que l’on peut contrôler, puis corrige. Pour cette vidéo, la boucle est une planche d’images extraites du rendu, relue avant chaque envoi.

Les évaluations avant l’écriture : trois scénarios réels, joués avec et sans le skill, sur plusieurs modèles si possible. Et la méthode à deux instances : Claude A vous aide à écrire et affiner le skill, Claude B l’utilise sur du vrai travail, et vous rapportez à A ce que B a raté.

Par défaut, vous et Claude pouvez lancer n’importe quel skill. La documentation propose deux verrous. Le premier, disable-model-invocation, réserve un skill à vous seul : déploiement, envoi d’un message, publication. Vous ne voulez pas que Claude décide de publier parce que le contenu lui paraît prêt. Le second, user-invocable à false, fait l’inverse : un savoir de fond que Claude charge tout seul, mais qui n’a aucun sens comme commande.

Un troisième réglage, allowed-tools, pré-approuve des outils précis pour le tour où le skill s’exécute, pas plus. Un skill peut aussi tourner dans un sous-agent isolé, pour ne pas encombrer la conversation principale. Et un rappel de sécurité de la documentation : installer un skill, c’est installer un logiciel. On lit ce qu’il contient avant de l’ajouter.

À lancer dans un projet qui a déjà plusieurs skills. Claude relit chaque description, repère les chevauchements et ne réécrit que ce qui est ambigu. Le prompt, à copier tel quel :

Relis les descriptions de tous mes skills. Pour chacune, dis-moi ce que le skill fait, quand il doit se déclencher, et où il chevauche un autre skill. Réécris uniquement les descriptions ambiguës, à la troisième personne, avec les mots qu’un utilisateur emploierait.

À lancer juste après un travail réussi, dans la même conversation, pendant que Claude a encore tout le contexte : les règles données en cours de route et les fichiers qui ont servi. Le prompt :

Crée un skill qui capture la façon dont on vient de faire ce travail : le processus étape par étape, les règles que je t’ai données en cours de route, et les fichiers de référence utiles. Reste concis, Claude connaît déjà le reste. Puis relance la même tâche avec ce skill et compare les deux résultats.

À lancer quand un skill a produit un mauvais résultat. L’idée vient de l’article d’ingénierie d’Anthropic : demander à Claude de réfléchir à ce qui a mal tourné avant de corriger, pour améliorer le skill et pas seulement le résultat. Le prompt :

Le skill a raté sur cette tâche. Avant de corriger le résultat, relis ta trajectoire : quel fichier tu as lu, quelle règle tu as sautée, ce qui manquait. Propose la plus petite modification du skill qui évite ce raté, applique-la, puis rejoue la tâche.

Anthropic, Skills dans Claude Code : https://code.claude.com/docs/fr/skills. Anthropic, Vue d’ensemble Agent Skills : https://docs.claude.com/fr/docs/agents-and-tools/agent-skills/overview. Anthropic, Bonnes pratiques de rédaction des skills : https://docs.claude.com/fr/docs/agents-and-tools/agent-skills/best-practices.

Anthropic Engineering, Equipping agents for the real world with Agent Skills : https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills. Chaque affirmation de ce guide se retrouve dans l’une de ces pages ; les exemples et la règle de rangement par client viennent de la pratique Adygital.