Les compétences Claude expliquées : les trois niveaux de divulgation progressive

Un Claude Skill est, physiquement, un dossier. Pas un service hébergé, pas un binaire, pas un bloc de texte que l’on colle au début d’une conversation — un répertoire contenant un fichier SKILL.md et tout ce dont la tâche a besoin. Presque tout ce qui rend les Skills intéressants découle de ce seul choix, car un dossier est quelque chose qu’un agent peut ouvrir de manière sélective. Un prompt, lui, ne peut pas être ouvert de manière sélective. Il est soit dans la conversation, soit il n’y est pas.

La documentation d’Anthropic décrit cette organisation comme semblable à un guide d’intégration que l’on créerait pour un nouveau membre de l’équipe, et l’analogie va plus loin qu’elle n’y paraît au premier abord. Personne ne lit un guide d’intégration de bout en bout avant de commencer à travailler. On lit la page qui correspond à la question que l’on se pose, en faisant confiance au fait que le reste sera toujours là au besoin. Une compétence repose sur le même pari : la majeure partie d’une procédure peut rester sur le disque la plupart du temps.

Système de fichiers d'abord, capacité ensuite

Claude fonctionne dans une machine virtuelle avec accès au système de fichiers. C'est la condition préalable pour qu'une compétence soit un répertoire plutôt qu'une entrée de configuration, car cela permet à l'agent de lister un dossier, de lire un fichier et de suivre une référence vers un autre fichier en utilisant les mêmes opérations qu'une personne utiliserait. Dans ce cadre, une compétence regroupe des instructions, des métadonnées et des ressources facultatives telles que des scripts et des modèles.

Le résultat est une capacité plus grande que n’importe quel fichier individuel du dossier. Les instructions expliquent comment accomplir la tâche. Un script fourni avec l’ensemble peut en exécuter une partie sans être décrit en prose. Un document de référence peut contenir des éléments que l’on consulte plutôt que l’on mémorise. Ce qui fait de ces trois éléments un système plutôt qu’un simple tas, c’est l’ordre dans lequel ils deviennent visibles, ce qu’Anthropic appelle la divulgation progressive — charger l’information par étapes au fur et à mesure des besoins plutôt que de consommer du contexte dès le départ.

Niveau 1 : les deux champs qui sont toujours chargés

Chaque compétence commence par un frontmatter YAML contenant un nom et une description. Claude charge ces métadonnées au démarrage et les inclut dans le prompt système. C'est la seule partie de la compétence présente avant que quiconque ne demande quoi que ce soit, et tant qu'une compétence n'est pas déclenchée, seuls son nom et sa description occupent le contexte.

La description remplit trois fonctions à la fois, et les séparer explique pourquoi tant de compétences sont discrètement ignorées. C’est une étiquette, qui indique comment la chose s’appelle. C’est une entrée d’index, le texte auquel une requête est comparée lorsque Claude décide si la compétence est pertinente. Et c’est une déclaration de portée, ce qui explique pourquoi les recommandations d’Anthropic sont qu’elle doit indiquer à la fois ce que fait la compétence et quand l’utiliser. Une description qui ne remplit que la première fonction ne donne aucun élément à faire correspondre au moteur de correspondance.

Prenez deux versions d’une même compétence. L’une est décrite comme servant à remplir et valider des formulaires PDF, à utiliser lorsqu’une demande implique de remplir ou de vérifier un formulaire PDF. L’autre est décrite comme une aide pour les documents. La première nomme une action et une situation ; la seconde ne nomme ni l’une ni l’autre. Une compétence dont la description ne nomme ni l’une ni l’autre restera sur le disque sans être lue pendant que l’agent accomplit la tâche par la voie longue — non pas parce que la compétence a échoué, mais parce qu’elle n’a jamais été trouvée.

Niveau 2 : le corps, à lire lorsque la description correspond

Lorsqu'une demande correspond à la description, le deuxième niveau s'ouvre : le corps de SKILL.md. Il s'agit de la procédure — workflows, bonnes pratiques, conseils — et elle est écrite pour un agent qui a déjà déterminé que cette compétence est le bon outil pour la tâche. C'est là qu'une équipe consigne les étapes qu'elle répéterait autrement dans chaque conversation, et c'est là que se trouvent les renvois vers des contenus plus approfondis.

L’ordre compte ici autant qu’au niveau 1. Le corps n’est pas chargé au démarrage, et il ne l’est pas par précaution. Il arrive après qu’une décision a été prise, ce qui signifie que la décision doit pouvoir être prise à partir du seul niveau 1. Une compétence dont la description est vague n’a aucun moyen de se rattraper au niveau 2, car le niveau 2 n’est jamais lu.

Niveau 3 : les fichiers qui s’ouvrent parce que quelque chose les a pointés

Le troisième niveau est le reste du dossier : les fichiers supplémentaires référencés depuis SKILL.md. L'exemple d'Anthropic est un fichier FORMS.md contenant des conseils avancés sur le remplissage de formulaires, tenu à l'écart des instructions principales afin que celles-ci restent courtes et que le détail ne soit disponible que lorsqu'une tâche en a besoin. Les scripts et les modèles appartiennent aussi à ce niveau.

L’effet structurel est qu’une compétence peut contenir une grande quantité de contenu sans tout porter d’un coup. Un dossier peut contenir un fichier d’instructions principal, une référence détaillée, un ensemble de modèles et un script, et une tâche donnée peut n’en toucher qu’un seul. Tout ce vers quoi rien ne pointe reste sur le disque, et le disque n’est pas la ressource rare chez un agent. Le contexte l’est.

C’est aussi là que le format lève le plafond auquel les prompts se heurtent. Un prompt doit être suffisamment court pour valoir la peine d’être collé. Les éléments fournis avec une compétence sont limités par ce qu’un répertoire peut contenir, car seule la partie que la tâche a réellement touchée parvient au modèle.

Pourquoi l’ordre est la conception, pas un détail

Trois conséquences en découlent, et ensemble, elles sont la raison pour laquelle cela mérite d’être compris plutôt que simplement connu.

• Le contexte est un budget, et le contenu toujours chargé représente un coût fixe. Tout ce qui figure dans un prompt système est payé à chaque requête, y compris celles qui n'ont rien à voir avec cette compétence. La divulgation progressive transforme un coût fixe en coût conditionnel : une description toujours, des instructions lorsqu'elles sont pertinentes, des références lorsqu'elles sont référencées.

• La description est une interface. C'est la seule partie d'une compétence qui est garantie d'être vue, c'est donc là qu'un auteur doit réfléchir au déclenchement et pas seulement au contenu.

• Une compétence a trois vitesses de maintenance. Les métadonnées changent lorsque la compétence doit se déclencher différemment, le corps change lorsque le flux de travail change, et les références changent lorsque le matériel sous-jacent change. Les garder séparés évite qu’une mise à jour de référence ne se transforme en réécriture des instructions.

Le coût est l’exact miroir du bénéfice. Chaque frontière de niveau est un endroit où le modèle doit prendre une décision correcte. Une description trop étroite signifie que la compétence ne se déclenche jamais et que le dossier est un poids mort. Une description trop large signifie qu’elle se déclenche sur des tâches pour lesquelles elle n’a pas été conçue, et que ses instructions deviennent une charge pour des tâches sans rapport. La divulgation progressive fait de la description un élément porteur, ce qu’un long prompt toujours présent n’est jamais.

Ce qu'Anthropic livre déjà, et d'où viennent vos propres compétences

Anthropic propose des Skills préconstruits pour PowerPoint, Excel, Word et PDF — présentations, feuilles de calcul, documents et PDF mis en forme. Ils sont disponibles sur claude.ai, Claude API, Claude Platform on AWS et Microsoft Foundry, avec la réserve que, sur Foundry, ils nécessitent un déploiement Hosted on Anthropic.

Ce sont le moyen le plus rapide de voir le mécanisme plutôt que d’en lire la description. L’ordre de chargement est identique à celui de tout ce que vous écrivez vous-même ; la différence entre une compétence préconstruite et une compétence personnalisée tient à qui a rédigé le dossier, et non à la manière dont elle parvient au modèle.

Les Custom Skills peuvent être créées dans Claude Code, importées via l’API Claude ou ajoutées dans les paramètres de claude.ai. Les avantages annoncés par Anthropic sont ceux auxquels on s’attendrait de tout élément réutilisable : spécialiser Claude pour des tâches métier, créer des consignes une fois plutôt que de les répéter, et combiner plusieurs compétences pour un travail en plusieurs étapes. Le dernier de ces avantages découle le plus directement de l’architecture, car si chaque compétence est un dossier qui s’ouvre à la demande, une pile de compétences coûte très peu tant que le travail n’en a pas réellement besoin.

Une compétence n'est pas un prompt, ni un connecteur

Trois choses se confondent dans la conversation, et l'ordre de chargement permet de garder facilement ces distinctions en tête.

Un prompt se situe au niveau de la conversation. Il est présent dès le premier tour, il colore tout dans cette conversation et il disparaît avec la conversation. Une compétence est à la demande : elle existe avant le début de la conversation, la majeure partie n’entre jamais dans la conversation, et la partie qui arrive le fait parce qu’une description a correspondu. C’est la différence entre dire à un agent comment se comporter et lui donner quelque chose qu’il peut prendre en main.

Un connecteur concerne la portée. Les connecteurs constituent un accès aux applications, ce qui signifie qu’ils déterminent ce qu’un agent peut atteindre ; une compétence détermine comment l’agent doit faire quelque chose une fois qu’il peut y accéder. Une équipe peut disposer d’excellents connecteurs et produire néanmoins des documents incohérents, car l’accès n’est pas une procédure. Elle peut aussi disposer d’excellentes compétences et ne toujours pas voir les données, car la procédure n’est pas l’accès.

La documentation d'Anthropic traite les Skills et le Model Context Protocol comme des couches différentes, et le mécanisme à trois niveaux montre pourquoi la séparation est nette. L'ordre de chargement concerne le moment où l'information arrive, non son origine.

Où s’inscrit le don, en un paragraphe

Le 22 octobre 2026, Anthropic a fait don de la norme Agent Skills à l’Agentic AI Foundation, sous l’égide de la Linux Foundation — le nom, le logo, l’organisation GitHub et le domaine agentskills.io — avec des ingénieurs d’Anthropic, de Google, d’OpenAI et d’autres entreprises qui la maintiennent à titre individuel. Rien de tout cela ne modifie le mécanisme ci-dessus. Le format de dossier, le frontmatter YAML, l’ordre de chargement et les compétences documentaires préconstruites sont exactement tels qu’ils étaient la veille. Ce qui a changé, c’est qui possède le nom, ce qui compte énormément pour la stabilité à long terme d’une norme et pas du tout pour la façon dont vous écrivez une compétence cet après-midi.

Lire une compétence avant de l'installer

Si les trois niveaux constituent l’architecture, ils fournissent aussi une courte liste de contrôle de revue. Lisez d’abord la description, car c’est elle qui détermine si autre chose se produit un jour : elle doit nommer ce que la compétence fait et quand elle doit être utilisée, dans des termes qu’une requête serait susceptible d’employer. Lisez ensuite SKILL.md, car c’est la procédure que l’agent suivra, et il doit se lire comme des instructions adressées à un collègue compétent plutôt que comme un résumé de ce que vous espérez voir se produire. Lisez en troisième lieu ce à quoi il renvoie. Lisez ensuite les scripts.

Ce dernier point n'est pas de la paranoïa. Le format permet à une compétence de porter des instructions aux côtés de ressources facultatives, et les ressources peuvent inclure du code exécutable. Une compétence que vous installez n'est donc pas seulement du texte qui façonne une conversation ; c'est un dossier dans lequel un agent capable ira ouvrir des fichiers et agir sur eux. Le modèle niveau par niveau vous indique exactement où regarder, ce que la plupart des éléments installés n'offrent pas.

Une frontière mérite d’être précisée pour les lecteurs qui arrivent depuis nos propres pages. OrcaRouter achemine les appels aux modèles, et nous n’hébergeons aucune des applications d’Anthropic ni ses surfaces de compétences — une compétence s’exécute là où se trouve le système de fichiers de l’agent, et ce n’est pas notre couche. Ce que nous faisons se situe sous le choix du modèle : plus de 200 modèles derrière une seule clé compatible OpenAI, le prix catalogue du fournisseur répercuté sans marge, et un basculement automatique entre fournisseurs lorsque l’un est indisponible. Une compétence décide comment une tâche doit être réalisée. Un routeur décide quel modèle l’exécute, et aucune des deux couches ne devrait avoir besoin d’en savoir beaucoup sur l’autre.

La divulgation progressive est honnête quant à la contrainte qu'elle résout. Le contexte est fini, les procédures sont longues, et l'essentiel de toute procédure donnée est sans rapport avec la tâche qui vous attend. Un nom, un corps et un ensemble de fichiers ne constituent pas une conception compliquée ; c'est la plus petite qui permette à un agent de porter une grande quantité de connaissances tout en ne retenant que la partie dont il a besoin.

C’est pourquoi la ligne la plus décisive dans une compétence bien conçue est aussi la plus courte. Tout le reste dans le dossier est une bibliothèque. La description est le catalogue de fiches, et quand le catalogue est erroné, autant que la bibliothèque n’existe pas.