Comment transformer une tâche répétitive en compétence réutilisable pour votre agent de codage IA

Si vous ne cessez de coller la même liste de contrôle dans votre agent de codage IA — « écris un commit conventionnel, puis lance les tests, puis mets à jour le changelog » — vous faites un travail que l'agent pourrait retenir à votre place. La plupart des agents modernes vous permettent d'empaqueter une procédure récurrente dans un petit fichier réutilisable. Dans Claude Code, on les appelle des compétences ; le même fichier alimente aussi des commandes slash comme /deploy. Ce guide explique comment en construire une de zéro, puis détaille les principes transposables à d'autres outils.

Ce qu'est une compétence

Une compétence est un dossier contenant un unique fichier SKILL.md. Ce fichier comporte deux parties : un frontmatter YAML qui indique à l'agent quand utiliser la compétence, et un corps en markdown avec les instructions qu'il suit lorsque la compétence s'exécute. L'avantage clé par rapport au fait de tout entasser dans un fichier CLAUDE.md (ou AGENTS.md) est la divulgation progressive : le corps ne se charge que lorsque la compétence est réellement invoquée, de sorte qu'un long document de référence ne coûte presque rien tant que vous n'en avez pas besoin.

Vous invoquez une compétence de deux façons : directement, en tapant /nom-de-la-competence, ou automatiquement — l'agent lit votre requête, la confronte à la description de la compétence et la charge si elle est pertinente.

Où vivent les compétences

L'endroit où vous placez le dossier décide de qui peut l'utiliser. Dans Claude Code, d'après la documentation officielle :

• ~/.claude/skills/<name>/SKILL.md — personnel, disponible dans tous vos projets.
• .claude/skills/<name>/SKILL.md — projet, validé dans le dépôt afin que toute l'équipe dispose de la même commande.

Le nom du dossier devient la commande. Un dossier nommé summarize-changes vous donne /summarize-changes.

Un exemple concret

Construisons une compétence qui résume vos modifications non validées et signale tout ce qui est risqué avant de committer. Créez le répertoire :

mkdir -p ~/.claude/skills/summarize-changes

Puis enregistrez ceci sous ~/.claude/skills/summarize-changes/SKILL.md :

---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in two or three bullet points, then list any
risks you notice such as missing error handling, hardcoded values, or tests
that need updating. If the diff is empty, say there are no uncommitted changes.

Deux choses font que cela fonctionne. Premièrement, la description est écrite pour l'agent, pas pour vous — elle nomme les déclencheurs (« what changed », « wants a commit message », « review their diff ») afin que l'agent sache quand y recourir. Deuxièmement, la ligne !`git diff HEAD` est une injection de contexte dynamique : Claude Code exécute cette commande et colle sa sortie dans le prompt avant que l'agent ne lise la compétence. Les instructions arrivent avec votre diff réel déjà inséré, de sorte que la réponse s'appuie sur votre véritable arbre de travail plutôt que sur des conjectures.

Faites une petite modification dans n'importe quel fichier, lancez votre agent et essayez les deux façons — demandez « qu'est-ce que j'ai modifié ? » pour le déclencher automatiquement, ou tapez /summarize-changes pour l'exécuter directement.

Passer des arguments

Les compétences peuvent prendre une entrée. Un espace réservé $ARGUMENTS dans le corps est remplacé par ce que vous tapez après la commande, et des variantes indexées ($0, $1) capturent des mots précis. Une compétence invoquée par /fix-issue 4821 peut référencer directement le numéro du ticket, de sorte qu'un seul fichier gère chaque ticket au lieu d'un fichier par ticket.

Cinq principes pour des compétences qui tiennent la route

Ils s'appliquent que vous écriviez une compétence Claude Code, une commande Cursor ou — depuis la fonctionnalité Record & Replay d'OpenAI de juin 2026 — que vous modifiiez une automatisation que l'agent a enregistrée pour vous :

1. Écrivez la description pour le modèle. Mettez en avant des phrases de déclenchement concrètes. Une description vague signifie que l'agent ne charge jamais la compétence automatiquement, et vous voilà de nouveau à taper / et à essayer de vous souvenir des noms.
2. Limitez chaque compétence à une seule tâche. Une compétence qui déploie et lance des migrations et publie sur Slack est difficile à apprécier et plus difficile encore à déboguer. Des compétences petites et à but unique se composent mieux.
3. Injectez du contexte en direct plutôt que de le décrire. Récupérer un vrai diff, un résultat de test ou une liste de fichiers vaut mieux que de dire à l'agent « vérifie l'état actuel » — cela supprime une étape où l'agent peut se tromper en devinant.
4. Mettez un garde-fou sur tout ce qui a des effets de bord. Pour les compétences qui déploient, migrent ou suppriment, exigez une invocation explicite plutôt que de laisser l'agent les déclencher automatiquement. Vous voulez un humain dans la boucle avant des actions irréversibles.
5. Validez les compétences d'équipe dans le dépôt. Placer les compétences de projet dans .claude/skills/ et les valider signifie que chaque développeur — et chaque exécution d'agent en CI — suit la même procédure. Vos conventions cessent de vivre dans la tête d'une seule personne.

Quand recourir à une compétence

La règle générale : dès l'instant où vous collez la même série d'instructions en plusieurs étapes pour la troisième fois, ou qu'une section de votre CLAUDE.md passe d'un fait à une procédure, déplacez-la dans une compétence. Vous obtenez une commande réutilisable, votre fichier de contexte reste léger, et les instructions ne se chargent que lorsqu'elles sont réellement nécessaires — ce qui vous garde, vous et l'agent, concentrés sur la tâche du moment.