Blank white background with no objects or features visible.

Bonjour, zone EMEA ! TrueFoundry étend sa présence en Europe, au Moyen-Orient et en Afrique. En savoir plus. →

Meilleures compétences Claude Code pour les développeurs en 2026

Published: novembre 20, 2026

TL;DR :

Une compétence est le moyen le plus économique d'améliorer l'efficacité de Claude Code sur votre codebase — car elle ne consomme des tokens que lorsqu'elle est réellement utilisée.

  • Une compétence est un ensemble d'instructions et de ressources SKILL.md qui se charge à la demande lorsque la tâche correspond, au lieu de rester dans le contexte pendant toute la session comme le fait CLAUDE.md.
  • Seuls le nom et la description restent résidents — quelques dizaines de tokens par compétence. Le corps et les fichiers associés se chargent de manière progressive, uniquement lorsque cela est nécessaire.
  • Les compétences ne sont ni des sous-agents ni des outils MCP. Une compétence injecte des connaissances, un sous-agent isole le travail dans sa propre fenêtre de contexte, et un serveur MCP ajoute des outils externes. La plupart des équipes ont besoin des trois.
  • Les meilleures compétences éliminent la phase d'exploration. Une vue d'ensemble du codebase (codebase-overview), un exécuteur de tests (test-runner), un guide de migration (migration playbook) ou une checklist de revue de PR évitent à Claude de dépenser des tokens à redécouvrir ce que vous savez déjà.
  • Elles permettent de réaliser de véritables économies. Chaque fichier que Claude n'a pas besoin de lire représente des tokens d'entrée que vous ne payez pas — et cet effet se cumule à l'échelle d'une équipe.
  • À l'échelle d'une équipe, les compétences nécessitent du versionnement et de la gouvernance, et non des copies dispersées sur les ordinateurs portables — c'est là qu meublent un registre partagé et une passerelle IA (AI gateway).

Ce qu'est réellement une compétence Claude Code

Une compétence est un dossier contenant un fichier SKILL.md à sa racine : une brève description du moment où elle s'applique, suivie des instructions et de tout fichier d'aide que Claude doit utiliser le cas échéant. Claude Code lit uniquement le nom et la description au préalable ; le corps complet n'est chargé dans le contexte que lorsqu'une tâche correspond. Cette propriété unique — le chargement à la demande — est ce qui rend les compétences très peu coûteuses.

À l'inverse, le fichier CLAUDE.md est chargé au début de la session et reste présent dans le contexte pendant toute la conversation. Les instructions de workflow détaillées qui y figurent consomment des tokens sur chaque message, même lors de travaux sans rapport. La bonne pratique consiste à conserver un fichier CLAUDE.md concis — restreint aux essentiels — et à déplacer les connaissances spécialisées et situationnelles vers des compétences qui se chargent en cas de besoin. Consultez notre note à ce sujet dans Tarification de Claude Code et comment réduire les coûts.

Anatomie d'un fichier SKILL.md et optimisation du contexte par le chargement à la demande

Une compétence se compose de trois parties, et comprendre où chacune réside dans le contexte est la clé du système. Le frontmatter YAML — un nom et une description — est la seule partie à être toujours résidente : Claude Code lit le frontmatter de chaque compétence installée au début de la session afin de savoir quelles compétences existent et quand chacune s'applique. Un nom accompagné d'une description d'une ligne ne représente que quelques dizaines de tokens, ce qui permet de conserver toute une bibliothèque de compétences installées pour un coût presque nul.

Le corps — le contenu Markdown situé sous le frontmatter — contient les véritables instructions : conventions, listes d'étapes, règles de décision, extraits de code. Il ne se charge pas au début de la session. Il n'est chargé que lorsque le modèle décide, d'après la description, que la tâche correspond ; il est alors lu pour cette phase de travail, puis disparaît de fait. Un corps lu une seule fois, lorsqu'il est pertinent, coûte une fraction du même texte ancré dans CLAUDE.md tout au long de la session.

La troisième partie concerne les ressources intégrées : des fichiers supplémentaires dans le dossier — documentation de référence, modèles, jeux de données de test (fixtures), scripts légers — vers lesquels le corps pointe, et qui ne se chargent que si la tâche suit un lien menant à eux. Il s'agit d'un chargement progressif (progressive disclosure) : chaque niveau n'est extrait que lorsque le précédent indique qu'il est nécessaire, de sorte qu'une compétence vaste et détaillée conserve un coût de repos quasi nul. La leçon à retenir : le coût d'une compétence ne dépend pas de sa taille, mais de sa fréquence de déclenchement.

NiveauContenuArrivée dans le contexteCoût au repos
Frontmatter (nom + description)Identité de la compétence et cas d'applicationToujours — lu au début de la sessionQuelques dizaines de tokens par compétence
Corps (instructions SKILL.md)Conventions, étapes et règles applicablesLors d'une correspondance — quand la tâche correspond à la descriptionZéro jusqu'au déclenchement
Ressources intégréesFichiers de référence, modèles, scripts liés dans le corpsLors d'une référence — uniquement si le fichier est nécessaireZéro jusqu'à l'ouverture

Compétences vs sous-agents vs outils MCP

Ces trois notions sont fréquemment confondues, et choisir la mauvaise option risque de faire exploser vos budgets de contexte. Elles répondent à des besoins différents :

DimensionCompétence (Skill)Sous-agent (Subagent)Outil MCP
NatureUn ensemble SKILL.md d'instructions et de ressourcesUne instance Claude distincte avec sa propre fenêtre de contexteUn outil externe exposé via le Model Context Protocol
Moment de chargementÀ la demande, lorsque la tâche correspond à sa descriptionLors de la délégation d'une tâche volumineuse ou isoléeLes définitions d'outils sont différées ; chargement à l'utilisation
Apport à ClaudeConnaissances — quoi faire et commentUn espace pour déléguer du travail et retourner un résuméUn élément à appeler — une action ou une source de données
Impact sur le contexteAjoute de manière brève des instructions à la conversationConserve les sorties verbeuses hors du contexte principalConserve les schémas d'outils hors du contexte jusqu'à l'appel
Idéal pourConventions, guides opératoires (playbooks), checklists de revueTests, tri de logs, refactorisations d'ampleur, rechercheAPI, bases de données, SaaS et systèmes internes

Une règle simple : si vous enseignez à Claude ce qu'il doit faire, il s'agit d'une compétence ; si vous lui donnez un espace pour déléguer du travail, c'est un sous-agent ; si vous lui fournissez un élément à appeler, c'est un serveur MCP. Ces éléments sont complémentaires — une compétence peut expliquer comment bien utiliser un outil MCP, et un sous-agent peut recevoir l'instruction de charger une compétence. Deux réalités financières à prendre en compte : les sous-agents héritent du modèle de la session à moins d'en spécifier un autre (model: haiku crée un assistant peu coûteux), et l'exécution d'une équipe complète d'agents peut consommer environ sept fois plus de tokens qu'une session unique. Nous détaillons l'aspect gouvernance dans Gouvernance des outils, compétences et sous-agents.

Les compétences qui valent la peine d'être installées

Les meilleures compétences encodent des connaissances que votre équipe répète constamment. Ces catégories méritent leur place dans presque tout codebase d'envergure :

CompétenceRôleDéclenchement
Codebase overviewDécrit l'architecture, les répertoires clés et les conventions de nommage pour éviter à Claude de lire des dizaines de fichiers pour s'orienterDébut de travail dans une zone non familière
Test runnerEncode la façon d'exécuter et de filtrer la suite de tests, en ne retournant que les échecs plutôt que des milliers de lignes de sortieExécution ou débogage de tests
PR reviewApplique votre checklist de revue — sécurité, style, cas limites — dans un ordre cohérentRevue d'un diff ou préparation d'une PR
Migration playbookCapture les étapes exactes et les pièges d'une migration de base de données ou de frameworkChangement de schéma ou mise à jour de dépendances
Doc generationTransforme le code et les commentaires en documentation au format de votre entrepriseRédaction ou mise à jour de documentation
Data / file format handlingRègles de traitement et de génération pour vos formats CSV, JSON ou propriétairesTraitement d'un fichier de données ou d'un jeu de test

Le « pourquoi » importe tout autant que le « quoi », c'est pourquoi certaines méritent une attention particulière :

Codebase overview (Vue d'ensemble du codebase)

La compétence au levier le plus élevé dans la plupart des répertoires. Elle définit l'architecture, les répertoires principaux, les limites des modules et les conventions de nommage en quelques centaines de tokens. Elle se déclenche dès que Claude commence à travailler sur une partie du codebase qu'il n'a pas encore analysée au cours de la session — exactement le moment où il ouvrirait autrement une dizaine de fichiers pour en déduire la structure. Cette déduction constitue un coût pur en tokens d'entrée sans aucun résultat concret à présenter ; la remplacer par une carte résidente est l'une des optimisations les plus efficaces.

Test runner et tri des échecs

Une suite de tests peut générer des milliers de lignes de sortie, et réinjecter l'ensemble constitue un bruit coûteux. Cette compétence encode la commande exacte, la manière de la restreindre au package concerné, et la méthode pour ne retourner que les échecs ainsi que leurs traces d'exécution (stack traces). Elle se déclenche à chaque demande d'exécution, de correction ou d'ajout de tests, ce qui économise à la fois les tokens de sortie d'une exécution complète et les itérations perdues à relancer des commandes après des tentatives infructueuses.

Checklist de revue de PR

La qualité d'une revue diminue lorsqu'elle est improvisée. Une compétence de revue fixe l'ordre et les critères — la sécurité d'abord, puis la justesse et les cas limites, enfin le style — afin que chaque diff bénéficie du même traitement. Elle se déclenche lorsque Claude révise ou prépare une modification, et permet d'économiser des tokens en évitant que le modèle ne redéfinisse vos standards à chaque fois ou ne consulte des fichiers inutiles à la revue.

Migration playbook (Guide de migration)

Les modifications de schéma, les montées en version de framework et les mises à jour de dépendances regroupent souvent des contraintes non documentées. Une compétence de migration rassemble les étapes ordonnées, les démarches de reprise de données (backfill), les procédures de retour arrière (rollback) et les pièges spécifiques rencontrés auparavant par votre infrastructure. Elle se déclenche lors d'une migration ou d'une mise à jour. L'économie de tokens est ici secondaire ; le véritable gain réside dans la précision — le modèle suit votre parcours validé plutôt qu'un chemin plausible mais erroné.

Documentation et gestion des formats de données

Une compétence de génération de documentation transforme le code et les commentaires en documentation respectant vos formats internes, et se déclenche dès que de la documentation est rédigée. Une compétence de format de données encode les règles applicables à vos fichiers CSV, JSON ou propriétaires — colonnes requises, encodage, validation, cas limites — pour que Claude cesse de relire des échantillons afin de deviner un schéma qui aurait pu lui être directement fourni. Ces approches ne sont pas de simples astuces : il s'agit de connaissances organisationnelles consignées une fois pour toutes, dont chaque développeur et chaque session Claude bénéficient immédiatement.

Vous déployez des compétences à l'échelle d'une équipe plutôt que sur un seul poste ?

Pourquoi les compétences économisent de l'argent, et pas seulement du temps

Le coût en tokens évolue avec la taille du contexte. Chaque fichier lu par Claude pour comprendre votre projet représente des tokens d'entrée facturés, et un prompt flou dans un codebase non familier peut provoquer une analyse large et coûteuse. Une compétence évite ce détour : au lieu de lire dix fichiers potentiels pour déduire votre architecture, Claude appelle la compétence codebase-overview et obtient directement la réponse.

Les économies se cumulent. Dans le cadre d'un abonnement, le travail consomme un quota partagé — une fenêtre glissante de 5 heures associée à un quota hebdomadaire, couvrant Claude Code, le chat et Cowork — ainsi, réduire l'exploration permet d'effectuer plus de travail effectif avant d'atteindre une limite. Via l'API ou un fournisseur cloud, la facturation s'effectue au token (par exemple pour Sonnet 3.5 à 3 $ en entrée / 15 $ en sortie par million de tokens), de sorte que les lectures évitées se traduisent par des dépenses en moins. Cette démarche s'inscrit dans la continuité de notre guide de routage entre Opus, Sonnet et Haiku et du suivi des coûts pour Claude Code.

Une nuance importante : sur Amazon Bedrock, Google Vertex ou Microsoft Foundry, la consommation est facturée au token directement sur votre compte cloud, et les tableaux de bord d'Anthropic n'y ont pas accès. Les compétences réduisent le volume de tokens de la même manière, mais pour attribuer ces dépenses par développeur, il est nécessaire d'intégrer OpenTelemetry ou une passerelle LLM sur le parcours d'appel — ce qui correspond au rôle de l'AI Gateway de TrueFoundry.

Rédiger votre propre compétence

La création d'une compétence est volontairement simple. Le frontmatter définit son nom et, élément fondamental, décrit son contexte de déclenchement — c'est sur cette description que Claude s'appuie pour effectuer la correspondance :

En résumé, la méthode comporte plusieurs étapes : (1) identifiez une tâche répétitive — si vous l'avez expliquée plus de deux fois à de nouveaux arrivants, elle constitue une bonne candidate ; (2) créez le fichier .claude/skills/<nom>/SKILL.md dans le répertoire afin qu'il soit intégré au code ; (3) rédigez une description centrée sur la situation et non sur le mécanisme (« À utiliser lors de l'exécution ou du débogage des tests » se déclenche de manière fiable ; « Utilitaires de test » ne suffit pas) ; (4) insérez des instructions concrètes dans le corps, et séparez la documentation de référence volumineuse dans des fichiers liés qui ne se chargeront qu'en cas de besoin ; (5) testez le déclenchement sur une tâche devant l'activer et sur une autre qui ne le doit pas, puis affinez la description pour qu'elle ne se charge que lorsque son apport le justifie.

Une compétence prétendant s'appliquer à toutes les situations se chargera en permanence et annulera tout l'intérêt de la démarche. Nous abordons ce concept plus en détail dans que sont les compétences Claude.

Gérer les compétences à l'échelle d'une équipe

La compétence créée par un développeur sur son poste constitue un outil pratique. Trente versions différentes qui s'éloignent les unes des autres deviennent une source de risque — personne ne sait quelle version fait référence, et une instruction incorrecte se propage discrètement. À l'échelle d'une équipe, l'objectif est de versionner, partager et contrôler les accès aux compétences dans un espace centralisé, tout comme le reste du code.

C'est précisément le rôle d'un registre de compétences (skills registry) : offrir une source unique de vérité pour les ensembles SKILL.md, incluant le gestionnaire de versions et le contrôle d'accès au niveau des répertoires, publiés une fois puis utilisés par l'ensemble des développeurs et des agents. Cette approche transforme une compétence individuelle en un artefact gouverné — vous pouvez identifier l'auteur d'une version, annuler une modification erronée et garantir que chacun utilise les mêmes directives. C'est ce que nous avons développé — découvrez le fonctionnement du Registre de Compétences TrueFoundry ainsi que les raisons de l'introduction d'un registre de compétences réutilisables.

Le registre traite les enjeux de distribution et de versionnement ; la passerelle gère le reste. Associée à une passerelle IA (AI gateway), vous bénéficiez de l'attribution des coûts par développeur, de politiques d'usage des modèles, de plafonds de dépenses et d'un plan de contrôle unique couvrant l'ensemble de vos fournisseurs — assurant la gouvernance sur les outils, compétences et modèles accessibles par chaque développeur, avec seulement 3 à 4 ms de latence supplémentaire et des traces conformes au standard OpenTelemetry. Cela s'avère particulièrement utile sur Bedrock, Vertex ou Foundry, où les tableaux de bord natifs ne permettent pas d'attribuer précisément les coûts.

EnjeuSur les postes individuelsDans un registre + passerelle
Source de véritéChaque copie est isolée ; les écarts sont invisiblesUne version publiée unique utilisée par tous
VersionnementAd hoc ; pas d'historique ni de retour arrièreVersionné, avec retour arrière et journal d'audit
Contrôle d'accèsChaque utilisateur peut modifier sa versionDroit de publication strictement contrôlé
Attribution des coûtsAbsente par développeur, en particulier sur le cloudDépenses suivies par développeur chez tous les fournisseurs
Impact d'une instruction erronéeDiscret et non maîtriséDétecté lors de la revue avant le déploiement

Ce modèle s'aligne sur la manière dont les entreprises gouvernent déjà leurs autres outils de codage par IA — le plan de contrôle qui centralise le contrôle des coûts et l'observabilité pour Claude Code, Cursor, Gemini CLI et les autres outils s'étend naturellement aux compétences que ces outils consomment.

Pièges courants à éviter

  • Une description trop large est contre-productive. Une compétence qui correspond à chaque tâche se charge en permanence et alourdit le contexte — soit l'inverse de l'effet recherché. Délimitez précisément le champ de déclenchement.
  • Les compétences apportent du savoir, pas des actions. Si une compétence doit interroger une API ou une base de données, ce rôle incombe à un outil MCP ; la compétence doit expliquer à Claude comment l'utiliser correctement, sans chercher à s'y substituer.
  • Ne copiez pas directement CLAUDE.md dans une compétence. L'intérêt réside dans l'extraction des instructions situationnelles hors du contexte permanent ; conservez les éléments essentiels permanents à leur emplacement d'origine.
  • Les compétences non versionnées dérivent. Les copies présentes sur les machines individuelles finissent par diverger ; traitez les compétences comme des artefacts partagés adossés à une source de vérité unique.
  • Des compétences qui se chevauchent perturbent le déclenchement. Deux compétences aux descriptions très proches rendent le choix ambigu pour le modèle ; attribuez à chacune un périmètre clair et distinct.

Articles associés

Conclusion

Les compétences Claude Code les plus efficaces ne sont pas les plus complexes — ce sont celles qui formalisent ce que votre équipe sait déjà afin d'éviter à quiconque, humain comme modèle, de devoir le redécouvrir. Une compétence bien conçue se charge exactement lorsqu'elle est pertinente, apporte la réponse à Claude, puis s'efface pour maintenir un contexte restreint et des coûts maîtrisés.

Le risque principal ne consiste pas à rédiger trop peu de compétences, mais à les laisser se multiplier sur les postes de travail sans versionnement, sans revue et sans contrôle des publications. En traitant les compétences comme du code — avec une source de vérité unique, versionnée et gouvernée — elles deviennent un levier de performance durable pour vos équipes.

Mettez à disposition de chaque développeur des compétences encadrées et une visibilité centralisée sur les coûts.

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

INSCRIVEZ-VOUS
Table des matières

Gouvernez, déployez et suivez l'IA dans votre propre infrastructure

Réservez un séjour de 30 minutes avec notre Expert en IA

Réservez une démo

Le moyen le plus rapide de créer, de gérer et de faire évoluer votre IA

Démo du livre
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Découvrez-en plus

Aucun article n'a été trouvé.
novembre 20, 2026
|
5 min de lecture

Grok 4.3 on Amazon Bedrock: We Routed Four Frontier Models Through One Gateway and Measured the Cost

Outils LLM
comparaison
novembre 20, 2026
|
5 min de lecture

Alternatives au bifrost : les meilleurs outils que vous pouvez envisager en 2026

Aucun article n'a été trouvé.
novembre 20, 2026
|
5 min de lecture

GPT-6.1 Terra : API, benchmarks, tarification et mode d'emploi

Aucun article n'a été trouvé.
novembre 20, 2026
|
5 min de lecture

GPT-5.1 vs GPT-5 : 9 améliorations majeures à connaître

LLM et GenAI
Aucun article n'a été trouvé.
Faites un rapide tour d'horizon des produits
Commencer la visite guidée du produit
Visite guidée du produit