C'est dans Claude Code que les skills sont nés, et c'est là qu'elles sont encore les plus exploitées : elles peuvent y exécuter des scripts avec un accès réseau complet, prendre des arguments, s'exécuter dans leur propre subagent et remplacer les commandes slash personnalisées que vous avez peut-être déjà. Ce guide traite spécifiquement du volet Claude Code. Pour le format en général et l'origine des skills, voir Claude skills and agent skills.
Nous avons consulté la documentation et la référence des commandes de Claude Code le 14 novembre 2026. La liste ci-dessus de ce guide recense toutes les skills du catalogue de HostedMCP, avec la commande pour les installer dans Claude Code.
Où Claude Code cherche les skills
| Portée | Dossier | Qui y a accès |
|---|---|---|
| Personnel | ~/.claude/skills/<name>/SKILL.md |
Vous, dans chaque projet |
| Projet | .claude/skills/<name>/SKILL.md |
Tous ceux qui clonent le dépôt |
| Imbriqué | <subfolder>/.claude/skills/<name>/SKILL.md |
Le travail dans cette partie d'un monorepo |
| Plugin | <plugin>/skills/<name>/SKILL.md |
Tous ceux qui ont le plugin, sous la forme /plugin:name |
| Organisation | Le dossier des paramètres gérés | Tous ceux soumis à cette politique |
Si deux skills portent le même nom, celui de l'organisation l'emporte sur le vôtre, et le vôtre sur celui du projet. Les skills que vous activez sur claude.ai sont synchronisés dans ~/.claude/skills/synced/.
En créer un
mkdir -p .claude/skills/release-notes
Écrivez ensuite .claude/skills/release-notes/SKILL.md :
---
name: release-notes
description: Write release notes from merged pull requests. Use when the user asks for release notes, a changelog entry or a summary of what shipped.
---
1. List pull requests merged since the last tag with `gh pr list --state merged`.
2. Group them under Added, Changed and Fixed.
3. Write one plain sentence per change, for users rather than developers.
Voilà une skill opérationnelle. Claude Code la détecte sans redémarrage. Demandez des notes de version et il l'utilisera, ou tapez /release-notes.
Gardez SKILL.md sous 500 lignes et déplacez le contenu volumineux dans des fichiers adjacents vers lesquels les instructions pointent. Le plugin skill-creator d'Anthropic, /plugin install skill-creator@claude-plugins-official, permet de tester une skill avec et sans son chargement et d'ajuster sa description.
L'invoquer
| Frontmatter | Vous pouvez taper /name |
Claude l'utilise de lui-même | Description dans le contexte |
|---|---|---|---|
| Par défaut | Oui | Oui | Toujours |
disable-model-invocation: true |
Oui | Non | Non |
user-invocable: false |
Non | Oui | Toujours |
/name ne fonctionne qu'en début de message, et jusqu'à six peuvent être enchaînés. Les skills acceptent des arguments : $ARGUMENTS dans le corps devient ce que vous tapez après le nom, et argument-hint affiche une indication dans le menu.
Quelques autres champs que Claude Code ajoute au standard : when_to_use pour une description de déclenchement distincte, model et effort pour exécuter un skill sur un autre modèle ou un autre niveau d'effort, allowed-tools et disallowed-tools, et context: fork pour exécuter le skill dans un subagent afin que son travail n'encombre pas votre conversation principale.
Les commandes slash personnalisées ont fusionné avec les skills. .claude/commands/deploy.md et .claude/skills/deploy/SKILL.md créent tous deux /deploy, et les anciens fichiers de commandes continuent de fonctionner.
Les skills fournis avec Claude Code
La référence des commandes de Claude Code répertorie 20 commandes comme skills. Voici celles que vous rencontrerez le plus souvent :
| Skill | Ce qu'elle fait |
|---|---|
/code-review |
Analyse un diff, une branche ou une pull request à la recherche de bugs, selon le niveau d'effort que vous choisissez, et peut corriger ou commenter |
/simplify |
Quatre agents de revue cherchent des problèmes de réutilisation, de simplification, d'efficacité et d'abstraction, puis appliquent les corrections |
/batch |
Découpe une modification volumineuse en 5 à 30 unités et lance un agent en arrière-plan par unité |
/debug |
Active la journalisation de débogage pour la session et lit le journal |
/loop |
Relance un prompt à intervalle régulier, ou s'auto-régule |
/run et /verify |
Lancent l'application et vérifient qu'une modification fonctionne réellement |
/doctor |
Vérifie l'installation, les paramètres, les extensions et CLAUDE.md |
/fewer-permission-prompts |
Transforme les commandes en lecture seule que vous approuvez souvent en liste d'autorisation |
/update-config |
Modifie settings.json à partir d'une simple description |
/claude-api |
Charge la référence actuelle de l'API et du SDK Claude |
/dataviz |
Conseils sur les graphiques et tableaux de bord, avec un validateur de palette |
/init, qui écrit un CLAUDE.md pour un nouveau projet, est une commande intégrée et non une skill, et /review est un alias de /code-review. Claude Code ne fournit pas les skills de documents d'Anthropic pour Word, PDF, PowerPoint et Excel ; installez-les depuis le dépôt anthropics/skills.
Ce que coûtent les skills
Chaque skill que Claude peut invoquer de lui-même place sa description dans le contexte à chaque tour. Claude Code limite cela de deux façons :
- Dans la liste, chaque description, avec
when_to_use, est tronquée à 1 536 caractères. - L'ensemble des descriptions partage un budget d'environ 1 % de la fenêtre de contexte du modèle. Au-delà, Claude Code supprime les descriptions en commençant par les skills les moins utilisés et ne conserve que leurs noms.
Une fois utilisé, le contenu d'un skill reste dans la conversation. Après une compaction automatique, la dernière utilisation de chaque skill est rattachée à nouveau, dans la limite de 5 000 tokens par skill et de 25 000 au total.
/skills liste vos skills et peut les trier par coût en tokens ; /skill-doctor indique le coût en contexte de chaque skill et la fréquence de son utilisation. Un skill que vous n'invoquez jamais qu'à la main devrait avoir disable-model-invocation: true, ce qui retire entièrement sa description du contexte.
Skill, hook, subagent, MCP ou plugin
| Vous voulez | Utilisez | Pourquoi |
|---|---|---|
| Des faits dont Claude a besoin à chaque session | CLAUDE.md | Chargé à chaque fois ; gardez-le sous 200 lignes |
| Un savoir-faire pour certaines tâches | Un skill | Chargé uniquement quand c'est pertinent |
| Que quelque chose se produise à chaque fois | Un hook | Déterministe, sans coût de contexte ; « placez les garde-fous dans les hooks » |
| Garder un travail lourd hors de votre contexte | Un subagent | Contexte séparé, renvoie un résumé |
| Des outils ou des données d'un autre système | Un MCP server | Un skill peut apprendre à Claude comment l'utiliser |
| Tout ce qui précède pour une équipe | Un plugin | Les empaquette en une seule installation |
L'association qu'Anthropic documente le plus est un skill associé à un MCP server : le serveur fournit les outils, le skill apporte le discernement sur quand et comment les utiliser.
Sécurité
Dans Claude Code, les skills peuvent exécuter n'importe quel script avec les droits de votre utilisateur et un accès réseau complet. Lisez les scripts de tout skill que vous n'avez pas écrit. allowed-tools permet à un skill d'utiliser des outils sans vous demander votre avis ; cela ne restreint rien. Dans un projet, relisez .claude/skills/ dans les pull requests comme vous reliriez du code. Les organisations peuvent verrouiller tout cela via des managed settings, notamment en n'autorisant que les skills provenant de plugin marketplaces approuvés.
Quand cela ne fonctionne pas
| Ce que vous observez | Cause | Correction |
|---|---|---|
| Claude ignore la skill | La description ne correspond pas à votre formulation | Réécrivez-la ; ajoutez when_to_use |
/name introuvable |
Le nom du dossier et name diffèrent, ou il s'agit d'un nouveau dossier de premier niveau |
Faites-les correspondre ; exécutez /reload-skills |
| Une skill de plugin porte un autre nom | Les skills de plugin sont préfixées par un espace de noms | Saisissez /plugin:name |
| Certaines skills ont perdu leur description | Le budget de listing est dépassé | Supprimez les skills inutilisées ou définissez disable-model-invocation: true |
| Votre skill est masquée | Une skill d'organisation ou personnelle porte le même nom | Renommez la vôtre |