Qu'est-ce qu'un skill ? — Introduction aux Agent Skills

Observez votre semaine de travail avec Claude Code. Lundi, vous lui expliquez vos conventions de code avant de lui confier un module. Mardi, avant une revue de pull request, vous redécrivez la structure de commentaires que votre équipe attend. Mercredi, vous rappelez une fois de plus le format de vos messages de commit. Chacune de ces explications est correcte, chacune fonctionne, et chacune disparaît à la fin de la session. Les skills existent pour rompre ce cycle : un skill est un dossier contenant un fichier SKILL.md qui apprend à Claude comment faire quelque chose une seule fois ; vous l’appelez ensuite comme une commande, ou Claude le charge de lui-même dès que la situation s’y prête.

Ce cours a été revu le 5 novembre 2026 sur la documentation officielle de Claude Code (version 2.1.318), celle de l’API Claude et la spécification ouverte Agent Skills. Depuis l’été, les skills ont absorbé les commandes personnalisées, se rechargent sans redémarrage, se synchronisent depuis votre compte claude.ai et se testent avec des outils dédiés : chaque leçon le reflète.

Ce qu’est un skill

Un skill se matérialise par un dossier dont le cœur est un fichier SKILL.md. Son en-tête YAML porte une description, et c’est elle qui décide du déclenchement : quand vous demandez une revue de pull request, Claude compare votre requête aux descriptions de tous les skills disponibles et charge celui qui correspond. Sous l’en-tête, vous écrivez les instructions : votre liste de vérification, vos préférences de format, tout ce dont Claude a besoin pour mener la tâche comme vous l’entendez.

---
description: Relit une pull request pour la qualité du code. À utiliser quand on demande une revue de PR ou une vérification des changements.
---

Quand tu relis une pull request :
1. Lis le diff complet avant de commenter
2. Signale d'abord ce qui casse (tests, types, sécurité), ensuite le style
3. Pour chaque remarque, cite le fichier et la ligne

Ce fichier, déposé dans .claude/skills/pr-review/, crée la commande /pr-review et remplace définitivement l’explication du mardi matin. Le nom du dossier devient le nom de la commande ; seule la description est recommandée, tout le reste de l’en-tête est facultatif.

Trois temps de chargement

Les skills tiennent leur économie de contexte d’un principe que la documentation nomme divulgation progressive (progressive disclosure). Au démarrage, Claude ne charge que le nom et la description de chaque skill, environ cent tokens chacun, jamais le contenu complet. Votre liste de vérification, qui fait peut-être cent lignes, n’occupe donc aucune place pendant que vous déboguez un test : elle arrive dans la conversation au moment précis où vous demandez une revue, et pas avant. Et les fichiers annexes du dossier (documentation de référence, scripts, gabarits) ne coûtent rien tant que Claude ne les ouvre pas.

Schéma des trois niveaux de chargement d'un skill : métadonnées toujours chargées, instructions au déclenchement, ressources et scripts à la demande ; et les emplacements où un skill peut vivre

Où se trouvent les skills

L’emplacement du dossier détermine qui en bénéficie :

Emplacement	Chemin	Disponible
Personnel	`~/.claude/skills/<nom>/SKILL.md`	Dans tous vos projets sur cette machine
Projet	`.claude/skills/<nom>/SKILL.md`	Dans ce dépôt, pour toute l’équipe une fois commité
Plugin	`<plugin>/skills/<nom>/SKILL.md`	Partout où le plugin est activé, sous le nom `/plugin:nom`
Organisation	`.claude/skills/` du dossier des réglages gérés	Sur toutes les machines où l’organisation le déploie
Compte claude.ai	Les skills activés dans vos réglages claude.ai	Dans Cowork, les sessions cloud, et le terminal quand vous y êtes connecté avec ce compte

Sous Windows, les skills personnels sont dans C:\Users\<vous>\.claude\skills. Dans un monorepo, les skills de .claude/skills/ des dossiers parents se chargent aussi, et ceux d’un sous-dossier se chargent dès que Claude y travaille.

Un standard ouvert, plusieurs produits

Le format SKILL.md suit la spécification ouverte Agent Skills (agentskills.io), adoptée par plusieurs outils. Chez Anthropic, il sert dans Claude Code, mais aussi sur claude.ai (vous téléversez un skill dans vos réglages) et dans l’API Claude (vous l’envoyez par l’API des skills et il s’exécute dans le conteneur d’exécution de code). Les skills prêts à l’emploi d’Anthropic pour les documents (PowerPoint, Excel, Word, PDF) existent sur claude.ai et l’API, pas dans Claude Code. Un même skill n’est pas synchronisé d’une surface à l’autre : un skill écrit pour Claude Code reste un fichier sur votre machine ou dans votre dépôt.

Skills, CLAUDE.md et commandes

Claude Code offre plusieurs moyens de modifier son comportement, et la question n’est pas de choisir le meilleur mais d’affecter chaque besoin au bon mécanisme :

Mécanisme	Chargement	Usage
CLAUDE.md	À chaque session, en entier	Standards permanents du projet (« toujours TypeScript strict »)
Skill	À la demande, quand la requête correspond ou quand vous tapez `/nom`	Expertise ou procédure liée à une tâche précise
Commande `.claude/commands/`	Idem : les commandes ont été fusionnées dans les skills	Ancien format, toujours fonctionnel ; préférez un skill pour tout nouveau travail

La fusion des commandes est le changement le plus visible de 2026 : un fichier .claude/commands/audit.md et un skill .claude/skills/audit/SKILL.md créent tous deux /audit. Le skill ajoute un dossier pour des fichiers annexes, un en-tête qui contrôle qui peut le déclencher, et le chargement automatique par Claude.

Reconnaître un skill qui attend d’être écrit

Les skills servent au mieux les connaissances attachées à une tâche identifiable : les standards de revue de code de votre équipe, le format de vos messages de commit, votre charte appliquée aux composants d’interface, vos gabarits de documentation, une liste de débogage propre à un framework que vous seul maîtrisez vraiment. Le point commun : la connaissance est précieuse mais ne concerne qu’une fraction de vos échanges. La documentation donne la règle : si vous retapez la même consigne pour démarrer une tâche, ou si vous collez le même mode opératoire pour la troisième fois, c’est un skill.

À vous de jouer

Parcourez vos dernières sessions avec Claude Code (ou /resume pour les relire) et notez les trois consignes que vous avez retapées le plus souvent.
Pour chacune, tranchez : règle permanente (CLAUDE.md) ou procédure liée à une tâche (skill) ?
Tapez / dans une session et parcourez la liste : repérez les skills fournis avec Claude Code (/code-review, /verify, /doctor…). Ils sont écrits dans le même format que ceux que vous allez créer.

Sources officielles : Extend Claude with skills · Agent Skills (API Claude) · Spécification Agent Skills · Extend Claude Code

Points clés à retenir

Un skill est un dossier avec un SKILL.md : une description qui déclenche, des instructions que Claude suit, des fichiers annexes facultatifs
Chargement en trois temps : description toujours en contexte, corps au déclenchement, ressources à la demande
Personnel, projet, plugin, organisation ou compte claude.ai : l’emplacement décide de qui en bénéficie
Les commandes personnalisées ont été fusionnées dans les skills ; le format est le standard ouvert Agent Skills, commun à Claude Code, claude.ai et l’API
Une consigne que vous retapez est un skill qui attend d’être écrit