La réponse courte
Un Skill est un dossier qui contient un fichier SKILL.md. Le fichier commence par un court en-tête avec un name et une description, suivi des instructions. Votre agent ne garde en tête que le nom et la description jusqu’à ce qu’une demande corresponde, puis lit le reste. Le même dossier fonctionne dans Claude Code, Codex et Cursor.
Pourquoi les Skills existent
Vous l’avez sans doute déjà fait
Vous gardez un prompt de 40 lignes pour vos pages de lancement. Il détaille la mise en page, les sections et les vérifications en largeur mobile. Vous le collez à chaque fois, oubliez une ligne un jour, et la page sort différente. Puis un collègue vous demande « ce fameux prompt » et vous lui envoyez la version du mois dernier.
Un Skill transforme ce prompt en un dossier que votre agent trouve tout seul. Prenez Meridian Marketing Landing : une fois installé, l’agent connaît déjà le Hero sur papier millimétré, la grille de fonctionnalités et le sélecteur de tarifs. Vous apportez les informations sur votre produit, rien de plus.
La plupart des exemples de Claude Skills suivent le même schéma : une méthode fixe pour un type de résultat. Notion Style OG Image crée une image de partage en 16:9, et d’autres Skills sur Skillry produisent des présentations, des sites CV et des vidéos courtes.
| Prompt collé | Skill | |
|---|---|---|
| Ce que vous expliquez | Mise en page, sections, style et vérifications, à chaque fois | Uniquement votre contenu |
| D’une exécution à l’autre | Dérive un peu à chaque fois | Suit les mêmes étapes |
| Partage | À retrouver dans l’historique de vos chats | Installer le même dossier |
Que contient un fichier SKILL.md ?
Un Skill a besoin d’un seul fichier, SKILL.md, et peut inclure des dossiers facultatifs pour la documentation de référence, des scripts et des modèles. Le fichier comporte deux parties : un court en-tête entre des lignes ---, puis des instructions en langage courant destinées à l’agent.
launch-page/
├── SKILL.md required
├── references/ optional: docs read when needed
├── scripts/ optional: code the agent can run
└── assets/ optional: templates and files---
name: launch-page
description: Build a product launch page with a hero, a feature
grid, and a pricing toggle. Use when asked for a launch page.
---
1. Ask for the product name, audience, and three features.
2. Build the hero, the feature grid, and the pricing section.
3. Check the page at phone width before you finish.name
Jusqu’à 64 caractères : lettres minuscules, chiffres et tirets. Il doit correspondre au nom du dossier.
description
Jusqu’à 1 024 caractères. Dites ce que fait le Skill et quand l’utiliser ; l’agent s’appuie sur cette seconde partie pour le choisir.
Facultatif
license, compatibility, metadata, allowed-tools
Ces limites proviennent de la spécification Agent Skills, qui est ouverte. Claude Code est plus souple : vous pouvez omettre name, il utilise alors le nom du dossier.
Comment un agent décide-t-il quel Skill utiliser ?
Il compare votre demande à la description de chaque Skill. Pour que cela reste peu coûteux, il charge chaque Skill en trois étapes :
- 1Au démarrage, il lit le nom et la description de chaque Skill installé. Rien d’autre.
- 2Quand votre demande correspond à une description, ou que vous appelez le Skill par son nom, il charge le
SKILL.mdcomplet. - 3Pendant le travail, il ouvre les fichiers de
references/ou exécutescripts/uniquement quand les instructions le lui demandent.
C’est pourquoi vous pouvez installer des dizaines de Skills sans ralentir votre agent. Tant qu’un Skill n’est pas nécessaire, il occupe environ une phrase de contexte.
| Agent | Appeler un Skill par son nom |
|---|---|
| Claude Code | /skill-name |
| Codex | $skill-name, ou choisissez-le dans /skills |
| Cursor | /skill-name, ou @skill-name pour le joindre |
Le choix automatique ne vaut que ce que vaut la description. Déclenchement montre comment en rédiger une qui sera retenue. En attendant, appeler le Skill par son nom fonctionne toujours.
Quels agents peuvent utiliser les Skills ?
La plupart des agents dont vous avez entendu parler. Anthropic a créé le format pour Claude et l’a publié comme standard ouvert le 18 décembre 2025. Le site agentskills.io répertorie désormais des dizaines d’outils qui le lisent, dont Claude Code, ChatGPT et Codex, Cursor, VS Code, GitHub Copilot et Gemini CLI.
| Agent | Dossier personnel |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.agents/skills/ (lit aussi l’ancien ~/.codex/skills/) |
| Cursor | ~/.cursor/skills/ ou ~/.agents/skills/ |
Un Skill placé dans votre dossier personnel est disponible dans tous les projets de votre ordinateur. Les dossiers de projet et tous les autres endroits où un agent cherche sont listés dans Emplacements des Skills.
Skill ou prompt : lequel utiliser ?
Faites-en un Skill quand vous allez répéter la tâche et voulez la même qualité à chaque fois. Pour une tâche ponctuelle, un prompt suffit.
Vous referez cette tâche
- Elle nécessite des exemples, des scripts ou une checklist
- Vous voulez le même résultat à chaque fois
- D’autres personnes en ont aussi besoin
C’est ponctuel
- Quelques phrases suffisent
- Vous cherchez encore ce que vous voulez
- Rien ne mérite d’être réutilisé
La plupart du temps, vous utilisez les deux. Le prompt dit ce que vous voulez aujourd’hui, et le Skill dit comment bien le faire. Skills vs prompts approfondit le sujet.
Ce qu’il faut vérifier avant d’installer un Skill
Un Skill peut exécuter des scripts sur votre ordinateur : lisez donc rapidement chaque nouveau Skill avant de l’installer.
Une vérification en cinq minutes
- Lisez
SKILL.mdet notez ce qu’il est autorisé à modifier. - Lisez tout le contenu de
scripts/. Ces scripts s’exécutent sur votre machine. - Vérifiez Dépendances et Coûts externes sur la page du Skill.
- Ne mettez ni mots de passe ni clés API dans les fichiers du Skill ou dans le chat.
La liste complète se trouve dans Sécurité. Quand vous êtes prêt à en essayer un, Premiers pas vous guide pour votre première installation.
Questions fréquentes
Que sont les Claude Skills ?
C’est ainsi que la plupart des gens appellent les Agent Skills quand ils les utilisent dans Claude ou Claude Code. Le format est le même : un dossier contenant un fichier SKILL.md. Ce même dossier fonctionne aussi dans Codex et Cursor.
Comment Claude sait-il quel Skill utiliser ?
Il compare votre demande à la description de chaque Skill et charge celui qui correspond. Taper /skill-name évite toute devinette.
Puis-je utiliser les Claude Skills gratuitement ?
Un Skill n’est qu’un ensemble de fichiers : un Skill gratuit ne coûte donc rien. Il vous faut tout de même un agent compatible avec les Skills, comme Claude Code, Codex ou Cursor, avec l’abonnement requis par ce produit. Skillry propose aussi des Skills gratuits, comme Dot Avatar Maker.
Un Skill est-il la même chose qu’un serveur MCP ?
Non. Un Skill apprend une méthode à l’agent, tandis qu’un serveur MCP le connecte à des données et des outils externes. On les utilise souvent ensemble. Voir Skills vs MCP.
Sources
Ce guide vous a-t-il aidé ?