Le pouvoir de la composition de skills
Un skill seul est utile. Plusieurs skills combinés intelligemment sont exponentiellement plus puissants. Mais attention : une mauvaise combinaison peut créer des conflits, des contradictions et de la confusion.
Les principes de composition
1. Le principe de responsabilité unique
Chaque skill doit avoir une seule responsabilité clairement définie :
typescript-strict.md: Règles TypeScripttesting-strategy.md: Stratégie de testsapi-conventions.md: Conventions APIsecurity-rules.md: Règles de sécurité
Mauvaise pratique : Un méga-skill de 500 lignes qui couvre tout.
2. Le principe de non-contradiction
Vérifiez que vos skills ne se contredisent pas :
Conflit :
- Skill A : "Toujours utiliser des classes pour les services"
- Skill B : "Toujours utiliser des fonctions pures"
Solution : Définir une hiérarchie claire. Le skill de niveau supérieur a priorité.
3. Le principe de complémentarité
Les meilleurs ensembles de skills se complètent sans se chevaucher :
@base-conventions.md → Style et nommage
@architecture-rules.md → Structure et patterns
@testing-standards.md → Tests et couverture
@security-policies.md → Sécurité
@documentation-rules.md → Documentation
Chacun couvre un domaine distinct.
Patterns de composition courants
Le stack complet
Pour un projet web full-stack :
# Full-Stack Composition
## Fondation
@company-standards.md
## Backend
@node-fastify.md
@prisma-database.md
@api-rest-conventions.md
## Frontend
@react-nextjs.md
@tailwind-styling.md
@accessibility.md
## Qualité
@testing-vitest.md
@security-owasp.md
@documentation-jsdoc.md
Le spécialiste
Pour un domaine spécifique approfondi :
# API Security Specialist
@api-design.md
@authentication-jwt.md
@rate-limiting.md
@input-validation.md
@cors-policy.md
@error-handling.md
Le workflow
Pour un processus de travail complet :
# Development Workflow
@git-conventions.md
@branch-strategy.md
@code-review-process.md
@ci-cd-pipeline.md
@deployment-checklist.md
Gérer les conflits entre skills
Détecter les conflits
Les signes d'un conflit de skills :
- Claude hésite entre deux approches
- Le code généré est incohérent
- Des erreurs de linting/type apparaissent
Résoudre les conflits
Méthode 1 : Priorité explicite
Ajoutez dans votre CLAUDE.md principal :
## Priorité des rules
En cas de conflit entre les skills :
1. security-rules.md a toujours priorité
2. company-standards.md ensuite
3. Les skills de projet en dernier
Méthode 2 : Fusion
Si deux skills se chevauchent, créez un skill fusionné qui résout les ambiguïtés :
# Style unifié (remplace style-backend.md et style-frontend.md)
## Code style
- camelCase pour les variables (backend ET frontend)
- PascalCase pour les classes et composants
- kebab-case pour les fichiers
Méthode 3 : Scoping
Limitez chaque skill à un contexte spécifique :
## Contexte d'application
- api-conventions.md s'applique UNIQUEMENT aux fichiers dans /src/api
- component-rules.md s'applique UNIQUEMENT aux fichiers dans /src/components
Optimiser la performance des skills combinés
La taille compte
Chaque skill consomme du contexte. Plus vous en combinez, plus le contexte utilisé est important. Optimisez :
- Supprimez les redondances entre skills
- Condensez les instructions sans perdre en clarté
- Retirez les skills non pertinents pour le travail en cours
Le test de pertinence
Pour chaque skill dans votre combinaison, posez-vous la question : "Si je retire ce skill, la qualité du code généré change-t-elle ?" Si non, retirez-le.
Le juste équilibre
En pratique, 5 à 8 skills est le sweet spot pour la plupart des projets. Au-delà, les rendements décroissent.
Créer des presets de skills
Pour faciliter la gestion, créez des presets par type de travail :
# preset-api.md
@base.md
@api-design.md
@database.md
@security.md
@testing.md
# preset-frontend.md
@base.md
@react.md
@tailwind.md
@accessibility.md
@testing.md
# preset-devops.md
@base.md
@docker.md
@ci-cd.md
@monitoring.md
Chaque développeur active le preset correspondant à sa tâche du moment.
Conclusion
La composition de skills est un art qui s'affine avec la pratique. Commencez simple avec 2-3 skills, ajoutez-en progressivement et surveillez les conflits. L'objectif n'est pas d'avoir le maximum de skills, mais la bonne combinaison pour votre contexte.
Parcourez notre bibliothèque de skills pour trouver des skills compatibles et nos guides pratiques pour des techniques avancées.