Personne ne vous prévient que les prompts ne passent pas à l'échelle. Vous en rédigez un parfait, il fonctionne une fois, puis il s'évapore dès que vous fermez l'onglet. Les agent skills corrigent ça. Un skill, c'est un dossier réutilisable et versionné que votre agent charge à la demande : écrivez-le une fois, et Claude Code comme Codex l'exécutent. Plutôt que d'aligner cinquante idées d'une ligne, cet article construit les huit skills qui valent la peine d'exister en premier, chacun avec la vraie syntaxe SKILL.md et l'invocation qui le déclenche. Une bibliothèque courte que vous livrez vraiment vaut mieux qu'une longue que vous n'écrirez jamais.
Ce qui justifie d'apprendre ça comme un standard et non comme une astuce : les skills sont multi-fournisseurs. Anthropic a introduit les Agent Skills et OpenAI a ajouté les skills à Codex sur le même format. Même dossier, plusieurs agents — un skill écrit aujourd'hui survit donc au harnais que vous utilisez cette semaine, quel qu'il soit.
Ce qu'est un skill, et en quoi il diffère d'un prompt
Un skill est un répertoire contenant un seul fichier obligatoire : SKILL.md. Ce fichier contient un en-tête YAML — au minimum un name et une description — puis des instructions en langage clair. Il peut embarquer des dossiers voisins : scripts/ pour du vrai code, references/ pour de la documentation approfondie et assets/ pour des gabarits. Un exemple minimal :
---
name: invoice-chaser
description: Draft polite payment-reminder emails for overdue invoices, escalating tone by days late. Trigger on "chase overdue invoices".
---
Read the overdue-invoice CSV. For each row, draft an email that names the
invoice, the amount, and the days overdue, with tone set by how late it is.
Un prompt, c'est ce que vous tapez. Un skill, c'est ce que votre agent possède. Trois différences comptent :
- Les skills persistent et se versionnent. Ils vivent dans git, passent en revue et voyagent avec votre dépôt. Votre historique de prompts, lui, ne suit pas.
- Les skills exécutent du code, pas seulement du texte. Un skill peut embarquer un script qui remplit un formulaire PDF ou remet en forme un tableur — une chose qu'un modèle ne peut pas faire de façon fiable en y « réfléchissant ».
- Les skills se chargent par divulgation progressive. L'agent ne voit d'abord que le nom et la description de chaque skill, et ne lit le contenu complet que lorsqu'une tâche correspond. Une étagère de skills ne gonfle donc pas votre contexte ; cette sobriété, c'est tout l'intérêt.
C'est aussi pourquoi la description porte tout le poids. C'est le seul texte que l'agent lit pour décider de déclencher ou non un skill. Description floue, skill jamais déclenché.
Comment Claude Code et Codex utilisent les skills
Claude Code découvre les skills sur le système de fichiers : déposez un dossier dans votre répertoire de skills et c'est en ligne, sans étape d'upload. Codex offre deux modes d'invocation, explicite (/skills ou $skill-name) et implicite, où il sélectionne automatiquement selon votre tâche. Comme les deux lisent la même structure de dossier, un skill bien écrit passe de l'un à l'autre presque sans modification.
Un cadrage à bien intégrer : préférez les skills à MCP pour la connaissance procédurale. Les skills sont basés sur le système de fichiers, versionnés dans git et sans serveur — bien moins de surcharge que de monter un serveur MCP. MCP reste gagnant pour les données live et les connexions système. Les skills gagnent pour les workflows réutilisables. Choisissez le bon outil au lieu de faire du cargo-cult avec l'un ou l'autre.
Huit skills à créer en premier
Chacun est portable, et chacun montre le SKILL.md plus la ligne qui l'invoque. Commencez par les deux ou trois qui collent le plus à votre semaine réelle.
1. Rédacteur de commits conventionnels.
---
name: commit-msg
description: Write a Conventional Commits message from the staged diff. Trigger on "write a commit message".
---
Read the staged diff. Output one line: type(scope): summary, then a short body
explaining why, not what. Types: feat, fix, chore, docs, refactor, test.
Invocation : $commit-msg après le staging, ou « rédige un message de commit pour ces changements ».
2. Description de PR à partir d'un diff. Transforme le diff d'une branche en résumé titré, liste de risques et checklist de plan de test. S'invoque avec « ouvre une PR pour cette branche ». La valeur, c'est un gabarit cohérent auquel vos relecteurs peuvent se fier.
3. Échafaudage de tests à partir d'une signature. À partir d'une fonction, il écrit le cas nominal, un cas limite et un cas d'échec, puis s'arrête plutôt que d'inventer un comportement qu'il ne peut pas voir. Invocation : « échafaude les tests de cette fonction ».
4. Garde-fou de voix de marque.
---
name: brand-voice
description: Rewrite a draft to match our tone rules. Trigger on "make this on-brand".
---
Apply these rules: short sentences, concrete nouns, no hype words. Keep claims
that have a number or a source; cut claims that do not. Return the edit only.
Écrivez les règles une fois, et chaque rédaction s'y conforme sans que vous ayez à vous réexpliquer.
5. Changelog à partir des commits. Lit l'historique des commits depuis le dernier tag et rédige des notes de version regroupées en Added, Fixed, Changed. Invocation : « rédige le changelog depuis v1.2.0 ».
6. Capture d'écran vers rapport de bug. Prend une image plus une plainte d'une ligne et produit des étapes de reproduction, un attendu-versus-observé et une première hypothèse d'erreur. S'invoque en joignant la capture et en disant « enregistre ça comme bug ».
7. Répondeur de macros pour le support client. Classe un message entrant, rédige une réponse dans votre voix de marque et signale tout ce qui exige un humain. Tout en Markdown, aucun code requis. Invocation : « trie ce ticket et rédige une réponse ».
8. Le méta-skill : skill-creator. Un skill qui vous interviewe sur un workflow et échafaude le dossier du skill suivant. C'est ainsi que la bibliothèque grandit sans que vous écriviez du YAML à la main à chaque fois.
Pour les fondateurs non techniques, commencez par le garde-fou de voix de marque et le répondeur support. Pour les développeurs, le rédacteur de commits, la description de PR et l'échafaudage de tests font leurs preuves la semaine même où vous les écrivez.
Liste de vérification : sécurité et revue
Les skills exécutent du code : un mauvais skill est donc un risque de chaîne d'approvisionnement. Traitez-le comme une dépendance :
- Auditez tout ce qui provient d'une source non fiable. Lisez le
SKILL.mdet chaque fichier descripts/avant d'installer. - Gardez les instructions sobres. Surcharger un seul
SKILL.mdcasse la divulgation progressive ; poussez le matériel approfondi dansreferences/. - Rédigez une
descriptiontranchante. C'est le déclencheur ; une faible signifie que le skill ne se déclenche jamais, en silence. - Construisez avec une éval. Partez d'un test de ce à quoi ressemble le « bon » résultat, itérez avec l'agent, puis élaguez.
- Concevez pour la portabilité. C'est un standard ouvert ; coder en dur les hypothèses d'un seul fournisseur jette aux orties l'avantage principal.
Gardez la bibliothèque
Sauvegardez les skills que vous créez comme un ensemble versionné dans le Command Center, pour que votre méthode devienne un actif que vous réutilisez plutôt qu'un prompt que vous retapez.
Sources et lectures complémentaires
- Anthropic : Equipping agents for the real world with Agent Skills
- OpenAI Codex : Agent Skills
- Anthropic : documentation Claude Code
FAQ
Une étagère de skills va-t-elle saturer ma fenêtre de contexte ? Non. La divulgation progressive fait que l'agent ne voit d'abord que les noms et les descriptions, et ne charge un skill complet qu'à la demande — un skill inactif ne vous coûte presque rien.
Faut-il être développeur pour écrire un skill ?
Non. Le skill le plus simple est un SKILL.md avec un en-tête et des instructions en langage clair. Utilisez un skill-creator ou un flux d'enregistrement-relecture pour en générer un à partir d'une démonstration que vous faites.
Un skill, c'est pareil qu'un serveur MCP ? Non. Les skills sont des workflows procéduraux basés sur le système de fichiers qui vivent dans git. MCP se connecte à des systèmes et des données en direct. Utilisez les skills pour la connaissance « comment faire » répétable, MCP pour les connexions temps réel — et souvent les deux.
Où placer un skill pour que mon agent le trouve ?
Dans le répertoire de skills de votre agent, sous forme de dossier nommé contenant SKILL.md. Claude Code et Codex découvrent tous deux les skills sur le système de fichiers, et c'est pourquoi le même dossier fonctionne d'un fournisseur à l'autre.