Utiliser des agents IA pour automatiser les tâches répétitives d'un projet

La façon la plus rapide d’arrêter de réexpliquer votre projet à un agent IA est de capturer la recette une bonne fois pour toutes sous forme de Claude Code skill — un répertoire contenant un fichier SKILL.md, versionné dans votre dépôt, que l’agent consulte au lieu de redécouvrir comment lancer, initialiser ou déployer votre application.

Quiconque a regardé un agent passer dix minutes à redécouvrir que l’application ne démarre pas sans une base de données initialisée et un fichier env copié connaît ce sentiment. Vous avez expliqué ces étapes exactes la semaine dernière, et la semaine d’avant. Cet article présente le modèle concret : en quoi une skill diffère d’un script npm, où vit une skill à portée de projet, et un exemple fonctionnel qui permet de lancer votre application depuis un checkout propre et de la vérifier. La thèse est simple : cessez d’écrire des scripts ponctuels que vous oublierez, et livrez une skill d’agent à portée de projet que toute votre équipe et l’agent partagent.

Le vrai coût des scripts npm oubliables et des documentations d’installation obsolètes

La partie coûteuse d’un processus d’installation périmé, ce n’est pas la commande cassée : c’est qu’un humain ou l’agent redérive la recette à chaque fois. Un package.json accumule des entrées cryptiques (predev:seed, db:reset:ci, start:tunnel) dont l’ordre et les prérequis ne vivent que dans la tête d’un seul ingénieur. La section « Getting Started » du README se désynchronise dès qu’on ajoute une variable d’environnement sans penser à la documenter. Les nouveaux contributeurs devinent ; l’agent IA devine aussi, et tous devinent différemment.

Une skill règle ce problème en enregistrant la procédure là où l’agent cherche déjà. La documentation officielle de Claude Code formule précisément le déclencheur pour en créer une : créez une skill lorsque vous collez sans cesse les mêmes instructions, listes de contrôle ou procédures en plusieurs étapes dans le chat, ou lorsqu’une section de CLAUDE.md a évolué vers une procédure plutôt que vers un simple fait.

Quelle est la différence entre un script et une skill ?

Utilisez un script pour les étapes qui ne doivent jamais varier, et une skill pour les étapes qui nécessitent une interprétation. Un script npm exécute des commandes fixes dans une séquence prédéterminée ; une skill utilise le modèle pour lire le contexte, gérer la variabilité et décider quoi faire ensuite, puis reconfie les parties déterministes au code. Les deux sont complémentaires, non concurrents.

L’équipe d’ingénierie d’Anthropic plaide pour le maintien du travail déterministe dans le code : certaines opérations sont mieux adaptées à l’exécution de code traditionnel, car trier une liste via la génération de tokens est plus lent et moins fiable que d’exécuter un algorithme de tri, et de nombreux workflows ont besoin de la répétabilité que seul le code offre. De manière cruciale, un script intégré reste économique en termes de contexte : les agents disposant d’un système de fichiers et d’outils d’exécution de code n’ont pas besoin de lire l’intégralité d’une skill dans leur fenêtre de contexte, ce qui signifie que la quantité de contexte pouvant être intégrée dans une skill est effectivement illimitée.

Qu’est-ce qu’une Claude Code skill, et où vit-elle ?

Une Claude Code skill est un répertoire contenant un fichier SKILL.md dont le frontmatter YAML indique à l’agent quand l’utiliser. Selon la présentation des Agent Skills, chaque skill regroupe des instructions, des métadonnées et des ressources optionnelles (scripts, templates) que Claude utilise automatiquement lorsque c’est pertinent. C’est le bon modèle mental : une skill est un répertoire, pas un simple fichier de commande.

L’emplacement détermine la portée. Les skills de projet se chargent depuis .claude/skills/ dans votre répertoire de départ et dans les répertoires parents jusqu’à la racine du dépôt, de sorte qu’un agent travaillant n’importe où dans le projet verra la skill comme disponible, et elle se charge automatiquement lorsque la requête correspond à sa description. Les skills personnelles vivent dans ~/.claude/skills/. Pour Claude Code spécifiquement, seule la description est recommandée ; name est optionnel et prend par défaut le nom du répertoire, qui est aussi ce que vous tapez après /.

Les éléments constitutifs sont faciles à confondre, alors choisissez délibérément :

• Skill : un répertoire + SKILL.md, avec des scripts optionnels intégrés. Découverte automatiquement via sa description et invocable avec /skill-name. Fonctionne également dans Claude.ai et Claude Desktop, de sorte qu’une équipe peut la partager au-delà du terminal.
• Slash command : historiquement un seul fichier .md dans .claude/commands/. Les commandes personnalisées ont été fusionnées avec les skills : un fichier à .claude/commands/deploy.md et une skill à .claude/skills/deploy/SKILL.md créent tous les deux /deploy et fonctionnent de la même façon. En cas de collision de noms, la skill l’emporte.
• Subagent : un fichier .md dans .claude/agents/ qui s’exécute dans sa propre fenêtre de contexte et renvoie un résultat condensé. Utilisez-le lorsqu’une tâche est suffisamment gourmande en lecture pour polluer votre thread principal.

Exemple concret : capturer « lancer depuis un checkout propre et vérifier »

Transformez votre rituel d’installation en une skill versionnée. Créez .claude/skills/run-app/SKILL.md avec une description suffisamment précise pour que l’agent la reconnaisse, la sortie des commandes injectée en amont, et des étapes numérotées :

---
name: run-app
description: Get this app running from a clean checkout and verify it boots. Use when setting up the project, onboarding, or checking the app still starts after a change.
allowed-tools: Bash(npm *) Bash(./scripts/verify.sh *)
---

## Environment
```!
node --version
npm --version
```

## Steps
1. Install dependencies with `npm ci`.
2. If `.env` is missing, copy `.env.example` to `.env`; ask before overwriting.
3. Start the app with `npm run dev`.
4. Run `./scripts/verify.sh` and report PASS or FAIL.

Expected output: a single PASS/FAIL line and the local URL the app serves on.

Le bloc ```! utilise l’injection de contexte dynamique : Claude Code exécute ces commandes et intègre la sortie avant que l’agent ne lise la skill, de sorte que la recette arrive ancrée dans votre chaîne d’outils réelle, et non dans une supposition. Demandez « lance l’application » et l’agent charge la skill à partir de sa description ; tapez /run-app pour la forcer.

Claude Code propose également ce modèle exact sous forme de skill intégrée. /run-skill-generator lance votre application depuis un environnement propre, capture ce qui a fonctionné (les commandes d’installation, les variables d’environnement, le script de démarrage), et le commite en tant que skill par projet dans .claude/skills/run-<name>/. Ensuite, /run, /verify et tout autre agent dans le dépôt suivent la recette enregistrée au lieu de la redécouvrir. /run, /verify et /run-skill-generator nécessitent Claude Code v2.1.145 ou ultérieur.

Rendre les skills fiables, puis les commiter

Gardez chaque skill atomique et énoncez explicitement la sortie attendue : une skill, une tâche, un résultat clairement défini que vous pouvez examiner dans une pull request. Des instructions vagues produisent de la dérive ; un format de sortie défini maintient la cohérence des exécutions et sécurise l’analyse en aval.

Poussez les étapes immuables dans un scripts/verify.sh intégré et laissez le corps du SKILL.md gérer l’interprétation : signaler pourquoi la vérification a échoué, repérer une variable d’environnement manquante. C’est cette séparation qui rend le workflow répétable plutôt que probabiliste.

Soyez honnête sur la vraie limitation : l’auto-invocation dépend entièrement de la description, et elle ne se déclenche pas toujours. La première étape de dépannage de la documentation est de vérifier que la description inclut des mots-clés que les utilisateurs diraient naturellement. Lorsque vous avez besoin d’un déclenchement manuel garanti (tout ce qui a des effets de bord), définissez disable-model-invocation: true pour que la skill ne s’exécute que lorsque vous tapez /name.

Commitez ensuite .claude/skills/ dans le contrôle de version. Cet acte unique boucle la boucle : la recette devient versionnée, révisable et partagée, de sorte que le prochain contributeur et la prochaine session d’agent héritent d’une procédure fonctionnelle au lieu d’en reconstruire une. Les skills sont disponibles dans Claude.ai, Claude Code et l’API, et selon la documentation d’assistance d’Anthropic, elles sont également en bêta pour les utilisateurs de Claude Code et pour tous les utilisateurs de l’API utilisant l’outil d’exécution de code, de sorte qu’une skill de projet commitée voyage avec le dépôt plutôt que de vivre dans l’historique shell d’une seule personne.

Commencez par votre tâche la plus répétée (le démarrage depuis un checkout propre, le changelog de release, l’initialisation et la réinitialisation) : rédigez son SKILL.md, intégrez la partie déterministe sous forme de script, et commitez-la. La prochaine fois que quelqu’un (ou l’agent) aura besoin de cette recette, elle sera déjà enregistrée.

FAQ

Puis-je encore invoquer une Claude Code skill manuellement, ou se déclenche-t-elle uniquement automatiquement ?

Vous pouvez faire les deux. Par défaut, vous et Claude pouvez invoquer n'importe quelle skill : tapez /skill-name pour l'exécuter directement, et Claude peut la charger automatiquement lorsque sa description correspond à votre requête. Les anciens guides affirmant que les skills ne peuvent pas être exécutées manuellement sont obsolètes. Si vous souhaitez un comportement manuel uniquement pour une skill avec des effets de bord, définissez disable-model-invocation à true pour qu'elle ne se déclenche que lorsque vous tapez son nom.

Que se passe-t-il lorsqu'une slash command et une skill partagent le même nom ?

La skill a la priorité. Les commandes personnalisées ont été fusionnées avec les skills : un fichier à .claude/commands/deploy.md et une skill à .claude/skills/deploy/SKILL.md créent tous les deux la même commande /deploy et fonctionnent de manière identique. Lorsque les deux existent sous le même nom, Claude Code charge la skill plutôt que le fichier de commande, il n'est donc pas nécessaire de maintenir les deux pour une seule commande.

Un script intégré dans une skill consomme-t-il des tokens de fenêtre de contexte ?

Non. Lorsque les instructions d'une skill référencent un script exécutable, Claude l'exécute via bash et ne reçoit que la sortie ; le code du script lui-même n'entre jamais dans la fenêtre de contexte. C'est pourquoi intégrer le travail déterministe sous forme de script est moins coûteux et plus fiable que de demander au modèle de le raisonner, et pourquoi les ressources qu'une skill peut intégrer sont effectivement illimitées en taille.

Dois-je payer pour un abonnement afin d'utiliser les Claude Code skills ?

Non. Selon la documentation d'assistance d'Anthropic, les skills sont disponibles sur les plans Free, Pro, Max, Team et Enterprise, et la fonctionnalité nécessite que l'exécution de code soit activée. Dans Claude Code spécifiquement, les skills sont disponibles en bêta, et elles fonctionnent également pour tous les utilisateurs de l'API utilisant l'outil d'exécution de code. Les détails de disponibilité changent souvent, vérifiez donc la documentation d'assistance actuelle d'Anthropic.