Que sont les Agent Skills ?

Un skill est un dossier qui porte son nom. Le frontmatter YAML de SKILL.md contient les champs name et description, et le corps contient des instructions pas à pas. Le dossier peut aussi contenir des scripts, des modèles ou des documents de référence.

• Dans Claude Code, les skills personnels vivent dans ~/.claude/skills/ et ceux du projet dans .claude/skills/.
• Codex prend aussi en charge les skills : ceux du projet vivent dans .agents/skills et les personnels dans ~/.codex/skills.
• Les plugins peuvent aussi apporter des skills.

Au départ, seuls le nom et la courte description de chaque skill entrent dans le contexte du modèle. Quand une tâche correspond à un skill, le modèle lit le SKILL.md complet et, si besoin, les fichiers voisins. Cela garde le contexte petit même avec des dizaines de skills installés, mais un skill à la description vague ne se déclenchera pas au bon moment.

Ces quatre notions sont souvent confondues ; chacune résout un problème différent.

• Skill : savoir-faire et scripts pour une tâche ; le modèle décide quand l’utiliser.
• MCP : ajoute de nouveaux outils et des connexions à des services externes.
• Sous-agent : un agent auxiliaire qui travaille dans un contexte séparé.
• Hook : une commande qui s’exécute à chaque fois sur un événement donné, quel que soit le modèle.

Un skill n’est utile que s’il se déclenche au bon moment et reste court.

• Dans description, dites clairement ce que fait le skill et quand l’utiliser.
• Gardez SKILL.md court et déplacez les longues références dans des fichiers séparés.
• Transformez les étapes exactes et répétées en scripts pour que le modèle ne les réécrive pas à chaque fois.
• Lisez les skills des autres avant de les installer ; leurs scripts s’exécutent sur votre machine.