Les skills de Claude Code : apprendre vos vrais process à une IA

Transparence totale d’abord : ce site est construit et maintenu avec Claude Code, l’agent IA en ligne de commande d’Anthropic. Pas « assisté par IA » au sens marketing — l’agent écrit du code, lance les builds, déploie sur Cloudflare, et se fait relire comme n’importe quel collègue. À l’utiliser quotidiennement, on apprend ce qui sépare vraiment le gadget de l’outil. Le plus grand séparateur a un nom : les skills.

C’est quoi, un skill

Un skill est un dossier contenant un fichier SKILL.md : un court frontmatter (nom + description de quand l’utiliser), puis des instructions, éventuellement accompagnées de scripts et de fichiers de référence. On le pose dans .claude/skills/ du projet (ou de son répertoire personnel), et l’agent le charge à la demande — seulement quand une tâche correspond à la description.

Ce dernier point compte. L’agent ne trimballe pas tout votre wiki à chaque requête ; il découvre que le skill existe, et ne charge les instructions complètes que lorsqu’elles sont pertinentes. Anthropic appelle ça la divulgation progressive. En pratique : on peut accumuler des dizaines de playbooks sans noyer le modèle.

Pourquoi c’est mieux que « mieux prompter »

Un prompt est une conversation ; un skill est de l’infrastructure :

• Répétable. La checklist de migration s’exécute de la même façon en mars et en novembre, quel que soit celui qui tape.
• Versionné. Les skills vivent dans git, à côté du code qu’ils manipulent. Ils passent en revue de PR comme le reste.
• Partagé. Un junior équipé des skills de l’équipe hérite de la façon de travailler de l’équipe — et l’agent aussi.
• Composable. Un skill peut invoquer vos scripts ; un script, lui, n’hallucine pas.

Si vous avez déjà écrit un CONTRIBUTING.md que personne ne lit, les skills sont ce document — sauf que quelqu’un le lit enfin, à chaque fois.

Ce que j’encode en skills (édition Drupal)

Des exemples concrets tirés de ma pratique :

1. La méthode de migration Drupal 10 → 11. La séquence exacte de mon guide de migration — audit Upgrade Status, vérification des environnements, nettoyage avant montée, Rector, tri de la contrib, checklist SEO de bascule. L’agent suit les mêmes étapes que celles que je facture, et signale ce qui exige une décision humaine.
2. Les conventions de revue de code. Ce que « fini » veut dire dans mes projets : cache tags sur chaque bloc custom, pas de \Drupal:: dans les services, sémantique d’accessibilité, hygiène des update paths. L’agent passe les diffs au crible avant même que je regarde.
3. Les runbooks de déploiement. L’ordre des opérations pour la stack d’un client donné — build, import de config, tests de fumée, chemin de rollback. Un runbook dans un tiroir ne sauve personne ; un runbook en skill s’exécute.
4. Les règles de contenu de ce site. Longueurs de title/description, règles d’appariement hreflang, ton. L’article que vous lisez est passé au travers.

Un exemple minimal

---
name: drupal-security-update
description: Appliquer les mises à jour de sécurité Drupal core/contrib
  proprement. À utiliser quand une alerte de sécurité doit être appliquée.
---

1. Vérifier la gravité de l'alerte ; critique + distant = fenêtre le jour même.
2. `composer update` des seuls paquets concernés — jamais de mise à jour globale.
3. `drush updb && drush cr`, puis lancer le script de fumée (./scripts/smoke.sh).
4. Déployer via la CI comme n'importe quelle version. Jamais en dehors du pipeline.
5. Poster le diff et le lien de l'alerte dans la description de la PR.

Douze lignes, et l’agent gère désormais les mercredis sécurité comme moi — y compris la partie où il refuse de contourner la CI.

Les réserves honnêtes

Les skills ne rendent pas l’agent infaillible ; ils le rendent constant. On relit toujours les diffs. On garde les secrets hors de portée et les permissions minimales. Et un skill qui encode un mauvais process exécute juste le mauvais process plus vite — la valeur de l’outil est exactement celle de la pratique qu’on lui donne.

C’est aussi pourquoi c’est un jeu de développeur senior, pas son remplacement : les skills qui valent la peine d’être écrits, c’est le discernement qu’on a déjà.

Curieux de voir ce que ça donne appliqué à une équipe Drupal — ou envie de transformer vos playbooks en quelque chose qu’un agent sait exécuter ? Parlons-en.