Un Skill (compétence) correspond à un savoir-faire spécialisé que Claude Code charge à la demande. Plutôt que de conserver en permanence l'ensemble des méthodes en contexte, l'agent s'appuie sur une bibliothèque de compétences qu'il active uniquement lorsqu'elles sont pertinentes, ou lorsque vous les invoquez explicitement avec /nom.

L'idée directrice est simple : conserver un agent léger et focalisé, tout en lui donnant accès à une expertise ciblée (revue de code, recherche, déploiement…) exactement au moment opportun.

Deux façons de déclencher un skill

  1. Vous l'invoquez en tapant /nom-du-skill (ex. /code-review).
  2. L'agent le déclenche lui-même quand votre demande correspond à la description du skill.

La description d'un skill détermine sa pertinence : elle doit indiquer clairement quand l'utiliser.

Anatomie d'un skill

Un skill est un simple dossier contenant un fichier SKILL.md :

.claude/skills/
  mon-skill/
    SKILL.md        ← instructions + métadonnées
    (scripts, modèles, ressources…)

Le SKILL.md débute par un en-tête (frontmatter) :

---
name: deploy-prod
description: Déploie l'application en production. À utiliser quand
  l'utilisateur demande un déploiement, une mise en ligne ou un push prod.
---

# Déploiement production

1. Lancer les tests
2. Construire les assets
3. Synchroniser vers le serveur
4. Vérifier la sonde de santé

Lorsque le skill se déclenche, l'intégralité du contenu du SKILL.md est injectée dans le contexte de l'agent : celui-ci applique alors ces instructions comme une procédure opérationnelle.

Skills intégrés vs skills maison

Type Emplacement Exemples
Intégrés livrés avec Claude Code /code-review, /security-review, /loop, /schedule
Projet .claude/skills/ (versionné) vos procédures d'équipe
Utilisateur ~/.claude/skills/ vos compétences personnelles
Plugins marketplace de plugins skills partagés par la communauté

Quelques skills intégrés utiles

  • /code-review — relit le diff courant à la recherche de bugs et de simplifications.
  • /security-review — passe en revue les changements sous l'angle sécurité.
  • /loop — relance une tâche à intervalle régulier (ou en auto-rythme).
  • /schedule — planifie des agents récurrents (cron).
  • /deep-research — recherche web multi-sources, vérifiée et citée.

Bonnes pratiques pour écrire un skill

  • Une description actionnable : dites quand l'utiliser, pas seulement ce que c'est. C'est ce qui déclenche le bon skill au bon moment.
  • Des instructions, pas un roman : le contenu est une procédure, pas un cours.
  • Des ressources à côté : scripts, gabarits, exemples — référencés depuis le SKILL.md.
  • Idempotence : un skill bien fait peut être rejoué sans casse.

Un skill joue pour l'agent le rôle d'une fiche de procédure pour un professionnel : la méthode n'est pas réinventée à chaque demande, elle est mobilisée au moment adéquat.