Claude Code Skills : Créer Vos Propres Commandes Slash Personnalisées (Guide 2026)

Les Skills Claude Code : transformez votre agent en outil sur-mesure

Les Skills sont l'une des nouveautés les plus impactantes de Claude Code en 2026. En quelques lignes de Markdown, vous pouvez créer des commandes slash personnalisées qui transforment Claude Code en un outil parfaitement adapté à votre workflow.

Tapez /deploy et Claude suit votre procédure de déploiement. Tapez /review et il applique votre checklist de code review. Tapez /adr et il génère une Architecture Decision Record selon votre template.

Sommaire

Qu'est-ce qu'un skill ?

Les Claude Code Skills transforment votre agent en outil personnalisé. Pour les actions déterministes, consultez aussi les [Hooks Claude Code](/blog/claude-code-hooks-automatiser-workflow). Si vous débutez, commencez par le [guide complet](/blog/claude-code-guide-complet).

Un skill est un fichier Markdown placé dans le dossier .claude/skills/ de votre projet (ou ~/.claude/skills/ pour un usage global). Quand vous tapez une commande slash correspondante, Claude Code lit le fichier et suit les instructions qu'il contient.

Skills vs Prompts classiques

Comment Claude Code découvre les skills

Claude Code cherche les skills dans cet ordre de priorité :

Créer votre premier skill

Étape 1 : Créer le dossier

mkdir -p .claude/skills

Étape 2 : Créer le fichier Markdown

touch .claude/skills/commit.md

Étape 3 : Écrire les instructions

---
name: commit
description: Commit avec message conventionnel
---

Analyse les changements en cours (git diff --staged) et crée un commit
avec un message suivant la convention Conventional Commits :

Format : <type>(<scope>): <description>

Types autorisés :
- feat: nouvelle fonctionnalité
- fix: correction de bug
- docs: documentation
- style: formatage
- refactor: restructuration du code
- test: ajout de tests
- chore: maintenance

Règles :
- Le message doit être en français
- La description ne dépasse pas 72 caractères
- Ajoute un body si les changements sont complexes
- Ne push pas automatiquement

Étape 4 : Utiliser le skill

Dans Claude Code, tapez simplement :

/commit

Claude analysera vos changements et créera un commit parfaitement formaté.

Anatomie d'un skill avancé

Un skill bien conçu utilise le frontmatter YAML pour se décrire et le corps Markdown pour les instructions :

---
name: review
description: Code review complète selon nos standards
---

# Instructions de code review

Tu es un reviewer senior. Analyse le code selon cette checklist :

## Sécurité
- [ ] Pas d'injection SQL ou XSS
- [ ] Les inputs utilisateur sont validés
- [ ] Pas de secrets en dur dans le code
- [ ] Les dépendances sont à jour

## Performance
- [ ] Pas de requête N+1
- [ ] Les données volumineuses sont paginées
- [ ] Les calculs lourds sont mis en cache

## Maintenabilité
- [ ] Les fonctions font moins de 50 lignes
- [ ] Les noms de variables sont explicites
- [ ] Le code est DRY (Don't Repeat Yourself)

## Tests
- [ ] Les cas limites sont testés
- [ ] La couverture est suffisante
- [ ] Les tests sont indépendants

Pour chaque problème trouvé, indique :
1. Le fichier et la ligne
2. La sévérité (critique, majeur, mineur)
3. La correction recommandée

Frontmatter expliqué

10 skills indispensables

1. /deploy — Procédure de déploiement

---
name: deploy
description: Déployer l'application en production
---

Suis cette procédure de déploiement étape par étape :

1. Vérifie que tous les tests passent : npm test
2. Vérifie que le build est propre : npm run build
3. Vérifie qu'il n'y a pas de changements non commités
4. Crée un tag de version (semver)
5. Push le tag
6. Lance le déploiement : npm run deploy
7. Vérifie que le déploiement est réussi
8. Notifie l'équipe du déploiement

IMPORTANT : demande confirmation avant chaque étape critique.

2. /test — Génération de tests

---
name: test
description: Générer des tests pour un fichier ou composant
---

Génère des tests unitaires pour le fichier ou composant spécifié :

- Framework : Vitest (ou Jest si le projet utilise Jest)
- Style : describe/it avec des descriptions en français
- Couverture : cas nominal, cas limites, cas d'erreur
- Mocks : mock les dépendances externes uniquement
- Place les tests dans un fichier adjacent : fichier.test.ts

3. /refactor — Refactoring guidé

---
name: refactor
description: Refactoring sûr avec tests de non-régression
---

Effectue un refactoring du code spécifié en suivant ces étapes :

1. Analyse le code existant et identifie les problèmes
2. Vérifie que les tests existants passent
3. Propose un plan de refactoring
4. Implémente les changements de manière incrémentale
5. Vérifie après chaque changement que les tests passent toujours
6. Si aucun test n'existe, crée-les d'abord

Principes : SOLID, DRY, KISS. Ne change pas le comportement externe.

4. /adr — Architecture Decision Record

---
name: adr
description: Créer une Architecture Decision Record
---

Crée un fichier ADR dans docs/adr/ avec le format suivant :

# ADR-{numéro} : {titre}

## Statut
Proposé | Accepté | Déprécié | Remplacé

## Contexte
Quel est le problème ou la situation qui motive cette décision ?

## Décision
Quelle est la décision prise ?

## Conséquences
Quelles sont les conséquences positives et négatives ?

## Alternatives considérées
Quelles alternatives ont été évaluées et pourquoi rejetées ?

Numérote automatiquement en regardant les ADR existants.

5. /migrate — Migration de base de données

---
name: migrate
description: Créer une migration de base de données
---

Crée une migration de base de données en suivant ces règles :

- Utilise Prisma si le projet a un schema.prisma
- Nomme la migration avec un timestamp et une description
- Inclus toujours un rollback (down migration)
- Vérifie la compatibilité avec les données existantes
- Teste la migration sur une base vide et une base avec données

6. /api — Endpoint REST

---
name: api
description: Créer un endpoint API REST complet
---

Crée un endpoint API REST avec :

1. Route handler (Next.js App Router)
2. Validation des inputs (Zod)
3. Gestion d'erreurs structurée
4. Types TypeScript
5. Tests d'intégration
6. Documentation OpenAPI (commentaire)

Conventions : kebab-case pour les URLs, camelCase pour le JSON.

7. /doc — Documentation technique

---
name: doc
description: Générer la documentation technique
---

Génère la documentation technique pour le code spécifié :

- JSDoc/TSDoc pour les fonctions publiques
- README.md pour les modules
- Exemples d'utilisation
- Diagrammes Mermaid si pertinent

Style : concis, orienté développeur, en français.

8. /perf — Audit de performance

---
name: perf
description: Audit de performance du code
---

Analyse les performances du code spécifié :

1. Identifie les goulots d'étranglement potentiels
2. Vérifie la complexité algorithmique (Big O)
3. Détecte les re-renders inutiles (React)
4. Analyse les requêtes base de données (N+1, index manquants)
5. Propose des optimisations concrètes avec benchmarks

Priorité : impact utilisateur > micro-optimisation.

9. /security — Audit de sécurité

---
name: security
description: Audit de sécurité du code
---

Effectue un audit de sécurité OWASP Top 10 :

1. Injection (SQL, NoSQL, OS, LDAP)
2. Authentification cassée
3. Exposition de données sensibles
4. XXE (XML External Entities)
5. Contrôle d'accès défaillant
6. Mauvaise configuration de sécurité
7. XSS (Cross-Site Scripting)
8. Désérialisation non sécurisée
9. Composants vulnérables connus
10. Logging et monitoring insuffisants

Pour chaque vulnérabilité : sévérité, localisation, correction.

10. /changelog — Notes de version

---
name: changelog
description: Générer les notes de version depuis les commits
---

Analyse les commits depuis le dernier tag et génère un CHANGELOG :

Format :
## [version] - date

### Ajouté
- Nouvelles fonctionnalités (feat)

### Corrigé
- Corrections de bugs (fix)

### Modifié
- Changements (refactor, style)

### Supprimé
- Fonctionnalités retirées

Déduis la version (semver) depuis les types de commits.

Skills d'équipe : partager les bonnes pratiques

Versionner les skills avec le projet

Le dossier .claude/skills/ fait partie du repository Git. Chaque membre de l'équipe accède aux mêmes commandes :

.claude/
├── skills/
│   ├── commit.md
│   ├── review.md
│   ├── deploy.md
│   ├── test.md
│   └── api.md
├── settings.json
└── CLAUDE.md

Onboarding accéléré

Un nouveau développeur rejoint l'équipe ? Il a immédiatement accès à toutes les procédures codifiées en skills. Plus besoin de chercher dans le wiki ou de demander à un collègue.

Standardisation sans friction

Les skills codifient les bonnes pratiques de l'équipe sans ajouter de friction. Au lieu d'un document de 50 pages que personne ne lit, chaque pratique est accessible en une commande slash.

L'écosystème des skills communautaires

En 2026, un écosystème vibrant de skills open-source s'est développé autour de Claude Code :

Awesome Claude Code

Le repository awesome-claude-code recense des centaines de skills, hooks et configurations partagés par la communauté.

ClaudeFast Code Kit

Le ClaudeFast Code Kit propose 18 agents spécialisés avec des configurations MCP et des skills prêts à l'emploi, couvrant des cas d'usage comme le SEO, la génération de composants UI, et l'analyse de code.

Installer un skill communautaire

# Copier un skill depuis un repo
curl -o .claude/skills/skill-name.md \
  https://raw.githubusercontent.com/user/repo/main/skills/skill-name.md

Skills vs Hooks vs CLAUDE.md

Ces trois mécanismes sont complémentaires :

La règle d'or

Pour maîtriser les hooks en détail, consultez notre [guide complet des hooks Claude Code](/blog/claude-code-hooks-automatiser-workflow).

Bonnes pratiques

1. Un skill = une responsabilité

Chaque skill doit faire une seule chose bien. Évitez les skills monolithiques qui essaient de tout faire.

2. Soyez explicite dans les instructions

Claude Code suit vos instructions à la lettre. Plus vos skills sont précis, meilleurs seront les résultats :

3. Incluez des exemples

Les exemples dans vos skills améliorent drastiquement la qualité des résultats de Claude :

Exemple de bon commit :
feat(auth): ajouter l'authentification OAuth2 Google

Exemple de mauvais commit :
fix stuff

4. Testez et itérez

Créez un skill, utilisez-le plusieurs fois, affinez les instructions. Les meilleurs skills sont le fruit de l'itération.

5. Documentez les skills complexes

Pour les skills complexes (comme /deploy), ajoutez un commentaire en haut du fichier expliquant le contexte et les prérequis.

Conclusion

Les Skills Claude Code sont le pont entre un assistant IA générique et un outil de développement personnalisé. En investissant quelques minutes dans la création de skills, vous :

Combinés avec les [hooks pour l'automatisation](/blog/claude-code-hooks-automatiser-workflow) et les [Agent Teams pour le travail parallèle](/blog/claude-code-agent-teams), les skills complètent le triptyque qui fait de Claude Code l'outil de développement le plus puissant de 2026.

Pour apprendre à créer des skills avancés et les intégrer dans votre workflow professionnel, notre [formation complète](https://go.saas-ia.io/se-faire-remplacer-par-lia) vous guide pas à pas avec des projets pratiques.

---

*Sources : Anthropic Claude Code Documentation, Claude Code Skills Guide, Awesome Claude Code, mars 2026.*