Créer ses propres skills Claude Code : structure, bonnes pratiques et exemples Laravel
22 Nov 2026 | Intelligence Artificielle et Automatisation | Informatique et Technologie
Un agent de code est d'autant plus utile qu'il connaît vos conventions et procédures. Les skills de Claude Code servent exactement à cela : un dossier contenant des instructions (et éventuellement des scripts) que l'agent charge quand la tâche s'y prête. Après avoir publié un dépôt open source de 12 skills pour Laravel et WordPress, voici la méthode pour créer les vôtres.
Skill, CLAUDE.md ou commande : quelle différence ?
- CLAUDE.md : le contexte permanent du projet (stack, conventions, commandes). Toujours chargé.
- Skill : une procédure spécialisée, chargée uniquement quand elle est pertinente (« auditer la sécurité », « migrer une table »). Elle n'encombre pas le contexte le reste du temps.
- Commande slash : un raccourci que vous déclenchez vous-même.
Pour le CLAUDE.md, voir notre article Claude Code pour un développeur Laravel.
La structure d'un skill
.claude/skills/
└── laravel-security-audit/
├── SKILL.md
├── checklist.md
└── scripts/
└── find-raw-queries.sh
Le fichier SKILL.md commence par un en-tête YAML :
---
name: laravel-security-audit
description: Audite la sécurité d'une application Laravel (autorisations, validation, requêtes brutes, configuration de production). À utiliser quand l'utilisateur demande un audit de sécurité ou une revue avant mise en production.
---
# Audit de sécurité Laravel
1. Lire `checklist.md`.
2. Lancer `scripts/find-raw-queries.sh` et analyser chaque résultat.
3. Vérifier les policies de chaque contrôleur de ressource.
4. Produire un rapport : critique / important / mineur, avec fichier et ligne.
Placé dans .claude/skills/ du projet, le skill est partagé avec l'équipe via Git. Dans ~/.claude/skills/, il vous suit sur tous vos projets.

La description, c'est ce qui déclenche le skill
L'agent décide de charger un skill en lisant sa description. Elle doit dire clairement ce que fait le skill et quand l'utiliser, avec les mots que vous emploieriez naturellement. « Outils Laravel » est trop vague ; « Crée une migration Laravel sûre (index, clés étrangères, rollback) quand l'utilisateur demande de modifier le schéma de la base » fonctionne.
Les bonnes pratiques
- Une tâche par skill : un skill « audit sécurité », un autre « déploiement », plutôt qu'un fourre-tout.
- Des étapes numérotées et vérifiables, avec le résultat attendu.
- Le détail dans des fichiers annexes : le SKILL.md reste court, les listes longues et les modèles vont dans des fichiers que l'agent lit au besoin.
- Des scripts pour le déterministe : une recherche de motifs ou une vérification de configuration est plus fiable en script qu'en instruction.
- Des garde-fous explicites : « ne jamais exécuter
migrate:fresh», « demander confirmation avant tout déploiement ». - Les commandes du projet :
php artisan test --compact,vendor/bin/pint, etc., pour que l'agent vérifie son travail.
Exemples de skills utiles pour Laravel
- Création de migration : conventions de nommage, index, clés étrangères, test du rollback.
- Nouvel endpoint d'API : Form Request, API Resource, policy, test Pest, documentation.
- Revue avant mise en production :
APP_DEBUG, files d'attente, cache de configuration, migrations en attente. - Audit de performance : recherche des requêtes N+1, index manquants, cache.
Tester un skill
- Formulez trois ou quatre demandes réalistes qui doivent déclencher le skill, et une qui ne doit pas.
- Vérifiez que l'agent le charge au bon moment et suit les étapes.
- Corrigez la description si le déclenchement est mauvais, les étapes si le résultat l'est.
- Recommencez après chaque modification importante.
Conclusion
Un bon skill transforme une procédure que vous expliquez à chaque fois en un savoir-faire que l'agent applique seul, de façon constante. Commencez par la tâche que vous répétez le plus, écrivez-la en dix lignes, testez-la, puis enrichissez. Et si vous voulez partir d'exemples concrets, le dépôt laravel-wordpress-claude-skills est ouvert aux contributions.
Commentaires (0)
Aucun commentaire pour le moment.
Laissez un commentaire