Guide des Skills Claude
Les skills sont des dossiers d'instructions que Claude Code charge à la demande. Dépose SKILL.md dans .claude/skills/ton-skill pour les workflows procéduraux, les checklists, les règles maison.
Arrêtez de configurer. Commencez à construire.
Templates SaaS avec orchestration IA.
Problème : Tu colles les mêmes lignes dans Claude Code à chaque nouvelle session. "Suis nos guidelines de marque." "Utilise notre processus de déploiement." "Vérifie d'abord les patterns de sécurité." Des tokens brûlés. Des minutes perdues. La moitié des règles oubliée de toute façon.
Victoire rapide : Livre ton premier skill en moins d'une minute :
.claude/skills/my-skill/SKILL.md
---
name: code-review
description: Reviews code for security and performance issues
---
# Code Review Process
1. Check for SQL injection vulnerabilities
2. Verify input validation exists
3. Confirm error handling patternsC'est un skill complet. Dépose le dossier dans ton projet. La prochaine demande de revue le chargera automatiquement.
Qu'est-ce qu'un skill ?
Un skill est un dossier d'instructions que Claude trouve et charge à la demande. Pense à une armoire de courts manuels de référence, ouverts seulement quand le sujet correspond.
Les prompts disparaissent après un tour. Les serveurs MCP connectent Claude à des outils extérieurs. Les skills se situent au milieu : ils enseignent comment faire les choses. La connaissance procédurale. Les workflows, les checklists, le style maison, le savoir-faire du domaine.
Simon Willison a mis un chiffre dessus : "Each skill only takes up a few dozen extra tokens, with the full details only loaded in should the user request a task that the skill can help solve."
Comment fonctionne la divulgation progressive
Le chargement se fait en deux étapes pour garder ta fenêtre de contexte légère.
Étape 1 - Métadonnées seulement (~100 tokens) : Claude ne voit que le nom et la courte description de chaque skill. Assez pour repérer ce qui est disponible.
Étape 2 - Instructions complètes (quand nécessaire) : Le corps est injecté au moment où Claude décide qu'un skill correspond à ta tâche. Ce corps reste généralement sous 5 000 tokens.
my-skill/
├── SKILL.md # Core instructions (loads when needed)
├── scripts/ # Automation scripts
├── references/ # Documentation Claude can read
└── assets/ # Templates and filesTu peux avoir des dizaines de skills de cette façon sans encombrer la mémoire de travail de Claude.
Skills versus tout le reste
Voici comment les skills se comparent au reste de la pile :
| Fonctionnalité | Skills | Prompts | Projects | MCP |
|---|---|---|---|---|
| Ce qu'il fournit | Connaissance procédurale | Instructions du moment | Connaissance de fond | Connectivité aux outils |
| Persistance | À travers les conversations | Une seule conversation | Dans le projet | Toujours connecté |
| Quand ça charge | Dynamiquement, selon les besoins | À chaque tour | Toujours dans le projet | Toujours disponible |
| Idéal pour | Workflows et expertise | Demandes rapides | Documents de référence | Accès aux données externes |
Distinction clé : Les Projects disent "voilà ce que tu dois savoir." Les Skills disent "voilà comment faire les choses." MCP dit "voilà comment se connecter."
Quand créer un skill
La règle : Toute instruction que tu colles dans plus d'une conversation devrait devenir un skill.
Bons candidats pour les skills :
- Guidelines de marque et règles de style
- Checklists de revue de code
- Procédures de déploiement
- Patterns d'audit de sécurité
- Templates de documentation
- Conventions de commit git
Pas idéal pour les skills :
- Demandes ponctuelles
- Contexte spécifique au projet (utilise Projects à la place)
- Accès à des API externes (utilise MCP à la place)
Écrire un SKILL.md efficace
Trois éléments entrent dans chaque skill :
---
name: my-skill
description: What it does and WHEN to trigger it
allowed-tools: "Read,Write,Bash"
---
# Clear Purpose Statement
## Step-by-Step Instructions
1. First action
2. Second action
3. Expected outputCritique : Le champ description est ce que Claude scanne pour décider si ton skill se déclenche. Sois précis sur le déclencheur. "When user requests code review" bat "Helps with code."
Skills pré-construits d'Anthropic
Anthropic publie un ensemble officiel de skills clé en main :
- pdf : Extraire le texte et les tableaux de documents PDF
- docx : Créer et modifier des documents Word avec les modifications suivies
- xlsx : Manipuler des feuilles de calcul Excel
- pptx : Générer des présentations PowerPoint
- brand-guidelines : Appliquer un style cohérent
Récupère-les sur github.com/anthropics/skills, ou crée les tiens sur le même pattern. Claude Code livre aussi /simplify et /batch comme intégrés pour les revues et les migrations sur toute la base de code. Zéro configuration.
Erreurs courantes
Descriptions vagues : "This skill helps with documents" ne se déclenchera jamais de façon fiable. Nomme le déclencheur clairement.
Instructions surchargées : Ton SKILL.md devrait rester sous 5 000 mots. Pousse les docs longues dans des fichiers de référence vers lesquels le skill peut pointer.
Limites manquantes : Dis clairement ce que le skill ne devrait pas toucher. Ça l'empêche de se déclencher sur des prompts pour lesquels il n'a pas été conçu.
Tes prochaines étapes
- Crée un skill couvrant l'instruction que tu répètes le plus
- Teste le déclenchement en utilisant des demandes du monde réel, pas seulement des commandes explicites
- Itère quand les vraies sessions montrent ce qui a besoin d'être affiné
- Explore la gestion du contexte pour plus de rendement par skill
- Lis sur le context engineering pour voir où les skills se situent dans une pile IA de production
Claude passe de généraliste à spécialiste une fois les skills en place, et la taxe de contexte sur les explications répétées disparaît. Ton expertise devient portable. Pour un kit fonctionnel plutôt qu'un dossier vide, le Code Kit de ClaudeFast livre plus de 20 skills de production sur 21 catégories (patterns React à travers les opérations base de données), plus un SkillActivationHook qui choisit le bon skill à chaque prompt.
L'un des cinq gestes que les meilleurs ingénieurs agentiques font chaque jour. L'ensemble complet est dans notre guide des meilleures pratiques Claude Code.
Arrêtez de configurer. Commencez à construire.
Templates SaaS avec orchestration IA.
Le répertoire de règles Claude Code
Le répertoire .claude/rules découpe CLAUDE.md en fichiers markdown ciblés par chemin. Chaque fichier se charge uniquement là où il s'applique, avec la même priorité élevée que CLAUDE.md.
Une bibliothèque centrale pour ta config .claude
Monte un dépôt Git privé pour tous tes skills, agents, commandes, hooks et CLAUDE.md sur tous tes projets. Un map.json décide quel dépôt reçoit quels éléments.