Comment créer votre propre skill Claude Code

Vous utilisez Claude Code quotidiennement et vous avez développé des patterns récurrents ? Il est temps de les transformer en skill réutilisable. Ce guide vous montre comment créer un skill efficace de A à Z.

Pourquoi créer un skill ?

• Consistance : Les mêmes instructions à chaque session
• Partage : Votre équipe bénéficie de vos bonnes pratiques
• Qualité : Claude suit un framework éprouvé au lieu d'improviser

Étape 1 : Identifier le besoin

Posez-vous ces questions :

1. Quelle tâche je répète souvent ? (revue de code, écriture de tests, génération de docs)
2. Quelles instructions je donne toujours à Claude ? (conventions de nommage, patterns architecturaux)
3. Où Claude fait-il des erreurs récurrentes ? (c'est là que les instructions sont les plus utiles)

Étape 2 : Structurer le skill

Le template minimal

---
name: nom-du-skill
description: Description courte et actionnable
platforms: [claude-code]
difficulty: intermediate
tags: [tag1, tag2]
---

# Nom du Skill

## Quand utiliser ce skill

Décrivez les situations de déclenchement.

## Instructions

### Règle 1 : [Nom de la règle]

Explication claire et concise.

**Bon exemple :**
\`\`\`
code correct
\`\`\`

**Mauvais exemple :**
\`\`\`
code incorrect
\`\`\`

### Règle 2 : [Nom de la règle]

...

## Checklist

- [ ] Point de vérification 1
- [ ] Point de vérification 2

Étape 3 : Écrire des instructions efficaces

Principe 1 : Soyez prescriptif, pas descriptif

❌ "Le code devrait être bien testé" ✅ "Écris un test unitaire pour chaque fonction publique. Utilise le pattern AAA (Arrange, Act, Assert). Chaque test a un seul expect."

Principe 2 : Utilisez des exemples concrets

Les exemples valent mille mots. Montrez le résultat attendu.

Principe 3 : Définissez les anti-patterns

Claude apprend autant de ce qu'il ne faut pas faire que de ce qu'il faut faire :

## Ce qu'il ne faut PAS faire

- Ne jamais utiliser `any` en TypeScript
- Ne pas créer de fichiers de plus de 300 lignes
- Ne pas ajouter de commentaires évidents

Principe 4 : Structurez en étapes

## Workflow

1. Lire le code existant dans le fichier ciblé
2. Identifier les patterns utilisés
3. Écrire le test en premier (TDD)
4. Implémenter la fonctionnalité
5. Vérifier que tous les tests passent
6. Committer avec un message conventionnel

Étape 4 : Tester le skill

1. Placez le fichier dans .claude/skills/
2. Lancez Claude Code et testez avec des cas réels
3. Notez où Claude dévie de vos attentes
4. Ajustez les instructions
5. Répétez jusqu'à satisfaction

Métriques de qualité

• Précision : Claude fait-il exactement ce que vous voulez ?
• Consistance : Le résultat est-il le même à chaque fois ?
• Autonomie : Claude a-t-il besoin de questions de clarification ?

Étape 5 : Publier et partager

Sur GitHub

1. Créez un repo avec votre SKILL.md à la racine
2. Ajoutez un README explicatif
3. Tagguez avec les topics claude-code, skill, claude-code-skill

Sur Skills Guides

Soumettez votre skill via notre formulaire de contribution pour qu'il soit référencé dans le catalogue.

Exemples de skills bien conçus

• Playwright Skill : Instructions très détaillées avec des patterns pour chaque type de test
• Loki Mode : Workflow multi-étapes complexe bien structuré
• VibeSec : Checklists de sécurité exhaustives avec références OWASP

Conclusion

Un bon skill est un investissement : quelques heures de rédaction pour des centaines d'heures gagnées. Commencez simple, itérez souvent, et partagez avec la communauté.