Claude Skills : créer et utiliser des skills (le guide complet)
En bref
Les claude skills sont des fichiers markdown que Claude Code charge automatiquement : ils encodent vos instructions persistantes et évitent de les ressaisir à chaque session.
Installation en quatre étapes, moins de deux minutes, aucune configuration supplémentaire.
Plus de 26 000 extensions Claude Code disponibles sur SkillsMP en décembre 2025.
Fonctionnent exclusivement dans Claude Code : pas dans Claude.ai, pas via l’API Anthropic.
Limites réelles à connaître : maintenance obligatoire, conflits potentiels, pollution contextuelle au-delà d’une dizaine de skills actifs.
Vous rouvrez une session Claude Code, et les premières minutes partent à reconfigurer les mêmes instructions : pas de console.log oublié, proposer un test unitaire à chaque modification, respecter les conventions de nommage maison. Les claude skills existent précisément pour éviter ça. Ce sont des fichiers markdown que Claude Code charge automatiquement au démarrage, selon les conditions que vous définissez. Résultat : votre agent IA applique vos règles sans que vous ayez à les ressaisir. Ce guide pratique couvre l’essentiel : comprendre ce que sont vraiment ces modules IA réutilisables, en installer un en deux minutes, créer le vôtre de zéro, et identifier les limites que la documentation officielle minimise.
Sommaire
Questions fréquentes sur Claude Skills
Avant de plonger dans le guide, ces réponses rapides vous permettent de partir avec les bons repères.
Un skill est un fichier Markdown (.md) stocké dans le répertoire de configuration de Claude Code (global : ~/.claude/skills/ ; projet : .claude/skills/). Ce fichier contient des instructions structurées que Claude lit et applique dès qu’un déclencheur est reconnu.
En pratique : c’est un prompt système réutilisable, versionnable et partageable, stocké en clair sur votre disque. Pas un plugin, pas un binaire compilé — du texte que Claude interprète.
- Repérez le bon répertoire :
~/.claude/skills/pour un skill disponible dans tous vos projets,.claude/skills/à la racine d’un dépôt pour le limiter à ce projet. - Déposez-y un fichier
mon-skill.mdcontenant au minimum un bloc frontmatter YAML (voir la question suivante). - Ouvrez une nouvelle session Claude Code (le chargement des skills se fait au démarrage).
- Invoquez le skill par son nom (
/mon-skill) ou laissez Claude le détecter automatiquement selon votre tâche.
Note : si vous modifiez un skill en cours de session, vous devez relancer la session pour que les changements soient pris en compte.
- Frontmatter
- Bloc YAML encadré par
---en tête du fichier skill. Il déclare les métadonnées :name(identifiant),description(ce que fait le skill) etwhen_to_use(la description de situation qui guide Claude pour le sélectionner automatiquement). Sans frontmatter valide, le skill n’est pas reconnu. - Trigger (déclencheur)
- La condition d’activation. Peut être explicite (vous tapez
/nom-du-skilldans Claude Code) ou implicite (Claude reconnaît que votre demande correspond au champwhen_to_useet active le skill sans que vous le demandiez). - Prompt (corps du skill)
- Tout le contenu Markdown après le frontmatter. C’est ici que vous rédigez les instructions, les règles, les étapes ou les exemples que Claude doit suivre quand le skill est actif. Ce corps est injecté dans le contexte de la session.
- Choisissez un besoin récurrent. Le skill vaut l’investissement s’il couvre une tâche que vous répétez régulièrement (révision de code, rédaction dans un style particulier, audit sécurité, etc.).
- Créez le fichier. Par exemple :
~/.claude/skills/revue-code-fr.md - Rédigez le frontmatter. Minimum requis :
---
name: revue-code-fr
description: Révision de code en français
when_to_use: Quand l'utilisateur demande une revue ou une critique de code
--- - Écrivez le corps. Instructions claires, cas d’usage, exemples de sortie attendue. Moins de 500 lignes reste raisonnable pour ne pas saturer le contexte.
- Testez dans une nouvelle session. Tapez
/revue-code-frpuis soumettez un extrait de code. Observez si Claude suit bien les instructions. - Itérez. Affinez selon les écarts entre ce que vous attendez et ce que Claude produit.
- Compatibles Claude Code CLI, Claude Code desktop app (Mac / Windows), extensions VS Code et JetBrains, claude.ai/code.
- Non compatibles Claude.ai (interface web standard), API Anthropic directe — les skills sont une fonctionnalité de l’outillage Claude Code, pas du modèle lui-même.
En 2026, les skills fonctionnent également dans les environnements CI/CD qui utilisent Claude Code en mode headless, ce qui ouvre la porte à des pipelines automatisés pilotés par des instructions versionnées.
- YAML malformé dans le frontmatter. Une indentation incorrecte ou un guillemet non fermé suffit à rendre le skill invisible. Validez votre YAML avec un linter avant de déployer.
- Oublier les
---de fermeture. Le frontmatter doit être encadré :---en ouverture ET en fermeture. Sans la balise de fin, tout le fichier est traité comme du YAML. - Confondre global et projet. Un skill dans
~/.claude/skills/est disponible partout ; dans.claude/skills/, uniquement dans ce projet. Si votre skill ne se déclenche pas, vérifiez d’abord le bon répertoire. - Skills trop longs. Chaque skill actif consomme de la fenêtre de contexte. Un skill de 3 000 lignes laisse moins de place pour votre code. Scindez les instructions volumineuses en plusieurs skills spécialisés.
- Champ
when_to_usevague ou absent. Si Claude ne sait pas dans quelle situation appliquer votre skill, il ne le fera pas automatiquement. Soyez précis et situationnel dans cette description.
Un skill n’exécute rien par lui-même : il guide le comportement de Claude, qui reste soumis aux mêmes règles d’autorisation que d’habitude. Un skill ne peut pas contourner les confirmations de permission de Claude Code (accès fichiers, exécution de commandes, etc.).
En revanche, un skill mal rédigé peut orienter Claude vers des comportements indésirables (suppression de fichiers sans confirmation, génération de code risqué). Traitez vos skills comme du code source : revoyez-les avant de les partager, et méfiez-vous des skills téléchargés de sources inconnues.
Pour les équipes, il est recommandé de versionner les skills dans Git et de les soumettre à revue (pull request) avant déploiement, exactement comme pour tout autre artefact de configuration.
Les skills sont des fichiers texte en clair : ils s’intègrent naturellement dans Git. Deux patterns courants en 2026 :
- Repo Git privé dédié (ex.
mon-org/claude-skills) : cloné sur chaque machine, les skills globaux sont des symlinks vers ce repo. Toute modification passe par un commit, l’historique est intact. - Dossier partagé synchronisé (Syncthing, iCloud Drive configuré, Dropbox) : plus simple à démarrer, mais sans historique de versions — acceptable pour un usage solo, moins robuste en équipe.
Pour les skills de projet, ils vivent déjà dans .claude/skills/ du dépôt : ils sont versionnés avec le reste du code, sans configuration supplémentaire.
Claude Skills : ce que c’est vraiment (et ce que la doc officielle oublie de dire)
Un skill dans l’écosystème Claude Code est un fichier markdown structuré, stocké dans un répertoire précis, que l’outil lit automatiquement à chaque démarrage de session. À la différence d’un CLAUDE.md (qui documente le contexte d’un projet) ou d’un prompt copié-collé (qui disparaît à la session suivante), une compétence personnalisée pour Claude encode un comportement réutilisable, indépendant du projet courant.
La documentation officielle Claude Code les présente comme un mécanisme de réutilisation d’instructions persistantes. Ce qu’elle explique moins clairement, c’est qu’ils constituent en pratique le seul moyen natif de stabiliser des comportements d’agent sur la durée sans modifier les fichiers du projet lui-même.
Skill vs prompt système : la différence qui change tout
Un prompt système s’injecte globalement, via la configuration côté API ou interface. Un skill est sélectif : son frontmatter YAML peut préciser des conditions d’activation (type de fichier, mots-clés déclencheurs, portée projet). Un développeur qui travaille sur des projets TypeScript et Python peut configurer deux skills distincts, chacun actif uniquement dans le bon contexte. C’est ce ciblage qui fait la valeur réelle du mécanisme sur des projets hétérogènes.
Comment Claude détecte et active un skill sans intervention manuelle
Claude Code scanne ~/.claude/skills/ (portée globale, tous les projets) et .claude/skills/ à la racine du projet courant au démarrage de chaque session. Si le frontmatter contient un champ when-to-use, Claude évalue cette condition avant de charger les instructions. Dans la majorité des cas observés en production, les instructions automatiques Claude sont configurées sans condition restrictive : elles s’appliquent dès que l’outil est actif dans le projet.
Installer un skill Claude en moins de deux minutes
La majorité des utilisateurs commence par récupérer un skill existant plutôt qu’en créer. Le catalogue SkillsMP recensait plus de 26 000 extensions Claude Code en décembre 2025 : pour les besoins courants (revue de code, génération de documentation, rédaction structurée), un skill existe presque toujours.
L’installation se fait en quatre étapes :
- Cherchez un skill adapté sur SkillsMP ou dans un dépôt GitHub (termes de recherche :
claude skills,claude code skill). - Téléchargez le fichier
.mdcorrespondant. - Placez-le dans le bon répertoire :
~/.claude/skills/pour une portée globale sur tous vos projets,.claude/skills/à la racine d’un projet pour le limiter à ce contexte. - Relancez une session Claude Code : aucune configuration supplémentaire n’est requise.
Deux pièges reviennent fréquemment. Le premier : un dossier skills créé au mauvais emplacement (dans ~/, ou dans ~/.claude/ sans le sous-dossier skills/). Claude Code ne charge rien et ne signale aucune erreur. Vérifiez le chemin exact avant de chercher ailleurs.
Le second : adopter un skill conçu pour une version ancienne de Claude Code. Les commandes personnalisées IA évoluent avec les mises à jour du modèle et de l’outil. Un fichier qui date de 2024 sans révision récente peut produire des résultats dégradés sans le moindre avertissement. Vérifiez toujours la date de dernière mise à jour avant d’intégrer un skill tiers.
Créer votre premier claude skill de zéro : la méthode pas à pas
Les claude skills les plus efficaces partagent la même structure de base : un bloc frontmatter YAML en en-tête, et un corps markdown libre contenant vos instructions.
La structure minimale d’un fichier skill (exemple annoté)
« `markdown
—
name: revue-code-typescript
description: Applique nos standards TypeScript : tests obligatoires, pas de console.log, nommage strict
when-to-use: Pour toute revue ou modification de fichiers .ts et .tsx
—
Lors de chaque revue ou modification de code TypeScript :
- Signale tout
console.logoublié comme bloquant - Vérifie qu’une fonction modifiée dispose d’au moins un test couvrant le cas nominal
- Propose systématiquement le nommage en camelCase
- N’écris aucun commentaire qui explique ce que le code fait déjà : uniquement les raisons non évidentes
Les trois champs frontmatter (`name`, `description`, `when-to-use`) suffisent pour démarrer. Le champ `description` est celui que Claude lit pour évaluer la pertinence du skill dans un contexte donné : soyez précis et concret, pas vague. Comptez 15 à 30 minutes pour poser vos instructions correctement la première fois, moins de 10 minutes une fois le format assimilé.
### Les 3 erreurs de débutant qui rendent un skill inutilisable
La première est d'écrire des instructions vagues. "Écris du bon code" n'est pas une règle applicable : c'est une intention. Un skill efficace pose des conditions binaires que Claude peut évaluer mécaniquement (toujours, jamais, uniquement si).
La deuxième est de créer un skill au scope trop large. Un skill qui s'applique "à toute tâche" interfère tôt ou tard avec des contextes pour lesquels ses règles n'ont pas lieu d'être. Cinq skills ciblés valent mieux qu'un skill omnibus.
La troisième est d'oublier la maintenance. Un skill dont les règles ne correspondent plus à vos conventions actuelles devient une source d'erreurs silencieuses. Traitez-le comme du code versionné : revoyez-le dès que le contexte de votre projet évolue.
## Les meilleurs skills Claude en 2026 selon votre métier
Le catalogue disponible est vaste, mais son utilité varie fortement selon le profil. Voici une sélection basée sur ce qu'on observe effectivement en production en 2026.
**Développeur.** Les skills de revue de code et de génération de documentation sont les plus adoptés dans les équipes techniques, selon les retours terrain que nous collectons chez nos clients. Deux références concrètes : un skill de revue TypeScript (standards, couverture de tests, nommage) qui remplace une liste de vérification mentale à chaque pull request, et un skill de génération de JSDoc ou README qui réduit de moitié le temps passé sur la documentation de routine.
**Consultant et chef de projet.** Les modules IA réutilisables les plus efficaces dans ces profils structurent la production écrite : plan de rapport d'audit, résumé de réunion formaté selon un template interne, status report hebdomadaire. Ce sont des tâches à forme prévisible, cas d'usage idéal pour un skill.
**Rédacteur et responsable marketing.** Un skill de brief SEO (intention, angle, structure, formulations interdites) évite de reconfigurer les consignes à chaque article. Un skill de ton éditorial (niveau de lecture, longueur de paragraphe, registre) stabilise la cohérence sur des productions en série.
| Profil | Skills recommandés | Quand ça vaut le coup |
|---|---|---|
| Développeur | Revue TypeScript, génération JSDoc | Standards partagés, volume de PR régulier |
| Consultant | Plan d'audit structuré | Livrables récurrents à format identique |
| Rédacteur | Brief SEO, ton éditorial | Production de contenu en série |
| Chef de projet | Template status report | Reporting hebdomadaire ou mensuel |
Un point d'honnêteté : quand la tâche est ponctuelle, non répétitive ou nécessite un contexte très variable, un skill n'apporte pas grand-chose de plus qu'un bon prompt manuel. Les compétences personnalisées pour Claude automatisent ce qui est structurellement identique d'une fois à l'autre.
## Limites réelles et pièges à ne pas ignorer
Quatre limites concrètes méritent d'être nommées clairement.
La première est le confinement à Claude Code. Les claude skills fonctionnent exclusivement dans Claude Code (CLI et extensions IDE). Ils ne s'appliquent pas à Claude.ai, à l'API Anthropic, ni à des intégrations tierces. Si votre workflow principal passe par une autre interface, ce mécanisme ne vous concerne pas directement.
La deuxième est la maintenance obligatoire. Un skill non revu après une mise à jour du modèle ou de l'outil peut produire des résultats dégradés sans aucun signal d'alerte. Contrairement à un test automatique qui échoue bruyamment, un skill devenu inadapté continue de s'exécuter en silence. Prévoyez une revue régulière, trimestrielle au minimum.
La troisième est la prolifération. Au-delà de 5 à 10 skills actifs simultanément, la gestion devient un projet à part entière. Chaque skill charge du contexte dans la fenêtre de Claude Code. Des skills redondants ou mal ciblés ajoutent du bruit et peuvent générer des comportements incohérents d'une session à l'autre.
La quatrième est le risque de conflits. Deux skills actifs dans un même projet avec des instructions contradictoires produiront des résultats imprévisibles. Il n'existe pas de mécanisme de résolution automatique : la détection est entièrement à votre charge.
Sur la confidentialité : si un skill contient des instructions métier sensibles (noms de clients, règles de tarification, contraintes contractuelles), veillez à ce qu'il ne soit pas partagé sur un dépôt public ou synchronisé sans contrôle. Un fichier `.md` d'apparence anodine peut embarquer plus d'informations stratégiques qu'il n'y paraît.
## Ce qu'il faut retenir
Les claude skills apportent une valeur mesurable sur les tâches récurrentes et structurellement identiques dans Claude Code. Le gain est réel, à condition que vos instructions soient précises et maintenues à jour. La vraie question n'est pas technique : c'est d'identifier quels processus de votre quotidien méritent d'être automatisés, et lesquels ne le méritent pas. C'est précisément ce que nous traitons lors d'un audit d'automatisation chez inforeole.
