Créer des compétences pour les agents d'IA : mécanismes, meilleures pratiques et transformation en plugin

L'auteur, développeur du référentiel rpa-skills, détaille comment créer des compétences pour les agents IA de la manière appropriée. Une compétence n'est pas un simple fichier markdown, mais un dossier contenant un fichier SKILL.md obligatoire avec un en-tête YAML (nom, description) et un corps d'instructions, ainsi que des répertoires optionnels references/, scripts/, assets/ et un README.md. Le principe de divulgation progressive charge uniquement la description de la compétence dans le système ; le corps est extrait lors de l'activation, donc le corps doit être limité à 500 lignes, avec le contenu lourd déplacé dans references/. Dans le champ de description, il est important de spécifier clairement l'objectif et les conditions de déclenchement, en évitant les mots génériques comme « MUST » pour empêcher le modèle d'activer la compétence de manière aléatoire. L'auteur souligne la différence entre les compétences et les règles : les règles (avec alwaysApply : true) sont toujours actives et adaptées au style de code ou à la gestion des erreurs, tandis que les compétences sont préférables pour les procédures en plusieurs étapes (déploiement, développement piloté par le comportement, analyse de bugs). Les descriptions et les corps de compétences doivent être rédigés en anglais en raison de la tokenisation : le cyrillique prend en moyenne deux fois plus de jetons que le latin, ce qui économise du contexte. Des pratiques d'Anthropic sont fournies : degrés de liberté (rails stricts pour les tâches critiques, champ libre pour les tâches créatives), les opérations déterministes doivent être déplacées dans des scripts, une section obligatoire pour les erreurs courantes (Gotchas), des noms sous forme gérondive (par exemple, processing-pdfs), et éviter une variabilité excessive — il est préférable de donner une solution principale et une solution de repli. Pour tester une compétence, exécutez un sous-agent avec un contexte propre et vérifiez si la compétence s'active automatiquement, où elle a commis des erreurs et si le résultat correspond aux attentes. Au moins trois exécutions sur différentes tâches et sur différents modèles, y compris les petits modèles qui suivent les instructions à la lettre, sont recommandées. Une compétence pour la place de marché est conditionnée en tant que plugin — un dossier avec un manifeste plugin.json (dans .claude-plugin/ pour Claude Code, dans .codex-plugin/ pour Codex), spécifiant les métadonnées, avec le nom correspondant au nom de SKILL.md et la version synchronisée. Le plugin peut également inclure des commandes slash, des sous-agents, des hooks et des serveurs MCP.