Les skills Claude Code sont des dossiers contenant un fichier SKILL.md qui apprennent à Claude une tâche répétable, comme relire une PR ou préparer une release, et Claude n’en charge un que lorsque votre demande en a besoin. Les skills sont donc le bon endroit pour des instructions qui comptent pour certaines tâches mais pas pour chaque session. Le piège : un skill est un ensemble d’instructions que votre agent suivra, et un skill venu d’Internet mérite le même soin qu’un script venu d’Internet.
Cet article couvre le format des skills, leur emplacement, la façon dont Claude les choisit, comment en écrire un bon, et comment trouver et installer des skills partagés sans confier à votre agent quelque chose de dangereux.
Ce qu’est un skill Claude Code
Un skill est un dossier. Le seul fichier obligatoire est SKILL.md :
---
name: release-notes
description: Use when the user asks for release notes or a changelog entry for a version.
---
1. Run `git log --oneline <last-tag>..HEAD`.
2. Group the commits into Features, Fixes and Other.
3. Write one plain sentence per change, for users, not developers.
4. Ask before writing to CHANGELOG.md.Le frontmatter contient le name et la description. Le corps est l’instruction que Claude suit une fois le skill chargé. Le dossier peut aussi contenir des scripts et des fichiers de référence vers lesquels les instructions renvoient, si bien qu’un skill peut dire « lance scripts/check.sh » ou « lis reference/api.md pour la liste des endpoints ».
Où vivent les skills Claude Code
| Emplacement | Qui l’obtient | Usage typique |
|---|---|---|
.claude/skills/<name>/SKILL.md | Tous ceux qui travaillent sur le dépôt, via git | Workflows de projet : déploiement, migrations, release |
~/.claude/skills/<name>/SKILL.md | Vous, dans chaque projet | Habitudes personnelles : votre checklist de relecture, votre style de commit |
Le nom du dossier devient la commande : .claude/skills/release-notes/SKILL.md peut aussi se lancer avec /release-notes. Tapez /skills dans une session pour lister les skills que Claude voit. Pour les autres commandes slash, voir l’aide-mémoire des commandes Claude Code.
Comment Claude décide d’utiliser un skill
Au début d’une session, Claude voit les descriptions des skills, pas leur corps complet. Quand votre demande correspond à une description, il charge ce skill. Deux conséquences :
- La description fait le routage. « Skill de notes de version » est une description faible. « Use when the user asks for release notes or a changelog entry for a version » dit à Claude quand s’en servir.
- Les skills gardent petit votre contexte de base. Seules les descriptions se chargent à chaque session : sortir de
CLAUDE.mdles instructions propres à une tâche pour les mettre dans des skills allège chaque tour. Plus de détails dans la fenêtre de contexte de Claude Code.
Skills, CLAUDE.md, subagents et MCP
Ces quatre se recoupent, il est donc utile de savoir lequel convient.
| Outil | Chargé | Idéal pour |
|---|---|---|
CLAUDE.md | À chaque session, fichier entier | Règles qui s’appliquent toujours |
| Skill | Description toujours, corps à la demande | Un workflow que vous répétez de temps en temps |
| Subagent | Quand il est délégué, dans son propre contexte | Un gros travail dont vous n’avez pas besoin des détails |
| Serveur MCP | Définitions d’outils à chaque session | Accès à des systèmes ou données extérieurs |
Si vous collez le même paragraphe dans vos prompts deux fois par semaine, cela devrait être un skill. Si l’agent doit parler à une base de données ou à une API, c’est un serveur MCP (ce qu’est un serveur MCP).
Comment écrire un bon skill
- Partez d’une tâche que vous répétez déjà. Notez les étapes que vous tapez aujourd’hui.
- Écrivez la description comme un déclencheur. Commencez par « Use when… » et nommez les mots qu’un utilisateur dirait.
- Gardez le corps court et ordonné. Des étapes numérotées valent mieux que des paragraphes.
- Mettez le contenu long dans des fichiers. Un tableau de référence ou un script va à côté de
SKILL.md, et le corps dit quand le lire ou l’exécuter. - Dites ce qu’il ne faut pas faire. « Ask before writing to CHANGELOG.md » évite la surprise que vous corrigeriez sinon à la main.
- Testez-le dans une session neuve. Demandez la tâche avec vos propres mots et vérifiez que Claude choisit le skill sans qu’on le lui dise.
Le risque des skills partagés
Le partage de skills est ce qui les rend utiles, et risqués. Un skill peut demander à votre agent d’exécuter une commande shell, de lire un fichier hors du projet ou d’envoyer quelque chose vers une URL. Si votre agent tourne avec de larges permissions, un skill malveillant ou négligent s’exécute avec elles. À repérer avant d’en installer un :
- Commandes destructrices ou privilégiées (
rm -rf,sudo) - Lecture de secrets, comme des fichiers
.envou des clés SSH - Envoi de données vers un hôte inconnu
- Schémas de téléchargement-exécution, comme faire passer
curldans un shell - Code obscurci ou caractères Unicode cachés
- Injection de prompt : du texte qui tente de contourner vos instructions
L’article sur la sécurité des agents de code IA traite plus en profondeur des permissions et du sandboxing.
Gérer les skills dans AgentVera
La skill gallery d’AgentVera se trouve dans la page Details d’un projet, Automation → Skills. Elle a trois vues : Local, Discover et My published.
Local liste les skills de votre ordinateur pour les deux agents qui utilisent des dossiers de skills :
| Agent | Dossier du projet | Dossier personnel |
|---|---|---|
| Claude Code | .claude/skills | ~/.claude/skills |
| Codex | .agents/skills | ~/.codex/skills |
De là, vous pouvez :
- En créer un avec New skill : choisissez l’Agent (Claude Code ou Codex), le Scope (This project ou All projects), un Name (lettres minuscules, chiffres et tirets) et When should it be used?, qui devient la description. Create and edit ouvre le nouveau
SKILL.md. - Désactiver un skill sans le supprimer. L’interrupteur déplace le dossier vers un endroit que les CLI n’analysent pas.
- Prévisualiser ou modifier
SKILL.md, copier un skill vers l’autre agent ou l’autre portée, ou le supprimer, ce qui déplace le dossier vers la Corbeille.
Trouver et installer des skills en sécurité
Discover affiche les skills de votre organisation et la galerie publique. Recherchez, choisissez l’une des 10 catégories (coding, testing, code review, DevOps, data, docs, design, security, productivity, other), filtrez par agent et triez par Popular ou New. La même galerie est sur le web à app.agentvera.dev/skills.
La vue détaillée de chaque skill a des onglets Files, Security et Versions. L’onglet Security affiche le Server scan. L’analyse cherche des commandes destructrices ou privilégiées, la lecture de secrets, des clés intégrées, des données envoyées à l’extérieur, du téléchargement-exécution, du code obscurci, de l’injection de prompt, de l’Unicode caché, des adresses IP brutes et des hôtes extérieurs. Les résultats vont de propre à critique, en passant par info, risque faible, moyen et élevé.
L’installation se fait en deux étapes :
- Download and scan. AgentVera télécharge les fichiers, vérifie leur SHA-256 et les analyse de nouveau sur votre ordinateur.
- Install. Les scripts sont écrits comme de simples fichiers et ne sont pas rendus exécutables.
Les agents voient le skill dès leur prochaine session. Quand une nouvelle version est publiée, un bouton de mise à jour apparaît à côté du skill installé. Les skills de la galerie ne s’installent que pour les agents qu’ils prennent en charge, Claude Code et Codex.
Les skills publics passent une analyse de sécurité et une revue par un modérateur, mais regardez quand même les constats et les fichiers. L’analyse détecte des schémas ; vous savez ce que votre projet doit et ne doit pas faire.
Partager vos propres skills
Avec un forfait Pro ou Team et un compte AgentVera, Share publie un skill local. Vous lui donnez un titre, un résumé de 20 à 300 caractères, jusqu’à 6 tags, une catégorie et une version comme 1.0.0, avec un changelog pour chaque version. Un skill est limité à 50 fichiers texte, 256 Ko par fichier et 1 Mo au total.
- Organization only : visible tout de suite pour votre organisation si l’analyse ne trouve rien d’élevé ou de critique ; sinon il est refusé.
- Public : attend l’approbation d’un modérateur, et les constats critiques ne sont pas acceptés. Suivez-le dans My published.
Skills et consommation de tokens
Chaque skill ajoute sa description au contexte de base. Une poignée, ça va ; des dizaines de skills personnels s’additionnent à chaque tour. Le profil Lean context d’AgentVera ne charge pas les skills de niveau utilisateur, ce qui est l’une des raisons pour lesquelles sa première requête est plus petite (mesuré ici). Gardez les skills de projet dans le dépôt et élaguez les skills personnels que vous n’utilisez plus.
En résumé
Les skills Claude Code transforment des prompts répétés en dossiers que Claude charge à la demande : un SKILL.md avec une description « use when » claire, des étapes courtes et ordonnées et les scripts nécessaires, dans .claude/skills pour le projet ou ~/.claude/skills pour vous. Les skills partagés ne valent la peine que si vous les vérifiez d’abord. AgentVera liste les skills Claude Code et Codex au même endroit, analyse les skills de la galerie sur le serveur puis de nouveau sur votre ordinateur avant l’installation, et laisse les utilisateurs Pro et Team publier les leurs. Téléchargez AgentVera pour gérer vos skills.