Les skills sont le moyen le plus simple d’apprendre à un agent de code ce qu’il ne fait pas bien par défaut : une charte de design, une checklist de relecture, une façon d’économiser des tokens. Ce guide explique où vivent les skills pour Claude Code et Codex, comment les installer à la main et comment les gérer sans ligne de commande.
Qu’est-ce qu’un skill ?
Un skill est un dossier qui contient un fichier SKILL.md : des instructions en Markdown avec un nom court et une description en tête, plus les scripts ou fichiers de référence nécessaires. L’agent lit la description de chaque skill installé et ne charge les instructions complètes que lorsqu’une tâche en a besoin. Un skill installé coûte donc très peu de contexte tant qu’il ne sert pas.
my-skill/
├── SKILL.md
└── scripts/
└── check.sh
Où Claude Code et Codex cherchent les skills
| Agent | Skills personnels (tous les projets) | Skills du projet |
|---|---|---|
| Claude Code | ~/.claude/skills/<name>/ |
.claude/skills/<name>/ dans le dépôt |
| Codex | ~/.codex/skills/<name>/ ou ~/.agents/skills/<name>/ |
selon la documentation Codex |
Si vous définissez CLAUDE_CONFIG_DIR ou CODEX_HOME, les dossiers personnels se déplacent avec.
Installer un skill à la main
- Trouvez le dépôt du skill et le dossier qui contient son
SKILL.md. - Copiez ce dossier dans votre répertoire de skills :
git clone https://github.com/owner/repo /tmp/repo
cp -R /tmp/repo/skills/my-skill ~/.claude/skills/- Démarrez une nouvelle session d’agent pour qu’il prenne le skill en compte.
Pour mettre à jour, il faut refaire la copie, et rien ne permet de revenir en arrière si la nouvelle version pose problème. Gardez donc une sauvegarde de l’ancien dossier.
N’installez que des skills de confiance. Un skill peut contenir des scripts que l’agent risque d’exécuter avec vos droits. Lisez d’abord SKILL.md et les scripts.
Gérer vos propres dépôts de skills avec Vibe Console
Dans le panneau Skills de Vibe Console, ajoutez un dépôt GitHub de confiance sous la forme owner/repo ou https://github.com/owner/repo. Choisissez une section pour sa carte, puis les skills à installer pour Claude Code ou Codex. La liste est enregistrée sur votre Mac ; Vibe Console ne fournit pas les fichiers des skills. Vous pouvez retirer une carte de la liste sans désinstaller ce que vous avez déjà installé.
Des mises à jour sûres, avec retour arrière
Vibe Console vérifie les mises à jour des skills installés et les signale par Mise à jour disponible, ou par Source différente — examinez les modifications quand les fichiers sur le disque ne correspondent plus à la source. Chaque mise à jour garde une sauvegarde des fichiers précédents. Si la nouvelle version pose problème, cliquez sur Revenir en arrière, ou sur Ouvrir la sauvegarde pour examiner les anciens fichiers.
FAQ
Les skills fonctionnent-ils à la fois dans Claude Code et Codex ?
Le format SKILL.md fonctionne dans les deux, mais chaque agent charge les skills depuis son propre dossier. Installez le skill pour chaque agent que vous utilisez.
Les skills installés ralentissent-ils l’agent ?
À peine. L’agent ne lit que la courte description de chaque skill tant qu’une tâche n’en a pas besoin.
Comment supprimer un skill ?
Supprimez son dossier du répertoire de skills, puis démarrez une nouvelle session.
Essayez le panneau Skills gratuitement pendant 14 jours : téléchargez Vibe Console.