Claude Skills : définition et mode d'emploi

Qu'est-ce qu'une compétence Claude (Claude Skill) ?

Une compétence Claude prend la forme d'un dossier rangé selon un format fixe, que Claude ouvre pour appliquer une méthode sans qu'on la lui réexplique. Anthropic la compare au guide d'accueil qu'une entreprise remet à un nouvel arrivant : la façon de procéder, les documents utiles, les outils à disposition. La différence tient au moment de la lecture.

Le nouvel arrivant lit tout le premier jour ; Claude n'en parcourt que la page de garde, puis ouvre le reste quand une tâche le demande.

Le seul fichier obligatoire s'appelle SKILL.md. Il est écrit en Markdown (un format de texte brut où un dièse marque un titre et un tiret une puce) et commence par un en-tête encadré par deux lignes de trois tirets.

Cet en-tête, au format YAML (une suite de lignes « champ : valeur »), porte deux champs exigés : name, le nom de la compétence, et description, qui dit ce qu'elle fait et dans quels cas s'en servir. Sous l'en-tête vient la méthode, rédigée comme une consigne : étapes, règles, exemples.

La spécification ouverte Agent Skills, tenue sur agentskills.io, suggère trois sous-dossiers facultatifs : references/ pour la documentation lue à la demande (grille de tarifs, procédure interne), assets/ pour les modèles, images et tables de correspondance, scripts/ pour le code que Claude lance quand une opération doit donner un résultat identique d'une fois sur l'autre.

La description sert de déclencheur

La description est la pièce maîtresse d'une compétence, parce qu'elle est la seule partie lue en permanence. Claude la confronte à votre demande pour décider s'il ouvre la compétence ; si les mots ne se rejoignent pas, la méthode reste fermée, aussi soignée soit-elle.

La documentation d'Anthropic appelle ce fonctionnement la divulgation progressive (progressive disclosure) et le décrit en trois niveaux.

Un token, l'unité de texte que traite le modèle, pèse quelques caractères : une compétence qui dort ne coûte que sa description, et vous pouvez en installer de nombreuses sans alourdir vos échanges.

Compétence, projet ou connecteur : trois outils qui se complètent

Un projet Claude garde des documents de fond chargés dans toutes ses conversations, quand une compétence ne s'active que pour la tâche qui la concerne, partout. Un connecteur MCP (le protocole qui relie Claude à un logiciel tiers) ouvre l'accès à un outil, et la compétence enseigne la manière de s'en servir.

Pour choisir entre prompt, projet, compétence et agent dans une équipe, ou voir comment ChatGPT, Copilot, Gemini et Vibe reprennent le format, lisez notre guide des prompts aux Skills pour capitaliser les méthodes d'une équipe.

Où utiliser les Claude Skills : claude.ai, Claude Code ou l'API ?

Les Claude Skills fonctionnent sur trois surfaces d'Anthropic, et chacune les range à sa manière ; Cowork et les compléments Office reprennent celles de votre compte. Le tableau résume le relevé fait le 1er novembre 2026 dans la documentation officielle.

Dans claude.ai, l'exécution de code doit être activée

Les compétences tournent dans l'environnement de calcul isolé de Claude, d'où ce prérequis. Sur les offres individuelles Free, Pro, Max et Ultra (la formule individuelle située au-dessus de Max), le réglage « Code execution and file creation » se trouve dans Settings, rubrique Capabilities ; il s'appelle « Create and edit files » dans la nouvelle présentation des réglages.

Côté Team et Enterprise, c'est un propriétaire de l'organisation qui ouvre l'exécution de code et les compétences dans Organization settings, rubrique Plugins & skills, onglet Policy, et le centre d'aide précise que la fonction est active par défaut sur Team. Si vos compétences apparaissent grisées, le centre d'aide invite à vérifier d'abord ce réglage.

Les skills dans Claude Code : des dossiers sur votre ordinateur

Claude Code, l'outil d'Anthropic qui travaille dans le terminal (la fenêtre de commandes de l'ordinateur) et dans les éditeurs de code, lit les compétences sur le disque. Un dossier placé dans ~/.claude/skills/ sert dans tous vos projets sur cette machine ; placé dans .claude/skills/ à la racine d'un dépôt, il sert à toutes les personnes qui travaillent sur ce dépôt.

Vous laissez Claude choisir la compétence, ou vous la lancez vous-même : une barre oblique, puis son nom, par exemple /compte-rendu-reunion.

Selon le centre d'aide de Claude et la page consacrée aux compétences dans la documentation de Claude Code, relevés le 1er novembre 2026, les compétences activées sur votre compte claude.ai se chargent aussi dans le terminal dès la version 2.1.273, quand vous vous connectez avec ce compte.

Le transfert va dans un seul sens, avec une recherche de changements environ toutes les dix minutes pendant le travail, et la commande /skills les range sous la mention « claude.ai sync ». Il ne fonctionne pas quand Claude Code s'identifie par une clé d'API ou passe par un fournisseur cloud comme Amazon Bedrock.

Sur l'API, les compétences appartiennent à l'espace de travail

Pour les équipes techniques, une compétence se téléverse par le point d'accès /v1/skills (une adresse de l'API), puis se cite dans le paramètre container de la requête, aux côtés de l'outil d'exécution de code.

La documentation fixe un plafond de 20 compétences par requête et de 30 Mo par compétence ; le conteneur d'exécution n'a pas accès au réseau et n'installe aucun paquet logiciel en cours de route. Entre l'API et claude.ai, la cloison reste entière : chaque surface demande son propre téléversement.

Comment installer un skill sur Claude ?

Installer une compétence dans claude.ai prend quelques clics une fois l'exécution de code activée, et une copie de dossier suffit dans Claude Code.

Installer une compétence dans claude.ai

1. 1Ouvrez le menu Customize, à gauche de l'écran, puis son onglet Skills.
2. 2Pour une compétence du répertoire, cliquez sur « + », puis sur « Browse skills », et choisissez « Add » sur celle qui vous intéresse.
3. 3Pour une compétence reçue sous forme de fichier, cliquez sur « + », puis sur « + Create skill » et « Upload a skill », et sélectionnez l'archive ZIP.
4. 4Contrôlez l'interrupteur placé à côté de la compétence : désactivée, elle reste invisible pour Claude.
5. 5Lancez une nouvelle conversation et formulez une demande proche de sa description.

Le répertoire réunit les compétences d'Anthropic et celles de partenaires comme Notion, Figma ou Atlassian, conçues pour aller avec leurs connecteurs. Une compétence ajoutée depuis le répertoire reste en lecture seule ; pour l'adapter, le centre d'aide conseille d'en télécharger une copie, de la modifier, puis de la téléverser comme une compétence à vous.

Installer une compétence dans Claude Code

Dans Claude Code, il suffit de copier le dossier au bon endroit : Claude Code repère l'ajout pendant la session, et la commande /reload-skills prend en compte un dossier skills créé après le lancement. Les compétences d'exemple d'Anthropic s'installent comme un plugin (un paquet qui regroupe compétences, commandes et réglages), en deux commandes.

La première commande déclare le dépôt d'Anthropic comme source de plugins, la seconde installe le lot des compétences de documents (Word, Excel, PowerPoint, PDF). Le lot example-skills, tiré du même dépôt, rassemble les autres exemples.

Comment créer un skill Claude pas à pas ?

Créer un skill Claude demande surtout de savoir décrire une tâche que vous maîtrisez déjà, et aucune ligne de code pour une compétence simple. Le bon point de départ est une tâche que vous avez déjà expliquée plusieurs fois à Claude, et dont vous savez montrer un résultat réussi.

Le centre d'aide d'Anthropic résume la matière à fournir en trois éléments : le format attendu, le ton, et un exemple qui vous a satisfait. Gardez une tâche par compétence : Anthropic recommande plusieurs compétences ciblées, qui se combinent mieux qu'une seule chargée de tout faire.

Première voie : demander à Claude de l'écrire

Ouvrez un nouvel échange et annoncez votre intention, par exemple : « Je veux créer une compétence pour rédiger les comptes rendus de nos réunions d'équipe. » Joignez un compte rendu jugé réussi ou votre modèle de document, puis répondez aux questions de Claude avec assez de détails pour qu'une personne compétente, mais nouvelle dans l'équipe, puisse suivre.

Claude consulte sa propre compétence de création, skill-creator, rédige le fichier SKILL.md, range vos pièces jointes et produit un fichier de compétence à enregistrer. Pour corriger un passage, surlignez-le dans le fichier affiché près de l'échange, puis cliquez sur « Edit with Claude ».

Sur Mac, Cowork (l'espace de Claude qui conduit un travail de bout en bout sur vos dossiers) permet aussi d'enregistrer la tâche pendant que vous la réalisez, avec le bouton « + » puis « Record a skill ». Au 1er novembre 2026, l'option est réservée aux offres Pro, Max, Ultra et Team, hors Windows.

Un enregistrement dure au plus une dizaine de minutes et capte tout l'écran ainsi que la voix : fermez ce qui n'a pas de rapport et ne tapez aucun mot de passe. Notre formation Claude Cowork fait transformer en compétence une tâche réussie le matin, puis la tester sur un second dossier.

Seconde voie : écrire le dossier vous-même

Écrire la compétence à la main donne la maîtrise complète de sa structure. Huit étapes suffisent pour une première compétence.

1. 1Créez un dossier dont le nom ne contient que des minuscules, des chiffres et des tirets, par exemple compte-rendu-reunion.
2. 2Dans ce dossier, créez le fichier SKILL.md, un simple fichier texte.
3. 3En haut du fichier, écrivez l'en-tête entre deux lignes de trois tirets, avec les champs name et description.
4. 4Sous l'en-tête, rédigez la méthode : étapes numérotées, contrôles à faire, renvoi vers les fichiers annexes.
5. 5Rangez les pièces de référence (exemple réussi, modèle, barème) dans un sous-dossier references/.
6. 6Compressez le dossier au format ZIP, en gardant le dossier lui-même à la racine de l'archive.
7. 7Téléversez l'archive dans Customize > Skills, ou copiez le dossier dans .claude/skills/ pour Claude Code.
8. 8Essayez la compétence dans une nouvelle conversation, avec une demande formulée comme d'habitude.

Quelques règles évitent les refus au téléversement. Le champ name compte au plus 64 caractères, en minuscules, chiffres et tirets, sans tiret au début ni à la fin et sans double tiret ; il reprend le nom du dossier, et la documentation de la plateforme y interdit les mots anthropic et claude.

Le champ description accepte 1 024 caractères selon la spécification et l'API, mais le centre d'aide de claude.ai le limite à 200 : restez sous ce seuil pour qu'une même compétence passe partout. Gardez enfin le corps de SKILL.md sous 500 lignes, comme le conseille Anthropic, et déplacez le surplus dans des fichiers séparés.

Un exemple complet : la compétence compte-rendu-reunion

L'exemple qui suit couvre une tâche que presque toutes les équipes répètent : tirer un compte rendu propre des notes prises en séance.

Le second fichier, references/exemple-valide.md, accueille un compte rendu que l'équipe juge réussi ; Claude ne l'ouvre qu'à la rubrique « Exemple ». La description, écrite à la troisième personne comme le demande Anthropic, reprend les mots de vos collègues.

Les étapes fixent ce que Claude ignore de vos habitudes, et les contrôles barrent la route à l'erreur la plus coûteuse d'un compte rendu : une décision qui n'a jamais été prise. Rien n'explique ce qu'est une réunion : Anthropic conseille de supposer que Claude le sait déjà.

Tester la compétence avant de s'y fier

Voir la compétence se déclencher prouve que Claude l'a trouvée ; il reste à vérifier qu'elle produit ce que vous attendiez.

• Dans une nouvelle conversation, demandez la tâche avec vos mots habituels. Dans le raisonnement affiché par Claude, « Reading » ou « Using » suivi du nom de la compétence confirme le déclenchement.
• Posez une demande voisine qui ne doit pas la déclencher, comme l'écriture du mail qui invite à la réunion.
• Comparez la sortie à l'exemple validé ; ce que vous corrigeriez encore à la main mérite une ligne de plus dans la compétence.
• Si la compétence reste muette, retouchez la description ou citez-la par son nom dans la demande.
• Essayez-la avec chacun de vos modèles : Anthropic prévient qu'une consigne suffisante pour Opus peut manquer de détails pour Haiku.

La conversation neuve compte, selon la documentation de Claude Code, parce que le contexte de l'échange qui a servi à écrire la compétence masque les manques des instructions.

Le même réflexe vaut pour les données : en septembre 2026, lors d'une formation individuelle Masteria, la personne chargée des analyses et des données d'un groupe immobilier a mis à l'épreuve sa première compétence, consacrée à une note récurrente, sur un autre fichier que celui de départ (parcours de la responsable études).

Dans Claude Code, le plugin skill-creator automatise ces essais avec et sans la compétence, et notre formation Claude Code consacre un module aux compétences, aux sous-agents et aux hooks.

Quelles compétences Anthropic fournit-il ?

Anthropic livre d'office quatre compétences de documents, et son dépôt GitHub anthropics/skills comptait dix-neuf dossiers de compétences au 1er novembre 2026.

Les compétences Word, Excel, PowerPoint et PDF font tourner la création de fichiers dans claude.ai : Claude les emploie sans qu'on les nomme, et demander une présentation sur les résultats du trimestre suffit à mobiliser la compétence PowerPoint.

Sur l'API, elles s'appellent par leurs identifiants pptx, xlsx, docx et pdf ; Claude Code ne les intègre pas d'office, mais peut les recevoir par le plugin document-skills.

Anthropic présente les exemples du dépôt comme des démonstrations, à tester avant de leur confier une tâche sensible. Son centre d'aide conseille de commencer par les compétences d'Anthropic : en ouvrir deux ou trois montre comment leurs auteurs tournent une description et découpent une méthode.

Comment partager une compétence avec son équipe ?

Le partage d'une compétence dépend de l'offre : chacun la garde pour soi sur les offres individuelles, alors que Team et Enterprise ouvrent le partage entre collègues et la publication à l'organisation.

Une compétence partagée reste la propriété de son auteur. Elle apparaît chez chaque destinataire avec le nom de l'auteur, grisée tant qu'il ne l'a pas activée, en lecture seule, et chaque mise à jour parvient à tous lors de l'utilisation suivante. L'accès tombe de lui-même au départ de la personne.

Publier confie la compétence à l'organisation. Dans Customize > Skills, le bouton « Publish to org » la soumet à la bibliothèque commune.

Quand une relecture est exigée, l'auteur propose la façon de l'offrir (disponible à l'installation, installée par défaut, ou obligatoire), puis un propriétaire ou une personne habilitée valide chaque version et choisit qui la reçoit ; en attendant, les utilisateurs restent sur la version approuvée.

D'après le centre d'aide relevé le 1er novembre 2026, les organisations Enterprise qui n'ont jamais fixé de politique de publication et qui ont activé l'analyse de sécurité passent à partir du 4 novembre 2026 de « Requires review » à « Open » : une compétence publiée entre alors dans la bibliothèque dès qu'elle passe l'analyse automatique.

Pour garder une relecture humaine, l'administrateur doit choisir « Requires review » lui-même.

Dans Claude Code, le partage passe par les fichiers : un dossier .claude/skills/ enregistré dans le dépôt Git du projet (l'outil qui conserve chaque version des fichiers) parvient à toute l'équipe, et un plugin ou les réglages gérés par l'entreprise diffusent un lot de compétences.

Qui écrit, qui relit et à quel rythme revoir chaque compétence : ces questions d'organisation sont traitées dans notre guide des prompts aux Skills pour capitaliser les méthodes d'une équipe.

Un exemple : onze compétences Claude portées par dix référents

En juin 2026, Masteria a formé dix référents d'un distributeur informatique qui vend aux entreprises.

Cette filiale française d'un groupe européen compte 58 salariés ; la formation a duré deux jours, chaque référent sur son propre projet, et onze compétences Claude en sont sorties, de la cotation tirée d'un mail client aux relances de devis, sans oublier les cahiers des charges, la prospection et les stocks. Aucune compétence n'est diffusée sans la validation de la direction.

Livrées avec des données fictives, elles reçoivent les données de l'entreprise, de la main de chaque référent, avant de passer en production. L'ouverture au reste de l'entreprise est prévue d'octobre à décembre 2026 (étude de cas du distributeur IT).

Quelles sont les limites des Claude Skills ?

Une compétence reste une consigne que le modèle interprète, avec les accès et les contraintes de la surface où elle tourne. Outre le prérequis de l'exécution de code et le cloisonnement des surfaces, cinq limites méritent d'être connues avant de bâtir dessus.

• Le déclenchement dépend des mots. Claude choisit d'après la description : une formulation vague laisse la compétence de côté, une formulation trop large la fait intervenir à tort.
• Les champs propres à Claude Code ne passent pas ailleurs. Un téléversement sur claude.ai ou sur l'API n'accepte que les champs de la spécification (name, description, license, compatibility, metadata, allowed-tools) ; un champ comme disable-model-invocation y provoque une erreur.
• L'accès au réseau varie. Il est nul sur l'API, variable selon les réglages sur claude.ai, et identique à celui de n'importe quel programme de l'ordinateur dans Claude Code.
• Une compétence ne peut pas en appeler une autre par son nom. Claude sait en revanche en combiner plusieurs de lui-même pour une même tâche.
• Les données suivent la conservation standard. Anthropic indique que les compétences ne relèvent pas des accords de conservation zéro des données (zero data retention).

Dans Claude Code, chaque description installée occupe une place à chaque échange ; la commande /skill-doctor repère les compétences coûteuses qui ne servent jamais.

Pourquoi ne jamais installer une compétence d'origine inconnue ?

Une compétence transmet à Claude des consignes, et quelquefois du code, qu'il exécute avec vos accès, ce qui la rapproche d'un logiciel à installer. La documentation d'Anthropic ne range parmi les sources de confiance que les compétences que vous avez écrites vous-même et celles qu'Anthropic fournit.

Le centre d'aide cite deux risques principaux : l'injection de prompt (un texte piégé qui glisse à l'assistant des ordres que vous n'avez pas donnés) et l'exfiltration de données (leur envoi discret vers l'extérieur), par du code malveillant ou par des contenus piégés.

Une compétence d'apparence utile peut ainsi pousser Claude à appeler des outils, à lire des fichiers ou à lancer du code sans rapport avec son objet affiché, et le danger grandit avec les accès de l'environnement. Avant d'activer une compétence reçue, même d'un collègue, quatre vérifications s'imposent.

• Lisez tous les fichiers du dossier : SKILL.md, scripts, images et ressources.
• Cherchez les appels réseau vers des adresses inconnues et les accès à des fichiers sans lien avec la tâche annoncée.
• Méfiez-vous des compétences qui vont chercher du contenu sur des adresses web externes : ce contenu peut porter des instructions malveillantes, et une dépendance fiable au moment de l'installation peut changer ensuite.
• Vérifiez qu'aucun mot de passe ni aucune clé d'API n'est écrit en clair dans les fichiers, et n'en placez jamais dans les vôtres.

Les organisations Enterprise disposent d'un garde-fou de plus : l'analyse des compétences et des plugins, activée par défaut pour celles qui n'avaient pas choisi de réglage avant le 2 octobre 2026. Chaque compétence tierce téléversée ou modifiée reçoit l'un de trois verdicts, réussite, avertissement ou échec, ce dernier bloquant son usage.

Le centre d'aide borne lui-même l'exercice : l'analyse ne couvre ni les compétences créées avec Claude ni celles partagées par un serveur MCP, et un verdict favorable ne garantit pas qu'une compétence se comporte comme vous l'attendiez.

Un dossier téléchargé depuis un site de partage ou un dépôt inconnu se lit donc en entier avant d'être activé, comme un contrat avant la signature.

Le vocabulaire des Claude Skills

Par où commencer avec les Claude Skills ?

Activez l'exécution de code, ouvrez Customize > Skills et regardez une compétence d'Anthropic au travail en demandant une note au format Word ou un diaporama. Choisissez ensuite une tâche que vous avez déjà expliquée plusieurs fois à Claude, demandez-lui d'en faire une compétence avec votre format, votre ton et un exemple réussi, puis essayez-la dans une conversation neuve.

Notre bibliothèque de prompts classée par métier fournit de la matière à transformer, et le détail des offres figure sur notre page prix et abonnements de Claude. La formation Claude de Masteria fait construire et tester ces premières compétences sur les tâches des participants, à partir de 1 980 € HT la journée.

Écrire une compétence oblige à formuler ce que l'on fait d'instinct. Ce travail de description sert Claude, et souvent d'abord l'équipe qui s'y attelle.

Sources officielles relevées le 1er novembre 2026 : Anthropic, Agent Skills (vue d'ensemble), Anthropic, bonnes pratiques de rédaction des compétences, Anthropic, compétences sur l'API, documentation Claude Code, Extend Claude with skills, Help Center, What are skills?, Help Center, Using skills in Claude, Help Center, How to create custom skills, Help Center, create a skill through conversation, Help Center, Teach Claude your way of working, Help Center, Provision and manage skills, Help Center, Browse skills, connectors and plugins, Help Center, Skill and plugin scanning, spécification Agent Skills, dépôt GitHub anthropics/skills, Anthropic, page tarifs. Fonctions, noms de menus et calendriers susceptibles d'évoluer.

Questions fréquentes

Vous voulez que vos équipes créent leurs premières compétences Claude ?

La formation Claude de Masteria fait écrire et tester des compétences sur les tâches de vos équipes, dans claude.ai, Cowork ou Claude Code selon les profils.