Skills Claude Code : créer, installer et utiliser un skill

Les skills permettent d'enseigner à Claude Code des compétences durables et réutilisables. Plutôt que de réexpliquer une procédure à chaque session, vous la capturez une fois dans un fichier, et Claude Code la mobilise quand elle sert.

Qu'est-ce qu'un skill

Un skill est un paquet de savoir-faire : des instructions, parfois accompagnées d'exemples, de fichiers de référence ou de scripts, qui décrivent comment accomplir un type de tâche. Il répond à la question « comment faisons-nous, ici, telle chose ? ».

Exemples typiques : générer un composant selon les conventions maison, rédiger un message de commit conforme à votre charte, mener une revue de sécurité selon votre checklist, produire une documentation dans votre format habituel.

Skill, commande, CLAUDE.md : qui fait quoi

Le fichier CLAUDE.md fournit le contexte permanent du projet, chargé à chaque session.

Les commandes personnalisées, vues dans la leçon sur les commandes, ont été fusionnées dans les skills. Un fichier .claude/commands/deploy.md et un skill .claude/skills/deploy/SKILL.md créent tous deux la commande /deploy. Les anciens fichiers de commandes continuent de fonctionner, mais pour tout nouveau besoin, un skill fait mieux : il accepte des fichiers d'appui, se pilote par son frontmatter et peut être déclenché automatiquement.

Un skill peut donc être appelé de deux façons : par vous (/nom-du-skill) ou par Claude, quand sa description correspond à ce que vous demandez.

Où installer un skill

L'emplacement du dossier détermine la portée du skill :

« Installer » un skill revient donc à copier son dossier au bon endroit. Rien d'autre à exécuter : Claude Code le découvre au démarrage de la session.

Anatomie d'un skill

Un skill est un dossier dont seul le fichier SKILL.md est obligatoire :

.claude/
  skills/
    revue-securite/
      SKILL.md          # frontmatter + instructions (obligatoire)
      checklist.md      # ressource de référence (facultative)
      scripts/
        audit.sh        # script d'appui (facultatif)

Le fichier commence par un frontmatter YAML, suivi des instructions :

---
name: revue-securite
description: Revue de sécurité du diff en cours. À utiliser avant une fusion ou quand l'utilisateur demande un audit.
allowed-tools: Bash(git diff *) Bash(git log *)
---
 
1. Récupère le diff avec git diff.
2. Vérifie injections, secrets, contrôles d'accès (voir checklist.md).
3. Rends un rapport classé par gravité, sans modifier le code.

Les champs les plus utiles :

• description (recommandé) : c'est sur elle que Claude s'appuie pour décider quand utiliser le skill. Une description vague rend le skill invisible ; une description qui nomme la situation déclenchante le rend utile au bon moment.
• name : le nom affiché dans le menu / (par défaut, celui du dossier).
• disable-model-invocation: true : seul un appel explicite le lance — indispensable pour une action à effet de bord, comme un déploiement.
• user-invocable: false : masqué du menu, réservé à Claude.
• allowed-tools : outils pré-autorisés pendant l'exécution du skill, sans confirmation à chaque usage.
• context: fork : exécute le skill dans un contexte isolé, comme un sous-agent.

Référencez les fichiers d'appui depuis SKILL.md (« pour la liste complète, voir checklist.md ») : Claude ne les charge que lorsqu'il en a besoin, ce qui préserve la fenêtre de contexte.

Écrire un bon skill

Cibler une compétence à la fois

Un skill « tout faire » est difficile à déclencher correctement. Préférez des skills étroits : un pour les tests, un pour la documentation, un pour les migrations de base de données.

Soigner la description

Écrivez-la comme une règle de déclenchement : ce que fait le skill, puis « à utiliser quand… ». C'est la ligne qui compte le plus, car c'est la seule que Claude lit en permanence.

Être explicite et orienté action

Comme pour un bon CLAUDE.md, restez factuel. Décrivez les étapes, les pièges à éviter, les conventions à respecter. Montrez le résultat attendu plutôt que de l'expliquer longuement.

Deux skills prêts à l'emploi

Pour démarrer sur du concret, nos ressources proposent deux skills commentés, à copier dans .claude/skills/ :

• une revue de sécurité du diff, exécutée en contexte isolé avec des outils Git en lecture seule ;
• un coach de révision CCA-F, qui interroge sur les domaines de l'examen.

Pour aller plus loin, notre annuaire des skills officiels d'Anthropic décrit en français chacun des skills publiés dans le dépôt anthropics/skills, avec la commande pour les installer en plugin.

Skills et sous-agents

Les skills se combinent naturellement avec les sous-agents. Un sous-agent spécialisé peut s'appuyer sur un skill pour mener sa mission selon vos standards : l'un découpe le travail, l'autre apporte le savoir-faire.

Maintenir ses skills

Un skill, comme une documentation, vieillit. Si vos conventions changent, vos skills doivent suivre. Relisez-les périodiquement, supprimez ceux devenus obsolètes et corrigez les instructions dépassées. Un skill erroné fait plus de dégâts qu'une absence de skill.

En résumé

Un skill, c'est un dossier et un SKILL.md : une description qui dit quand l'utiliser, des instructions qui disent comment. Placé dans ~/.claude/skills/ ou .claude/skills/, il se déclenche seul ou par /nom, et remplace avantageusement les anciennes commandes personnalisées.

La prochaine leçon traite de l'intégration GitHub. Côté claude.ai, les skills existent aussi : voir la leçon sur les skills personnalisés. Découvrez enfin les cours et la certification Certified Architect.