Agent Skills : le standard SKILL.md adopté par 70+ plateformes IA
Axel Grégoire
#skills #mcp #standards #claude #agents iaDepuis un an, chaque outil d'IA pour développeurs a inventé sa propre façon d'empaqueter des instructions réutilisables : commandes personnalisées, prompts système, fichiers de configuration maison. Résultat, le même savoir-faire devait être réécrit pour Claude Code, pour Cursor, pour Copilot, et pour le suivant. Anthropic a tenté de résoudre ce problème avec les Agent Skills, un format simple basé sur un fichier SKILL.md.
Ce qui rend le sujet intéressant aujourd'hui, c'est que ce format n'est plus un gadget propre à Claude. Publié comme standard ouvert en décembre 2025, il a ensuite été cédé à l'Agentic AI Foundation, une organisation hébergée par la Linux Foundation, suivant exactement la même trajectoire que le Model Context Protocol (MCP) quelques mois plus tôt. Plusieurs dizaines d'outils concurrents lisent désormais les mêmes fichiers SKILL.md.
Si tu construis des agents ou que tu utilises Claude Code, Cursor ou Copilot au quotidien, comprendre ce format te permet d'écrire un Skill une seule fois et de le réutiliser partout, plutôt que de maintenir N versions d'un même prompt.
Qu'est-ce qu'un Agent Skill, concrètement ?
Un Skill est un dossier dont le seul fichier obligatoire s'appelle SKILL.md. Ce fichier commence par un en-tête YAML entre deux lignes ---, suivi d'un corps en Markdown qui contient les instructions proprement dites. Deux champs sont obligatoires dans l'en-tête : name (qui doit correspondre au nom du dossier) et description, limitée à 1024 caractères selon la spécification publiée sur agentskills.io.
--- name: pdf-extraction description: Extrait le texte et les tableaux d'un PDF, remplit des formulaires. À utiliser quand l'utilisateur fournit un fichier PDF à traiter. license: Apache-2.0 --- # Extraction PDF Pour extraire le texte d'un PDF, utilise le script `scripts/extract.py` fourni dans ce Skill. Ne tente jamais de lire un PDF scanné sans passer d'abord par l'OCR décrit dans `references/ocr.md`. Autour de ce fichier, le dossier peut contenir des sous-dossiers optionnels : scripts/ pour du code exécutable, references/ pour de la documentation détaillée que l'agent ne charge qu'à la demande, et assets/ pour des modèles ou ressources statiques.
Le mécanisme de « progressive disclosure »
L'intérêt principal du format tient à son chargement en trois niveaux, pensé pour ne pas saturer le contexte du modèle :
- Au démarrage, seuls
nameetdescriptionde chaque Skill disponible sont chargés — de l'ordre d'une centaine de tokens par Skill. - Quand l'agent juge le Skill pertinent pour la tâche en cours, il charge le corps complet du fichier
SKILL.md— plusieurs milliers de tokens. - Les fichiers de
references/ouscripts/ne sont lus qu'au moment où l'agent en a réellement besoin.
C'est ce qui permet d'avoir des dizaines de Skills installés sans gonfler artificiellement chaque requête : la majorité du contenu reste « froid » jusqu'à ce qu'il serve.
Skill, MCP, sous-agent, prompt : ne pas confondre les couches
Ces quatre notions se recoupent dans les discussions mais répondent à des besoins différents :
- MCP donne à un agent un accès à des données ou des outils externes (une base de données, une API, un système de fichiers distant). C'est une couche de connexion.
- Un Skill empaquette un savoir-faire procédural — comment faire quelque chose correctement, avec éventuellement du code à exécuter. Un Skill peut très bien s'appuyer sur un serveur MCP pour accéder aux données dont il a besoin.
- Un sous-agent est une instance séparée qui exécute une tâche de façon isolée, avec son propre contexte.
- Un prompt ou une commande personnalisée reste statique et non découvrable automatiquement : l'agent doit être explicitement invoqué avec, alors qu'un Skill est repéré tout seul dès que sa description correspond à la tâche.
En pratique, les deux formats sont complémentaires plutôt que concurrents : MCP expose des capacités, Skills documente comment les utiliser correctement et dans quel ordre.
D'une fonctionnalité Claude à un standard gouverné par la Linux Foundation
La chronologie publique du format est la suivante :
- 16 octobre 2025 : Anthropic introduit les Agent Skills comme fonctionnalité de Claude (Claude.ai, Claude Code, l'Agent SDK et la plateforme développeur).
- 18 décembre 2025 : Anthropic publie la spécification comme standard ouvert sur agentskills.io, avec Microsoft, OpenAI, Cursor et GitHub cités parmi les premiers adoptants.
- Fin octobre 2026 : selon TechRepublic, Anthropic cède le nom, le logo, l'organisation GitHub et le domaine agentskills.io à l'Agentic AI Foundation, hébergée par la Linux Foundation — cette date précise n'a pas pu être recoupée avec d'autres sources au moment de la rédaction, à prendre avec prudence.
Les chiffres d'adoption varient selon la source consultée, entre une trentaine et plus de soixante-dix plateformes selon les relevés — ces chiffres proviennent des annonces des fournisseurs eux-mêmes et méritent d'être vérifiés via le showcase officiel d'agentskills.io plutôt que pris pour argent comptant. Ce qui est vérifiable, c'est la liste des outils cités de façon répétée dans plusieurs sources indépendantes : Claude Code, Cursor, GitHub Copilot, VS Code, OpenAI Codex, Gemini CLI et JetBrains Junie.
Cette trajectoire — fonctionnalité propriétaire, puis standard ouvert, puis gouvernance transférée à une fondation neutre — reproduit presque à l'identique celle de MCP, qu'Anthropic avait lancé en 2024 avant de le voir repris par la même Agentic AI Foundation en 2026. Pour les équipes qui pariaient sur MCP malgré son origine propriétaire, c'est un signal rassurant sur la pérennité de Skills.
Écrire un Skill portable : ce qu'il faut vérifier avant de le publier
Quelques règles ressortent de la spécification et des guides de bonnes pratiques :
- Garde le corps de
SKILL.mdcourt — l'ordre de grandeur recommandé est de rester sous 500 lignes. Si la documentation est plus longue, déplace-la dansreferences/et renvoie-y depuis le corps principal. - Le champ
descriptionest ce que l'agent lit pour décider d'activer ou non le Skill : sois précis sur le déclencheur (« à utiliser quand… ») plutôt que de décrire uniquement ce que fait le Skill. - Le nom du dossier doit correspondre exactement au champ
name— une divergence fait échouer le chargement sur certains clients. - Si ton Skill embarque des scripts exécutables, documente-les clairement : plusieurs clients exposent un champ optionnel
allowed-tools(encore expérimental) pour restreindre ce qu'un Skill peut invoquer.
Le risque qu'il ne faut pas ignorer
La documentation officielle d'Anthropic avertit explicitement qu'un Skill tiers malveillant, ou simplement mal écrit, peut entraîner des actions allant au-delà de son objectif déclaré — en particulier quand il embarque des scripts. Avant d'installer un Skill trouvé en ligne, lis son SKILL.md en entier et inspecte le contenu de ses dossiers scripts/ comme tu le ferais pour une dépendance npm inconnue : un Skill a potentiellement les mêmes droits d'exécution que l'agent qui l'active.
Par où commencer
Si tu veux tester le format dès aujourd'hui sans attendre une migration complète de ton outillage :
- Crée un dossier avec un
SKILL.mdminimal (justenameetdescription) pour une tâche répétitive que tu fais souvent dans Claude Code. - Vérifie que le Skill se déclenche bien tout seul en formulant une demande qui correspond à sa description, sans l'invoquer explicitement.
- Une fois satisfait, teste le même dossier, sans modification, dans un second outil compatible (Cursor ou VS Code par exemple) pour vérifier la portabilité réelle.
- Avant de partager un Skill avec ton équipe ou de l'ouvrir en public, fais-le relire par quelqu'un d'autre si des scripts sont inclus — exactement comme une revue de code.
Le pari derrière Skills est le même que celui de MCP : éviter que chaque fournisseur réinvente sa propre case fermée. Pour l'instant, l'adoption annoncée par les éditeurs va dans ce sens, mais la vérification indépendante de ces chiffres, et la gouvernance réelle une fois le standard confié à la fondation, restent à observer dans les prochains mois.
À lire aussi
IA 27 octobre 2026 7 minClaude Opus 5.5, Sonnet 5.5, Haiku 5.5 : quel modèle choisir ?
Opus, Sonnet ou Haiku 5.5 : prix, benchmarks et règles concrètes pour choisir le bon modèle Claude selon la tâche de développement.
Lire l'article →IA 9 octobre 2026 6 minClaude Opus 5.5 : le paramètre effort, votre levier de coût
Opus 5.5 baisse les prix et accélère : découvre le paramètre effort pour régler finement coût et qualité de tes agents Claude, avec du code.
Lire l'article →IA 22 septembre 2026 7 minClaude Code Projects : l'IA orchestre plusieurs sessions cloud
Anthropic a refondu Claude Code Projects : un coordinateur répartit le travail entre plusieurs sessions cloud parallèles sur des branches distinctes.
Lire l'article →