Construis ton premier Skill
Planifier, écrire, organiser le fichier SKILL.md
⏱ Estim. ~7 min
01 · Lire
Avant d'écrire une seule ligne, tu dois identifier un workflow répétable.
Pense à ce que tu répètes tout le temps à Claude Code : « Utilise des composants fonctionnels. » « Écris les tests d'abord. » « Utilise des conventional commits. » « N'ajoute pas de commentaire sur du code évident. »
Chacun de ces trucs est un candidat pour un skill. Les meilleurs skills capturent un workflow que tu suis à chaque fois — pas une demande ponctuelle.
Demande-toi : « Quelle instruction est-ce que je tape à Claude Code au moins une fois par semaine ? » Voilà ton premier skill.
Points clés
- Un bon skill capture un workflow répétable, pas une tâche ponctuelle
- Pense aux instructions que tu tapes à chaque session Claude Code
- Commence par un workflow concret, pas tout en même temps
- Un skill doit avoir un parti pris — des règles claires, pas de vagues suggestions
02 · Exemple de code
Chaque SKILL.md commence par un frontmatter YAML entre des ---. Voici les trois champs principaux.
Frontmatter YAML
---
name: Code Reviewer
description: Reviews code for bugs, style, and best practices
instructions: Use this skill when reviewing pull requests or code changes
---
name est le nom affiché du skill dans la liste /skill. description dit à Claude (et à toi) ce que fait ce skill. instructions donne à Claude un indice sur quand activer ce skill. Les trois sont optionnels, mais tous les trois sont vivement recommandés.
03 · Quiz
Tu viens de voir les trois champs standards du frontmatter YAML. Lequel n'en fait pas partie ?
- name
- description
- language
- instructions
04 · Étape par étape
On va construire un vrai skill étape par étape. On va faire un skill « Code Reviewer », qui applique les standards de revue de ton équipe.
1. Crée le dossier du skill
Crée la structure de répertoires dans ton projet. Lance : mkdir -p .claude/skills/code-reviewer. Le flag -p crée les répertoires parents s'ils n'existent pas. Ça place le skill dans ton projet, et il peut être commité avec git.
2. Écris le frontmatter YAML
Ouvre .claude/skills/code-reviewer/SKILL.md et ajoute le bloc de métadonnées. Commence par une ligne ---, ajoute les champs name, description, instructions, puis termine par une autre ligne ---.
3. Ajoute le corps des instructions
Sous le --- de fin, écris tes règles de revue en langage naturel. Utilise des titres markdown pour structurer les sections, des listes à puces pour les règles concrètes. Sois précis — « Vérifie les injections SQL dans les entrées utilisateur » vaut beaucoup mieux que « Relis le code ».
4. Teste avec /skill
Tape /skill dans une conversation Claude Code et vérifie que ton nouveau skill apparaît dans la liste. Sélectionne-le pour l'activer. Demande à Claude de relire du code — il devrait suivre tes règles. Sinon, affine et réessaie.
05 · Exemple de code
Voici le skill « Code Reviewer » terminé — un SKILL.md complet, prêt pour la prod.
code-reviewer/SKILL.md
---
name: Code Reviewer
description: Reviews code changes for bugs, security, and style
instructions: Use when asked to review code, PRs, or diffs
---
## Review Checklist
When reviewing code, check for:
- **Security**: SQL injection, XSS, command injection, hardcoded secrets
- **Error handling**: Are errors caught? Are they logged? Do they fail gracefully?
- **Edge cases**: What happens with empty input? Null values? Very large data?
- **Naming**: Are variables and functions named clearly?
- **Tests**: Are there tests for the new code? Do existing tests still pass?
## Output Format
Structure your review as:
1. **Summary** — one sentence overview
2. **Issues** — bullet list, severity (high/medium/low)
3. **Suggestions** — optional improvements (not blockers)
Le corps utilise du markdown standard — titres, gras, listes à puces. Claude le traite comme des instructions à suivre. La checklist de revue dit à Claude quoi regarder, et le format de sortie garantit que chaque revue est cohérente et structurée.
06 · Compléter
Le frontmatter YAML d'un fichier SKILL.md est encadré par deux lignes _____
07 · Glisser pour trier
Un fichier SKILL.md a une structure précise. Pense à ce que Claude lit en premier quand il charge le skill, et range ces parties de haut en bas.
(Cette section est interactive — active JavaScript pour l'utiliser.)
Autres leçons de ce chapitre
⚠ L'expérience interactive complète nécessite JavaScript. Active-le et recharge la page.
※ Ce site est un projet éducatif indépendant — pas un produit officiel d'Anthropic. Claude™ est une marque déposée d'Anthropic, PBC.