Anthropic révolutionne Claude avec des compétences personnalisées

Le défi de la personnalisation avec Claude

Chaque fois que vous engagez une nouvelle conversation avec Claude, vous devez rétablir vos préférences et votre contexte. Cela inclut votre format de sortie préféré, le style d'écriture de votre équipe, le vocabulaire spécifique à votre domaine et vos normes de qualité. Pour une question ponctuelle, cela peut être acceptable, mais pour un travail professionnel répétitif, cela devient une contrainte majeure à chaque interaction.

Introduction des compétences Claude

Les compétences Claude ont été introduites comme une solution à ce problème. Une compétence est un ensemble d'instructions que vous créez une fois et que Claude charge automatiquement lorsque la tâche l'exige. Cela signifie que vos préférences, vos flux de travail et votre expertise de domaine sont intégrés dans la compétence, éliminant le besoin de les réinsérer à chaque conversation. Lancées en octobre 2025, ces compétences sont rapidement devenues le moyen dominant de doter Claude de capacités spécifiques à un domaine dans Claude Code, Claude Desktop et l'API Claude.

Anthropic a publié le dépôt officiel des compétences sur GitHub comme référence de travail sur la façon dont les compétences doivent être structurées. En mai 2026, le dépôt comptait plus de 141 000 étoiles et plus de 16 000 forks, ce qui en fait l'un des dépôts d'outils IA les plus suivis sur GitHub.

Comprendre les compétences Claude

Une compétence Claude est essentiellement un dossier. À l'intérieur, vous trouverez un fichier SKILL.md obligatoire et, éventuellement, des répertoires pour le code exécutable, la documentation et les fichiers de support. Contrairement à des plugins ou des modèles, ces compétences sont des instructions open-source en markdown.

Architecture et fonctionnement

Les compétences Claude reposent sur une architecture de divulgation progressive à trois niveaux, minimisant l'utilisation des tokens tout en maintenant une expertise spécialisée. Le YAML frontmatter est toujours chargé, coûtant environ 100 tokens par compétence, peu importe combien de compétences sont installées. Cette couche de métadonnées donne à Claude juste assez d'informations pour décider si la compétence est pertinente pour la tâche actuelle sans charger le contenu complet.

Le corps de SKILL.md est chargé lorsque Claude détermine que la compétence est pertinente. Cela contient les instructions complètes, les flux de travail étape par étape, des exemples et des conseils de dépannage. Les fichiers référencés sont des fichiers supplémentaires dans references/ et assets/ que Claude navigue uniquement lorsque la tâche l'exige. De longs guides de référence API, des spécifications de style détaillées ou des sections de dépannage étendues se trouvent ici plutôt que dans le fichier principal. Ce système signifie que vous pouvez avoir plusieurs compétences installées simultanément sans alourdir le contexte de Claude ; seule la frontmatter de chaque compétence se charge par défaut.

Trois principes de conception régissent l'ensemble du système : la divulgation progressive, comme décrit ci-dessus. Composabilité — cela signifie que Claude peut charger plusieurs compétences simultanément, donc votre compétence doit bien fonctionner aux côtés des autres plutôt que de supposer qu'elle est la seule capacité disponible. Portabilité — les compétences fonctionnent de manière identique sur Claude.ai, Claude Code et l'API. Construisez une compétence une fois, et elle fonctionne sur toutes les surfaces sans modification, tant que l'environnement prend en charge les dépendances requises par la compétence.

Pour les équipes construisant sur des serveurs Model Context Protocol (MCP), les compétences ajoutent une couche de connaissance au-dessus de la connectivité. La façon dont Anthropic le présente dans le guide officiel : le MCP fournit la cuisine professionnelle — accès aux outils, ingrédients et équipements. Les compétences fournissent les recettes et les instructions étape par étape pour créer quelque chose de précieux. Le MCP dit à Claude ce qu'il peut faire. Les compétences disent à Claude comment bien le faire.

Planifier votre compétence avant d'écrire une ligne

L'erreur la plus courante lors de la construction d'une compétence est de commencer par la structure des fichiers plutôt que par le cas d'utilisation. Le guide d'Anthropic est explicite : identifiez deux ou trois cas d'utilisation concrets avant de toucher à des fichiers.

Un cas d'utilisation bien défini répond à quatre questions :

• Que veut accomplir un utilisateur ?
• Quel flux de travail en plusieurs étapes cela nécessite-t-il ?
• Quels outils sont nécessaires — les capacités intégrées de Claude, ou des outils connectés via MCP ?
• Quelle connaissance de domaine ou meilleures pratiques devraient être intégrées que l'utilisateur devrait autrement expliquer à chaque session ?

Une définition concrète d'un cas d'utilisation ressemble à ceci :

Cas d'utilisation : Rédaction d'un article de blog

Déclencheur : L'utilisateur dit "rédige un article de blog", "rédige du contenu pour notre blog", ou "crée un post suivant notre guide de style".

1. Lire le guide de style depuis references/style-guide.md.
2. Confirmer le sujet et le public cible avec l'utilisateur.
3. Rédiger en suivant la structure des en-têtes et les directives de ton.
4. Exécuter la liste de contrôle de qualité avant de livrer le brouillon.

Résultat : Un brouillon complet qui correspond au guide de style de l'entreprise sans que l'utilisateur ait besoin de coller des directives dans le chat.

L'équipe d'Anthropic a observé trois catégories qui couvrent la plupart des cas d'utilisation des compétences :

• Création de documents et d'actifs : Création de documents, présentations, conceptions frontend et code de haute qualité et cohérents. La caractéristique définissante est l'intégration de guides de style et de listes de contrôle de qualité. L'exécution de code intégrée de Claude et la création de documents gèrent la sortie sans outils externes requis. Le dépôt officiel des compétences d'Anthropic contient des compétences de qualité production, y compris des compétences documentaires pour la manipulation de docx, pdf, pptx et xlsx. La compétence de conception frontend est l'exemple canonique ici ; elle intègre des tokens de système de design et des conventions de composants afin que chaque interface utilisateur générée suive les mêmes normes.

• Automatisation des flux de travail : Processus en plusieurs étapes avec une méthodologie cohérente, pipelines de recherche, flux de contenu et séquences d'intégration. Les techniques clés sont des flux de travail étape par étape avec des portes de validation entre les étapes, des modèles pour des structures répétées, et des boucles de raffinement itératif. La compétence skill-creator (qui est incluse dans le dépôt officiel d'Anthropic et aide à construire d'autres compétences) est l'exemple de référence ; elle guide les utilisateurs à travers la définition du cas d'utilisation, la génération de frontmatter et la validation comme un flux de travail guidé.

• Amélioration du MCP : Orientation des flux de travail superposée à un serveur MCP fonctionnel. Si vos utilisateurs ont connecté Notion, Linear ou Sentry via MCP mais ne savent pas quels flux de travail exécuter, une compétence d'amélioration MCP fournit la couche de connaissance — séquençant les appels d'outils, intégrant l'expertise de domaine et gérant les erreurs. La compétence de révision de code de Sentry, qui analyse et corrige automatiquement les bogues dans les pull requests GitHub en utilisant les données MCP de Sentry, est l'exemple de référence du guide officiel d'Anthropic.

Avant d'écrire le contenu de SKILL.md, définissez vos critères de succès. Anthropic recommande deux types. Quantitatifs : la compétence se déclenche sur au moins 90 % des requêtes pertinentes, complète le flux de travail dans un nombre défini d'appels d'outils, et produit zéro appel API échoué par exécution. Qualitatifs : les utilisateurs n'ont pas besoin de rediriger Claude en cours de flux de travail, les sorties sont structurellement cohérentes à travers des exécutions répétées, et un nouvel utilisateur peut accomplir la tâche dès le premier essai sans guidance. Ce sont des repères approximatifs plutôt que des seuils stricts, mais les définir à l'avance vous donne quelque chose de concret contre quoi tester.

Les exigences techniques

C'est ici que la plupart des compétences échouent silencieusement. Les règles sont strictes, et les erreurs qu'elles produisent sont déroutantes car Claude ne chargera tout simplement pas une compétence qui les viole — sans message d'erreur pour expliquer pourquoi.

Structure des fichiers

your-skill-name/
├── SKILL.md              # Obligatoire -- fichier principal de la compétence
├── scripts/              # Optionnel -- code exécutable
│   ├── process_data.py
│   └── validate.sh
├── references/           # Optionnel -- documentation chargée au besoin
│   ├── api-guide.md
│   └── examples/
└── assets/               # Optionnel -- modèles, polices, icônes
└── report-template.md

Règles de nommage critiques

• SKILL.md est sensible à la casse. Le fichier doit être nommé exactement SKILL.md. Des variations comme skill.md, SKILL.MD, ou Skill.md ne seront pas reconnues. Claude ne chargera tout simplement pas la compétence — pas d'erreur, pas d'avertissement.

• Les noms de dossiers doivent utiliser le kebab-case. Lettres minuscules et tirets uniquement. Pas d'espaces (Notion Project Setup), pas de tirets bas (notion_project_setup), pas de majuscules (NotionProjectSetup). Le nom du dossier doit correspondre exactement au champ de nom dans votre frontmatter.

• Pas de README.md à l'intérieur du dossier de compétence. Toute la documentation pour Claude va dans SKILL.md ou references/. Si vous distribuez sur GitHub, mettez votre README lisible par un humain à la racine du dépôt, pas à l'intérieur du dossier de compétence lui-même.

• Noms réservés : les noms de compétences ne peuvent pas contenir "claude" ou "anthropic" ; ceux-ci sont réservés par Anthropic et seront rejetés.

• Pas de chevrons XML dans la frontmatter. La frontmatter apparaît directement dans l'invite système de Claude. Un contenu de type XML pourrait injecter des instructions non intentionnelles, donc il s'agit d'une restriction de sécurité appliquée au niveau de la plateforme.

YAML Frontmatter

La frontmatter est la façon dont Claude décide de charger votre compétence. Si elle est faible ou manque de conditions de déclenchement, la compétence ne s'activera pas de manière fiable. C'est le mode d'échec le plus courant.

Format minimal requis :

name: your-skill-name
description: Ce qu'elle fait. Utilisez lorsque l'utilisateur demande [phrases spécifiques].

Le champ name doit être en kebab-case et correspondre exactement au nom du dossier.

Le champ description doit inclure à la fois ce que fait la compétence et quand l'utiliser. La limite de caractères est de 1024. Selon les conseils d'ingénierie d'Anthropic, ce champ fournit juste assez d'informations à Claude pour savoir quand chaque compétence doit être utilisée sans charger tout cela dans le contexte. Descriptions sans conditions de déclenchement...