Que sont les compétences de Claude Code – et pourquoi elles changent tout
UN Compétence Claude Code est un dossier contenant des fichiers d'instructions et des scripts optionnels que Claude charge dynamiquement lorsqu'il détecte un contexte pertinent. Contrairement aux invites système statiques qui restent fixes quel que soit le sujet sur lequel vous travaillez, les compétences sont sélectif et composable — Claude analyse ce qui est disponible, fait correspondre la tâche active et charge uniquement ce qui est nécessaire.
Le delta pratique est important. Sans compétences, vous réexpliquez votre stack à chaque session. Avec les bonnes compétences, Claude connaît déjà votre cadre de test, votre pipeline de déploiement et les conventions de votre projet avant de taper un mot.
Avant les compétences
"Nous utilisons Vitest, pas Jest. Nos routes API sont dans /src/routes. Utilisez toujours Zod pour la validation. N'utilisez pas les exportations par défaut." — collé manuellement, à chaque session, souvent oublié.
Après les compétences
Claude charge votre compétence typescript-vitest au début de la session. Tout cela, il le sait déjà.
Comment les compétences fonctionnent réellement sous le capot
Lorsque Claude Code initialise une session, il recherche des compétences à deux endroits :
- Répertoire mondial des compétences - généralement
~/.claude/skills/sur votre machine - Compétences locales du projet — un dossier
.claude/skills/à la racine du repo (idéal pour le partage en équipe)
Chaque compétence réside dans son propre sous-dossier nommé et doit inclure un fichier manifeste (skill.json ou skill.md). Claude lit ces manifestes, les note en fonction de leur pertinence par rapport au contexte de tâche actuel et charge les compétences les plus adaptées jusqu'à un budget contextuel configurable.
Un manifeste minimal ressemble à ceci :
{
"name": "typescript-vitest",
"version": "1.2.0",
"description": "TypeScript project conventions using Vitest for testing",
"triggers": ["vitest", "typescript", ".ts", "tsconfig"],
"files": ["instructions.md", "snippets.md"],
"permissions": ["read_project_files"]
}
| Champ | Requis | But |
|---|---|---|
| nom | Oui | Identifiant unique de la compétence |
| version | Oui | Semver; Claude préfère les versions supérieures sur le conflit |
| déclencheurs | Oui | Mots-clés/modèles qui activent le chargement |
| fichiers | Oui | Quels fichiers dans le dossier de compétences charger |
| autorisations | Non | Déclare à quoi les scripts de la compétence peuvent accéder |
| priorité | Non | Entier; une priorité plus élevée l'emporte sur les conflits d'ordre de chargement |
Déclencheur Sweet Spot : Le tableau triggers est l'endroit où la plupart des auteurs de compétences se trompent : trop large et la compétence se charge constamment (gaspillage du budget de contexte), trop étroite et elle ne se déclenche jamais. Visez 3 à 6 déclencheurs spécifiques et non génériques liés aux noms de fichiers réels ou aux identifiants de framework.
Les compétences dont vous avez réellement besoin (classées selon leur impact dans le monde réel)
Plutôt qu'un vidage de liens bruts, voici un cadre d'évaluation pour chaque compétence que vous considérez :
- Ajustement au cas d’utilisation : Correspond-il à votre pile actuelle ou est-il générique ?
- Qualité d'entretien : Dernier commit dans les 6 mois ? Problèmes activement résolus ?
- Coût de chargement : Combien de jetons la compétence consomme-t-elle lorsqu’elle est active ?
- Compatibilité: Cible-t-il Claude Code, l'API Claude ou Claude.ai ? Ceux-ci ne sont pas interchangeables.
Compétences pour les développeurs solo
Ceux-ci offrent le retour sur investissement immédiat le plus élevé pour les développeurs individuels travaillant sur plusieurs projets :
git-flow-pro
Messages de validation · Descriptions PR · Dénomination des branches
Avantages : Élimine le changement de contexte pour les commits passe-partout ; applique automatiquement les commits conventionnels.
Inconvénients : Un format d’opinion peut entrer en conflit avec les conventions d’équipe existantes.
Idéal pour : Les développeurs solo qui expédient rapidement et qui veulent un historique Git propre sans y penser.
typescript-strict
TypeScript strict · Marquer tout · Utilitaires de type
Avantages : Détecte les problèmes de type avant l'exécution ; enseigne passivement de meilleures habitudes TS.
Inconvénients : Peut se sentir agressif sur les bases de code existantes avec une dette any existante.
Idéal pour : Développeurs axés sur TypeScript qui souhaitent que Claude fasse respecter la discipline, pas seulement l'assister.
test-driven
TDD · Blague · Vitest · Pytest
Avantages : Produit naturellement du code plus testable ; s'intègre à Jest, Vitest, Pytest.
Inconvénients : Ralentit l'échafaudage initial ; pas utile pour les phases de prototypage.
Idéal pour : Les développeurs qui savent que TDD a raison mais ont du mal à rester cohérents sous la pression des délais.
security-audit
OWASP Top 10 · Injection · Détection de secrets
Avantages : Détecte les problèmes au moment de l'écriture, et non au moment de la révision ; couvre les 10 meilleurs modèles OWASP.
Inconvénients : Faux positifs sur des environnements de développement intentionnels à faible sécurité.
Idéal pour : Tout développement solo expédié en production sans un réviseur de sécurité dédié.
Compétences pour les équipes de développement et les entreprises
Les équipes ont des besoins fondamentalement différents : conventions partagées, contrôle d’accès et cohérence entre les contributeurs. Le modèle le plus efficace est un registre de compétences local du projet via .claude/skills/ engagé dans le monorepo.
monorepo-navigator
Nx · Turborepo · Lerne
Avantages : Élimine toute confusion quant à savoir quel package.json est pertinent ; améliore considérablement la précision des grandes pensions.
Inconvénients : Nécessite une configuration initiale par topologie d’espace de travail.
Idéal pour : Équipes exécutant plus de 5 packages dans un seul dépôt.
api-contract-enforcer
OpenAPI · GraphQL · Validation de schéma
Avantages : Empêche Claude d'halluciner les champs API ; maintient le frontend/backend synchronisé.
Inconvénients : Les schémas obsolètes causent autant de problèmes que l’absence de compétences.
Idéal pour : Des équipes full-stack où frontend et backend sont développés en parallèle.
internal-style-guide
Personnalisé · Conventions d'équipe · Décisions d'architecture
Avantages : Entièrement adapté ; aucune compétence publique ne connaîtra jamais votre modèle interne BaseRepository aussi bien que cela.
Inconvénients : Nécessite une maintenance à mesure que les conventions évoluent.
Idéal pour : Toute équipe comptant plus de 3 développeurs et une base de code établie.
Conseil d'entreprise : Stocker les compétences internes sensibles dans un dépôt GitHub privé et référencez-les via la configuration .claude/skills-registry.json. Contrôlez qui peut extraire les mises à jour des compétences via les autorisations de dépôt standard : aucun outil personnalisé n'est requis.
Compétences pour les constructeurs non techniques (contenu, opérations, marketing)
Claude Code n'est pas réservé aux ingénieurs. Les équipes de contenu, les responsables des opérations et les responsables marketing utilisent de plus en plus les compétences de Claude Code pour automatiser les pipelines de documentation, les flux de travail de contenu et les tâches de formatage des données, souvent sans écrire eux-mêmes une ligne de code.
markdown-cms
Contenu · Santé mentale · API Notion
Avantages : Élimine le reformatage manuel entre les outils de rédaction et les plateformes de publication.
Inconvénients : Le schéma doit correspondre à la configuration de votre CMS ou aux interruptions de sortie.
Idéal pour : Les équipes de contenu publient sur un CMS sans tête via API.
seo-content
Méta descriptions · Hiérarchie des titres · Densité des mots clés
Avantages : Détecte les erreurs de référencement avant la publication sans nécessiter un abonnement à un outil de référencement.
Inconvénients : Les valeurs par défaut sont orientées vers le contenu du blog.
Idéal pour : Les spécialistes du marketing de contenu utilisent Claude Code pour rédiger des articles et assurer le contrôle qualité à grande échelle.
data-formatter
CSV · JSON · Tableaux de démarques
Avantages : Gère les données désordonnées du monde réel avec élégance ; utile pour les équipes opérationnelles travaillant avec les exportations.
Inconvénients : Des structures JSON imbriquées complexes peuvent le faire échouer.
Idéal pour : Les équipes opérationnelles effectuent régulièrement une transformation des données sans assistance technique.
Comment développer votre propre compétence Claude Code en 10 minutes
Vous n'avez pas besoin d'attendre que quelqu'un publie la compétence parfaite pour votre pile. Voici le flux de travail complet :
Étape 1 : Créer la structure des dossiers
.claude/
skills/
my-first-skill/
skill.json
instructions.md
Étape 2 : Rédigez le manifeste (skill.json)
{
"name": "nextjs-app-router",
"version": "1.0.0",
"description": "Next.js 15 App Router conventions and patterns",
"triggers": ["next.config", "app/", "layout.tsx", "page.tsx", "next.js"],
"files": ["instructions.md"],
"permissions": []
}
Étape 3 : Écrivez les instructions (instructions.md)
# Next.js 15 App Router Conventions
## Routing
- All routes live in `app/` directory
- Use `page.tsx` for route components, `layout.tsx` for persistent UI
- Never use `pages/` directory — this project uses App Router exclusively
## Data Fetching
- Prefer React Server Components for data fetching
- Use `fetch()` with explicit `cache` options, not `getServerSideProps`
- Client components only when you need browser APIs or interactivity
## File Naming
- Components: PascalCase (`UserCard.tsx`)
- Utilities: camelCase (`formatDate.ts`)
- Never use default exports for components
Étape 4 : Testez-le
Ouvrez Claude Code dans votre projet Next.js et demandez : "Comment dois-je structurer un nouveau parcours pour les profils d'utilisateurs ?"
Si votre compétence s'est correctement chargée, Claude répondra en utilisant les conventions d'App Router sans que vous le lui demandiez. Un manque de compétence produira des conseils Next.js génériques qui mélangent d’anciens modèles de Pages Router.
Référence du manifeste de compétences – Champs, schémas et meilleures pratiques
| Champ | Taper | Remarques |
|---|---|---|
| nom | chaîne | Minuscules, tirets uniquement. Doit être unique parmi les compétences chargées. |
| version | Semeur | Format "1.0.0" requis. En cas de conflit, la version supérieure l'emporte. |
| description | chaîne | Utilisé par Claude pour comprendre la portée des compétences. Soyez précis. |
| déclencheurs | chaîne[] | Noms de fichiers, extensions ou mots-clés. 3 à 6 est optimal. |
| fichiers | chaîne[] | Chemins relatifs dans le dossier de compétences. Tous les fichiers répertoriés sont chargés. |
| autorisations | chaîne[] | Déclare la portée d'accès au script. Omettre si la compétence n'a pas de scripts. |
| priorité | entier | Facultatif. Par défaut : 0. Nombre plus élevé = chargé préférentiellement. |
| compatible_avec | chaîne[] | Facultatif. ["Claude Code", "claude-api"] — portée de compatibilité des signaux. |
Erreurs de création courantes
- Répertorier
"js"ou"ts"comme déclencheurs : ils se déclenchent sur presque tous les projets et gonflent le budget du contexte. - Placer toutes les instructions dans un seul fichier volumineux - divisé par sujet pour un chargement sélectif plus rapide
- Oublier
version— provoque un comportement imprévisible lorsque plusieurs versions de compétences existent
Compétences de débogage – Lorsque Claude ignore ou charge mal votre compétence
La plupart des guides ignorent complètement cela. Voici quoi faire lorsque les choses tournent mal.
Symptôme : Claude ignore complètement votre compétence
- Vérifiez que
skill.jsonest un JSON valide : une virgule finale interrompt l'analyse silencieusement. - Vérifiez les déclencheurs par rapport aux fichiers réels de votre projet :
"vitest.config"ne correspondra pas à"vitest.config.ts"à moins que vous n'incluiez la variante d'extension. - Confirmez que le dossier de compétences se trouve dans un emplacement numérisé (
~/.claude/skills/ou.claude/skills/) - Assurez-vous que le nombre total de jetons de compétences chargés ne dépasse pas votre budget configuré : les compétences de moindre priorité sont supprimées en premier.
Symptôme : Claude charge la compétence mais ignore ses instructions
- Le fichier d'instructions est peut-être trop long — Claude charge le fichier mais peut ne pas s'occuper des sections ultérieures sous la pression du contexte. Conservez les fichiers d’instructions sous 800 jetons.
- Les instructions sont trop vagues (« écrire du bon code ») — la formation existante de Claude domine. Soyez précis et prescriptif.
Symptôme : Conflit de deux compétences
Lorsque deux compétences chargées donnent des instructions contradictoires, Claude utilise par défaut la valeur priority plus élevée. Si aucun des deux n’a de priorité définie, le comportement est non déterministe.
Réparer: Définissez des valeurs priority explicites dans les compétences concurrentes. Les compétences locales du projet doivent toujours avoir une priorité plus élevée que les compétences globales pour que les remplacements spécifiques au projet fonctionnent correctement.
Symptôme : les compétences se chargent localement mais pas dans CI ou sur les machines des coéquipiers
La compétence se trouve probablement dans votre ~/.claude/skills/ global plutôt que dans le .claude/skills/ du projet. Déplacez les compétences pertinentes pour le projet dans le dépôt : validez le dossier .claude/ et traitez les compétences comme du code.
Remarque sur les performances : Le chargement simultané de plus de 10 compétences peut consommer entre 2 000 et 5 000 jetons de budget contextuel avant d'écrire un seul message. Vérifiez vos compétences actives avec claude skills list et désactivez celles qui ne sont pas pertinentes pour le travail en cours. Il n'y a pas d'impact mesurable sur la latence, mais la réduction du budget contextuel est réelle : privilégiez la qualité à la quantité.
Où trouver, évaluer et faire confiance aux compétences de la communauté
Source officielle : GitHub.com/Anthropics/skills — le référentiel canonique maintenu par Anthropic. Les compétences ici sont examinées, versionnées et garanties pour correspondre au schéma de compétences actuel. Commencez ici.
Annuaires communautaires :
- claudeskills.info — le plus grand annuaire communautaire en 2026, avec filtrage par catégorie et métadonnées de base
- claudemarketplaces.com — une sélection plus organisée et plus petite, comprend les évaluations des utilisateurs
Signaux de qualité avant d'installer une compétence communautaire
| Signal | Vert | Rouge |
|---|---|---|
| Dernier commit | Dans les 6 mois | Il y a plus de 12 mois |
| Problèmes ouverts | Trié activement | Des dizaines de bugs non reconnus |
| Version manifeste | Correspond au schéma actuel | Champ compatible_with entièrement manquant |
| Étoiles | 100+ pour une compétence générale | Moins de 20 ans sans activité |
| Fichier de test inclus | Oui | Non, vous ne pouvez pas vérifier le comportement |
Compétences à éviter en 2026 (surfaites ou abandonnées)
La crédibilité signifie signaler ce qui ne fonctionne pas, et pas seulement ce qui fonctionne.
ai-optimize-everything (fourches diverses)
Une catégorie de compétences prétendant « optimiser le raisonnement de Claude » en injectant des méta-instructions. Ces contextes saturés entrent souvent en conflit avec des compétences spécifiques à une tâche et ne montrent aucune amélioration mesurable des résultats. Évitez tout ce qui entre dans cette catégorie.
react-hooks-2023 (et compétences similaires verrouillées pendant une année)
Les compétences liées à une année spécifique dans le nom sont généralement gelées. Les conventions React ont évolué ; une compétence de 2023 enseigne activement des modèles obsolètes. Vérifiez le manifeste version et la date de la dernière validation avant d'installer une compétence avec un an dans son nom.
universal-developer
Les compétences promettant de couvrir tous les langages, tous les frameworks, tous les paradigmes dans un seul package sont trop vastes pour être utiles. Le contexte de Claude est mieux servi par une pile de 3 compétences ciblées que par une compétence universelle gonflée qui tire sur tout et ajoute des instructions contradictoires.
Allez plus loin dans votre flux de travail de codage avec EasyClaw
Tandis que les compétences de Claude Code dynamisent votre expérience en éditeur, EasyClaw apporte la même intelligence composable et pilotée par agent à votre contenu complet et à votre pipeline de référencement – fonctionnant localement, sans plafond d'utilisation, sans dépendance au cloud et sans surprises en matière de prix par siège.
- ✅ Exécution native sur ordinateur : vos données ne quittent jamais votre machine
- ✅ Architecture d'agent composable : mélangez et associez des flux de travail comme les compétences de Claude Code, mais pour les opérations de contenu
- ✅ Fonctionne avec votre configuration Claude Code existante – pas un remplacement, un multiplicateur de force
- ✅ Pipeline de référencement, de recherche et de publication intégré – aucune intégration supplémentaire requise
Comment choisir votre pile de compétences Claude Code
La bonne pile de compétences dépend entièrement de votre rôle, de la taille de votre équipe et de l’étape du projet. Voici trois configurations éprouvées :
Pile de démarrage – Développeur solo, nouveau venu dans les compétences
| Compétence | But |
|---|---|
| git-flow-pro | Nettoyer l'historique git sans effort |
| dactylographié-strict | Application de la sécurité du type |
| audit de sécurité | Signalement de vulnérabilité en ligne |
Installez ces trois-là, enregistrez-les dans votre répertoire de compétences global et vous ressentirez la différence en une journée.
Advanced Stack — Développeur expérimenté, projet établi
Commencez par la Starter Stack, puis ajoutez :
test-driven— pour un TDD discipliné- Une compétence spécifique au framework correspondant à votre stack principale (Next.js, Django, Rails, etc.)
- Votre propre compétence
internal-conventionspersonnalisée créée à l'aide du didacticiel de 10 minutes ci-dessus
Enterprise Stack – Chef d’équipe ou architecte
- Tout ce qui précède, projet local dans
.claude/skills/et engagé dans le monorepo monorepo-navigatorsi vous exécutez un espace de travail multi-packageapi-contract-enforcerpour la cohérence frontend/backend- Un registre de compétences privé pour les modèles internes propriétaires, accessible via
.claude/skills-registry.json
Foire aux questions
Q : Quelle est la différence entre une compétence Claude Code et une invite système ?
R : Une invite système est statique : elle reste la même, quel que soit l'objet sur lequel vous travaillez. Une compétence Claude Code est dynamique et sensible au contexte : Claude analyse les compétences disponibles, les compare à la tâche en cours et charge uniquement celles qui sont pertinentes. Cette sélectivité évite la surcharge du contexte et signifie que Claude obtient automatiquement les bonnes instructions pour la bonne tâche.
Q : Puis-je utiliser les compétences Claude Code avec l'API Claude ou Claude.ai ?
R : Non, l'architecture des compétences est spécifique à Claude Code (l'outil CLI). Les compétences conçues pour Claude Code ne fonctionneront pas dans l'API Claude ou l'interface web Claude.ai sans adaptation. Vérifiez toujours le champ compatible_with dans le manifeste d'une compétence avant l'installation.
Q : Combien de compétences puis-je charger à la fois sans nuire aux performances ?
R : Il n'y a pas de limite stricte, mais le chargement simultané de plus de 10 compétences peut consommer entre 2 000 et 5 000 jetons de budget de contexte avant d'écrire un seul message. Un plafond pratique est de 5 à 7 compétences actives pour la plupart des projets. Auditez régulièrement avec claude skills list et désactivez tout ce qui n'est pas pertinent pour votre travail actuel.
Q : Les compétences du projet doivent-elles figurer dans le dépôt ou dans mon répertoire global ?
R : Les compétences spécifiques au projet appartiennent au .claude/skills/ engagé dans le dépôt – point final. Cela garantit que chaque membre de l'équipe obtient un comportement de Claude identique sans aucune configuration individuelle. Réservez ~/.claude/skills/ pour les préférences personnelles inter-projets (par exemple, votre format de message de validation préféré).
Q : Que se passe-t-il lorsque deux compétences donnent à Claude des instructions contradictoires ?
R : Claude utilise par défaut la compétence avec la valeur entière priority la plus élevée. Si aucune des compétences n’a de priorité explicite, le comportement est non déterministe. Définissez toujours des valeurs de priorité explicites lorsque vous possédez des compétences qui peuvent se chevaucher, en particulier lorsque vous mélangez des compétences globales et locales au projet.
Q : Est-il sûr d'installer des compétences communautaires à partir de GitHub ?
R : Traitez les compétences de la communauté comme n'importe quelle dépendance open source : vérifiez ce que vous installez avant de l'installer. Vérifiez attentivement le champ permissions du manifeste ; une compétence déclarant les autorisations "write_filesystem" mérite un examen plus approfondi. Préférez les compétences du référentiel officiel Anthropic ou des sources communautaires bien entretenues avec un tri actif des problèmes.
Q : À quelle fréquence dois-je mettre à jour mes compétences ?
R : Traitez les compétences comme des dépendances : mettez à jour lorsqu'une nouvelle version apporte une amélioration significative ou corrige un bug qui vous affecte. Ne procédez pas à une mise à jour automatique aveuglément ; consultez le journal des modifications. Pour les compétences partagées en équipe dans un monorepo, traitez une mise à jour des compétences comme un PR nécessitant une révision, comme toute autre modification de code.
Pensées finales
L’écosystème de compétences Claude Code en 2026 est encore précoce – et c’est un avantage, pas un avertissement. Assez tôt pour qu'une compétence personnalisée bien entretenue vous donne toujours un véritable avantage sur les équipes qui s'appuient uniquement sur des options publiques. Assez tôt pour que la validation de votre dossier .claude/skills/ dans le monorepo soit encore une pratique nouvelle que la plupart des concurrents n'ont pas adoptée.
Le didacticiel de 10 minutes de ce guide est votre point de départ. Construisez une fois, engagez-vous dans le dépôt, et chaque contributeur hérite du même comportement de Claude dès le premier jour. Les retours composés sur cet investissement augmentent avec chaque nouveau membre de l'équipe qui n'a plus jamais à expliquer votre stack à Claude.
Pour les compétences que vous installez à partir de la communauté : appliquez la liste de contrôle des signaux de qualité, évitez les catégories trop médiatisées signalées ci-dessus et rappelez-vous que trois compétences ciblées surpassent à chaque fois une compétence universelle gonflée. Commencez par la Starter Stack, observez la différence en une journée, puis augmentez la complexité uniquement selon les exigences de votre flux de travail.
Liste de contrôle de démarrage rapide
- Installez
git-flow-pro,typescript-strictetsecurity-audità partir du dépôt officiel Anthropic - Déplacez toutes les compétences pertinentes pour le projet dans
.claude/skills/et engagez-les - Développez votre compétence
internal-conventionsà l'aide du didacticiel de 10 minutes : ce sera votre compétence ayant le plus grand impact d'ici une semaine. - Définissez des valeurs
priorityexplicites sur toutes les compétences qui pourraient se chevaucher - Auditez mensuellement les compétences actives avec
claude skills list- élaguez ce que vous n'utilisez pas