À retenir
- Une skill = un dossier + un fichier SKILL.md — des instructions que Claude charge automatiquement quand le contexte s'y prête, pas un simple prompt.
- Créer une skill prend 10 minutes : frontmatter YAML + corps Markdown + test. Le tutoriel complet est dans cet article.
- Skill = le comment, MCP = l'accès, subagent = la délégation — confondre les trois, c'est payer ses tokens inutilement.
- 5 templates métiers prêts à copier-coller : revue de code, rédaction éditoriale, analyse Excel, slides, prospection.
- L'écosystème est déjà standardisé : plus de 900 skills officielles côté Anthropic, et le format est adopté par Cursor, Codex, Gemini CLI et Copilot.
Vendredi, 16 h 05. Vous relisez à Claude Code la même consigne que lundi — mêmes fichiers, même projet, mêmes règles de revue de code. Et lundi prochain, il faudra recommencer, comme si la conversation précédente n'avait jamais existé. Si vous cherchez un tutoriel pour créer vos propres skills Claude Code, c'est probablement que vous en avez assez de ce manège : répéter au lieu de systématiser. Bonne nouvelle : la solution tient dans un fichier Markdown de 40 lignes.
Une skill Claude Code est une procédure que Claude charge automatiquement quand le contexte s'y prête. Autrement dit : vous écrivez la méthode une fois, avec les exemples, les pièges et les formats attendus, et l'agent l'utilise tout seul. Un cas que nous voyons chaque semaine dans les formations de The Intelligence Academy : une lead développeuse dans une PME de 40 personnes passait environ 4 heures par semaine à re-préciser les règles de revue de code. Son premier skill de 40 lignes a ramené ce temps à 20 minutes. Et surtout, ses commentaires sont devenus plus cohérents, parce que la procédure ne varie plus d'un vendredi à l'autre.
Dans ce guide, vous allez apprendre ce qu'est vraiment un skill — et ce que ce n'est pas —, où le créer selon votre profil, les 6 étapes pour en construire un, puis 5 templates métiers prêts à copier-coller. En fin d'article, une section avancée transforme votre skill en micro-agent grâce à MCP.
Qu'est-ce qu'un skill Claude Code exactement ?
Une skill Claude Code est un dossier contenant un fichier SKILL.md qui charge automatiquement des instructions quand le contexte s'y prête — procédure, exemples et formats attendus, le tout activé par le modèle lui-même. Le fichier comporte un en-tête YAML (name, description) et un corps en Markdown. Elle peut embarquer des scripts, des templates et des fichiers de référence. Le chargement est progressif : environ 100 tokens pour la description au démarrage, puis le corps complet — moins de 5 000 tokens — uniquement quand le besoin est détecté (spécification Agent Skills).
Le point qui change tout : le déclenchement est model-invoked. Claude lit votre demande, la compare aux descriptions des skills disponibles, et décide seul d'en activer une. Vous n'avez pas à l'appeler — en tout cas, pas quand elle est bien conçue.
Imaginez un chef étoilé qui confie sa recette signature à son second. Il ne lui glisse pas un ingrédient au dernier moment : il écrit une fiche procédure complète — les gestes, les températures, les pièges à éviter — que le second consulte quand il en a besoin et range ensuite. Une skill, c'est exactement ça : la fiche procédure de Claude Code. Claude sait déjà cuisiner ; la skill lui dit comment vous voulez que ce soit cuisiné.
💡 Bon à savoir : le chargement progressif des skills (100 tokens inactifs, jusqu'à 5 000 tokens activés) évite de saturer le contexte. À titre de comparaison, un serveur MCP reste chargé en permanence avec environ 10 000 tokens, même quand vous ne l'utilisez pas.
Pour comprendre ce qui distingue une skill des autres mécanismes de Claude Code, voici le comparatif qui compte :
La règle à retenir : une skill sait faire, un MCP sait connecter, un subagent sait exécuter, un prompt sait improviser. Si vous confondez les trois premiers, vous payez l'addition en tokens — un serveur MCP reste chargé même quand vous ne l'utilisez pas. Une skill, elle, ne se réveille que lorsqu'elle est utile.
Concrètement, voici ce qu'une skill change dans une semaine de travail ordinaire :
Revue de code systématique
Rédaction aux normes
Analyse de fichiers
Une skill n'est pas un prompt mieux rangé. C'est une procédure que Claude active tout seul, à condition que la description soit un bon radar. Une description vague, et votre skill restera au fond du tiroir.
Où créer et installer son skill ?
Trois environnements existent, chacun adapté à un profil différent : le CLI pour les développeurs, le web pour les métiers non techniques, et le mode entreprise pour les directions IT. Le premier réflexe ? Choisir le bon environnement — et le bon emplacement — selon vos besoins :
Votre profil détermine le bon point de départ. Un développeur n'a pas besoin de passer par l'interface web ; un marketeur n'a pas besoin d'ouvrir un terminal. Voici comment trancher :
Développeur ou tech lead
Métier non technique
Direction / DSI
L'emplacement décide de la portée : le dossier ~/.claude/skills/ pour vos skills personnelles, .claude/skills/ à la racine du dépôt pour les skills partagées par l'équipe, et le dossier skills du plugin pour les skills livrées avec un plugin. En cas de conflit de nom, la priorité est : entreprise, puis personnel, puis projet, puis plugin (documentation officielle).
Comment créer un skill Claude Code : le tutoriel pas à pas
Vous savez maintenant ce qu'est une skill et où elle vit. Passons à la pratique. L'objectif : un skill de revue de code fonctionnel, créé de zéro en moins de 15 minutes.
Claude
La famille de modèles et d'outils d'Anthropic — Claude Code en est l'agent de développement en ligne de commande
Voici la vue d'ensemble du processus, avant d'entrer dans le détail de chaque étape :
Créer le dossier et le fichier
Un dossier par skill, un fichier SKILL.md à la racine. L'emplacement dépend de la portée : personnel ou projet.
Rédiger le frontmatter
Le name et la description YAML. La description est le radar qui déclenche la skill — c'est elle qui décide de tout.
Écrire les instructions
Le corps Markdown : la procédure, les exemples, les formats attendus. Un seul objectif, des exemples plutôt que des règles.
Ajouter les ressources
Scripts, templates, fichier référence.md pour les cas particuliers. Tout ce qui ne tient pas sur un écran part ailleurs.
Activer et tester
Recharger, vérifier la présence dans /skills, lancer des tests réels. Corriger ce qui ne se déclenche pas.
Itérer avec les logs
Observer les sessions, noter les ratés, enrichir la procédure au fil des semaines. Une skill vit, elle n'est jamais figée.
Si vous êtes plutôt visuel, cette vidéo de 3 minutes résume les concepts que nous venons de poser :
Étape 1 : créer le dossier et le fichier SKILL.md
Ouvrez votre terminal et exécutez :
mkdir -p ~/.claude/skills/mon-premier-skill
touch ~/.claude/skills/mon-premier-skill/SKILL.md
Pour une skill partagée avec votre équipe, créez plutôt le dossier .claude/skills/ à la racine du dépôt Git. Elle sera versionnée, relue en pull request, et livrée avec le code — c'est la bonne façon de standardiser les règles de l'équipe.
Étape 2 : rédiger le frontmatter, le radar de la skill
Ouvrez SKILL.md et commencez par l'en-tête YAML :
---
name: mon-premier-skill
description: |
Utilisez cette skill quand l'utilisateur demande de relire son code non commité
ou de résumer ses changements Git. Couvre git diff, git status, revue de cohérence.
---
Deux champs, deux règles : le name est un identifiant sans espaces — il apparaîtra dans la liste des skills. La description est un radar de routage : elle doit décrire quand la skill s'active, pas seulement ce qu'elle fait. Le pattern officiel recommandé par Anthropic commence par « Use when the user asks to… » — en français : « Utilisez cette skill quand l'utilisateur demande… ».
Étape 3 : écrire des instructions qui guident vraiment
Sous le frontmatter, le corps en Markdown. Exemple simple inspiré de la skill officielle de démonstration :
Exécutez `git diff` et `git status` pour connaître l'état du dépôt.
Produisez ensuite un résumé structuré :
- fichiers modifiés et impact pressenti
- risques identifiés, par priorité
- suggestions de correction
Terminez par une question ouverte. Ne modifiez aucun fichier sans validation explicite.
Trois règles d'écriture : des exemples plutôt que des règles abstraites — montrez une sortie attendue, un cas limite, un contre-exemple. Un seul objectif par skill — une skill qui fait trois choses s'activera au mauvais moment. Et gardez le fichier principal sur un écran — les détails partent dans des fichiers compagnons.
💡 Bon à savoir : le modèle excelle dans la rédaction, pas dans le parsing PDF ni dans le tri déterministe. Si une étape est mécanique, écrivez un script Python ou bash — vous réduirez les hallucinations et le coût en tokens. La skill appelle le script ; le script ne dort jamais.
Étape 4 : ajouter des ressources (scripts, templates, référence.md)
Les skills ne se limitent pas au Markdown. Vous pouvez placer dans le même dossier des scripts, des templates et un fichier reference.md pour les cas particuliers.
Le modèle excelle dans la rédaction, pas dans le parsing PDF ni dans le tri déterministe. Si une étape est mécanique, écrivez un script Python ou bash — vous réduirez les hallucinations et le coût en tokens. La skill appelle le script ; le script ne dort jamais.
Exemple : une skill d'analyse de CSV fera appel à un script de nettoyage des données avant de demander à Claude d'interpréter les résultats. Le travail déterministe revient au code, le travail de jugement revient au modèle.
Étape 5 : activer et tester votre skill
Une fois le fichier en place :
# Lister les skills chargées
/ skills
# Ou, dans Claude Code, la commande slash du skill
# Si votre skill s'appelle mon-premier-skill, invoquez : /mon-premier-skill
Testez ensuite l'activation naturelle : posez une question qui correspond à la description, sans la nommer. Si la skill ne se déclenche pas, la description est trop vague ou mal alignée. En cas de doute, utilisez la skill intégrée /doctor pour diagnostiquer l'installation et les conflits éventuels.
Étape 6 : itérer avec les logs
Une skill n'est jamais terminée au premier essai. Passez une semaine à observer : quand s'active-t-elle à contretemps ? Que produit-elle quand les fichiers sont volumineux ? Les corrections que vous apportez sont du patrimoine — elles bénéficieront à toutes les sessions suivantes.
Attention à la confusion classique : le name du frontmatter et le nom du dossier doivent rester alignés. Un name mal formé (espaces, accents) rend la skill introuvable, même si le dossier existe.
5 templates de skills prêts à copier-coller (par métier)
Les exemples génériques de revue de code, c'est bien. Une skill qui colle à votre métier, c'est mieux. Voici cinq templates adaptés aux profils que nous formons chez The Intelligence Academy — remplacez les valeurs entre crochets et testez.
Revue de code
Rédaction éditoriale
Analyse Excel / CSV
Génération de slides
Prospection commerciale
Template 1 — Revue de code (développeur)
---
name: revue-code-equipe
description: |
Utilisez cette skill quand l'utilisateur demande une revue de code,
une relecture de pull request ou une vérification des conventions
du projet. Ne pas utiliser pour écrire du nouveau code.
---
Vérifiez dans l'ordre : cohérence avec les conventions (lint, nommage, structure),
bugs évidents (variables inutilisées, conditions inversées, retours oubliés),
dette technique introduite. Produisez un résumé structuré : fichiers, risques
par priorité, suggestions. Terminez par une question ouverte.
Template 2 — Rédaction éditoriale (marketing / comm)
---
name: redaction-editoriale
description: |
Utilisez cette skill quand l'utilisateur demande un article de blog,
une newsletter ou un post LinkedIn. Couvre la structure H2/H3, le ton
et l'appel à l'action final.
---
Avant de rédiger, demandez : lecteur cible, objectif, ton. Structurez ensuite
en sections courtes avec un exemple concret au moins par section. Terminez
par un appel à l'action unique. Interdiction de jargon creux.
Template 3 — Analyse de fichiers Excel/CSV (finance, opérations)
---
name: analyse-excel
description: |
Utilisez cette skill quand l'utilisateur fournit un fichier CSV ou Excel
et demande une analyse, un résumé ou une détection d'anomalies.
---
Nettoyez les données (valeurs manquantes, doublons, formats) avant toute analyse.
Calculez les indicateurs clés : totaux, moyennes, variations. Détectez les
anomalies supérieures à deux écarts-types. Produisez une synthèse en français
simple avec les chiffres exacts et leur source dans le fichier.
Template 4 — Génération de slides (consultant, manager)
---
name: generation-slides
description: |
Utilisez cette skill quand l'utilisateur demande une présentation,
un support de slide ou un deck. Couvre la structure, la densité
et le message clé.
---
Pour chaque slide : un message clé en une phrase, maximum 5 points visuels,
une source ou une donnée chiffrée. Passez de l'idée générale au plan détaillé
avant de rédiger le contenu. Adaptez le ton au public annoncé.
Template 5 — Prospection commerciale (business development)
---
name: prospection-commerciale
description: |
Utilisez cette skill quand l'utilisateur demande un email de prospection,
une relance ou un argumentaire pour un prospect identifié.
---
Personnalisez à partir des informations disponibles sur le prospect : secteur,
taille, contexte. Structure : accroche liée à un enjeu réel, preuve de valeur,
question ouverte. Relance à 5 jours avec un angle nouveau, jamais un copier-coller.
Ces templates sont des points de départ, pas des dogmes. La valeur vient de l'itération : après une semaine d'usage réel, ajustez les instructions avec ce que vous avez appris de vos propres sessions.
Les meilleurs skills Claude Code en 2026 : notre sélection
L'écosystème a déjà largement dépassé le stade artisanal. Côté bibliothèques officielles, Anthropic maintient 927 skills, Microsoft 1577, OpenAI 746 et Vercel 396 (Agent Skills Library). Et surtout, le format est devenu un standard ouvert — les mêmes skills fonctionnent dans Claude Code, Cursor, Codex, Gemini CLI et GitHub Copilot.
Claude Code embarque aussi des skills incluses, chargées automatiquement : /doctor, /code-review, /batch, /debug, /loop, /claude-api, /run et /verify. Notre sélection ci-dessous part de ces bases et ajoute les mieux notées de la communauté :
Universal CLAUDE.md
tech-debt-skill
claude-seo
66 skills full-stack
Superpowers
summarize-changes
Pour explorer le reste du catalogue : le dépôt awesome-claude-skills recense les meilleures skills communautaires triées par thématique, et l'annuaire mcpservers.org/agent-skills couvre les bibliothèques officielles.
💡 Bon à savoir : le format Agent Skills est désormais un standard ouvert adopté par Cursor, OpenAI Codex, Gemini CLI et GitHub Copilot. Une skill bien écrite pour Claude Code est portable avec des ajustements mineurs — un atout si votre équipe change d'outil.
Erreurs courantes et guide de débogage
Les trois erreurs les plus fréquentes expliquent 80 % des abandons : une description vague empêche l'activation, un multi-objectif provoque des activations à contretemps, et l'absence d'exemples rend les réponses génériques. Avant de conclure que les skills ne marchent pas, vérifiez ces points :
Description vague
Multi-objectif
Zéro exemple
SKILL.md géant
Ensuite, quand un skill refuse de se comporter correctement, suivez le guide de débogage symptôme → cause → solution :
💡 Bon à savoir : la skill
/doctorintégrée dans Claude Code permet de diagnostiquer l'installation et les conflits entre skills. Si votre skill ne s'active pas, lancez/doctoravant de modifier la description — le problème est parfois ailleurs.
Skill avancé + MCP : transformez votre skill en micro-agent
Une skill seule, c'est une procédure. Une skill adossée à des serveurs MCP — le Model Context Protocol — devient un micro-agent capable d'agir : interroger une API, lire une base de données, piloter un navigateur. C'est la combinaison que les équipes les plus avancées utilisent en production.
Concrètement, la skill apporte le « comment » (la procédure, les formats, les critères de qualité) et le serveur MCP apporte l'« accès » (les outils externes). Claude exécute la procédure et mobilise les outils au moment prévu par les instructions.
Pour construire un skill augmenté par MCP, suivez cette méthode :
Cadrer l'objectif
Une tâche précise, un livrable défini, des critères de validation explicites. Exemple : « auditer les URLs du site et produire un rapport d'accessibilité ».
Lister les accès nécessaires
API, base de données, navigateur headless : chaque accès correspond à un serveur MCP à configurer séparément.
Décrire les outils dans les instructions
Dans le corps de la skill, précisez à quel moment appeler quel outil : « avant de conclure, appelez l'outil de recherche pour vérifier la donnée ».
Tester avec et sans MCP
La skill doit rester utilisable sans les outils — elle dégrade alors son livrable au lieu de planter.
Mesurer le temps gagné
Comparez une semaine avec et une semaine sans, sur la même tâche. Le ROI se chiffre en heures récupérées, pas en impressions.
Les skills et les serveurs MCP manipulent des données parfois sensibles. Avant de connecter un MCP à votre CRM ou à votre base clients, validez le traitement avec votre DPO. Une skill puissante sur des données non maîtrisées, c'est un incident qui vous attend.
Sources et références
Les données chiffrées de cet article proviennent des sources vérifiables suivantes. Aucune statistique inventée : tout est traçable.
- Documentation officielle Claude Code — Extend Claude with skills — chargement progressif, emplacements, skills incluses.
- Code with Me or for Me? How Increasing AI Automation Transforms Developer Workflows (arXiv, 2025) — 35 % de tâches supplémentaires accomplies avec les agents de code.
- Insee Première — Les TIC dans les entreprises en 2025 — adoption de l'IA dans les entreprises françaises : 6 % (2023) à 18 % (2025).
- Bpifrance Le Lab — L'IA dans les PME et ETI françaises — rapport institutionnel sur l'adoption dans les PME et ETI.
- Awesome MCP Servers — Agent Skills Library — bibliothèques de skills : Anthropic 927, Microsoft 1577, OpenAI 746, Vercel 396.
- Camille Roux — Les 13 meilleurs skills & plugins Claude Code (2026) — Universal CLAUDE.md et réduction des tokens de sortie de 63 %.
- GitHub — awesome-claude-skills — liste curated de skills communautaires.
- Spécification Agent Skills — métadonnées et recommandations de taille pour les skills.
Questions fréquentes sur les skills Claude Code
Qu'est-ce qu'un skill Claude Code exactement ?
Une skill est un dossier contenant un fichier SKILL.md : un en-tête YAML (name, description) et des instructions en Markdown, avec éventuellement des scripts et des templates. Claude la charge automatiquement quand votre demande correspond à sa description — c'est une procédure réutilisable, pas un simple prompt.
Quelle est la différence entre un skill et un prompt ?
Un prompt est jetable : vous le réécrivez à chaque session, avec des variations et des oublis. Une skill est une procédure versionnée, chargée automatiquement, avec des exemples et des pièges documentés. Le même prompt utilisé toute la journée reste un prompt ; une skill, elle, devient un standard.
Combien de skills peut-on avoir dans Claude Code ?
Techniquement, il n'y a pas de limite. En pratique, gardez un nombre raisonnable — moins de 50 — car chaque description de skill consomme environ 100 tokens de contexte au démarrage. Une bibliothèque de 200 skills avec des descriptions verbeuses dégraderait vos sessions sans bénéfice.
Où sont stockés les skills Claude Code ?
Dans quatre emplacements possibles : ~/.claude/skills/ pour vos skills personnelles, .claude/skills/ dans le dépôt du projet pour les skills partagées, le dossier skills du plugin pour celles livrées avec un plugin, et les managed settings pour le déploiement entreprise. En cas de conflit, la priorité est : entreprise, personnel, projet, plugin.
Peut-on partager un skill Claude Code ?
Oui. La méthode la plus simple : placer le dossier dans .claude/skills/ du dépôt Git, et le partager en pull request. Pour un partage public, les skills sont publiées sur GitHub et référencées dans des annuaires communautaires comme awesome-claude-skills.
Faut-il savoir coder pour créer une skill ?
Non. Un fichier Markdown avec un en-tête YAML suffit pour 90 % des usages métier. Les scripts ne deviennent nécessaires que pour les tâches déterministes — parsing, tri, nettoyage — et peuvent être ajoutés progressivement, une fois la skill validée.
Les skills fonctionnent-elles avec d'autres outils que Claude Code ?
Oui. Le format Agent Skills, popularisé par Anthropic, est désormais un standard ouvert adopté par Cursor, OpenAI Codex, Gemini CLI et GitHub Copilot. Une skill bien écrite est portable d'un outil à l'autre, avec des ajustements mineurs.
Pour aller plus loin
- Claude code debutant tutoriel
- Meilleurs skills plugins claude code
- Alternative ia remplacer claude coder
Envie de passer à la pratique ? Notre formation dédiée vous accompagne pour appliquer tout ça à votre métier.
Conclusion : créez votre premier skill ce week-end
Vous avez maintenant tout ce qu'il faut : la définition, le comparatif avec les autres mécanismes, le tutoriel en 6 étapes, cinq templates métiers, les erreurs à éviter et la combinaison avancée avec MCP. Le seul élément qui manque, c'est l'heure de pratique — et elle ne prendra pas plus d'un après-midi.
Commencez petit. Choisissez la tâche que vous répétez le plus souvent — revue de code, compte rendu, analyse de fichier — et transformez-la en skill. Testez-la dès le premier jour. Itérez une semaine plus tard. La différence entre quelqu'un qui utilise Claude Code et quelqu'un qui le maîtrise, c'est exactement cette capacité à transformer l'usage ponctuel en patrimoine réutilisable.
Si vous voulez aller plus loin, la formation Code with AI de The Intelligence Academy — éligible CPF — consacre un module entier aux skills, à MCP et au débogage d'agents. Vous repartez avec vos propres skills opérationnelles, pas avec un certificat de plus.
Pour une approche complémentaire, découvrez [LIEN_INTERNE: les meilleures pratiques de prompting pour Claude → /blog/meilleures-pratiques-prompting-claude] et [LIEN_INTERNE: comment automatiser vos workflows avec MCP → /blog/automatisation-workflows-mcp].
