---
title: Les Skills de Claude Code
source: https://synapx.fr/blog/claude-code-skills/
date: 2026-06-26
category: Claude Code
site: SynapxLab
---

# Les Skills de Claude Code

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) :

```markdown
---
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.