Skill

Comment ça marche

Quand une tâche revient régulièrement, on finit par l’expliquer à l’agent toujours de la même façon : voilà les étapes, voilà le format attendu, voilà ce qu’il ne faut pas oublier. Une skill, c’est cette explication, écrite une fois dans un fichier, que l’agent charge quand la tâche se présente. On la déclenche par une commande, ou l’agent la reconnaît lui-même d’après sa description.

Une skill contient au minimum une description courte de ce qu’elle fait, pour que l’agent sache quand s’en servir, et la procédure détaillée. Elle peut embarquer des ressources : un gabarit de document, un script qui fait un calcul, une liste de vérifications, des exemples de résultats attendus. Dans Claude Code, c’est un dossier avec un fichier SKILL.md ; d’autres outils ont des formats voisins. L’idée est la même partout : la procédure devient un objet qu’on peut relire, améliorer et partager.

Un exemple concret

Description. Produit le compte rendu d’une réunion client à partir d’une transcription ou de notes. À utiliser quand on te donne une transcription et le nom d’un client.

Procédure. 1. Lis la fiche du client dans clients/NOM/README.md pour connaître le contexte et les projets en cours. 2. Lis la transcription en entier avant d’écrire. 3. Rédige selon le gabarit compte-rendu.md : participants, décisions, actions avec responsable et date, points ouverts. 4. Les actions sont des phrases à l’infinitif, une ligne chacune. 5. Si une décision est ambiguë dans la transcription, mets-la dans « points ouverts », pas dans « décisions ». 6. Enregistre dans clients/NOM/produits/AAAA-MM-JJ-compte-rendu.md.

Vérification. Chaque action a un responsable et une date. Aucun nom de personne externe à la réunion. Longueur : une page maximum.

Déclenchée par /compte-rendu, elle produit en une minute ce qui prenait vingt minutes, dans le même format pour toute l’agence. Elle a été corrigée trois fois depuis sa création, à chaque fois après un compte rendu qui ne convenait pas.

Ce que ça change pour une équipe

• Les procédures deviennent exécutables. Une procédure écrite dans un classeur dort ; une skill travaille.
• La qualité devient homogène. Tout le monde obtient le même format, les mêmes vérifications, quel que soit son talent pour formuler des demandes.
• L’amélioration est continue. Un résultat décevant se corrige dans la skill, une fois, pour tous.
• Le savoir-faire se transmet. Les skills d’une équipe sont la description la plus précise qui existe de sa façon de travailler. Un nouveau les reçoit le premier jour.

Les limites et les erreurs fréquentes

• La skill trop générale. « Rédige des documents » ne sert à rien. Une skill par tâche précise, avec un déclencheur clair.
• La description qui ne dit pas quand l’utiliser. L’agent choisit les skills d’après leur description. Si elle est floue, il ne la charge pas, ou la charge à tort.
• Oublier la vérification. Une skill sans critères de qualité produit des résultats que personne ne contrôle. Les vérifications font partie de la procédure.
• Installer des skills de source inconnue. Une skill peut contenir des scripts qui s’exécutent. On lit ce qu’elle fait avant de l’installer, comme pour n’importe quel logiciel.