Si vous avez déjà recollé pour la centième fois la même charte éditoriale, la même checklist de déploiement ou les mêmes consignes « voici exactement comment je veux que ce soit fait » dans ChatGPT ou Claude, les agent skills sont la solution. Un agent skill, c'est un dossier organisé d'instructions, de scripts et de ressources qu'un agent IA peut découvrir et charger tout seul pour mieux accomplir une tâche précise. Vous écrivez le workflow une seule fois ; l'agent le réutilise dès qu'il est pertinent. Que vous cherchiez à coder avec l'IA (le vibe coding), à monter une agence d'automatisation IA ou simplement à créer une entreprise avec l'IA sans être développeur, ce guide explique ce que sont les skills IA, en quoi ils diffèrent des prompts, comment Claude Code et Codex les utilisent, et comment bâtir une petite librairie qui devient rentable en une semaine.
Ce qu'est un agent skill
La définition d'Anthropic reste la référence : les agent skills sont des « dossiers organisés d'instructions, de scripts et de ressources que les agents peuvent découvrir et charger dynamiquement ». Au minimum, un skill, c'est un répertoire contenant un seul fichier : SKILL.md.
Ce fichier est du Markdown ordinaire avec un court en-tête YAML. L'en-tête exige exactement deux champs — name et description — et le corps Markdown contient le workflow lui-même :
---
name: pdf-form-filler
description: Fill out PDF forms when a user uploads a fillable PDF and asks to complete it. Do NOT use for scanned image PDFs.
---
1. Read the uploaded PDF and list every form field.
2. Map the user's answers to those fields.
3. Write the filled PDF and return it.
La ligne description fait tout le travail de fond. Un agent décide de charger un skill en comparant la tâche qu'il a sous les yeux à cette description ; elle doit donc dire clairement quand le skill doit se déclencher — et quand il ne le doit pas. Une description floue est de loin la première raison pour laquelle un skill ne se déclenche jamais, ou se déclenche au mauvais moment.
Les skills transportent bien plus que du texte. Un dossier de skill peut embarquer scripts/, references/ et assets/. L'exemple standard d'Anthropic est un skill PDF qui livre un script Python pour lire un formulaire et en extraire les champs. L'agent exécute le script via bash et ne récupère que la sortie — le code source du script n'entre jamais dans la fenêtre de contexte. C'est là le véritable écart entre un skill et des instructions collées : un skill emballe un outillage qui fonctionne, pas seulement du texte.
En quoi les skills diffèrent des prompts (et de la mémoire)
Un prompt est une instruction ponctuelle que vous tapez et retapez. Un skill est une procédure réutilisable et versionnée que l'agent va chercher de lui-même au moment opportun. Ce qui rend cela peu coûteux, c'est la divulgation progressive (progressive disclosure) — trois niveaux de chargement paresseux :
- Niveau 1, au démarrage. L'agent ne charge que le
nameet ladescriptionde chaque skill. C'est minuscule, donc une grosse librairie ne coûte presque rien. (Codex plafonne les descriptions de skills à environ 2 % de la fenêtre de contexte.) - Niveau 2, pertinence. Si l'agent juge un skill pertinent, il lit l'intégralité du corps de
SKILL.md. - Niveau 3, à la demande. Les fichiers de référence liés — un schéma, un
reference.md— ne se chargent que si la tâche les atteint vraiment.
Une affirmation d'Anthropic découle directement de cette conception : parce que le détail ne se charge qu'à l'usage, « la quantité de contexte qu'on peut regrouper dans un skill est de fait illimitée ». Un skill que vous ne déclenchez jamais dans une session ne vous coûte quasiment rien.
Voici la distinction que les lecteurs confondent le plus : les skills ne sont pas de la mémoire. La doc du Hermes Agent le dit clairement — « la mémoire stocke de petits faits durables qui doivent toujours être en contexte, tandis que les skills stockent des procédures plus longues qui ne doivent se charger que lorsqu'elles sont pertinentes ». La raison sociale de votre entreprise est un fait (mémoire, ou une ligne de CLAUDE.md). Votre processus de release en sept étapes est une procédure (un skill). Gardez les deux séparés.
Comment fonctionnent les skills dans Claude Code
Dans Claude Code, les slash commands personnalisées ont été fusionnées avec les skills, si bien que les deux tournent désormais sur la même mécanique. Un fichier .claude/commands/deploy.md et un skill .claude/skills/deploy/SKILL.md créent tous deux une commande /deploy.
L'endroit où vous placez le dossier définit sa portée :
- Skills personnels :
~/.claude/skills/— disponibles dans tous vos projets, pour vous seul. - Skills de projet :
.claude/skills/— committés dans git et partagés avec toute l'équipe.
Vous pouvez lancer un skill Claude Code directement en tapant /skill-name, ou laisser Claude le déclencher automatiquement en faisant correspondre la tâche à la description. Claude Code suit le standard ouvert Agent Skills et l'étend avec un contrôle d'invocation, l'exécution par sous-agents et l'injection dynamique de contexte. Anthropic maintient un catalogue public d'exemples réels sur github.com/anthropics/skills si vous voulez étudier des SKILL.md qui fonctionnent.
Comment fonctionnent les skills dans Codex
OpenAI a ajouté les skills à Codex fin 2025 ; Simon Willison a documenté leur apparition à la fois dans le Codex CLI et dans ChatGPT le 12 décembre 2025. Dans Codex, on invoque un skill explicitement en tapant $skill-name, ou on laisse Codex en faire correspondre un pour vous.
Codex scanne plusieurs emplacements par ordre de priorité — en gros : le .agents/skills du dossier courant, puis le .agents/skills à la racine du dépôt, puis votre $HOME/.agents/skills au niveau utilisateur, puis un chemin admin, puis les skills intégrés. Une mise en garde honnête : la convention de chemins est encore en train de se stabiliser. Les premières versions de Codex utilisaient ~/.codex/skills ; la doc actuelle pointe vers .agents/skills. Vérifiez la doc Codex en ligne (developers.openai.com/codex/skills) pour le chemin exact avant de figer vos dossiers.
L'info qui compte pour les builders : les skills de Claude Code et ceux de Codex visent le même standard ouvert (agentskills.io). Un skill est, selon les mots de Willison, « juste un dossier avec un fichier Markdown et quelques ressources optionnelles » ; il est donc partageable, versionnable et réutilisable entre outils et coéquipiers, au lieu d'être verrouillé à un seul fournisseur. Soyez précis sur la limite, cependant. Les deux implémentations sont proches, mais chaque outil ajoute ses propres extensions. Traitez les skills comme largement portables sur un standard partagé, pas comme des copier-coller garantis à l'octet près.
Un exemple de librairie de skills
Voici une librairie de départ qui devient vite rentable. Chaque élément est un dossier avec un SKILL.md.
brand-voice— capture votre ton, vos mots interdits et vos règles de signature une bonne fois. Chaque landing page, courriel ou brouillon de publication sort à votre image, sans recoller la charte éditoriale. C'est le « définissez vos préférences une fois, réutilisez-les automatiquement » rendu concret.pdf-form-filler— l'exemple maison d'Anthropic : déposez un contrat fournisseur ou une facture et l'agent remplit chaque champ via un script embarqué. Vous voyez un document fini, jamais de code.deploy— committez.claude/skills/deploy/SKILL.mddans le dépôt et n'importe quel coéquipier (ou l'IA elle-même) exécute la même checklist de release avec/deploy. La connaissance tribale devient un workflow partagé et versionné.rapport-hebdo— récupère vos métriques standard, les met en forme à votre façon, chaque lundi, à l'identique.
Cas d'usage business pour fondateurs non techniques
Pas besoin de savoir lire du code pour en tirer de la valeur. Les skills, c'est l'étape où le vibe coding — terme retenu par Merriam-Webster en 2025 pour désigner le fait de bâtir un logiciel en décrivant ce qu'on veut et en laissant l'IA le produire — gagne en maturité. Au lieu de redécrire le même workflow à chaque session, vous l'encodez une fois pour que l'agent l'exécute de façon fiable. C'est aussi de là que naissent les meilleures idées business IA :
- Du contenu à votre image, à grande échelle. Un skill
brand-voicegarde chaque actif rédigé par l'IA cohérent, et vous cessez d'être le goulot d'étranglement qui relit le ton. Imaginez un studio à Montréal qui produit ses infolettres bilingues sans repasser derrière chaque phrase. - Des opérations répétables. Courriels d'onboarding, mises à jour aux investisseurs, macros de support — tout ce que vous faites de la même manière à chaque fois devient un skill que toute l'équipe (et l'agent) exécute de la même façon. Une PME en Belgique peut ainsi standardiser ses devis générés par l'IA.
- Transformer le savoir-faire d'un prestataire en actif. Quand un développeur ou un profil ops documente un processus sous forme de skill, cette connaissance reste dans le dépôt même après son départ.
Cas d'usage pour développeurs
Pour les builders, les skills s'installent directement au cœur du codebase :
- Les conventions du code à portée de main. Un skill qui encode votre pattern de tests, votre format de message de commit ou vos étapes de migration fait suivre le style maison par les agents IA sans re-prompter.
- De l'outillage embarqué. Livrez un dossier
scripts/pour que l'agent exécute du vrai code — un linter, un générateur, une vérif de données — et ne lise que la sortie, ce qui garde la fenêtre de contexte propre. - Des agents qui s'améliorent seuls. Le Hermes Agent de Nous Research (open source, MIT, sorti en 2026) écrit ses propres skills via un outil
skill_manage, en les traitant comme de la « mémoire procédurale ». Quand il met au point un workflow non trivial ou qu'un utilisateur le corrige, il met l'approche en banque sous forme de skill réutilisable. (Dites « Hermes Agent » ou « Nous Hermes » pour éviter la confusion avec la marque de luxe.) C'est un avant-goût des agents qui apprennent et réutilisent leurs workflows tout seuls.
Checklist de sécurité et de relecture
Les skills rendent le travail répétable, pas infaillible. Les recommandations « people-first » de Google récompensent toujours l'expérience réelle et le jugement humain — et vous devriez faire de même. Avant de faire confiance à un skill :
- Affûtez la
description. Indiquez quand il se déclenche et quand il ne doit surtout pas. Mettez les mots déclencheurs en tête pour que l'agent le choisisse correctement. - Gardez
SKILL.mdléger. La règle empirique d'Anthropic : moins de 500 lignes. Poussez le détail dans des fichiers de référence liés pour que la divulgation progressive joue son rôle — ne tassez pas tout dans un seul fichier géant. - Séparez les skills des faits. Les faits durables vont dans la mémoire ou dans
CLAUDE.md; les procédures à plusieurs étapes vont dans un skill chargé à la demande. - Relisez les scripts embarqués. Tout code qu'un skill exécute mérite la même rigueur que le code que vous avez écrit vous-même.
- Ne présumez pas du copier-coller entre outils. Même standard, mais vérifiez qu'un skill Claude Code se comporte comme prévu dans Codex, et inversement, plutôt que de supposer une exécution identique.
- Ne codez pas en dur des chemins périmés. Les conventions bougent encore (Codex
~/.codex/skills→.agents/skills) ; pointez vers la doc à jour. - Gardez un humain dans la boucle. Les skills suppriment la répétition, pas la responsabilité.
FAQ
Faut-il savoir coder pour utiliser les agent skills ?
Non. Un SKILL.md est du Markdown ordinaire — des instructions en mots. Vous pouvez écrire un skill brand-voice ou rapport-hebdo utile sans toucher au code. Les scripts sont optionnels et généralement ajoutés par un développeur.
Un skill que j'écris pour Claude Code marchera-t-il aussi dans Codex ? En grande partie. Les deux visent le même standard ouvert Agent Skills, donc le cœur est portable. Mais chaque outil ajoute des extensions : testez-le dans le second outil plutôt que de supposer une correspondance à l'octet près.
Quelle est la différence entre un skill et la mémoire ? La mémoire retient de petits faits durables qui doivent toujours être en contexte, comme le nom de votre produit. Un skill retient une procédure plus longue qui ne se charge que lorsqu'elle est pertinente, comme votre checklist de déploiement. Les faits restent actifs ; les skills se chargent à la demande.
En quoi est-ce différent d'écrire simplement un très bon prompt ? Un prompt est ponctuel et manuel. Un skill est sauvegardé, versionné, découvert automatiquement par l'agent, et capable d'embarquer scripts et fichiers de référence — le même workflow tourne donc de façon fiable à chaque session sans que vous ayez à le retaper.
À lire aussi sur Boostor : créer des skills pour Claude Code, concevoir des agents IA pour son business, et une intro au vibe coding pour fondateurs non techniques.