Intelligence artificielle

Skills Claude Code : c'est quoi et comment les utiliser

30 Jui 2026 à 11:02

Skill sur Claude Code : définition, fonctionnement du fichier SKILL.md et guide pas à pas pour créer et utiliser vos skills. Cas d'usage concrets en TPE-PME.

Les skills sur Claude Code : c'est quoi et comment les utiliser concrètement

Mis à jour en 2026 · Par l'équipe ProductivityAI (Studio IA Plateya) · Temps de lecture : 9 min

Les skills sur Claude Code sont devenues l'un des leviers les plus efficaces pour transformer l'assistant de codage d'Anthropic en un véritable collaborateur sur-mesure. Une skill Claude Code encapsule une procédure, un style ou une expertise réutilisable que Claude active automatiquement quand le contexte s'y prête. Ce guide explique ce qu'est une skill sur Claude Code, comment elle fonctionne techniquement, et comment l'utiliser pas à pas — avec le regard d'un studio IA qui déploie ces outils en TPE-PME.

Claude et Claude Code : de quoi parle-t-on ?

Claude est la famille de modèles d'intelligence artificielle développée par Anthropic. En 2026, elle comprend notamment Claude Opus 4.8 (raisonnement complexe et codage agentique), Claude Sonnet 4.6 et Claude Haiku 4.5. Ces modèles excellent sur les tâches de langage, d'analyse et de programmation.

Claude Code est l'outil de codage agentique d'Anthropic. Il permet de déléguer des tâches de développement à Claude depuis le terminal, l'application desktop, VS Code ou JetBrains. Concrètement, Claude Code ne se contente pas de répondre : il lit et écrit des fichiers, exécute des commandes shell et orchestre des tâches multi-étapes dans un environnement d'exécution de code. C'est cette nature agentique qui rend les skills si puissantes : une skill peut embarquer des scripts que Claude exécute réellement, et pas seulement des consignes textuelles.

Pour aller plus loin sur l'écosystème d'Anthropic, voir notre comparatif des outils IA pour TPE-PME sur le blog Plateya.

C'est quoi une skill sur Claude Code ?

Une skill sur Claude Code est, dans sa forme la plus simple, un dossier avec un fichier SKILL.md. Ce fichier comporte deux parties : un frontmatter YAML (entre deux lignes ---) qui décrit à quoi sert la skill et quand l'utiliser, puis le corps en Markdown qui contient les instructions que Claude suit lorsque la skill est active.

Dès qu'on demande « qu'est-ce que j'ai changé ? », Claude Code charge cette skill automatiquement — ou on la lance directement avec /resumer-changements. La ligne !`git diff HEAD` illustre l'injection de contexte dynamique : Claude Code exécute la commande et insère sa sortie dans la skill avant que Claude ne la lise.

L'architecture en 3 couches (progressive disclosure)

Le mécanisme qui rend les skills efficaces est le chargement progressif. Tout n'est pas chargé en même temps dans le contexte de Claude, ce qui économise des tokens :

1. Métadonnées (frontmatter) : toujours chargées au démarrage. Claude lit le nom et la description de chaque skill disponible pour décider laquelle pourrait être pertinente.
2. Instructions (corps du SKILL.md) : chargées uniquement quand la skill est sélectionnée. C'est là que vivent le workflow, les étapes et les exemples.
3. Ressources annexes : fichiers de référence, modèles, schémas ou scripts placés dans des dossiers comme scripts/ ou reference/. Ils ne sont lus qu'au moment où on en a besoin.
   
   

Conséquence directe : une skill peut embarquer une documentation volumineuse, des jeux de données ou des scripts sans coût de contexte tant qu'ils ne sont pas réellement consultés. Lorsqu'un script comme validate.py est exécuté, seul son résultat consomme des tokens, pas son code.

Skills intégrées et commandes fusionnées

Claude Code embarque des skills intégrées (bundled skills) disponibles dans chaque session, comme /code-review, /debug, /run ou /verify. Par ailleurs, les anciennes commandes personnalisées ont été fusionnées avec les skills : un fichier .claude/commands/deploy.md et une skill .claude/skills/deploy/SKILL.md créent tous deux la commande /deploy. Les skills ajoutent simplement des options supplémentaires (dossier de fichiers annexes, contrôle de l'invocation, chargement automatique).

Skill, CLAUDE.md, commande, MCP : quelles différences ?

Quatre mécanismes coexistent dans Claude Code. Les distinguer évite bien des confusions :

Règle simple : un fait qui doit toujours être connu va dans CLAUDE.md ; une procédure qui ne sert qu'occasionnellement devient une skill, dont le corps ne coûte rien tant qu'on ne l'utilise pas.

Comment créer et utiliser une skill sur Claude Code (pas à pas)

Étape 1 — Choisir où vit la skill

L'emplacement du dossier détermine qui peut utiliser la skill :

En cas de même nom à plusieurs niveaux, l'ordre de priorité est : entreprise > personnel > projet, et une skill de ce type l'emporte sur une skill intégrée homonyme. Le nom du dossier devient la commande que vous tapez (ex. deploy-staging/ → /deploy-staging).

Étape 2 — Créer le dossier et le SKILL.md

Seule la description est vraiment recommandée dans le frontmatter : c'est elle que Claude lit pour décider quand appliquer la skill. Mettez le cas d'usage principal en premier — le texte combiné description + when_to_use est tronqué à 1 536 caractères dans la liste des skills.

Étape 3 — Invoquer la skill

• Automatiquement : posez une question qui correspond à la description (« qu'est-ce que j'ai changé ? »). Claude charge la skill seul.
• Manuellement : tapez /resumer-changements pour la déclencher explicitement.

Pour les workflows à effets de bord (déploiement, commit, envoi de message), ajoutez disable-model-invocation: true afin que vous seul puissiez les lancer : on ne veut pas que Claude décide de déployer parce que le code « a l'air prêt ».

Étape 4 — Aller plus loin : arguments, scripts, sous-agents

• Arguments : la variable $ARGUMENTS (ou $0, $1...) récupère ce qui suit la commande. /fix-issue 123 injecte « 123 » dans la skill.
• Scripts embarqués : placez un script dans scripts/ et appelez-le via ${CLAUDE_SKILL_DIR}. Claude l'exécute, ce qui est plus fiable que de lui faire régénérer du code à chaque fois.
• Exécution isolée : ajoutez context: fork pour lancer la skill dans un sous-agent qui n'a pas accès à l'historique de la conversation — idéal pour la recherche ou l'analyse lourde.
  
  
  

Bon à savoir : Claude Code surveille les dossiers de skills. Ajouter, modifier ou supprimer une skill sous ~/.claude/skills/ est pris en compte dans la session en cours, sans redémarrage.

5 cas d'usage de skills en TPE-PME

Au-delà du développement pur, les skills deviennent un outil de standardisation des process. Quelques exemples concrets que nous déployons :

4. Revue de code aux normes maison : une skill qui impose vos conventions d'API, vos formats d'erreur et vos règles de validation à chaque endpoint.
   
   
5. Génération de comptes-rendus : une skill qui résume les changements, prépare un message de commit propre et signale les risques avant chaque pull request.
   
   
6. Documentation automatique : une skill qui génère README, docstrings et références d'API dans le style de votre projet, à partir du code existant.
   
   
7. Visualisation de données : une skill qui exécute un script Python pour produire un rapport HTML interactif (arborescence du code, couverture de tests, schéma de base de données).
   
   
8. Procédures métier sensibles : une skill de déploiement verrouillée en invocation manuelle, avec pré-autorisation fine des commandes Git via allowed-tools.

Bonnes pratiques pour des skills Claude Code fiables

• Soignez la description : c'est le levier n°1. Incluez les mots-clés que les utilisateurs diront naturellement, et placez le cas d'usage principal en tête.
  
  
• Restez concis : gardez le SKILL.md sous 500 lignes. Déplacez la documentation détaillée dans des fichiers annexes que Claude charge à la demande.
  
  
• Préférez les scripts au texte : pour les opérations déterministes (validation, calcul), un script est plus fiable qu'une consigne en langage naturel.
  
  
• Nommez les fichiers explicitement : form_validation_rules.md plutôt que doc2.md. Claude navigue votre dossier comme un système de fichiers.
  
  
• Évaluez avant de diffuser : le plugin skill-creator automatise la comparaison avec / sans skill (taux de déclenchement, qualité de sortie, coût en tokens).

Si une skill ne se déclenche pas, vérifiez d'abord la description : c'est presque toujours là que se joue la fiabilité. La commande /doctor indique si des descriptions ont été tronquées faute de budget de contexte.

FAQ — Skills sur Claude Code

Une skill Claude Code, c'est la même chose qu'une Agent Skill ?

Oui. Les skills de Claude Code suivent le standard ouvert Agent Skills (agentskills.io), partagé avec l'API Claude et claude.ai. Claude Code y ajoute des fonctionnalités propres comme le contrôle d'invocation, l'exécution en sous-agent et l'injection de contexte dynamique.

Faut-il savoir coder pour créer une skill ?

Non pour une skill simple : il suffit d'un dossier et d'un fichier SKILL.md en Markdown avec une description et des instructions. Les fonctions avancées (scripts, arguments, sous-agents) demandent davantage de technicité, d'où l'intérêt d'un accompagnement.

Où sont stockées les skills ?

À quatre niveaux : entreprise (réglages managés), personnel (~/.claude/skills/), projet (.claude/skills/) et plugin. Le niveau choisi détermine la portée, et l'ordre de priorité va de l'entreprise au projet.

Comment empêcher Claude de déclencher une skill tout seul ?

Ajoutez disable-model-invocation: true dans le frontmatter. La skill reste lançable manuellement via /nom, mais Claude ne la chargera plus automatiquement — utile pour les actions sensibles comme un déploiement.

Comment savoir si ma skill fonctionne vraiment ?

En comparant les résultats avec et sans la skill sur des prompts réalistes, dans des sessions neuves. Le plugin skill-creator automatise cette boucle d'évaluation et mesure le gain par rapport au coût en tokens.

En résumé

Les skills sur Claude Code transforment un assistant de codage en plateforme d'expertise réutilisable. Le principe est simple — un dossier, un SKILL.md, une bonne description — mais la valeur vient de l'usage systématique : standardiser des process, embarquer des scripts fiables, et laisser Claude charger la bonne expertise au bon moment. Pour une TPE-PME, c'est un moyen concret de capitaliser son savoir-faire dans des outils que toute l'équipe peut activer.

Vous voulez déployer des skills et des agents IA dans votre organisation ? Échangeons avec Studio IA ou formez vos équipes sur le Hub Formations Plateya.

Sources

Documentation officielle Claude Code — Skills

Documentation Claude Platform — Agent Skills (overview)

Standard ouvert Agent Skills — agentskills.io

Dépôt public Agent Skills — github.com/anthropics/skills