Créez des Skills et Commandes Personnalisées pour Claude Code
Les Skills transforment des prompts répétitifs en commandes réutilisables. Écrivez un SKILL.md une fois, invoquez-le avec /nom-de-skill, et Claude Code exécute le workflow complet à chaque fois.
Les Skills sont des fichiers markdown qui définissent des workflows réutilisables pour Claude Code. Au lieu de taper le même prompt complexe chaque fois que vous voulez déployer, faire une revue de code ou générer de la documentation, vous écrivez un SKILL.md une fois et l'invoquez avec une commande slash.
Qu'est-ce qu'un Skill Claude Code ?
Un Skill est un fichier markdown (SKILL.md) qui contient des instructions que Claude Code suit quand vous l'invoquez. Il peut inclure une description, des restrictions d'outils, des paramètres de contexte et des instructions étape par étape. Voyez-le comme un prompt sauvegardé avec des super-pouvoirs.
Comment créer un Skill ?
Créez un fichier SKILL.md dans le répertoire .claude/skills/ de votre projet (partagé avec l'équipe) ou dans ~/.claude/skills/ (personnel) :
# .claude/skills/deploy.md
---
name: deploy
description: Déployer la branche actuelle en staging
allowed-tools: Bash, Read
---
## Étapes
1. Lancer la suite de tests : `npm run test`
2. Si les tests passent, builder le projet : `npm run build`
3. Déployer en staging : `npm run deploy:staging`
4. Vérifier le déploiement en consultant le endpoint de santé
5. Poster un résumé de ce qui a été déployéMaintenant vous pouvez l'invoquer :
# Dans Claude Code
> /deployQuelles options de frontmatter sont disponibles ?
| Option | Ce qu'elle fait | Exemple |
|---|---|---|
| name | Nom de la commande slash | deploy |
| description | S'affiche dans la liste des skills | Déployer en staging |
| allowed-tools | Restreindre les outils utilisables par le skill | Bash, Read, Edit |
| disable-model-invocation | Empêcher les appels IA imbriqués | true |
| context | Gestion de session | fork (s'exécute dans un contexte isolé) |
Quels sont les bons cas d'utilisation pour les Skills ?
- +Workflows de déploiement (test -> build -> deploy -> vérification)
- +Checklists de revue de code (sécurité, performance, style)
- +Génération de documentation (docs API, changelogs, READMEs)
- +Opérations de base de données (migration, seeding, sauvegarde)
- +Onboarding de nouveaux membres d'équipe (visite du projet, vérification de setup)
- +Gestion des releases (version bump, changelog, tag, publication)
Comment utiliser des variables dans les Skills ?
Les Skills supportent les arguments via $ARGUMENTS (texte complet) et les variables positionnelles ($0, $1, etc.) :
# .claude/skills/create-component.md
---
name: create-component
description: Créer un nouveau composant React
---
Crée un nouveau composant React nommé $0 dans le répertoire components.
Exigences :
- TypeScript avec interface de props correcte
- Tailwind CSS pour le style
- Export par défaut
- Inclure un test unitaire basique dans __tests__/
Utilisation : /create-component UserProfileInvocation avec des arguments
# Un seul argument
> /create-component UserProfile
# Plusieurs arguments
> /create-component UserProfile --with-tests --with-storyComment partager les Skills avec votre équipe ?
Placez les Skills dans le répertoire .claude/skills/ de votre projet et commitez-les dans git. Chaque développeur qui clone le dépôt obtient les mêmes skills. Les skills personnels vont dans ~/.claude/skills/ et ne sont pas partagés.
Les Skills se composent bien avec les Hooks. Par exemple, un skill "deploy" peut déclencher un hook PostToolUse qui envoie une notification Slack après le déploiement. Construisez votre automatisation par couches.