Guide

Claude Code skills : à quoi ça sert et comment créer le tien

Les skills de Claude Code sont des dossiers d’instructions que l’agent charge quand une tâche correspond à leur description : chaque skill contient un fichier SKILL.md qui explique à Claude comment faire un travail précis, à ta façon. Tu peux laisser Claude les déclencher automatiquement quand c’est pertinent, ou en appeler un directement en tapant /nom-du-skill. C’est le moyen le plus simple de transformer une procédure que tu réexpliques sans arrêt en savoir-faire installé une fois pour toutes — et ça ne demande pas de savoir coder.

Un skill, c’est quoi exactement ?

Un skill est un dossier qui contient un fichier SKILL.md. Ce fichier a deux parties : un court en-tête avec une description — c’est elle qui dit à Claude quand utiliser le skill — puis des instructions en Markdown, du texte ordinaire : les étapes à suivre, tes règles, le format de sortie attendu.

Le dossier peut aussi embarquer des fichiers d’appui : modèles de documents, références, scripts. Et c’est là que le format est malin : tant que le skill ne sert pas, seule sa description occupe la mémoire de travail de Claude. Le contenu complet n’est chargé que lorsqu’une tâche le demande.

  • Un skill « compte-rendu » qui transforme tes notes de réunion en CR structuré, toujours au même format.
  • Un skill « relecture » qui applique ta checklist avant chaque envoi de document.
  • Un skill « proposition commerciale » qui suit ta trame, tes mentions et ton ton.

Skill ou CLAUDE.md : lequel utiliser ?

Les deux sont des instructions écrites, mais ils ne travaillent pas pareil. Le CLAUDE.md (ou AGENTS.md) est lu à chaque session : il porte ce qui est toujours vrai — qui tu es, ton métier, tes règles générales. Un skill, lui, n’est chargé que quand on en a besoin : il porte une procédure, un savoir-faire ponctuel.

Le critère donné par la documentation officielle est concret : si tu recolles sans arrêt les mêmes consignes dans le chat, ou si une section de ton CLAUDE.md est devenue une procédure en dix étapes plutôt qu’un fait, c’est qu’elle mérite de devenir un skill.

Où ranger tes skills

L’emplacement du dossier décide de sa portée. Un skill placé dans ~/.claude/skills/ est personnel : il te suit dans tous tes projets. Un skill placé dans .claude/skills/ à la racine d’un projet ne vaut que pour ce projet — et comme c’est un simple dossier de fichiers texte, il se partage avec une équipe comme n’importe quel document du projet.

Bon à savoir : Claude Code surveille ces dossiers. Ajouter ou modifier un skill est pris en compte dans la session en cours, sans redémarrer.

Créer ton premier skill, pas à pas

Pas besoin d’outil spécial : un skill, c’est un dossier et un fichier texte. Le plus dur n’est pas technique — c’est de décrire ta procédure clairement, comme tu l’expliquerais à quelqu’un qui te remplace.

  • Crée un dossier au nom du skill, par exemple ~/.claude/skills/compte-rendu/.
  • Écris dedans un fichier SKILL.md : en haut, une description qui dit quand l’utiliser (« Transforme des notes de réunion en compte-rendu structuré… ») ; en dessous, les étapes et le format attendu.
  • Teste : tape /compte-rendu dans Claude Code, ou décris la tâche et regarde si le skill se déclenche tout seul.
  • Affine la description si le skill se déclenche trop ou pas assez — c’est elle qui pilote le déclenchement.

Un format ouvert qui dépasse Claude Code

Les skills suivent le standard ouvert Agent Skills, publié par Anthropic (spécification sur agentskills.io). Le même dossier SKILL.md est repris par d’autres outils d’agents, dont Codex d’OpenAI : ce que tu écris pour Claude Code n’est pas enfermé chez un éditeur.

Tu n’es pas non plus obligé·e de partir de zéro : Anthropic maintient un dépôt public d’exemples de skills sur GitHub (anthropics/skills), utile pour voir comment les bons skills sont rédigés avant d’écrire le tien.

Skills + Dossier-Contexte : les deux pièces d’un workspace

Un skill décrit comment faire une tâche. Mais pour bien travailler, Claude Code a aussi besoin de savoir pour qui il travaille : ton métier, tes clients, tes règles. C’est le rôle du Dossier-Contexte — un AGENTS.md et des fichiers d’appui qu’il lit avant de commencer. Skills sans contexte : des procédures appliquées à l’aveugle. Contexte sans skills : un assistant qui te connaît mais réinvente la méthode à chaque fois.

Le kit Workspace IA Claude Code prépare cette deuxième pièce pour toi : tu réponds à quelques questions sur ton métier, et ton Dossier-Contexte est généré — rôle de l’IA, règles, missions types, exemples. Le kit est en cours de construction : inscris-toi sur sa page pour être prévenu·e à la sortie.

Questions fréquentes
Faut-il savoir coder pour créer un skill Claude Code ?

Non. Un skill est un dossier contenant un fichier SKILL.md écrit en Markdown — du texte ordinaire. Si tu sais rédiger une procédure claire, tu sais écrire un skill. Les scripts et automatisations sont possibles, mais optionnels.

Quelle différence entre un skill et un prompt enregistré ?

Un prompt se recolle dans le chat à chaque fois, à la main. Un skill est installé : Claude le déclenche tout seul quand la tâche correspond à sa description, tu peux l’appeler avec /nom-du-skill, et il peut embarquer des fichiers d’appui — modèles, références, scripts.

Où trouver des skills déjà prêts ?

Anthropic maintient un dépôt public d’exemples sur GitHub (anthropics/skills), et des skills se partagent aussi via les plugins de Claude Code. Le plus utile reste souvent d’écrire les tiens : ce sont tes procédures qui ont de la valeur.

Les skills fonctionnent-ils ailleurs que dans Claude Code ?

Oui. Le format suit le standard ouvert Agent Skills (agentskills.io), publié par Anthropic et repris par d’autres outils d’agents, dont Codex d’OpenAI. Vérifie la documentation de chaque outil pour les détails de prise en charge.

Le kit lié

Kit Workspace IA Claude Code

Les skills disent à Claude Code comment faire. Le Dossier-Contexte lui dit pour qui il travaille — AGENTS.md, règles, missions, exemples, générés à partir de ton métier. Le kit est en cours de construction : inscris-toi pour être prévenu·e à la sortie.