Skills Claude Code : fonctionnement de SKILL.md et emplacements de chargement

Les skills Claude Code sont des dossiers contenant un fichier SKILL.md. Ce fichier comprend un frontmatter YAML qui indique quand la skill s'applique et un corps en Markdown qui contient les instructions. Claude Code garde la description de chaque skill en contexte, ne charge son corps complet que lorsqu'elle est utilisée et vous permet de lancer n'importe quelle skill en saisissant /skill-name.^[1] Les commandes slash personnalisées fonctionnent désormais de la même façon : .claude/commands/deploy.md et .claude/skills/deploy/SKILL.md créent tous deux /deploy, et les anciens fichiers de commandes continuent de fonctionner.^[1]

Le conseil d'Anthropic sur le moment d'en écrire une est concret. Créez une skill lorsque vous collez régulièrement la même liste de contrôle ou procédure dans le chat, ou lorsqu'une section de CLAUDE.md est devenue une procédure plutôt qu'un fait. CLAUDE.md se charge à chaque session ; le corps d'une skill ne coûte presque rien tant qu'elle n'est pas exécutée.^[1]

Une skill Claude Code minimale

Une skill nécessite un dossier et un seul fichier. Celle-ci rédige des notes de version à partir des commits récents. Enregistrez-la sous ~/.claude/skills/release-notes/SKILL.md :

---
description: Drafts release notes from recent git commits. Use when the user asks for release notes, a changelog entry, or what shipped.
disable-model-invocation: true
---

## Recent commits

!`git log --oneline -30`

## Instructions

Group the commits above into Added, Changed and Fixed. Write one line per change in plain language. Skip merge commits.

Le nom du dossier devient la commande : vous la lancez donc avec /release-notes. La ligne !`...` est une injection de contexte dynamique : Claude Code exécute la commande et insère sa sortie dans la skill avant que Claude ne la lise, de sorte que les notes proviennent de votre véritable historique.^[1] disable-model-invocation: true empêche Claude de lancer la skill de lui-même, ce qui convient aux actions que vous souhaitez déclencher vous-même.

Où les skills Claude Code se chargent-elles ?

Le dossier choisi détermine qui dispose de la skill :^[1]

Emplacement	Chemin	Qui en dispose
Personnel	`~/.claude/skills/<name>/SKILL.md`	Vous, dans tous les projets sur cette machine
Projet	`.claude/skills/<name>/SKILL.md`	Toute personne qui travaille dans le dépôt, une fois le fichier commité
Imbriqué	`<subdir>/.claude/skills/<name>/SKILL.md`	Les sessions démarrées dans ce dossier ou ses sous-dossiers
Plugin	`<plugin>/skills/<name>/SKILL.md`	Toute personne ayant activé le plugin, sous la forme `/plugin-name:skill-name`
Entreprise	Dossier des paramètres gérés	Tous les utilisateurs auprès desquels l'organisation la déploie
Compte claude.ai	Skills activées sur le compte	Les sessions connectées avec ce compte

Deux noms sont réservés. Claude Code utilise ~/.claude/skills/synced/ pour les skills téléchargées depuis claude.ai et ignore toute skill que vous créez avec ce nom de dossier. En dehors d'un plugin, un dossier nommé anthropic-skills, ou dont le nom commence par anthropic-skills:, ne se charge pas.^[1]

Ce que contrôle le frontmatter

Tous les champs sont facultatifs, et Anthropic ne recommande que description. Claude Code ignore un nom de champ mal orthographié sans signaler d'erreur : recopiez donc les noms à l'identique.^[1] Voici les champs qui modifient le plus le comportement :

description permet à Claude de décider d'utiliser la skill. Placez le cas d'usage principal en premier : avec when_to_use, elle est tronquée à 1,536 caractères dans la liste des skills.
disable-model-invocation: true rend la skill uniquement manuelle. Sa description quitte aussi le contexte : elle ne coûte donc rien tant que vous ne la saisissez pas.
user-invocable: false fait l'inverse : seul Claude peut la charger, et elle disparaît du menu /. Anthropic suggère ce réglage pour les connaissances de fond, comme le fonctionnement d'un système ancien.
allowed-tools préautorise des outils pour le tour qui exécute la skill. Cette autorisation prend fin lorsque vous envoyez votre message suivant.
paths limite le chargement automatique aux fichiers correspondants, et context: fork exécute la skill dans un sous-agent.

model et effort changent le modèle et le niveau de raisonnement pour le reste du tour, sans enregistrer la modification dans vos paramètres.^[1]

Combien de contexte une skill consomme-t-elle ?

Anthropic décrit trois niveaux. Le nom et la description de chaque skill se chargent au démarrage, à raison d'environ 100 tokens par skill. Le corps de SKILL.md se charge lorsque la skill se déclenche ; le tableau d'Anthropic situe ce niveau sous 5,000 tokens. Les fichiers fournis avec la skill ne coûtent rien tant que Claude ne les lit pas, et le code d'un script n'entre jamais dans le contexte ; seule sa sortie y entre.^[2]

Une fois une skill exécutée, son contenu reste dans la conversation sous forme d'un message, et Claude Code ne relit pas le fichier aux tours suivants. Après la compaction automatique, Claude Code rattache l'exécution la plus récente de chaque skill, en conservant les 5,000 premiers tokens de chacune dans un budget partagé de 25,000 tokens, de la plus récente à la plus ancienne. Si vous avez utilisé de nombreuses skills dans une longue session, les plus anciennes peuvent disparaître.^[1] Écrivez les règles qui doivent s'appliquer à toute la tâche sous forme d'instructions permanentes près du début du fichier.

Les skills Claude en dehors de Claude Code

Le même format s'exécute sur d'autres interfaces Claude, avec des règles propres à chacune :^[2]

claude.ai dispose des skills prédéfinies d'Anthropic pour les fichiers PowerPoint, Excel, Word et PDF, actives sans configuration. Les skills personnalisées se téléversent sous forme de fichiers zip dans Settings > Features avec les offres Pro, Max, Ultra, Team et Enterprise et l'exécution de code activée. Chaque téléversement est privé à un seul utilisateur.
L'API Claude reçoit un skill_id dans le paramètre container, avec l'outil d'exécution de code. Les identifiants prédéfinis sont pptx, xlsx, docx et pdf ; les skills personnalisées passent par les endpoints /v1/skills et sont partagées dans tout l'espace de travail.
Claude Code prend en charge les skills personnalisées, mais pas les skills documentaires prédéfinies.

La documentation d'Anthropic se contredit sur la synchronisation. La présentation d'Agent Skills indique que les skills personnalisées ne se synchronisent pas entre les interfaces et que les skills Claude Code sont distinctes de celles de claude.ai comme de l'API.^[2] La page Claude Code plus récente répertorie les skills activées sur un compte claude.ai parmi les sources de chargement des sessions de terminal connectées avec ce compte, téléchargées dans ~/.claude/skills/synced/.^[1] Si vous comptez sur cette synchronisation, vérifiez que la skill apparaît dans le menu / avant de construire un workflow autour d'elle.

Transférer une skill Claude Code vers claude.ai ou la Skills API demande de l'attention. Ces modes de chargement n'acceptent que six champs de frontmatter du standard ouvert Agent Skills : name, description, license, compatibility, metadata et allowed-tools. Tout autre champ, comme disable-model-invocation ou argument-hint, fait échouer le téléversement avec une erreur « Unexpected key(s) » au lieu d'être ignoré, et les fonctions propres à Claude Code comme l'injection !`command` ne s'y exécutent pas.^[1]^[3] Il faudrait retirer ces deux éléments de l'exemple de notes de version ci-dessus.

Installer des skills écrites par d'autres

Une skill peut demander à Claude d'exécuter des commandes et d'appeler des outils. Anthropic conseille donc de n'utiliser que des skills provenant de sources de confiance et de traiter leur installation comme celle d'un logiciel. Lisez tous les fichiers du dossier, pas seulement SKILL.md : scripts, images et fichiers de référence peuvent tous contenir des instructions. Les skills qui récupèrent du contenu depuis des URL externes présentent un risque supplémentaire, car la page récupérée peut changer après votre examen.^[2]

FAQ

Les skills Claude Code sont-elles la même chose que les commandes slash ?

Elles ont été fusionnées. Un fichier de commande dans .claude/commands/ et un dossier de skill portant le même nom créent tous deux la même commande /name. Les skills ajoutent des fichiers complémentaires, le chargement automatique et le contrôle du déclenchement.^[1]

Claude Code peut-il utiliser les skills PowerPoint et Excel ?

Non. Les skills documentaires prédéfinies d'Anthropic s'exécutent sur claude.ai et l'API, mais ne sont pas disponibles dans Claude Code. Claude Code fournit ses propres skills intégrées, comme /code-review, /debug et /claude-api.^[1]^[2]

Pourquoi Claude ignore-t-il ma skill ?

Vérifiez d'abord la description : avec when_to_use, c'est tout ce que Claude voit avant de décider. Vérifiez ensuite que le --- d'ouverture est sur la première ligne du fichier : sinon, Claude Code traite le frontmatter comme du texte brut, et une erreur YAML fait charger la skill sans aucun champ défini.^[1]

Exécuter les skills Claude Code avec votre propre accès aux modèles

Les skills personnelles et de projet sont des fichiers sur votre machine que lit le client Claude Code. Si vous configurez Claude Code pour utiliser une passerelle plutôt qu'un abonnement Claude, le guide Claude Code de reAPI détaille l'URL de base, le type de clé et les identifiants de modèles Claude acceptés, et la page Claude Sonnet 5.5 affiche les tarifs actuels. Les skills synchronisées depuis claude.ai dépendent de la connexion avec ce compte : conservez donc dans des dossiers personnels ou de projet les skills Claude Code dont vous avez besoin partout.

Références

Anthropic. Extend Claude with skills (Claude Code documentation). Consulté le 4 novembre 2026 sur code.claude.com/docs/en/skills
Anthropic. Agent Skills overview. Consulté le 4 novembre 2026 sur platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
Agent Skills. Agent Skills open standard. Consulté le 4 novembre 2026 sur agentskills.io