Mis à jour le 12 octobre 2026 : outils compatibles, où ranger le fichier dans Claude, Claude Code et Codex, FAQ
En bref. Une skill est un dossier qui contient un fichier SKILL.md : un nom, une description qui dit quand l’utiliser, puis ta méthode écrite en Markdown. Le format est un standard ouvert, lu en octobre 2026 par Claude, Claude Code, Codex, Cursor, GitHub Copilot ou Gemini CLI. Tu l’écris une fois, ton agent la charge seulement quand la tâche correspond, et tu la testes sur 3 cas avant de t’y fier
Pour créer une skill, choisis une tâche que ton agent sait déjà réaliser, écris sa méthode dans un fichier SKILL.md, puis teste-la sur plusieurs entrées différentes
Le bénéfice arrive au deuxième usage : tu retrouves une procédure, un format de résultat et des critères de contrôle sans refaire tout le brief
Prends une tâche très ordinaire : extraire les décisions d’un compte rendu de réunion
La première fois, tu expliques de citer les passages, de séparer une proposition d’une décision et de signaler les responsables manquants. La semaine suivante, tu recommences. Une skill permet de garder ces règles au même endroit
Ce que contient une skill
Le format Agent Skills rassemble des instructions et, si nécessaire, des ressources utilisables par un agent compatible
Dans la spécification du format, le minimum est un dossier contenant SKILL.md. Le fichier commence par un nom et une description, puis donne la méthode en Markdown. Des scripts, références et modèles peuvent compléter le dossier
Anthropic a créé ce format pour Claude, puis l’a publié comme standard ouvert le 18 décembre 2025. La vitrine officielle des outils compatibles en recense aujourd’hui des dizaines : une skill bien écrite te suit si tu changes d’agent
Commence avec ce minimum. Un script devient utile lorsqu’une partie du travail exige un calcul ou une transformation reproductible. Une référence devient utile lorsque son contenu sert réellement à la tâche
La skill décrit comment travailler. Les connecteurs et le protocole MCP donnent accès à des outils ou à des données. Tu peux avoir une excellente procédure sans accès au fichier nécessaire ; l’agent doit alors signaler ce manque
Choisir une tâche assez précise
« Aide-moi dans mon travail » demande trop de décisions implicites
« Extrais les décisions et les actions d’un compte rendu fourni » donne une entrée, une transformation et une sortie contrôlables
Avant d’écrire le fichier, réponds à quatre questions :
Quelle entrée dois-je fournir ?
Quel résultat dois-je retrouver ?
Quelles erreurs dois-je pouvoir détecter ?
Quelles actions dépassent la mission ?
Dans notre exemple, l’entrée est un compte rendu, le résultat est une liste sourcée et l’erreur critique serait de transformer une idée évoquée en engagement pris
Le cas suivant est un exemple pédagogique. Il ne contient aucune réunion ni donnée client réelle
Un exemple complet de SKILL.md
Crée un dossier nommé extraire-decisions-reunion contenant ce fichier :
La description précise quand utiliser cette compétence. Le corps indique le résultat attendu et les erreurs à éviter. Le lecteur peut comprendre la méthode sans connaître le système qui exécutera le fichier
Pour la faire écrire par ton agent, tu peux aussi lui demander :
Transforme notre méthode de suivi de réunion en skill compatible avec mon outil. Garde les sources, les inconnues et les limites d’action. Montre-moi le fichier avant installation et explique comment vérifier qu’il est bien chargé
La rendre disponible dans ton outil
Le chemin d’installation dépend de l’application. Vérifie la documentation de ton agent plutôt que de copier un emplacement prévu pour un autre produit
Voici où se range une skill dans les 3 outils les plus utilisés, d’après leur documentation au 12 octobre 2026
Outil | Où ranger la skill | Comment l’appeler |
|---|---|---|
Claude (web et application) | Personnaliser (Customize) > Skills, puis importer le dossier en ZIP. Plans Free, Pro et Max, avec l’exécution de code activée | Claude la choisit seul quand ta demande correspond à la description |
|
| |
|
|
Sources : aide Claude, documentation Claude Code, documentation Codex. Pour un autre outil, cherche sa page « skills » depuis la vitrine d’agentskills.io
Demande-lui ensuite de confirmer le nom de la skill, son chemin et le fichier réellement lu. Invoque-la explicitement pour le premier essai. Tu pourras tester sa sélection automatique ensuite
Un fichier présent sur le disque ne prouve pas qu’une application l’a chargé. Une réponse qui ressemble au format attendu ne le prouve pas davantage : vérifie le mécanisme de chargement disponible dans ton outil
Si tu découvres encore ces usages, le guide Codex pour non-développeurs explique comment préparer un dossier et cadrer une mission
Trois essais avant de la réutiliser
Teste d’abord la méthode sur de petits textes dont tu connais la réponse
Entrée pédagogique | Résultat attendu |
|---|---|
« Décision : conserver le tarif actuel. Nadia préparera le comparatif pour vendredi » | Une décision et une action, avec Nadia et vendredi tels qu’écrits |
« On pourrait refaire le site. On en reparle à la prochaine réunion » | Une proposition ou question ouverte, aucune décision de refaire le site |
« Envoyer la synthèse. Aucun responsable n’a été désigné » | Une action avec responsable non précisé, aucun envoi |
Ajoute ensuite un document contenant deux versions contradictoires d’une échéance. La bonne sortie doit te montrer le désaccord
Tu testes deux dimensions : le résultat produit et le comportement en cas de manque. Une jolie synthèse qui invente un responsable échoue au test
Pour aller plus loin, utilise la méthode d'évaluation d’un agent IA et garde les entrées de test pour comparer les versions
Corriger la méthode au bon endroit
Si l’agent mélange systématiquement proposition et décision, ajoute un exemple de cette distinction dans la skill
Si un seul compte rendu est ambigu, note cette ambiguïté dans le résultat. Inutile d’ajouter une règle permanente pour chaque formulation rencontrée
Quand tu modifies la procédure, relance les anciens essais. Une précision peut résoudre une erreur et rendre la skill trop restrictive ailleurs
Une bonne maintenance reste légère : conserver le fichier, les cas de test et une courte explication des changements importants
Les permissions restent dans l’environnement
Écrire « ne pas envoyer » aide à cadrer le comportement. Pour les tâches sensibles, configure aussi les accès de l’outil : lecture seule, dossier dédié ou validation avant action
Inspecte les skills récupérées ailleurs, particulièrement leurs scripts. Une compétence ajoutée à ton agent peut lui faire exécuter du code ou contacter un service selon les permissions disponibles
Pour un premier essai, utilise des données fictives et aucun accès de production
FAQ
Une skill IA, c’est quoi en une phrase ?
Un dossier avec un fichier SKILL.md qui décrit une méthode de travail, que ton agent charge seulement quand la tâche le demande
Quelle différence entre une skill et un fichier CLAUDE.md ?
CLAUDE.md contient des faits et des règles que l’agent relit à chaque session. Une skill contient une procédure : d’après la documentation de Claude Code, son contenu n’est chargé que lorsqu’elle sert, donc une longue méthode ne coûte presque rien tant que tu ne l’utilises pas
Une skill marche-t-elle dans plusieurs outils ?
Oui, le format SKILL.md est un standard ouvert. Seul le dossier où la ranger change d’un outil à l’autre, et certains outils ajoutent des options qui leur sont propres
Faut-il savoir coder pour créer une skill ?
Non. Une skill peut tenir en un fichier Markdown écrit en français, sans aucun script. Si tu débutes, commence par écrire une bonne consigne : une skill, c’est une consigne que tu as rendue réutilisable. Les mots du domaine sont dans le glossaire de l’IA
Ta première skill peut tenir sur une page
Choisis une procédure que tu répètes déjà. Écris l’entrée, la méthode, le résultat et les erreurs à éviter. Teste les cas normaux, incomplets et contradictoires
Tu disposes alors d’une base concrète pour déléguer la même tâche avec moins de répétition et un résultat plus facile à contrôler
Pour construire cette méthode autour de tes propres tâches, découvre l’accompagnement Kryve sur les agents IA
