Claude Skills : guide complet pour débutants

Publié le 10 avril 2026

Les Claude Skills sont des fichiers Markdown (.md) que tu places dans le dossier .claude/skills/ de ton projet. Claude Code les charge automatiquement comme contexte et adapte son comportement en fonction de leurs instructions. Concrètement, au lieu de répéter les mêmes consignes à chaque conversation ("utilise Tailwind", "commits en anglais", "teste avant de déployer"), tu les écris une fois dans un skill et Claude Code les applique systématiquement. C'est la différence entre un assistant à qui tu réexpliques tout chaque matin et un collaborateur qui connaît déjà tes process. Les skills couvrent tous les cas d'usage : conventions de code, workflow de déploiement, règles SEO, checklist de review, ton rédactionnel. Pas besoin de savoir coder pour en créer. Tu écris tes règles en langage naturel, tu les structures en Markdown, et Claude Code fait le reste. Ce guide t'explique comment créer ton premier skill, quelle structure adopter, et quels cas d'usage concrets vont te faire gagner des heures chaque semaine.

Qu'est-ce que les Claude Skills et pourquoi les utiliser ?

Si tu utilises déjà Claude Code au quotidien, tu as forcément vécu cette situation : tu démarres une nouvelle conversation, et tu dois re-spécifier toutes tes préférences. "Utilise TypeScript." "Indentation 2 espaces." "Commits en anglais avec Conventional Commits." "Ne touche jamais au fichier config.prod.ts." À chaque session, tu perds 5 minutes à reformuler les mêmes consignes.

Les Claude Skills règlent ce problème une fois pour toutes. Un skill, c'est un fichier .md que tu déposes dans .claude/skills/. Claude Code détecte ces fichiers et les injecte dans son contexte. Résultat : il connaît tes règles avant même que tu ne poses ta première question.

La différence avec le fichier CLAUDE.md à la racine du projet ? Le CLAUDE.md est chargé systématiquement, pour tout. Les skills sont chargés de manière ciblée, selon des conditions de déclenchement que tu définis. C'est comme la différence entre un règlement intérieur général et des procédures spécifiques par service.

Les trois avantages concrets des skills

1. Consistance : tes conventions sont appliquées à chaque session, sans oubli. Plus de "ah mince, j'ai oublié de préciser qu'on utilise des guillemets simples".
2. Gain de temps : tu économises 5 à 10 minutes de contexte par conversation. Sur une semaine, c'est une heure de productivité récupérée.
3. Partage d'équipe : les skills sont versionnés avec ton code. Quand un collègue clone ton repo, il récupère automatiquement les mêmes règles.

Comment créer ton premier skill Claude Code ?

Créer un skill prend littéralement deux minutes. Voici la marche à suivre, étape par étape.

Étape 1 : créer le dossier skills

Si ton projet n'a pas encore de dossier .claude/skills/, crée-le :

mkdir -p .claude/skills

C'est tout. Claude Code scanne automatiquement ce répertoire à chaque démarrage de session.

Étape 2 : créer ton fichier skill

Crée un fichier Markdown dans ce dossier. Le nom du fichier doit être descriptif :

# Exemples de noms de fichiers
.claude/skills/conventions-code.md
.claude/skills/deploiement-vercel.md
.claude/skills/seo-checklist.md
.claude/skills/commit-conventions.md

Chaque fichier = un skill = une responsabilité. Ne mélange pas tout dans un seul fichier.

Étape 3 : écrire le contenu du skill

Un skill est un fichier Markdown classique. Tu écris tes instructions en langage naturel. Voici un exemple minimaliste mais fonctionnel :

# Conventions de code TypeScript

## Règles
- Indentation : 2 espaces, jamais de tabulations
- Nommage : camelCase pour les variables, PascalCase pour les composants
- Imports : toujours utiliser des chemins absolus avec @/
- Types : pas de "any", définir des interfaces explicites

## Interdit
- Ne jamais utiliser var, toujours const ou let
- Pas de console.log en production
- Pas de commentaires inutiles ("// increment i")

C'est aussi simple que ça. Pas de syntaxe spéciale, pas de YAML complexe. Du Markdown avec des instructions claires.

Quelle est la structure idéale d'un skill efficace ?

Un skill qui fonctionne bien suit une structure précise. Après avoir créé et testé des dizaines de skills, voici le format qui donne les meilleurs résultats.

L'anatomie d'un skill complet

Chaque skill devrait contenir quatre sections clés :

1. Titre et description : en une ligne, ce que fait ce skill.
2. Conditions de déclenchement : quand Claude Code doit activer ce skill.
3. Règles et conventions : les instructions concrètes à appliquer.
4. Exemples : du code ou des patterns à suivre (et à éviter).

Voici un skill complet et production-ready pour un projet web :

# Skill : déploiement Vercel

Assure la qualité du code avant chaque déploiement sur Vercel.

## Déclenchement
TRIGGER : quand l'utilisateur mentionne "deploy", "déployer",
"mise en production" ou "push to prod".

## Checklist pré-déploiement
1. Vérifier que `npm run build` passe sans erreur
2. Vérifier qu'aucun console.log ne reste en production
3. Vérifier que les variables d'environnement sont documentées
4. Vérifier que les images sont optimisées (WebP, lazy loading)
5. Lancer les tests si ils existent

## Règles
- Ne JAMAIS déployer si le build échoue
- Toujours créer un commit propre avant le deploy
- Vérifier l'URL de preview avant de passer en production

## Exemple de workflow
```bash
npm run build         # Vérifie la compilation
vercel deploy         # Preview d'abord
# Vérifier l'URL de preview
vercel --prod         # Production seulement si preview OK
```

Les erreurs à éviter

Trois erreurs classiques que je vois chez les débutants :

• Skill trop vague : "Écris du bon code" ne sert à rien. Sois spécifique : "Utilise des interfaces TypeScript, pas de types inline."
• Skill trop long : un skill de 500 lignes consomme du contexte inutilement. Vise 50 à 150 lignes maximum.
• Tout dans un seul skill : un skill "conventions-code-seo-deploy-tests-git.md" est ingouvernable. Un fichier = un sujet.

Si tu veux aller plus loin dans la compréhension de la mémoire de Claude Code, les skills s'intègrent parfaitement dans ce système de contexte persistant.

Quels sont les meilleurs cas d'usage des skills ?

Les skills ne se limitent pas aux conventions de code. Voici cinq cas d'usage concrets qui font la différence au quotidien.

1. Conventions de développement web

Le cas d'usage le plus évident. Tu définis tes règles de code une fois, elles s'appliquent partout : nommage, structure de fichiers, patterns autorisés, librairies à privilégier. Si tu travailles avec des plugins Claude Code comme Codex, un skill de conventions garantit que le code généré respecte tes standards dès la première passe.

# Skill : stack technique Next.js

## Librairies obligatoires
- UI : shadcn/ui (JAMAIS de composants custom si shadcn le fait)
- State : Zustand pour le global, useState pour le local
- Fetching : Server Components par défaut, SWR si besoin client
- Validation : Zod pour les schemas, react-hook-form pour les formulaires

## Structure de fichiers
- app/(routes)/     : pages et layouts
- components/ui/    : composants shadcn
- components/       : composants métier
- lib/              : utilitaires, clients API
- types/            : interfaces TypeScript

2. Optimisation SEO

Chaque page que tu crées doit respecter des règles SEO précises. Plutôt que de te rappeler toutes les meta tags, les alt d'images et les schémas JSON-LD à chaque fois, un skill SEO automatise la vérification. C'est exactement ce qu'on fait sur le site de LE LABO IA : chaque page est validée par un skill qui vérifie les balises, le maillage interne et les données structurées.

3. Code review automatisée

Tu peux créer un skill qui définit ta checklist de review. Quand tu demandes à Claude Code de relire ton code, il applique systématiquement tes critères : pas de console.log en prod, pas de secrets en dur, pas de fonctions de plus de 50 lignes. L'architecture interne de Claude Code est conçue pour que ce type de skill soit particulièrement efficace.

4. Création de contenu

Les skills ne sont pas réservés au code. Tu peux définir un skill pour ton ton rédactionnel, tes règles de copywriting, tes templates d'articles. Par exemple : "Tutoiement obligatoire, phrases courtes, pas de jargon inutile, toujours un exemple concret après une explication théorique." C'est exactement le genre de consigne que tu ne veux pas réécrire à chaque article.

5. Workflow Git et déploiement

Un skill peut définir tes conventions Git : format des commits (Conventional Commits), stratégie de branches, checklist avant merge. Combiné avec un skill de déploiement, tu obtiens un pipeline complet où Claude Code sait exactement quoi vérifier à chaque étape.

Comment organiser et maintenir ta bibliothèque de skills ?

Créer des skills, c'est bien. Les garder organisés et à jour, c'est mieux. Voici les bonnes pratiques pour une bibliothèque qui évolue avec ton projet.

Nommer tes skills de manière prédictible

Adopte une convention de nommage stricte dès le départ. Je recommande le format domaine-action.md :

.claude/skills/
  code-conventions.md         # Règles de code générales
  code-review.md              # Checklist de review
  deploy-vercel.md            # Procédure de déploiement
  deploy-pre-check.md         # Vérifications avant deploy
  seo-meta-tags.md            # Règles SEO
  seo-schema-jsonld.md        # Schémas structurés
  git-commits.md              # Format des commits
  content-blog.md             # Ton rédactionnel blog

Le préfixe par domaine te permet de retrouver n'importe quel skill en une seconde. Et quand tu as 20 skills, crois-moi, c'est indispensable.

Versionner avec Git

Les skills vivent dans ton repo. Ils évoluent avec ton projet. Traite-les comme du code :

• Commite chaque nouveau skill ou modification avec un message explicite.
• Fais une review avant de merger un skill en production.
• Documente les changements importants dans ton CLAUDE.md.

Le gros avantage : quand tu reviens sur un projet six mois plus tard, tes skills sont là. Tout le contexte est préservé. Tu n'as pas à te souvenir de tes préférences.

Tester et itérer

Un skill n'est pas figé dans le marbre. Après l'avoir créé, teste-le sur plusieurs conversations. Est-ce que Claude Code applique bien tes règles ? Est-ce qu'il y a des cas limites où le skill ne s'active pas ? Affine au fur et à mesure. Les meilleurs skills sont ceux qui ont été itérés 3 ou 4 fois.

Pour approfondir la sécurité dans Claude Code, tu peux dédier un skill entièrement aux vérifications de sécurité : pas de secrets dans le code, validation des inputs, headers HTTP obligatoires.

Partager avec la communauté

La documentation officielle d'Anthropic sur Claude Code encourage le partage de skills. Tu peux créer un dépôt GitHub public avec tes skills génériques (conventions TypeScript, checklist SEO, workflow Git). La communauté grandissante autour de Claude Code signifie qu'il y a de plus en plus de skills partagés et affinés collectivement.

Meydeey — Architecte IA & Automatisation

+110 entrepreneurs formés au Vibe Coding et à l'automatisation IA. +28 000 abonnés YouTube.

YouTube LinkedIn Communauté