Anthropic présente ses « compétences » comme composables, portables et économes. Les listes des « dix meilleurs skills Claude » ont suivi en quelques semaines. Ce qu’elles expliquent rarement, c’est ce qu’un skill est au sens technique, à quel moment Claude le lit, et ce qu’il coûte une fois lu. J’ai ouvert la documentation, le billet d’ingénierie et la spécification du format. Regardons.
L’essentiel : un skill Claude, c’est quoi ?
Un skill est un dossier. Au minimum, il contient un fichier SKILL.md qui commence par deux champs, un nom et une description, suivis d’instructions écrites en langage courant. Il peut aussi embarquer des scripts, des documents de référence et des modèles de fichiers. La documentation d’Anthropic le définit comme des ressources réutilisables, rangées dans un système de fichiers, qui donnent à Claude une expertise de domaine.
L’image retenue par ses ingénieurs est celle du guide d’accueil qu’on remet à un nouvel embauché : « Building a skill for an agent is like putting together an onboarding guide for a new hire », billet du 16 octobre 2025. Le modèle ne change pas, il n’apprend rien. Il reçoit un mode d’emploi au moment où la tâche le réclame, et pas avant.
Ce que ça établit : un skill n’est pas une nouvelle capacité du modèle, c’est du texte et parfois du code, livrés au bon moment. Ce que ça n’établit pas : que n’importe quel dossier d’instructions rende Claude meilleur. Un guide d’accueil mal écrit produit un embauché mal formé.
Ce que Claude lit, et quand : la divulgation progressive
C’est le mécanisme qui distingue un skill d’un long prompt collé à chaque conversation. Anthropic le nomme « progressive disclosure » et le découpe en trois niveaux, avec des ordres de grandeur que sa documentation chiffre elle-même.
| Niveau | Ce qui est chargé | Quand | Coût annoncé |
|---|---|---|---|
| 1. Métadonnées | le nom et la description de chaque skill | toujours, au démarrage, dans le prompt système | environ 100 tokens par skill |
| 2. Instructions | le corps de SKILL.md | quand la demande correspond à la description | moins de 5 000 tokens |
| 3. Ressources et code | fichiers annexes, scripts | à la demande, fichier par fichier | rien tant que ce n’est pas ouvert |
Source : documentation Agent Skills, Claude Platform, consultée le 26 août 2026. Le détail qui compte est au niveau 3 : quand un skill contient un script, Claude l’exécute et ne reçoit que sa sortie. Le code du script n’entre jamais dans la fenêtre de contexte. Un skill peut donc embarquer une documentation d’API entière ou des dizaines de gabarits sans peser un token de plus tant que personne ne les ouvre.
La description fait tout le travail de déclenchement. C’est elle que Claude compare à ta demande pour décider d’ouvrir le dossier ou non. La documentation impose qu’elle dise à la fois ce que le skill fait et quand l’utiliser, dans une limite de 1 024 caractères, le nom étant plafonné à 64 caractères en minuscules. Une description vague, et le skill ne se déclenche pas. Une description trop large, et il se déclenche à tort.
Le point que les guides oublient : un skill chargé reste là
La promesse « économe » vaut pour le démarrage. Elle ne dit rien de la suite, et la documentation de Claude Code, elle, en parle sans détour : une fois invoqué, le contenu du skill entre dans la conversation comme un message unique et y reste pour le reste de la session. Chaque ligne d’un skill est donc un coût récurrent, payé à chaque tour. La même page conseille d’écrire un corps concis pour cette raison précise.
Deux autres chiffres méritent d’être connus. Quand la conversation est compactée pour libérer de la place, Claude Code ne conserve que les 5 000 premiers tokens de chaque skill invoqué, dans une enveloppe commune de 25 000 tokens, en commençant par le plus récent.
La liste des descriptions présentée au modèle au démarrage a un budget fixé à 1 % de la fenêtre de contexte : au-delà, les descriptions des skills les moins utilisés sont raccourcies, puis retirées.
Autrement dit, installer cinquante skills n’est pas gratuit, contrairement à ce que la formule « seulement ce qui est nécessaire » laisse entendre. Sur ce point, je note que la documentation technique est plus honnête que la page d’annonce.
Skill, MCP, projet, instructions : qui fait quoi
La confusion la plus fréquente concerne le MCP. Le centre d’aide d’Anthropic tranche en une ligne : le MCP connecte Claude à des services externes, les skills lui enseignent des procédures. Un skill peut très bien dire à Claude de se servir d’un serveur MCP à l’étape trois. Les deux se cumulent, ils ne se remplacent pas.
Face aux projets de claude.ai, la différence est le moment du chargement. Les connaissances d’un projet sont chargées en permanence ; un skill ne l’est que si la tâche le justifie. Face aux instructions personnalisées, c’est la portée : elles s’appliquent partout, un skill est contextuel.
Dans Claude Code, la frontière avec les commandes personnalisées a tout simplement disparu. La documentation l’écrit en gras : les commandes ont été fusionnées dans les skills. Un fichier .claude/commands/deploy.md et un dossier .claude/skills/deploy/SKILL.md créent tous deux la commande /deploy. Le skill ajoute ce que la commande n’avait pas : des fichiers annexes, des champs de réglage, et la possibilité que Claude le charge de lui-même.
Où ça marche, et ce qui ne circule pas
Les skills existent sur trois surfaces, et c’est là que la promesse « portable » demande une lecture attentive.
Sur claude.ai, quatre skills préconstruits par Anthropic (Word, Excel, PowerPoint, PDF) sont actifs sans réglage dès que tu crées un document. Les skills personnalisés s’envoient sous forme d’archive zip dans les réglages, sur les plans Pro, Max, Team et Enterprise, à condition que l’exécution de code soit activée. Ils restent propres à chaque utilisateur : un administrateur ne peut pas les déployer à toute une organisation depuis cette interface.
Sur l’API, un skill se déclare par son identifiant dans le conteneur d’exécution de code, sans accès réseau et sans installation de paquets. Dans Claude Code, tout passe par le disque : ~/.claude/skills/ pour tes skills personnels, .claude/skills/ dans un projet, ou un plugin. Là, le skill dispose du même accès réseau que n’importe quel programme sur ta machine.
La phrase qui tempère le marketing est dans la section des limites : « Custom Skills do not sync across surfaces ». Un skill envoyé sur claude.ai n’existe pas sur l’API, et l’inverse est vrai. Le format est portable. Les fichiers, eux, ne voyagent pas seuls.
Qui déclenche un skill : toi, Claude, ou les deux
Par défaut, les deux. Tu peux taper /nom-du-skill, et Claude peut l’ouvrir de lui-même quand ta demande correspond à la description. Deux champs de l’en-tête permettent de restreindre l’un ou l’autre, et leur logique est plus intéressante qu’il n’y paraît.
disable-model-invocation: true réserve le skill à l’humain. La documentation donne l’exemple qui parle : un skill de déploiement en production, que tu ne veux pas voir Claude lancer « parce que ton code a l’air prêt ». Si Claude tente quand même, Claude Code bloque l’appel et lui interdit de reproduire les étapes autrement.
user-invocable: false fait l’inverse : il cache le skill du menu, pour une connaissance de fond que Claude doit avoir sans que ce soit une action à lancer.
Un autre champ, allowed-tools, autorise des outils sans demande de confirmation pendant le tour où le skill est invoqué. C’est pratique, et c’est aussi le point à surveiller : la documentation précise que cette autorisation s’applique même dans un dossier que tu n’as jamais déclaré de confiance. Un skill peut s’accorder à lui-même un accès large.
Pour une règle qui doit tenir quoi qu’il arrive, la même page renvoie vers les hooks, qui imposent un comportement au lieu de le suggérer.
Un skill s’installe comme un logiciel, pas comme un prompt
C’est Anthropic qui le dit, pas moi. La documentation demande de n’utiliser que des skills « que tu as créés toi-même ou obtenus d’Anthropic », et de traiter l’installation d’un skill tiers comme celle d’un logiciel. Le raisonnement tient en une phrase : un skill donne des capacités par des instructions et du code, donc un skill malveillant peut faire appeler des outils ou exécuter du code sans rapport avec son objet déclaré.
Le cas jugé le plus risqué est le skill qui va chercher des données sur une adresse externe : le contenu récupéré peut lui-même contenir des instructions, et un skill honnête au départ peut être compromis si sa dépendance change. Les organisations Enterprise disposent d’une analyse des skills téléversés sur claude.ai. Elle ne couvre pas ceux envoyés par l’API.
Même le dépôt public d’Anthropic, 171 700 étoiles sur GitHub au 26 août 2026, porte un avertissement : ses skills sont fournis « à des fins de démonstration et d’apprentissage », à tester avant tout usage critique. Les skills de documents (PDF, Word, PowerPoint, Excel) y sont en code visible mais pas open source ; les autres sont sous licence Apache 2.0.
Quant aux catalogues tiers qui proposent des skills par centaines, ils vendent la commodité d’un clic sur un objet que l’éditeur lui-même compare à un exécutable. Je les laisse à ta prudence.
Un format ouvert, et plus seulement chez Anthropic
Le 18 décembre 2025, Anthropic a publié le format comme standard ouvert, sous le nom Agent Skills, sur le site agentskills.io. La spécification tient à peu de chose : un dossier, un SKILL.md avec au minimum un nom et une description, et le même chargement en trois temps.
La liste des outils compatibles, telle que le site l’affiche fin août 2026, comprend Cursor, GitHub Copilot, VS Code, Gemini CLI, ChatGPT et Codex, OpenCode, Goose, et deux agents personnels dont Nox a déjà parlé, Hermes Agent et OpenClaw.
Ce que ça établit : le format est repris hors de l’écosystème Claude, ce qui est rare pour un objet né chez un seul éditeur. Ce que ça n’établit pas : qu’un skill se comporte à l’identique partout.
La documentation de Claude Code liste une quinzaine de champs d’en-tête qui lui sont propres, du choix du modèle aux hooks, et précise que les champs du standard comme la licence sont acceptés mais sans effet chez elle. Un skill écrit pour Claude Code et déposé dans Cursor gardera ses instructions, pas ses réglages.
Les questions qui reviennent
C’est quoi les skills sur Claude, en une phrase ?
Un dossier d’instructions, avec parfois des scripts et des fichiers de référence, que Claude ne lit qu’au moment où ta demande correspond à sa description. Ce n’est ni une mise à jour du modèle ni une connexion à un service : c’est un mode d’emploi rangé sur le disque.
Où trouver des skills pour Claude ?
Dans le dépôt public d’Anthropic sur GitHub, dans les skills préconstruits de claude.ai, et dans le menu /skills de Claude Code qui liste ceux installés. Les catalogues tiers existent ; la documentation d’Anthropic demande de les auditer fichier par fichier avant usage, scripts compris.
Quels sont les meilleurs skills Claude ?
Je n’en ai testé aucun pour cet article, donc je n’en classe aucun. Les listes qui le font mesurent rarement quoi que ce soit. La seule question utile est celle de la documentation : quelle procédure répètes-tu assez souvent pour mériter d’être écrite une fois ?
Un skill remplace-t-il le fine-tuning ?
Non, et les deux ne jouent pas au même niveau. Le fine-tuning modifie le modèle par entraînement ; un skill lui donne un texte à lire. Le second se corrige en éditant un fichier, le premier non.
À retenir
- Un skill Claude est un dossier : un
SKILL.md(nom, description, instructions) et, au choix, des scripts et des documents de référence. - Claude ne lit que la description au démarrage (environ 100 tokens par skill) ; le corps n’entre dans le contexte que si la demande correspond, et les scripts ne coûtent que leur sortie.
- Une fois chargé, le skill reste dans la conversation jusqu’à la fin de la session, et la liste des descriptions est plafonnée à 1 % de la fenêtre de contexte : la sobriété se paie à l’usage.
- Le format est ouvert et repris par Cursor, Copilot, Codex ou Gemini CLI, mais les fichiers ne se synchronisent pas entre claude.ai, l’API et Claude Code, et un skill tiers s’audite comme un logiciel.