Aller au contenu principal
Skills

Qu'est-ce qu'un Skill Claude Code ?

Comprendre les Skills Claude Code : concept, types, fonctionnement et différences avec les instructions du CLAUDE.md. Guide complet pour maîtriser les slash commands.

Les Skills, c'est quoi exactement ?

Un Skill Claude Code est un fichier Markdown qui enseigne à Claude un comportement, un workflow ou une expertise spécifique. Quand vous invoquez un Skill avec une slash command (ex: /review-pr), Claude suit les instructions du fichier comme un chef cuisinier suit une recette.

L'analogie de la recette de cuisine

Imaginez que Claude Code est un chef cuisinier talentueux. Sans recette, il peut improviser un plat correct. Mais avec une recette précise (un Skill), il reproduira exactement le même plat savoureux à chaque fois, les mêmes étapes, les mêmes vérifications, le même résultat. Les Skills sont les recettes de Claude Code : des instructions structurées qui transforment un assistant généraliste en expert spécialisé.

Les 3 types de Skills

Les Skills se répartissent en trois catégories selon leur portée et leur provenance.

1. Skills built-in (intégrés)

Ce sont les Skills livrés avec Claude Code. Ils couvrent les opérations courantes et sont disponibles immédiatement sans aucune configuration.

# Exemples de Skills built-in
/init # Initialiser un projet avec CLAUDE.md
/review # Revue de code du diff courant
/compact # Compacter la conversation pour libérer du contexte
/memory # Gérer les fichiers mémoire de Claude

2. Skills de projet (project commands)

Créés dans le dossier .claude/commands/ de votre projet, ces Skills sont partagés avec toute l'équipe via le contrôle de version. Chaque fichier Markdown dans ce dossier devient automatiquement une slash command.

# Structure des Skills de projet
.claude/
commands/
review-pr.md # → /project:review-pr
deploy.md # → /project:deploy
hotfix.md # → /project:hotfix
onboarding.md # → /project:onboarding

3. Skills personnels (user commands)

Stockés dans ~/.claude/commands/, ces Skills sont disponibles dans tous vos projets mais ne sont pas partagés avec l'équipe. Idéal pour vos habitudes de travail personnelles.

# Structure des Skills personnels
~/.claude/
commands/
tdd-guide.md # → /user:tdd-guide
code-review.md # → /user:code-review
brainstorm.md # → /user:brainstorm

Comment choisir le bon type ?

  • Built-in : vous n'avez rien à faire, ils sont déjà là
  • Projet : pour les conventions et workflows partagés par l'équipe (review, deploy, conventions de code)
  • Personnel : pour vos habitudes individuelles (style de commit, workflow TDD personnel, templates favoris)

Comment fonctionne un Skill ?

Quand vous tapez une slash command, Claude Code exécute un processus en quatre étapes.

Détection

Claude Code reconnaît la commande /project:review-pr et cherche le fichier correspondant dans .claude/commands/review-pr.md.

Chargement

Le contenu Markdown du fichier est injecté dans le contexte de Claude comme instructions système. Claude les interprète comme des directives prioritaires.

Exécution

Claude suit les instructions du Skill pas à pas. Si le Skill contient des variables (comme $ARGUMENTS), elles sont remplacées par les arguments fournis par l'utilisateur.

Résultat

Claude produit le résultat selon le format défini dans le Skill : un rapport, du code modifié, une checklist validée, etc.

Anatomie d'un fichier Skill

Un Skill est simplement un fichier Markdown avec des instructions claires. Voici un exemple complet :

# Review de Pull Request
Tu es un reviewer de code senior. Analyse la PR en cours et fournis un feedback structuré.
## Étapes
1. Lis le diff complet avec `git diff main...HEAD`
2. Vérifie la cohérence avec les conventions du projet (CLAUDE.md)
3. Identifie les problèmes potentiels :
- Bugs logiques
- Problèmes de performance
- Failles de sécurité
- Code dupliqué
4. Vérifie la couverture de tests
## Format de sortie
Pour chaque fichier modifié, fournis :
- **Fichier** : chemin du fichier
- **Sévérité** : CRITICAL / HIGH / MEDIUM / LOW
- **Problème** : description du problème
- **Suggestion** : correction proposée
## Variables
- $ARGUMENTS : branche cible pour le diff (défaut: main)

La puissance de \$ARGUMENTS

La variable $ARGUMENTS capture tout ce que vous tapez après la slash command. Par exemple, /project:review-pr develop remplace $ARGUMENTS par develop. Cela rend vos Skills dynamiques et réutilisables.

Skill vs CLAUDE.md : quelle différence ?

Vous vous demandez peut-être pourquoi créer des Skills quand on a déjà le fichier CLAUDE.md pour donner des instructions à Claude. La réponse tient en trois points.

CLAUDE.mdSkill
PortéeToujours actif, chargé à chaque conversationActivé à la demande via slash command
ObjectifContexte global du projet (conventions, architecture)Workflow ou tâche spécifique
TailleCourt et ciblé (éviter de surcharger le contexte)Aussi détaillé que nécessaire
ActivationAutomatiqueManuelle (/command)
AnalogieLa carte d'identité du projetUne recette pour une tâche précise

En résumé

Le CLAUDE.md dit à Claude qui est le projet. Les Skills disent à Claude comment accomplir une tâche précise. Les deux sont complémentaires : le CLAUDE.md fournit le contexte permanent, les Skills fournissent l'expertise à la demande.

Exemple concret : avant et après

Sans Skill

# Vous devez expliquer à chaque fois ce que vous attendez
> Claude, fais une review de mon code. Vérifie les bugs, la sécu,
> les perfs, et regarde si les tests couvrent bien les changements.
> Donne-moi un rapport structuré par fichier avec la sévérité.

Avec Skill

# Une seule commande, le même résultat à chaque fois
/project:review-pr

Le Skill garantit que la review suit toujours le même processus, avec le même niveau de détail, les mêmes vérifications. Plus besoin de se souvenir de toutes les consignes, elles sont codifiées dans le fichier.

Découvrir les Skills disponibles

Pour voir tous les Skills disponibles dans votre session courante :

# Lister toutes les slash commands disponibles
/help
# Ou commencez à taper / et explorez l'autocomplétion
/

Claude Code affiche les Skills regroupés par source : built-in, projet (/project:...) et personnel (/user:...).

Prochaines étapes

Maintenant que vous comprenez le concept des Skills, passons à la pratique.