Claude Code Skills : le guide complet

Les skills transforment Claude Code en collaborateur spécialisé

Les Claude Code skills sont le système d’extension qui transforme un agent généraliste en collaborateur formé à vos conventions et à votre stack. Concrètement, un skill est un fichier SKILL.md qui contient des instructions réutilisables : Claude Code les charge automatiquement quand le contexte est pertinent, ou vous les invoquez via une commande /slash.

Selon le Stack Overflow Developer Survey 2026, 73 % des développeurs qui utilisent des assistants ou agents de code le font quotidiennement, et Claude Code est l’agent de code le plus cité (66 %), devant GitHub Copilot (59 %) (Stack Overflow, 2026). Personnaliser son agent de code fait la différence entre un assistant générique et un outil qui connaît vos conventions.

Ce guide détaille les cinq piliers du système d’extension de Claude Code : CLAUDE.md, skills, hooks, serveurs MCP et slash commands. Il a été mis à jour le 24 octobre 2026 pour intégrer le passage du standard Agent Skills sous la gouvernance de l’Agentic AI Foundation, les plugins et les mods.

Pourquoi personnaliser Claude Code avec des skills

Sans personnalisation, Claude Code est un agent généraliste performant. Avec des skills bien configurés, il devient un collaborateur qui connaît vos conventions de nommage, votre architecture de fichiers et vos standards de qualité. La différence est mesurable : j’ai constaté une réduction de 40 à 60 % des allers-retours de correction sur mes projets après avoir mis en place un ensemble de skills adaptés.

Andrej Karpathy, cofondateur d’OpenAI, a introduit le terme « agentic engineering » pour décrire cette évolution : « Par défaut, vous n’écrivez pas le code directement 99 % du temps : vous orchestrez des agents qui le font. »

Les skills Claude Code suivent le standard ouvert Agent Skills. Un même fichier SKILL.md fonctionne dans Claude Code, ChatGPT, Cursor, GitHub Copilot, VS Code, Gemini CLI et Codex CLI : Anthropic recense plus de 70 plateformes compatibles depuis la publication du standard en décembre 2025. Vous investissez une fois dans la configuration, vous en bénéficiez dans tous vos outils.

Agent Skills : un standard confié à l’Agentic AI Foundation

Le 22 octobre 2026, Anthropic a cédé le standard Agent Skills à l’Agentic AI Foundation (AAIF), la fondation de la Linux Foundation qui héberge déjà le protocole MCP et AGENTS.md. Le don couvre le nom, le logo, l’organisation GitHub et le domaine agentskills.io. Le même jour, l’AAIF a accueilli trois autres projets : Open Responses (OpenAI), OpenEnv (Hugging Face) et OpenSandbox (Alibaba), ce qui porte son portefeuille à dix projets (Linux Foundation, 22 octobre 2026).

Côté gouvernance, la spécification est désormais pilotée par un Technical Steering Committee. Les mainteneurs viennent de plusieurs entreprises, dont Anthropic, Google et OpenAI, et siègent à titre individuel ; David Soria Parra et Mahesh Murag en sont les lead maintainers. La feuille de route annoncée prévoit des versions numérotées, un processus formel de propositions et des recommandations de sécurité pour écrire et installer des skills.

Les chiffres mis en avant par Anthropic et l’AAIF sont auto-déclarés : plus de 70 plateformes compatibles, plus d’un million de skills publiés et près de 280 millions d’installations. Le million de skills et les 280 millions d’installations proviennent du registre skills.sh de Vercel, atteints en sept mois selon son rapport State of Agent Skills du 25 septembre 2026. Le même rapport nuance l’effet de volume : près de la moitié des skills n’ont été installés qu’une seule fois, et 0,04 % d’entre eux concentrent 62 % des installations.

Ce que cela change pour vous : rien dans le format SKILL.md, tout dans la pérennité. Un skill écrit aujourd’hui ne dépend plus des choix produit d’un seul éditeur.

CLAUDE.md : le fichier de mémoire permanent

Comment fonctionne CLAUDE.md

CLAUDE.md est un fichier Markdown que Claude Code lit au démarrage de chaque session. Il contient les instructions permanentes de votre projet : conventions de code, commandes de build, architecture, décisions techniques. C’est l’équivalent d’un brief d’onboarding que vous donneriez à un nouveau développeur.

Deux systèmes de mémoire coexistent dans Claude Code :

Système	Auteur	Contenu	Portée
CLAUDE.md	Vous	Instructions et conventions	Projet, utilisateur ou organisation
Auto memory	Claude	Apprentissages et patterns	Par dépôt, partagée entre les worktrees (200 premières lignes ou 25 Ko chargés)

Depuis la version 2.1.277, Claude Code lit aussi un fichier AGENTS.md à la place de CLAUDE.md lorsqu’un dépôt n’en possède pas. Pour choisir entre les deux formats et structurer vos instructions, consultez mon guide CLAUDE.md et AGENTS.md : les meilleures pratiques.

Où placer vos fichiers CLAUDE.md

Le placement détermine la portée des instructions :

Portée	Emplacement	Partagé avec
Projet	./CLAUDE.md ou ./.claude/CLAUDE.md	L’équipe via Git
Personnel	~/.claude/CLAUDE.md	Vous seul, tous projets
Local	./CLAUDE.local.md (à ajouter au .gitignore)	Vous seul, ce projet
Organisation	/Library/Application Support/ClaudeCode/CLAUDE.md (macOS), /etc/claude-code/CLAUDE.md (Linux)	Tous les utilisateurs

Bonnes pratiques pour un CLAUDE.md efficace

La documentation officielle de Claude Code recommande de cibler moins de 200 lignes par fichier CLAUDE.md. Pour chaque ligne, posez-vous la question : si je la supprime, est-ce que Claude fera des erreurs ? Si la réponse est non, supprimez-la.

Voici un exemple de CLAUDE.md efficace :

# Projet : API de facturation
Stack : Node.js 22, TypeScript 5.7, PostgreSQL 16
Build : pnpm build
Tests : pnpm test (vitest)

## Conventions
- Indentation : 2 espaces, pas de tabs
- Noms de fichiers : kebab-case
- Pas de console.log en production - utiliser le logger Winston

## Architecture
- src/api/handlers/ : endpoints REST
- src/services/ : logique métier
- src/db/ : requêtes SQL (pas d'ORM)

Pour les projets volumineux, décomposez les instructions dans le répertoire .claude/rules/ avec des fichiers thématiques (testing.md, api-design.md, security.md).

Ces fichiers peuvent être conditionnés à des chemins spécifiques grâce au frontmatter paths :

---
paths:
  - "src/api/**/*.ts"
---

# Règles API
- Toujours valider les inputs avec Zod
- Format d'erreur standardisé { code, message, details }
- Commentaires JSDoc obligatoires sur chaque endpoint

Un skill = frontmatter de configuration + instructions Markdown.

Créer et utiliser des skills Claude Code

Anatomie d’un skill

Chaque skill est un dossier contenant un fichier SKILL.md avec deux parties : un frontmatter YAML qui configure le comportement, et un contenu Markdown avec les instructions.

---
name: review-code
description: "Analyse le code modifié et vérifie la conformité aux conventions du projet."
allowed-tools: Read, Grep, Glob
---

# Revue de code

## Étapes
1. Identifie les fichiers modifiés récemment
2. Vérifie la conformité aux conventions du CLAUDE.md
3. Détecte les problèmes de sécurité (injections SQL, XSS, secrets exposés)
4. Propose des améliorations concrètes avec des diffs

Les champs du frontmatter

La spécification Agent Skills ne définit que six champs : name, description, license, compatibility, metadata et allowed-tools. Claude Code accepte en plus ses propres extensions, listées ci-dessous. Si vous voulez qu’un skill reste portable vers claude.ai, l’API Skills ou un autre agent, limitez-vous aux six champs du standard.

Champ	Description	Obligatoire
name	Nom du skill (devient la commande /slash)	Non (utilise le nom du dossier par défaut)
description	Rôle et contexte d’activation automatique	Recommandé
disable-model-invocation	true pour empêcher l’activation automatique	Non
user-invocable	false pour masquer du menu /	Non
allowed-tools	Outils autorisés sans demande de permission	Non
disallowed-tools	Outils retirés tant que le skill est actif	Non
paths	Globs de fichiers qui déclenchent le chargement automatique	Non
hooks	Hooks enregistrés à l’invocation du skill, actifs jusqu’à la fin de la session	Non
context	fork pour exécuter dans un sous-agent isolé	Non
agent	Type de sous-agent (Explore, Plan, etc.)	Non
model	Modèle à utiliser quand le skill est actif	Non
effort	Niveau d’effort (low, medium, high, xhigh, max)	Non

Où stocker vos skills

Emplacement	Chemin	Portée
Personnel	~/.claude/skills/<nom>/SKILL.md	Tous vos projets
Projet	.claude/skills/<nom>/SKILL.md	Ce projet uniquement
Imbriqué	<sous-dossier>/.claude/skills/<nom>/SKILL.md	Les sessions ouvertes dans ce sous-dossier (monorepos)
Entreprise	Via les managed settings	Toute l’organisation
Plugin	<plugin>/skills/<nom>/SKILL.md	Là où le plugin est activé, sous la forme /plugin:skill
Compte claude.ai	Skills activés sur votre compte	Cowork, sessions cloud et terminal connecté

Invoquer un skill

Deux modes d’invocation coexistent :

• Automatique : Claude détecte que votre demande correspond à la description du skill et le charge.
• Manuel : vous tapez /nom-du-skill suivi d’arguments optionnels.

Exemple avec arguments :

/fix-issue 42

Le skill reçoit 42 via la variable $ARGUMENTS et peut l’utiliser dans ses instructions.

Skills bundled : les skills intégrés à Claude Code

Claude Code intègre une quinzaine de skills prêts à l’emploi, désactivables en bloc avec le paramètre disableBundledSkills. Les plus utiles au quotidien :

Skill	Description
/batch <instruction>	Orchestre des modifications à grande échelle en parallèle (5 à 30 sous-agents)
/code-review	Revue de code du diff courant ou d’une PR, avec trois niveaux de profondeur
/claude-api	Charge la documentation API Claude et Managed Agents pour votre langage
/debug [description]	Analyse les logs de session pour diagnostiquer un problème
/doctor	Bilan de configuration : installation, extensions, CLAUDE.md, permissions, coût en contexte
/loop [intervalle] <prompt>	Exécute un prompt en boucle à intervalles réguliers
/simplify [focus]	Revue de code automatique avec trois agents parallèles
/skill-doctor	Mesure le coût en contexte et l’usage de chaque skill pour désactiver les inutiles
/verify	Compile et lance votre application pour confirmer qu’une modification fonctionne
/plugin-authoring	Génère un mod ou un plugin à partir d’une description en langage naturel

Le skill /batch est particulièrement utile pour les refactorings multi-fichiers. J’ai récemment migré 23 composants d’une bibliothèque UI en une seule commande : /batch migrate src/components from MUI to shadcn/ui. Chaque composant a été traité par un sous-agent dédié dans un worktree Git isolé. Pour les migrations plus lourdes, les Dynamic Workflows prennent le relais avec le skill /workflow-authoring.

Exemple avancé : skill avec contexte dynamique

Le skill suivant injecte des données en temps réel avant de les transmettre à Claude grâce à la syntaxe !`commande` :

---
name: pr-summary
description: "Résume les changements d'une pull request."
context: fork
agent: Explore
allowed-tools: Bash(gh *)
---

## Contexte de la PR
- Diff : !`gh pr diff`
- Commentaires : !`gh pr view --comments`
- Fichiers modifiés : !`gh pr diff --name-only`

## Tâche
Résume cette pull request en 3 points maximum.

Les commandes shell s’exécutent avant que Claude reçoive le prompt. Claude voit uniquement les résultats, pas les commandes.

Distribuer vos skills : plugins, marketplaces et mods

Commiter .claude/skills/ suffit pour une équipe sur un dépôt. Dès que vous voulez installer le même ensemble de skills, hooks, sous-agents et serveurs MCP dans plusieurs projets, le bon format est le plugin : un dossier avec un manifeste .claude-plugin/plugin.json, installé en une commande depuis une marketplace.

# Ajouter une marketplace puis installer un plugin
claude plugin marketplace add votre-org/claude-plugins
claude plugin install deploy-kit@votre-org

# Ou en une seule commande (v2.1.292+)
claude plugin install deploy-kit --marketplace votre-org/claude-plugins

Une marketplace n’est pas une boutique hébergée : c’est un dépôt Git contenant un fichier .claude-plugin/marketplace.json qui liste des plugins et leur source. Claude Code ajoute la marketplace officielle d’Anthropic (claude-plugins-official) au premier lancement interactif ; la commande /plugin permet d’y naviguer et affiche pour chaque plugin une estimation de son coût en contexte. Le scanner Claude Code Security est distribué sous cette forme.

Depuis le 1er octobre 2026 (v2.1.287), un plugin peut aussi contenir un mod : du code JavaScript ou TypeScript exécuté à l’intérieur de Claude Code. Un mod dessine un panneau à côté de la conversation, ajoute une commande instantanée ou intercepte un appel d’outil avant qu’il ne parte. Anthropic publie des exemples sur GitHub, dont blast-radius, qui retient une commande rm -rf ou un git push --force et montre ce qu’elle changerait avant de laisser passer.

Un mod s’exécute avec vos permissions et hors sandbox. Avant d’en installer un, claude plugin validate ./le-mod liste les événements qu’il écoute et ce qu’il demande à Claude Code (lecture de fichiers, requêtes réseau). Pour tester un plugin sur des cas réels, claude plugin eval rejoue une suite de cas avec et sans le plugin et compare les scores ; l’option --disallow-tools (v2.1.299, 14 octobre 2026) retire certains outils intégrés, comme Agent, des runs d’évaluation.

La prudence n’est pas théorique. L’audit ToxicSkills de Snyk (février 2026) a passé au crible 3 984 skills publiés sur ClawHub et skills.sh : 76 contenaient une charge malveillante confirmée (exfiltration d’identifiants, exécution de commandes, persistance) et 13,4 % présentaient au moins une faille critique. Lisez le SKILL.md et les scripts d’un skill tiers comme vous liriez une dépendance npm inconnue.

Les hooks : automatiser la qualité du code

Comment fonctionnent les hooks

Les hooks sont des commandes shell, endpoints HTTP, outils MCP, prompts ou agents qui s’exécutent automatiquement à des moments précis du cycle de vie de Claude Code. Ils permettent d’automatiser le linting, les tests, les notifications et les garde-fous de sécurité.

Les événements disponibles

La référence des hooks compte plus de trente événements en octobre 2026. Les plus utilisés :

Événement	Se déclenche	Usage principal
PreToolUse	Avant l’exécution d’un outil	Bloquer des actions dangereuses
PermissionRequest	Quand un appel d’outil attend une décision de permission	Approuver ou refuser par règle, sans dialogue
PostToolUse	Après une exécution réussie	Linting, formatage automatique
UserPromptSubmit	Avant traitement du prompt	Ajouter du contexte, filtrer les requêtes
Stop	Quand Claude termine sa réponse	Forcer la continuation, vérifier les tests
SessionStart / SessionEnd	Au démarrage ou à la fin de la session	Charger l’environnement, archiver, nettoyer
PreCompact	Avant la compaction du contexte	Sauvegarder l’état de travail
WorktreeCreate	À la création d’un worktree par un sous-agent	Installer les dépendances, copier un .env
Notification	Lors d’une notification	Alertes personnalisées

Configurer un hook en pratique

Les hooks se définissent dans vos fichiers de configuration JSON. Chaque handler reçoit l’événement au format JSON sur son entrée standard, d’où l’usage de jq dans les scripts :

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-destructive.sh",
            "timeout": 10
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path // empty' | xargs -r npx prettier --write"
          }
        ]
      }
    ]
  }
}

Le hook PreToolUse dans cet exemple intercepte chaque commande Bash et exécute un script de validation. Si le script retourne le code de sortie 2, l’action est bloquée. Le hook PostToolUse lit le chemin du fichier modifié dans tool_input.file_path et le formate avec Prettier. Sur PostToolUse, un code 2 ne bloque rien (l’outil a déjà tourné) : il remonte simplement le message d’erreur à Claude.

Exemple : bloquer les commandes destructrices

#!/bin/bash
# .claude/hooks/block-destructive.sh
COMMAND=$(jq -r '.tool_input.command')

if echo "$COMMAND" | grep -qE 'rm -rf|drop table|git push.*--force'; then
  jq -n '{
    hookSpecificOutput: {
      hookEventName: "PreToolUse",
      permissionDecision: "deny",
      permissionDecisionReason: "Commande destructrice bloquée par hook de sécurité"
    }
  }'
else
  exit 0
fi

Les serveurs MCP : connecter Claude Code à vos outils

Le Model Context Protocol en bref

Le MCP (Model Context Protocol) est un standard ouvert qui permet à Claude Code de communiquer avec des outils externes : GitHub, bases de données, Notion, Slack, Google Calendar. Donné à l’Agentic AI Foundation en décembre 2025, le MCP est le standard de facto pour connecter des agents IA. Le registre officiel recensait 30 375 serveurs uniques au 10 septembre 2026, trois fois plus qu’en mai de la même année, selon une analyse de l’API du registre. Le chiffre est à relativiser : 18 200 éditeurs distincts, dont 16 356 n’ont publié qu’un seul serveur.

Ajouter un serveur MCP à Claude Code

Deux méthodes sont disponibles :

Via la commande CLI claude mcp add, depuis votre terminal :

# Serveur distant HTTP (GitHub)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer VOTRE_GITHUB_PAT"

# Serveur local stdio, partagé avec l'équipe
claude mcp add --scope project --transport stdio postgres \
  --env DATABASE_URL=postgresql://... \
  -- npx -y @modelcontextprotocol/server-postgres

Via le fichier .mcp.json à la racine du projet, versionné avec le dépôt :

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${GITHUB_PAT}"
      }
    },
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

La syntaxe ${VAR} lit la variable d’environnement au lancement, ce qui évite de commiter un secret. Les serveurs de portée local et user sont stockés dans ~/.claude.json. Dans la session, /mcp affiche l’état de chaque serveur, gère l’authentification OAuth et permet un /mcp reconnect all.

MCP Tool Search : charger les outils à la demande

Quand vous connectez plusieurs serveurs MCP, le nombre d’outils disponibles peut saturer le contexte. Le MCP Tool Search résout ce problème en chargeant les outils dynamiquement, à la demande, au lieu de tous les précharger. Seuls les noms d’outils et les instructions des serveurs sont chargés au démarrage ; Claude Code identifie l’outil pertinent et le charge uniquement quand il en a besoin.

Le Tool Search est activé par défaut depuis 2026. La variable ENABLE_TOOL_SEARCH=auto passe en mode seuil : les outils sont préchargés tant que leurs définitions pèsent moins de 10 % de la fenêtre de contexte, puis différés au-delà. auto:5 abaisse ce seuil à 5 %.

Pour aller plus loin sur les serveurs MCP

Pour approfondir le sujet, consultez mon guide des meilleurs serveurs MCP en 2026 qui détaille les cas d’usage concrets et les configurations recommandées. Pour un cas d’usage complet, le tutoriel automatiser n8n avec Claude Code montre comment générer et publier des workflows via le serveur MCP n8n.

Slash commands vs skills : comprendre les différences

Les anciens « custom commands » et les skills ont été fusionnés. Un fichier dans l’un ou l’autre emplacement crée la même interface /slash.

Vos fichiers .claude/commands/ existants continuent de fonctionner. En cas de collision de noms, le skill l’emporte.

Critère	Commands (ancien)	Skills (recommandé)
Emplacement	.claude/commands/deploy.md	.claude/skills/deploy/SKILL.md
Fichiers associés	Non	Oui (templates, exemples, scripts)
Frontmatter avancé	Basique	Complet (context, agent, hooks, paths)
Activation automatique	Non	Oui (Claude détecte le contexte)
Sous-agent dédié	Non	Oui (context: fork)
Portabilité	Claude Code uniquement	Standard Agent Skills (70+ plateformes)

Utilisez les skills pour tout nouveau workflow. Gardez CLAUDE.md pour les conventions courtes et toujours actives.

Les cinq extensions de Claude Code, configurables en environ 2 heures.

Récapitulatif : les cinq piliers de la personnalisation

Pilier	Rôle	Quand l’utiliser
CLAUDE.md	Instructions permanentes chargées à chaque session	Conventions d’équipe, stack technique, commandes de build
Skills	Workflows réutilisables activés à la demande	Revue de code, déploiement, génération de tests
Hooks	Automatisations déclenchées par des événements	Linting, tests, sécurité, notifications
Serveurs MCP	Connexion à des outils externes	GitHub, bases de données, API tierces
.claude/rules/	Instructions conditionnelles par chemin de fichier	Règles spécifiques à un module ou une technologie

Les plugins ne sont pas un sixième pilier : c’est l’emballage qui permet de distribuer les quatre premiers en une seule installation. Les mods en sont l’extension la plus récente, réservée aux cas où un script ou un prompt ne suffit plus.

Mon avis : deux heures de configuration rentabilisées en une semaine

Configurer un environnement Claude Code complet (CLAUDE.md, 3 à 5 skills, quelques hooks de qualité, 2 à 3 serveurs MCP) prend environ 2 heures. Le retour sur investissement est mesurable dès la première semaine : moins d’allers-retours de correction et des conventions respectées sans que j’aie à les rappeler.

J’utilise Claude Code quotidiennement pour construire ce site et mes projets clients. Les skills que j’ai le plus rentabilisés sont ceux de revue de code et de génération d’articles.

Le système de hooks m’évite les erreurs de déploiement. Et les serveurs MCP me permettent de gérer GitHub, ma base de données et mes outils de monitoring sans quitter le terminal.

Le passage d’Agent Skills sous la Linux Foundation me rassure sur un point : le temps investi dans mes SKILL.md ne dépend plus d’un seul éditeur. Je reste en revanche prudent sur les plugins et mods tiers tant que les recommandations de sécurité annoncées par l’AAIF ne sont pas publiées.

Si vous débutez avec Claude Code, commencez par le tutoriel pour débutant qui couvre l’installation et les bases. Ce guide sur les skills est l’étape suivante pour passer de l’utilisation occasionnelle à un workflow structuré.

Pour comparer Claude Code avec d’autres outils de développement IA, consultez le comparatif Claude Code vs Cursor et le comparatif Codex vs Claude Code.

Si vous souhaitez recevoir ce type de contenu chaque semaine, inscrivez-vous à la newsletter - un email par semaine, zéro spam.