Claude Skills, expliqué : ce qu'ils sont vraiment, et les subtilités d'accès par forfait sur lesquelles deux pages d'Anthropic se contredisent

Ce qu'est vraiment un Skill, mécaniquement

Débarrassé du marketing, un Skill est un répertoire avec un seul fichier obligatoire. SKILL.md porte un en-tête YAML (au minimum un name et une description) suivi d'instructions en Markdown. Autour, facultativement, se trouvent un dossier scripts/ de code exécutable, un dossier references/ de documentation que Claude n'ouvre que lorsqu'il en a besoin, et un dossier assets/ de modèles, polices ou icônes pour ce que le skill produit. La documentation de la plateforme d'Anthropic décrit le mécanisme de façon presque littérale : le modèle exécute l'équivalent de bash: cat pdf-processing/SKILL.md. C'est une lecture de système de fichiers, pas une primitive API spéciale.

Ce qui distingue cela du simple fait de coller un long prompt système, c'est la divulgation progressive, et elle a des coûts en tokens réels et documentés plutôt qu'une vague garantie. La documentation de la plateforme d'Anthropic la décompose en trois niveaux : Niveau 1, le name et la description du skill, se charge automatiquement dans chaque conversation pour un coût d'environ 100 tokens par skill installé. Niveau 2, le corps complet de SKILL.md, ne se charge que lorsque Claude juge que votre demande correspond à la description, et Anthropic le plafonne à moins de 5 000 tokens (son guide séparé de création de skills formule le même conseil en moins de 5 000 mots) spécifiquement pour borner ce coût. Niveau 3, tout fichier de référence ou script embarqué, ne se charge que si Claude l'ouvre réellement, et le code source d'un script n'entre jamais lui-même dans la fenêtre de contexte, seulement ce qu'il affiche sur stdout lors de son exécution. Le propre guide de 32 pages d'Anthropic sur la création de skills utilise une analogie culinaire qui mérite d'être citée directement : « MCP fournit la cuisine professionnelle : l'accès aux outils, aux ingrédients et à l'équipement. Les Skills fournissent les recettes : des instructions étape par étape. »

Où les Skills fonctionnent vraiment, et le forfait dont vous avez besoin

C'est le point qui mérite d'être précis, car deux pages d'Anthropic le décrivent différemment. Le centre d'aide grand public d'Anthropic déclare : « Les Skills sont disponibles pour les utilisateurs des forfaits Free, Pro, Max, Team et Enterprise. Cette fonctionnalité nécessite que l'exécution de code soit activée. » La documentation de la plateforme développeur d'Anthropic, décrivant la même fonctionnalité sous-jacente en termes plus techniques, indique que les skills personnalisés sont « disponibles sur les forfaits Pro, Max, Team et Enterprise avec l'exécution de code activée », et ajoute que sur claude.ai ils « ne sont pas partagés à l'échelle de l'organisation et ne peuvent pas être gérés de façon centralisée par les administrateurs ». Free est présent dans une phrase et absent de l'autre.

En les lisant ensemble, l'explication la plus probable est que les quatre skills de documents prédéfinis d'Anthropic, génération PDF, Word, Excel et PowerPoint, fonctionnent automatiquement pour tout le monde y compris les utilisateurs Free, tandis qu'importer et exécuter votre propre skill personnalisé nécessite Pro ou plus avec l'exécution de code activée. Si vous êtes sur le forfait Free et qu'un skill n'apparaît pas là où vous l'attendez, c'est probablement la raison, pas un bug.

Surface              Pre-built doc skills    Custom skills              Sharing model
----------------------------------------------------------------------------------------------
claude.ai              Yes, all plans          Pro/Max/Team/Enterprise    Per-user, no org
                        automatically           + code execution on       admin management
Claude Code             No (own reference       Yes, filesystem-based,    Personal (~/.claude),
                        skill ships instead)    no upload needed          project, or plugin
API                     Yes, via skill_id in    Yes, via /v1/skills       Workspace-wide, all
                        the container param     upload endpoints          members share access
Cowork / cloud          N/A                     Loads skills enabled on   Doesn't read your
sessions                                        your claude.ai account,  local ~/.claude/skills
                                                 synced at session start  unless committed to it
Enterprise (org-wide)   Inherits API behavior   Admins can push skills    Org-wide, automatic
                                                workspace-wide since     updates
                                                18 Dec 2025

La ligne qui mérite d'être anticipée est l'absence de synchronisation. Un skill importé via le panneau Réglages de claude.ai n'est pas visible pour les appels API, et un skill importé via l'endpoint /v1/skills de l'API n'apparaît pas sur claude.ai. Les skills de Claude Code sont de simples fichiers sur votre machine, dans ~/.claude/skills/ pour un usage personnel ou .claude/skills/ à l'intérieur d'un dépôt pour un skill de projet partagé, et une session cloud Cowork ne voit que ceux committés dans ce dépôt, pas ce qui se trouve sur votre ordinateur portable. Si vous construisez un bon skill, attendez-vous à devoir le réinstaller sur chaque surface que vous utilisez réellement, pas une seule fois pour toutes.

Comment l'installer et l'utiliser réellement aujourd'hui

• Sur claude.ai : Réglages → Capacités (appelé « Fonctionnalités » sur certains comptes) → Skills, puis soit « Parcourir les skills » pour ouvrir le propre répertoire d'Anthropic, soit « Importer un skill » pour ajouter un dossier zippé que vous avez construit ou téléchargé, et activez-le.
• Dans Claude Code : créez ~/.claude/skills/<nom>/SKILL.md pour un skill personnel, détecté en direct sans redémarrage, ou .claude/skills/<nom>/SKILL.md à l'intérieur d'un dépôt pour le partager avec votre équipe via le contrôle de version. Les skills officiels d'Anthropic s'installent via la marketplace de plugins : /plugin marketplace add anthropics/skills, puis /plugin install document-skills@anthropic-agent-skills. Invoquez un skill explicitement avec /skill-name, ou laissez Claude le charger automatiquement quand votre demande correspond à la description.
• Via l'API : référencez les skills prédéfinis d'Anthropic par skill_id (pdf, docx, pptx, xlsx) à l'intérieur du paramètre container d'un appel Messages API aux côtés de l'outil d'exécution de code, ou importez-en un personnalisé via les endpoints /v1/skills de la Console pour que tout l'espace de travail le partage.
• Créer le vôtre : utilisez le skill skill-creator lui-même, le méta-skill d'Anthropic pour construire des skills. Décrivez en langage naturel le flux de travail que vous répétez souvent, et il structure un SKILL.md correctement formaté, suggère une formulation de déclenchement pour la description, et signale les formulations trop vagues pour se déclencher de façon fiable. Le propre guide d'Anthropic présente cela comme un processus de 15 à 30 minutes une fois que vous connaissez vos deux ou trois tâches les plus répétées.

Skills contre MCP contre Custom GPTs contre Gemini Gems

La comparaison qui clarifie vraiment ce qu'est un skill est celle qu'Anthropic établit avec son propre MCP (Model Context Protocol) : « MCP connecte Claude à des services et sources de données externes. Les Skills fournissent des connaissances procédurales, des instructions sur la façon d'accomplir des tâches ou flux de travail précis. Vous pouvez utiliser les deux ensemble : les connexions MCP donnent à Claude l'accès à des outils, tandis que les skills apprennent à Claude comment utiliser ces outils efficacement. » Mécaniquement, MCP est un protocole qui expose de nouveaux outils, des capacités que Claude ne pourrait sinon vraiment pas exercer, comme appeler une API privée. Un Skill est du contenu de prompt plus du code facultatif qui indique à Claude comment enchaîner des appels d'outils qu'il peut déjà effectuer. C'est le cœur honnête de l'argument sceptique traité plus bas : un skill sans script ni connexion MCP derrière lui ne peut rien faire qu'un prompt ponctuel suffisamment détaillé ne pourrait déjà faire. Sa valeur tient à l'empaquetage et à la réutilisation économe en contexte, pas à une nouvelle capacité.

                 Claude Skills             MCP                      Custom GPTs (OpenAI)   Gemini Gems
-----------------------------------------------------------------------------------------------------------
Grants new        No - packages prompting   Yes - exposes new        No - system prompt +    No - saved
capability?       Claude already has        tools/API access         optional Actions        persona/prompt
Invocation        Automatic, matched to     Always-on connection     Manual - pick the GPT   Manual - switch
                  your request's wording    once configured          from a list             into the Gem
Portable across   Yes in spirit (open       Yes, it's a protocol,    No - ChatGPT only       No - Gemini
tools?            agentskills.io standard), works with any MCP                                ecosystem only
                  but doesn't sync accounts client
Entry cost        Pro+ for custom skills,   Varies by server, often  ChatGPT Plus/Team/       Included with
                  code execution required   free/self-hosted         Enterprise               most Gemini plans
Instruction       ~5,000 words recommended  N/A - it's a tool        Knowledge files, no      Reportedly capped
length limit      per SKILL.md              connection, not a prompt hard length limit stated ~4,000 characters

Cette dernière ligne pour Gemini Gems mérite une réserve : elle vient d'articles de comparaison tiers, pas d'une fiche technique publiée par Google, donc considérez le chiffre exact comme une approximation rapportée plutôt qu'une limite confirmée.

Est-ce juste du prompting déguisé ? L'argument sceptique

La critique publique la plus solide est celle de Sibylline Software, « Claude Skills Considered Harmful », et elle mérite d'être lue au-delà du titre car l'auteur en a ensuite partiellement rétropédalé. Son argument central : les skills lient vos flux de travail documentés au propre runtime d'Anthropic d'une façon qui rend le fait de migrer ailleurs ou d'auditer le comportement plus difficile qu'avec un simple fichier, et, cité directement, « vous n'avez aucune visibilité sur la raison pour laquelle un Skill s'est déclenché ni sur son influence sur le raisonnement du modèle », concluant que les Skills étaient « une micro-optimisation conçue pour fidéliser les clients, déguisée en innovation ». L'alternative proposée était une hiérarchie simple et versionnée de fichiers README.md que n'importe quel modèle pourrait lire, auditable par un humain et non liée au runtime d'un seul fournisseur.

Le texte porte son propre addendum, ajouté après qu'Anthropic a ouvert le format : « Depuis la rédaction de cet article, Anthropic a rendu la spécification des skills ouverte, et Codex en a implémenté la prise en charge. Je pense toujours que les skills sont surestimés, mais ils ne sont pas activement nuisibles. » L'argument de verrouillage fournisseur était la partie centrale de la critique initiale, et il a été substantiellement affaibli une fois que le format SKILL.md est devenu une norme ouverte (agentskills.io) que d'autres outils agentiques, pas seulement Claude, ont commencé à implémenter. Ce qui survit à cette rétractation, c'est le point plus étroit et toujours exact de la section précédente : un Skill sans code ni accès à un outil derrière lui est du prompting chargé sous conditions, pas une nouvelle capacité, et c'est une limite que le propre discours d'Anthropic reconnaît implicitement plutôt qu'il ne la conteste.

Des skills à connaître, nommément

Anthropic livre quatre skills prédéfinis par défaut, génération PDF, Word, Excel et PowerPoint, ce qui signifie une véritable sortie au format natif plutôt que du Markdown mis en forme pour ressembler à un document. Au-delà, skill-creator (le méta-skill pour construire des skills, à installer en premier) et frontend-design (du prompting orienté qualité d'interface pour les tâches de code) sont des créations propres à Anthropic. L'API fournit aussi un skill de référence open source qui maintient l'usage du SDK à jour sur huit langages.

La couche communautaire est plus vaste et plus précise que ne le suggèrent les pages marketing. Le dépôt awesome-claude-skills de ComposioHQ, capturé plus haut à 74,5 k étoiles et 8,6 k forks aujourd'hui, un signal réel et vérifiable de l'attention que cet écosystème reçoit des développeurs, liste des skills nommés et attribués incluant un Changelog Generator qui transforme des commits git en notes de version orientées utilisateur, un MCP Builder qui structure des serveurs MCP en Python ou TypeScript à partir d'une description en langage naturel, une bibliothèque Brand Build Skills de 59 skills couvrant tout le cycle de vie d'un site web, du SEO au déploiement, et Sentry Automation, un skill construit par un partenaire qui gère les issues, événements, projets, releases et alertes Sentry directement depuis Claude. Un skill partenaire connexe mais distinct, Sentry Code Review, listé sur le propre répertoire de plugins de Sentry plutôt que ce dépôt, utilise le serveur MCP de Sentry pour analyser et corriger automatiquement des bugs dans des pull requests GitHub à partir de vraies données d'erreurs de production.

Une source plus sélective est « I Tried 100 Claude Skills » du développeur Suraj Khaitan, qui a noté chaque skill testé selon une grille à cinq axes, l'un d'eux étant la posture de sécurité : si un skill effectue des appels réseau surprenants ou embarque des binaires opaques. Son propre taux d'élimination rapporté, sur son lot personnel d'environ 100, pas un chiffre représentatif du secteur, était d'environ 70 % en dessous de 3 sur 5 sur plus de deux axes. Ses préférés : PDF (« le skill qui a fait de moi un converti », grâce à un analyseur embarqué qui évite les champs de formulaire hallucinés), DOCX/PPTX/XLSX, skill-creator, qu'il dit falloir installer « avant tout autre » skill, mcp-builder, et webapp-testing, un skill d'automatisation de navigateur piloté par Playwright pour tester de bout en bout une application web.

Ce qui casse, et l'avertissement de sécurité que tout le monde répète

La propre documentation de la plateforme d'Anthropic énonce le risque sans détour, pas comme un simple avertissement de façade : « N'utilisez des Skills que provenant de sources fiables : celles que vous avez créées vous-même ou obtenues auprès d'Anthropic... un Skill malveillant peut amener Claude à invoquer des outils ou exécuter du code d'une façon qui ne correspond pas à l'objectif affiché du Skill. » Elle signale spécifiquement les skills qui récupèrent des URL externes comme à plus haut risque, puisque le contenu récupéré peut porter des instructions injectées, et avertit qu'un skill légitime peut devenir risqué plus tard si une dépendance externe dont il dépend change sous ses pieds. Les tests indépendants de Khaitan font écho à la même conclusion de l'extérieur : il recommande d'auditer chaque script embarqué avant d'installer, de figer les dépendances, de mettre en sandbox l'exécution, et de traiter « les badges partenaires comme du marketing, pas comme une garantie », pas un substitut à la lecture effective du code.

Les comptes Enterprise bénéficient d'une atténuation partielle : Anthropic propose un scan de contenu des skills, mais seulement pour les imports via claude.ai et Cowork, pas pour les skills importés via l'API ou la Console. Un skill personnalisé partagé à l'échelle de l'espace de travail et poussé via l'API ne passe pas du tout par ce scanner.

• Le coût en contexte s'accumule avec le volume. Le propre guide d'Anthropic avertit qu'au-delà d'environ 20 à 50 skills activés simultanément, une dégradation de la qualité des réponses apparaît en pratique, et recommande de désactiver les skills que vous n'utilisez pas actuellement plutôt que de tout laisser activé.
• Le sous- et le sur-déclenchement sont des modes d'échec nommés, avec des correctifs prescrits. Un skill qui ne se déclenche jamais a besoin d'une description plus précise, avec davantage des formulations que les utilisateurs tapent réellement ; un skill qui se déclenche trop souvent a besoin de déclencheurs négatifs explicites (« NE PAS utiliser pour... ») ajoutés au même champ.
• Le contenu d'un skill ne se rafraîchit pas en cours de session. Modifiez un fichier de skill après que Claude Code l'a déjà chargé dans la conversation en cours, et vous devrez le réinvoquer explicitement pour que le changement prenne effet.
• Les noms de fichiers exacts et les noms réservés comptent. SKILL.md doit être orthographié exactement ainsi, sensible à la casse, sinon le propre guide de dépannage d'Anthropic indique que vous obtiendrez « Could not find SKILL.md in uploaded folder ». Les noms de skills doivent être en kebab-case sans espaces ni majuscules, et tout nom contenant « claude » ou « anthropic » est rejeté d'office comme réservé.

Quand ne pas se donner la peine d'utiliser les Skills

• Si la tâche est vraiment ponctuelle. Empaqueter un prompt en skill ne rapporte que si vous auriez sinon retapé les mêmes instructions dans plusieurs conversations.
• Si ce dont vous avez vraiment besoin est une nouvelle capacité, pas du prompting mieux organisé. C'est le travail d'un serveur MCP, pas celui d'un skill. Installer un skill ne donnera pas à Claude l'accès à un système qu'il ne pouvait pas déjà atteindre.
• Si vous êtes sur le forfait Free et voulez un skill personnalisé. Vu l'incohérence d'accès par forfait décrite plus haut, l'hypothèse la plus prudente est que les imports personnalisés nécessitent Pro ou plus avec l'exécution de code activée, même si une page d'Anthropic laisse entendre le contraire.
• Si vous ne pouvez pas ou ne voulez pas lire le script embarqué du skill avant de l'installer. Les propres consignes de sécurité d'Anthropic et tous les testeurs indépendants ayant réellement audité des skills communautaires s'accordent sans exception sur ce point.

Questions fréquentes

Que sont les Claude Skills ?

Un Skill est un dossier contenant un fichier d'instructions SKILL.md obligatoire, plus des scripts, documents de référence et modèles facultatifs. Claude charge automatiquement le nom et la description du skill dans chaque conversation, et ne charge les instructions complètes que lorsqu'une demande correspond, un mécanisme appelé divulgation progressive.

Les Claude Skills coûtent-ils un supplément, et de quel forfait ai-je besoin ?

Les skills de documents prédéfinis d'Anthropic (PDF, Word, Excel, PowerPoint) fonctionnent sur tous les forfaits, y compris Free. Les skills personnalisés que vous construisez ou téléchargez nécessitent Pro, Max, Team ou Enterprise avec l'exécution de code activée, selon la documentation de la plateforme développeur d'Anthropic, même si la formulation du centre d'aide grand public est moins précise sur ce point.

Quelle est la différence entre un Skill et un serveur MCP ?

MCP connecte Claude à des outils et données externes qu'il ne pourrait sinon pas atteindre, une véritable nouvelle capacité. Un Skill empaquette des instructions sur la façon d'utiliser des capacités que Claude possède déjà, et n'apporte aucune nouvelle capacité par lui-même à moins d'embarquer un script ou une connexion MCP.

Est-il sûr d'installer des Claude Skills depuis GitHub ?

Seulement depuis des sources en qui vous avez assez confiance pour les avoir auditées. La propre documentation d'Anthropic avertit qu'un skill malveillant peut amener Claude à exécuter du code qui ne correspond pas à son objectif affiché, en particulier les skills qui récupèrent des URL externes. Les testeurs indépendants ayant essayé des dizaines de skills communautaires recommandent de lire chaque script embarqué avant d'installer, puisqu'un nombre d'étoiles GitHub ou un badge partenaire n'est pas une garantie de sécurité.

Combien de Claude Skills puis-je avoir installés en même temps ?

Les propres recommandations d'Anthropic situent le plafond souple à environ 20 à 50 skills activés simultanément avant que la qualité des réponses ne se dégrade sous la charge de contexte. Désactivez les skills que vous n'utilisez pas activement plutôt que de tout laisser activé.

Les Claude Skills fonctionnent-ils dans ChatGPT ou Gemini ?

Non, les Skills sont un produit spécifique à Claude, mais le format SKILL.md sous-jacent est une norme ouverte (agentskills.io) que d'autres outils agentiques, y compris certains produits non-Anthropic, ont commencé à adopter indépendamment.