1. Qu'est-ce qu'une skill
Une skill, c'est une compétence métier formalisée que Claude Code apprend une fois et réutilise indéfiniment.
Concrètement, une skill est un dossier avec :
- Un fichier
SKILL.mdqui décrit la compétence - Optionnellement : des templates, des exemples, des scripts
Quand vous demandez quelque chose qui correspond à la skill, Claude Code la charge automatiquement et applique les instructions. Pas besoin de la mentionner explicitement.
2. Anatomie d'une skill
Créez le dossier ~/.claude/skills/rapport-client/ puis le fichier SKILL.md :
Avec cette skill en place, vous tapez juste : "Fais le rapport mensuel de Dupont SARL pour mars". Claude Code charge la skill, la suit à la lettre, produit un rapport conforme à votre template. Plus besoin de tout réexpliquer à chaque fois.
3. Les niveaux de skill : projet vs global
Deux endroits pour stocker vos skills :
- Projet :
.claude/skills/[nom]/SKILL.mddans le dossier projet. Skills propres à ce projet, partagées si vous versionnez le projet. - Global :
~/.claude/skills/[nom]/SKILL.mddans votre home. Skills disponibles dans tous vos projets.
Bonne pratique : les skills métier transversales (rapports, signatures, formats) en global. Les skills spécifiques à un projet (gestion d'un dépôt particulier) en projet.
4. La différence avec sub-agents et MCP
Trois mécanismes complémentaires, souvent confondus :
| Skill | Sub-agent | MCP | |
|---|---|---|---|
| Quoi ? | Instructions et templates | Bulle d'exécution isolée | Connexion à un outil externe |
| Quand activé ? | Auto, sur reconnaissance contexte | Délégation explicite | Auto, quand outil pertinent |
| Donne accès à... | De la connaissance | De la capacité d'action isolée | Des actions sur un système externe |
| Exemple | "Comment on fait un rapport" | "Va analyser ce dépôt" | "Envoie un message Slack" |
Les trois se combinent : un sub-agent peut utiliser une skill et appeler un serveur MCP.
5. Cinq exemples de skills métier puissantes
Skill 1 : "compte-rendu-reunion"
Format de compte-rendu standard de votre entreprise (sections, ton, longueur). Active dès qu'on parle de "CR" ou "compte-rendu".
Skill 2 : "email-prospect"
Template d'email de prospection avec ton AzenFlow, signature standard, mention IA Act. Active sur "email prospect" ou "relance commerciale".
Skill 3 : "audit-conformite-rgpd"
Checklist de 25 points à vérifier sur un site web, format de rapport. Active sur "audit RGPD" ou "audit conformité".
Skill 4 : "synthese-pdf"
Format de synthèse standardisé : 5 points clés + 3 actions, max 1 page. Active sur "résume ce PDF" ou "synthèse de ce document".
Skill 5 : "veille-concurrentielle"
Process de veille hebdo : 5 concurrents, 4 axes (produit, prix, comm, recrutement), format newsletter. Active sur "veille hebdo" ou "veille concurrentielle".
6. La structure recommandée d'un SKILL.md
Pour des skills robustes, suivez cette structure :
Plus c'est précis, mieux Claude exécute. Comptez 1-3 pages par skill bien faite.
7. Skills avec ressources additionnelles
Une skill peut avoir des fichiers compagnons :
Dans le SKILL.md, vous référencez ces fichiers : "Utilise le template ./template.md, vérifie avec ./checklist.md". Claude Code va les lire automatiquement.
8. Tester et itérer une skill
Première version de votre skill : faites-la et utilisez-la sur 2-3 cas réels. Notez ce qui ne va pas :
- Ton pas conforme ?
- Section manquante ?
- Mauvaise interprétation d'un cas limite ?
Mettez à jour le SKILL.md en ajoutant la précision manquante. Refaites un cas. Itérez 3-5 fois. Une bonne skill est rarement parfaite du premier coup, mais converge vite.
9. Partager des skills en équipe
Pour une PME avec plusieurs utilisateurs Claude Code :
- Centralisez vos skills dans un dépôt Git interne (ex:
azenflow/claude-skills) - Chaque membre clone le dépôt dans
~/.claude/skills/ - Mises à jour propagées via
git pull
Vous capitalisez collectivement votre savoir-faire métier. Quand un consultant améliore la skill "rapport-client", tous les autres en bénéficient.
10. À retenir avant le chapitre suivant
- Skill = compétence métier formalisée, activée automatiquement
- Format : dossier avec SKILL.md (frontmatter + corps)
- Niveau projet ou global (~/.claude/skills/)
- Différent de sub-agent (bulle d'exécution) et MCP (connexion outil)
- 5 exemples : rapports, emails, audits, synthèses, veille
- Structure type : Quand activer / Pré-requis / Process / Templates / Contraintes / Sources / Validation
- Itération : 3-5 cycles pour qu'une skill soit excellente
- Partage équipe via Git interne
Au chapitre 6, on attaque les MCP servers : la connexion native à vos outils externes (Gmail, Slack, Notion, GitHub, etc.) en quelques minutes.