---
title: "Claude Skills expliqués: comment fonctionnent les Agent Skills"
description: "Les Claude Skills sont des dossiers avec un fichier SKILL.md que Claude ne charge que si votre demande correspond. Ce qu'ils sont et lesquels installer."
type: "guide"
locale: "fr"
category: "Claude Code"
canonical: "https://agenticschool.dev/fr/guides/claude-skills-explained"
datePublished: "2026-08-28"
dateModified: "2026-08-28"
---

# Claude Skills expliqués: comment fonctionnent les Agent Skills

- Category: Claude Code
- Keywords: claude skills, claude code skills, what are claude skills, claude agent skills, claude skills marketplace, how to use claude skills, claude skills vs subagents, best claude skills, how to add skills to claude code, claude skills example, claude skills github, claude design skills
- Canonical URL: https://agenticschool.dev/fr/guides/claude-skills-explained
- Locale: fr

> Les Claude Skills sont des dossiers avec un fichier SKILL.md que Claude ne charge que si votre demande correspond. Ce qu'ils sont et lesquels installer.

Les Claude Skills sont des dossiers. Chacun contient un fichier SKILL.md dont le frontmatter YAML porte deux champs obligatoires, name et description, suivis d'instructions en Markdown, et l'agent ne charge ce contenu que si votre demande correspond à la description. Anthropic appelle la fonctionnalité Agent Skills, l'a publiée comme standard ouvert en décembre 2025, et la prend en charge sur claude.ai, dans Claude Code, dans le Claude Agent SDK et sur la Claude Developer Platform. Ce guide Claude Skills couvre ce qu'est un Claude skill, où les skills fonctionnent, en quoi ils diffèrent des slash commands, des subagents, des MCP servers et de CLAUDE.md, lesquels valent la peine d'être installés, et comment en écrire un en une dizaine de minutes.

## Ce qu'est un Claude skill, en trois couches

Un Claude skill est un répertoire contenant un fichier SKILL.md, et en option des scripts, des documents de référence et des templates à côté. Le fichier s'ouvre sur un frontmatter YAML et continue en instructions Markdown ordinaires. Ce qui fait marcher le format, ce n'est pas le fichier, c'est le modèle de chargement: Anthropic documente un processus en trois étapes appelé progressive disclosure, où l'agent ne lit que les métadonnées au démarrage, tire les instructions dans le contexte quand votre demande correspond, et ne touche aux fichiers embarqués que si la tâche en a réellement besoin. C'est pour cela que vous pouvez installer beaucoup de skills sans payer pour ceux que vous ne déclenchez jamais.

- Niveau 1, métadonnées: les champs name et description, chargés dans le system prompt au démarrage, environ 100 tokens par skill.
- Niveau 2, instructions: le corps du SKILL.md, chargé seulement quand le skill est déclenché, recommandé sous 5 000 tokens.
- Niveau 3, ressources: fichiers de référence et scripts embarqués, qui ne coûtent rien tant qu'ils ne sont pas lus. Un script qui s'exécute n'apporte que sa sortie, jamais son code source.

La description n'est pas de la documentation, c'est la surface de correspondance. C'est le seul texte sur votre skill qui se trouve dans le system prompt avant que quoi que ce soit ne se déclenche, donc la seule chose qui sépare le vôtre de tous les autres skills que Claude peut voir. Anthropic exige qu'elle dise à la fois ce que le skill fait et quand l'utiliser, et une description vague produit un skill qui ne se déclenche jamais.

Tout ce qui figure sur cette page a été lu sur des sources primaires le 28 août 2026: l'Agent Skills overview sur la Claude developer platform, la référence des skills de Claude Code, la spécification Agent Skills publiée, et le dépôt anthropics/skills sur GitHub. Les skills sont sortis en octobre 2025 et la surface bouge encore vite, alors vérifiez les mêmes sources avant de construire quelque chose de coûteux sur un seul détail donné ici.

## Où les Claude Skills fonctionnent, surface par surface

Les skills tournent dans Claude Code, sur claude.ai et via la Claude API, et Anthropic indique que le Claude Agent SDK et la Claude Developer Platform les prennent également en charge. Ce qui change d'une surface à l'autre, c'est où le fichier vit, qui d'autre peut le voir, et quels champs de frontmatter sont légaux. L'avertissement qui piège tout le monde: les skills personnalisés ne se synchronisent pas entre les surfaces. Un skill uploadé sur claude.ai n'est pas disponible via l'API, et les skills de Claude Code vivent sur le système de fichiers et sont séparés des deux. Vous installez le même dossier une fois par surface où vous le voulez.

- Claude Code, où il vit: ~/.claude/skills/name/SKILL.md pour un skill personnel, .claude/skills/name/SKILL.md pour un projet, ou un dossier skills dans un plugin.
- Claude Code, qui peut l'utiliser: vous, toute personne qui clone le dépôt, ou toute personne pour qui le plugin est activé. Le nom du répertoire devient la slash command.
- Claude Code, frontmatter autorisé: tous les champs, y compris les extensions propres à Claude Code comme disable-model-invocation, allowed-tools, model, effort et paths.
- Claude Code, attention à: les skills ont le même accès réseau que n'importe quel autre programme sur votre machine, donc un skill non fiable est un logiciel non fiable.

- claude.ai, où il vit: uploadé sous forme de fichier zip via Settings puis Features.
- claude.ai, qui peut l'utiliser: vous seul. Anthropic indique que les skills personnalisés y sont individuels à chaque utilisateur et ne peuvent pas être gérés centralement par les admins. Plans Pro, Max, Team et Enterprise, code execution activé.
- claude.ai, frontmatter autorisé: uniquement les six champs de la spécification, soit name, description, license, compatibility, metadata et allowed-tools.
- claude.ai, attention à: l'accès réseau varie selon vos réglages utilisateur et admin, donc un skill qui va chercher des données peut se comporter autrement que sur votre machine.

- Claude API, où il vit: créé via les endpoints /v1/skills et référencé par skill_id dans le paramètre container d'une requête.
- Claude API, qui peut l'utiliser: tout le workspace. Anthropic indique que les skills personnalisés uploadés sont partagés à l'échelle du workspace.
- Claude API, frontmatter autorisé: les mêmes six champs de spécification que claude.ai. Une clé inattendue fait échouer l'upload avec une erreur dure, au lieu d'être ignorée.
- Claude API, attention à: les skills exigent le tool code execution et tournent dans un conteneur sandboxé sans accès réseau et sans installation de paquets à l'exécution, donc seuls les paquets préinstallés sont disponibles.

Anthropic livre aussi quatre Agent Skills préconstruits pour les documents: PowerPoint, Excel, Word et PDF, référencés par les skill ids pptx, xlsx, docx et pdf. Ils sont actifs sur claude.ai et disponibles via l'API, et Anthropic indique qu'ils ne sont pas disponibles dans Claude Code, où c'est en revanche le skill open source pour la Claude API qui est livré d'origine.

## Claude Skills face aux agents, subagents, commandes et MCP

Ce ne sont pas des options concurrentes, elles résolvent des problèmes différents, et les confondre est l'erreur la plus fréquente dans tout ce domaine. Claude Skills contre agents est déjà le mauvais cadrage: un agent, c'est tout le système qui fait le travail, et un skill est l'une des choses que vous lui donnez, pas une version réduite de lui. Un skill est une procédure chargée à la demande. Une slash command est désormais la même chose dans un seul fichier, parce qu'Anthropic a fusionné les custom commands dans les skills: un fichier .claude/commands/deploy.md et un skill .claude/skills/deploy/SKILL.md créent tous deux /deploy et se comportent de façon identique, et si les deux existent, le skill gagne. Un subagent est un contexte séparé qui fait le travail et renvoie une conclusion. Un MCP server est une connexion vivante à un système externe. CLAUDE.md est un ensemble de faits chargé à chaque tour.

- Skill: utilisez-le quand vous collez sans arrêt la même procédure en plusieurs étapes et que vous la voulez disponible sans être chargée à chaque tour.
- Slash command: utilisez-la quand un fichier Markdown suffit et qu'il n'y a rien à embarquer. Elle crée la même commande qu'un skill, il n'y a donc aucune raison de migrer une commande qui marche.
- Subagent: utilisez-le quand le travail noierait votre contexte principal et que vous n'avez besoin que de la conclusion.
- MCP server: utilisez-le quand l'agent a besoin de données en direct ou d'une API externe à l'exécution. Des instructions ne peuvent rien aller chercher.
- CLAUDE.md: utilisez-le pour les faits qui s'appliquent à chaque tour. Anthropic conseille de déplacer une section de CLAUDE.md dans un skill dès qu'elle est devenue une procédure plutôt qu'un fait.

Bien poser cette répartition, c'est l'essentiel de ce qui sépare un setup d'agent qui paraît rapide d'un setup qui paraît lourd, et c'est la colonne vertébrale du cours Claude Code que nous enseignons à Agentic School.

## L'anatomie d'un SKILL.md minimal

Un skill qui fonctionne a besoin d'exactement deux champs de frontmatter. La spécification Agent Skills exige name, au plus 64 caractères en lettres minuscules, chiffres et tirets, sans tiret initial, final ou consécutif, et correspondant au nom du répertoire parent. Elle exige description, au plus 1 024 caractères, couvrant à la fois ce que le skill fait et quand l'utiliser. Tout le reste est optionnel. L'exemple ci-dessous est la réponse honnête la plus courte à la question de comment créer des Claude Skills qui tournent partout: il n'utilise que des champs de la spécification, donc le même dossier se charge dans Claude Code, s'uploade sur claude.ai et se package pour la Skills API sans une seule modification.

```markdown
---
name: pr-description
description: Writes a pull request description from the current branch diff. Use when the user asks for a PR description, a pull request summary, or release notes for a branch.
---

# PR description

## Steps

1. Read the diff between the current branch and the default branch.
2. Group the changes by area: features, fixes, refactors, tests.
3. Write a title under 70 characters, then a body with a Summary section and a Testing section.
4. List any migration or config change a reviewer has to apply by hand.

## Rules

- Describe behavior a reviewer can check, not the files you touched.
- Never claim a test passed unless you ran it.
- If the diff is empty, say so and stop.
```
Un SKILL.md complet enregistré dans .claude/skills/pr-description/SKILL.md. Le nom du répertoire devient /pr-description, et la description est ce à quoi le modèle compare votre demande.

- license: la licence qui couvre le skill, soit un nom de licence, soit le nom d'un fichier de licence embarqué.
- compatibility: jusqu'à 500 caractères décrivant les exigences d'environnement, par exemple des paquets système requis ou un accès réseau.
- metadata: une map libre de clés string vers des valeurs string, à lire par votre propre outillage.
- allowed-tools: les tools préapprouvés que le skill peut utiliser, marqués expérimentaux dans la spécification parce que le support varie selon les agents.

Claude Code accepte bien plus de champs que ces six-là, dont argument-hint, arguments, disable-model-invocation, user-invocable, model, effort, context, hooks et paths. Ce sont des extensions Claude Code, pas des éléments du standard. Mettez-en un dans un skill que vous packagez pour claude.ai ou la Skills API et l'upload échoue avec une erreur de clé inattendue nommant le champ fautif, au lieu de l'ignorer silencieusement. Écrivez les six portables si le skill doit voyager, et ne prenez les extensions que pour des skills qui resteront sur votre machine.

## Marketplace, bibliothèque et listes awesome de Claude Skills

Il n'existe pas de marketplace Claude Skills dédié ni de bibliothèque Claude Skills officielle en tant que produit Anthropic séparé. Qui en cherche un tombe sur le système de plugins de Claude Code, qui est le vrai mécanisme de distribution. Anthropic publie son propre dépôt Claude Skills sur GitHub sous anthropics/skills, que vous enregistrez dans Claude Code comme plugin marketplace puis installez sous forme de l'un de ses deux plugins. Anthropic exploite aussi un plugin marketplace officiel, et sa documentation indique que c'est le seul marketplace que Claude Code enregistre de lui-même. Tout le reste, y compris les listes awesome Claude Skills que les gens partagent, est curé par la communauté et non vérifié.

- Dépôt de skills Anthropic: ajoutez anthropics/skills comme plugin marketplace dans Claude Code, puis installez son plugin document-skills ou example-skills. Limite: Anthropic qualifie ce contenu de matériel de démonstration, pas de code de production.
- Plugin marketplace officiel d'Anthropic: anthropics/claude-plugins-official, le seul marketplace que Claude Code enregistre tout seul. Limite: des noms comme agent-skills sont réservés précisément parce que l'usurpation est un risque réel ici.
- Réglages claude.ai: uploadez un dossier de skill en zip via Settings puis Features. Limite: le skill reste privé à votre propre compte et les admins ne peuvent pas le gérer centralement.
- Skills API: créez et uploadez via les endpoints /v1/skills pour un accès à l'échelle du workspace. Limite: exige le tool code execution, et le conteneur n'a pas d'accès réseau.
- Listes communautaires: ComposioHQ maintient awesome-claude-skills sur GitHub, une liste curée de skills et d'outils communautaires. Limite: une liste awesome est un index, pas une revue. Rien de ce qui s'y trouve n'a été audité pour vous.

Anthropic publie aussi un long PDF intitulé The Complete Guide to Building Skills for Claude sur son site de ressources, ce qui est ce qui se rapproche le plus d'un manuel d'écriture officiel pour le format.

Anthropic est direct sur le risque: n'utilisez que des skills que vous avez créés vous-même ou obtenus d'Anthropic, parce qu'un skill peut amener Claude à exécuter du code et à appeler des tools d'une manière qui ne correspond pas à son objectif affiché. Lisez chaque fichier d'un skill avant de l'installer, pas seulement le SKILL.md, et traitez un skill qui va chercher des données à une adresse externe comme la catégorie la plus risquée, puisque le contenu récupéré peut porter ses propres instructions. Installer un skill depuis un dépôt GitHub, c'est installer un logiciel venant d'un inconnu.

## Les Claude Skills à installer en premier

Chaque skill nommé ci-dessous a été vérifié le 28 août 2026 en lisant son propre SKILL.md dans le dépôt anthropics/skills, pas en recopiant le résumé de quelqu'un d'autre. Nous avons choisi pour la largeur plutôt que pour un classement: deux qui vous rendent meilleur pour construire de l'outillage d'agent, deux qui élèvent la qualité de ce que vous livrez, et trois skills de design, la catégorie la plus recherchée après le terme général. La majeure partie de ce dépôt est sous Apache 2.0; les skills de documents pour Word, Excel, PowerPoint et PDF sont source-available plutôt qu'open source.

- skill-creator: crée et édite des skills, et lance des evals qui mesurent avec quelle fiabilité une description se déclenche. Idéal pour qui écrit plus de deux skills. Limite: il corrige la structure et le déclenchement, pas votre connaissance métier.
- mcp-builder: construit des MCP servers en Python avec FastMCP ou en Node et TypeScript avec le MCP SDK. Idéal quand un skill est le mauvais outil et qu'il vous faut une connexion vivante. Limite: la conception du serveur seulement, ni l'hébergement ni l'auth.
- webapp-testing: pilote une application web locale avec Playwright pour vérifier le comportement frontend, capturer des screenshots et lire les logs du navigateur. Idéal pour contrôler un changement dans l'application qui tourne, pas seulement dans les tests. Limite: applications locales uniquement.
- frontend-design: direction esthétique pour une UI nouvelle ou reprise, visant un résultat qui ne se lit pas comme un template par défaut. Idéal pour les builders solo sans designer. Limite: il façonne la typographie, il ne connaît pas votre marque.
- canvas-design: transforme une philosophie de design écrite en affiches et autres pièces statiques, en PNG et PDF. Idéal pour des assets visuels ponctuels. Limite: sortie statique, et il a pour consigne de créer une oeuvre originale plutôt que de copier un artiste.
- theme-factory: applique l'un des dix thèmes de couleurs et de polices préréglés à un deck, un doc ou une page HTML, ou en génère un nouveau. Idéal pour faire ressembler des sorties éparses à un seul système. Limite: il stylise, il ne met pas en page.
- claude-api: une référence à jour sur la Claude API et les SDKs couvrant les model ids, les prix, le streaming, le tool use et le caching dans huit langages. Idéal pour écrire du code contre Claude. Limite: il est déjà livré avec Claude Code.

Deux réserves honnêtes sur l'ensemble. D'abord, Anthropic attache un avertissement explicite à ce dépôt: les skills sont fournis à des fins de démonstration et d'éducation, et ce que Claude fait réellement peut différer de ce que le skill décrit. Ensuite, les meilleurs skills Claude Code pour vous ne sont presque jamais les célèbres. Un skill de trois lignes qui encode la façon dont votre équipe écrit ses messages de commit se déclenche dix fois par jour; un skill de design magnifiquement construit que vous avez installé parce qu'il avait l'air impressionnant reste là à vous coûter 100 tokens par session pour toujours.

## Ce qu'un skill vous coûte vraiment en contexte

Un skill que vous ne déclenchez jamais coûte environ 100 tokens, d'après le tableau de progressive disclosure d'Anthropic lui-même: le name et la description de chaque skill installé se trouvent dans le system prompt dès le démarrage, et rien d'autre. Le coût qui mord arrive après le déclenchement, parce que dans Claude Code le contenu rendu d'un skill invoqué entre dans la conversation comme un message unique et y reste pour le reste de la session. Claude Code ne relit pas le fichier aux tours suivants, donc un skill long est un impôt de longue durée.

- 30 skills installés à environ 100 tokens de métadonnées chacun: environ 3 000 tokens dépensés au démarrage, que vous en utilisiez un seul ou non.
- Un corps de skill au plafond recommandé de 5 000 tokens, invoqué une fois: 5 000 tokens qui restent dans la conversation pour le reste de la session.
- Cinq skills de ce type invoqués dans une même session: environ 25 000 tokens, ce qui est exactement le budget combiné que Claude Code rattache après une auto-compaction.
- Après compaction, Claude Code ne garde que les 5 000 premiers tokens de chaque skill rattaché et remplit ce budget de 25 000 tokens en partant du plus récemment invoqué vers l'arrière, donc les skills invoqués tôt peuvent disparaître entièrement.
- Claude Code plafonne par défaut la liste des skills à 1 pour cent de la context window du modèle, et plafonne chaque entrée à 1 536 caractères de texte de description, en supprimant d'abord les descriptions de vos skills les moins utilisés en cas de débordement.

La règle qui tombe de ce calcul: gardez la description tranchante et le corps court, et poussez tout ce qui est long dans des fichiers de référence qui ne se chargent que si la tâche va les chercher. La spécification d'Anthropic recommande de garder le SKILL.md sous 500 lignes exactement pour cette raison. C'est la même discipline de budget de contexte que notre matériel Claude Code applique au reste d'une session d'agent, et c'est pourquoi la longueur d'un skill est une contrainte de conception plutôt qu'un détail.

## Quand il ne faut pas écrire de skill du tout

La plupart de ce que les gens empaquettent en skill ne devrait pas être un skill. Une instruction ponctuelle appartient au prompt que vous êtes déjà en train de taper. Un fait qui s'applique à chaque tour appartient à CLAUDE.md, où il est toujours chargé. Une source de données externe en direct appartient à un MCP server, parce que des instructions écrites ne peuvent rien aller chercher. Un travail qui noierait votre contexte principal appartient à un subagent. Et tout ce qui doit se produire à chaque fois, sans que le modèle ait voix au chapitre, appartient à un hook. Un skill n'est la bonne réponse que pour une procédure répétable que vous voulez disponible sans être chargée en permanence.

- Instruction ponctuelle: mettez-la dans le prompt. Un skill que vous invoquez une fois vous a coûté le temps de l'écrire, puis environ 100 tokens de métadonnées dans chaque session ensuite.
- Règle ou fait de projet: mettez-le dans CLAUDE.md. Anthropic trace la ligne exactement à cet endroit, en notant que le corps d'un skill ne se charge que lorsqu'il est utilisé, contrairement au contenu de CLAUDE.md.
- Données en direct ou API externe: construisez un MCP server. Un skill peut décrire une API, il ne peut pas en appeler une à laquelle l'agent n'a aucune connexion.
- Une longue investigation qui remplirait votre contexte: confiez-la à un subagent et ne gardez que la conclusion.
- Une garantie plutôt qu'une suggestion, comme bloquer un mauvais commit: utilisez un hook. Un skill, ce sont des instructions que le modèle peut refuser de suivre, et Anthropic conseille les hooks quand un comportement doit être imposé de façon déterministe.

Le test le plus simple, c'est de savoir si vous pouvez dire à voix haute quand le skill devrait se déclencher. Si vous n'y arrivez pas, sa description ne le dira pas non plus, et vous avez écrit un document plutôt qu'un skill.

## Ce que vous devriez mettre en place cette semaine

Trois choses tranchent la question à chaque fois: sur quelle surface vous travaillez réellement, si le skill doit voyager entre surfaces, et si ce que vous empaquetez est une procédure ou un fait. Une fois ces trois points réglés, la construction elle-même tient dans un dossier et un fichier.

- Une personne seule qui livre dans Claude Code: créez ~/.claude/skills/name/SKILL.md pour les deux procédures que vous retapez le plus, et utilisez le frontmatter Claude Code complet. Vous n'avez pas besoin de la portabilité des six champs tant qu'un skill ne quitte pas votre machine.
- Une petite équipe sur un dépôt: mettez les skills dans .claude/skills/ et committez-les, pour que la procédure parte avec le code et que la prochaine recrue en hérite. Ajoutez disable-model-invocation: true à tout ce qui a un effet de bord, comme un deploy.
- Travail documentaire et de communication sur claude.ai: les skills préconstruits PowerPoint, Excel, Word et PDF sont déjà actifs et ne demandent aucune configuration. Uploadez un skill personnalisé pour votre style maison, et rappelez-vous qu'il reste privé à votre compte.
- Construction sur la Claude API: uploadez via les endpoints /v1/skills pour un accès à l'échelle du workspace, limitez le frontmatter aux six champs de la spécification, et concevez pour un conteneur sans accès réseau et sans installation de paquets.

Si vous ne faites qu'une seule chose: prenez la procédure que vous avez collée deux fois dans un chat cette semaine, mettez-la dans un dossier avec un SKILL.md, et écrivez une description qui nomme les mots que vous diriez vraiment quand vous la voulez. Le cours Claude Code gratuit d'Agentic School montre comment en construire un de bout en bout.

## Steps

### 1. Choisissez la procédure que vous répétez sans cesse

Prenez quelque chose que vous avez collé plus de deux fois dans un chat: une checklist de release, une routine de revue, un format de rapport. Si c'est un fait plutôt qu'une procédure, sa place est dans CLAUDE.md.

### 2. Créez le dossier du skill

Créez un répertoire dont le nom est en lettres minuscules, chiffres et tirets, au plus 64 caractères, sans tiret initial, final ou consécutif. Dans Claude Code, ce nom de répertoire devient la slash command que vous tapez.

### 3. Écrivez les deux champs de frontmatter obligatoires

Créez SKILL.md dans le dossier, en ouvrant sur un frontmatter YAML qui définit name, identique au nom du répertoire, et description, jusqu'à 1 024 caractères disant à la fois ce que le skill fait et quand l'utiliser. La description est le seul texte chargé au démarrage, alors mettez-y les mots déclencheurs.

### 4. Écrivez le corps comme des instructions, pas comme de la prose

Sous le frontmatter, écrivez des étapes numérotées et des règles explicites. Gardez SKILL.md sous 500 lignes, ce qui est la recommandation d'Anthropic, et déplacez le matériel de référence long dans des fichiers séparés du dossier pour qu'il ne se charge que si la tâche en a besoin.

### 5. Mettez le dossier là où la surface le lit

Pour Claude Code, utilisez ~/.claude/skills/name/ en personnel ou .claude/skills/name/ dans le dépôt pour un projet. Pour claude.ai, zippez le dossier et uploadez-le via Settings puis Features. Pour l'API, créez-le via les endpoints /v1/skills. Les skills ne se synchronisent pas entre ces surfaces, installez-le donc sur chacune où vous le voulez.

### 6. Gardez-le portable s'il doit voyager

Si le même skill doit tourner sur plus d'une surface, limitez le frontmatter aux six champs de la spécification: name, description, license, compatibility, metadata et allowed-tools. Un champ propre à Claude Code comme argument-hint fait échouer un upload sur claude.ai ou sur la Skills API avec une erreur de clé inattendue.

### 7. Vérifiez qu'il est bien chargé

Dans Claude Code, demandez quels skills sont disponibles et confirmez que le vôtre est listé avec sa description, puis invoquez-le directement par sa slash command. Si la commande marche mais que la description manque, le YAML n'a pas été parsé: lancez claude plugin validate sur votre répertoire de skills, ou démarrez avec le flag de debug pour voir l'erreur de parsing.

## FAQ

### Qu'est-ce que les Claude Skills?

Les Claude Skills sont des dossiers qui donnent à Claude une capacité précise. Chaque dossier contient un fichier SKILL.md avec un frontmatter YAML portant deux champs obligatoires, name et description, suivis d'instructions Markdown, plus les scripts ou fichiers de référence que vous voulez embarquer. Anthropic appelle la fonctionnalité Agent Skills et l'a publiée comme standard ouvert en décembre 2025. Claude ne charge au démarrage que les quelque 100 tokens de métadonnées et ne lit les instructions complètes que si votre demande correspond à la description.

### Comment ajouter des skills à Claude Code?

Créez un répertoire à ~/.claude/skills/nom-de-votre-skill/ pour un skill personnel, ou .claude/skills/nom-de-votre-skill/ dans un dépôt pour un skill de projet, et mettez-y un fichier SKILL.md avec name et description dans le frontmatter. Le nom du répertoire devient la slash command. Claude Code charge aussi les skills depuis les plugins, vous pouvez donc installer un ensemble publié en ajoutant un plugin marketplace, par exemple le dépôt anthropics/skills d'Anthropic, puis en installant son plugin document-skills ou example-skills.

### Comment créer un Claude skill?

Créez un dossier, ajoutez un fichier SKILL.md, et donnez-lui deux champs de frontmatter. Le name doit faire au plus 64 caractères en lettres minuscules, chiffres et tirets, ne doit pas commencer ni finir par un tiret, ne doit pas contenir de tirets consécutifs, et doit correspondre au nom du dossier. La description doit faire au plus 1 024 caractères et doit indiquer à la fois ce que le skill fait et quand l'utiliser, parce que c'est le texte auquel le modèle compare votre demande. Tout ce qui est sous le frontmatter est de l'instruction Markdown ordinaire, et Anthropic recommande de garder le fichier sous 500 lignes.

### Quelle est la différence entre les Claude Skills et les subagents?

Claude Skills contre subagents est une différence de nature, pas de taille. Un skill est du contenu: des instructions et des fichiers chargés dans la conversation en cours quand votre demande correspond à sa description, pour un coût d'environ 100 tokens de métadonnées tant qu'il ne se déclenche pas. Un subagent est un contexte séparé qui part, travaille avec ses propres tools et ne renvoie qu'une conclusion, ce qui empêche une longue investigation de remplir votre context window principale. Utilisez un skill quand vous voulez que l'agent suive une procédure connue. Utilisez un subagent quand le travail lui-même noierait votre contexte et que vous n'avez besoin que de la réponse.

### Existe-t-il un marketplace officiel de Claude Skills?

Il n'existe pas de produit marketplace de skills séparé chez Anthropic. La distribution passe par le système de plugins de Claude Code: Anthropic publie un plugin marketplace officiel à anthropics/claude-plugins-official, que sa documentation décrit comme le seul marketplace que Claude Code enregistre de lui-même, et ses skills open source vivent dans le dépôt anthropics/skills, que vous pouvez enregistrer vous-même comme plugin marketplace. Sur claude.ai, vous uploadez un zip via Settings puis Features, et sur la Claude API vous uploadez via les endpoints /v1/skills. Les index communautaires comme awesome-claude-skills de ComposioHQ listent des skills tiers mais n'en auditent aucun.

### Les Claude Skills fonctionnent-ils en dehors de Claude Code?

Oui. Anthropic indique que les Agent Skills sont pris en charge sur claude.ai, dans Claude Code, dans le Claude Agent SDK et sur la Claude Developer Platform, et le format a été publié comme standard ouvert pour que d'autres produits d'agents puissent l'adopter. Le piège, c'est que les skills personnalisés ne se synchronisent pas entre les surfaces: un skill uploadé sur claude.ai n'est pas disponible via l'API, et les skills de Claude Code vivent sur le système de fichiers et sont séparés des deux. Le frontmatter diffère aussi, puisque claude.ai et la Skills API n'acceptent que les six champs de la spécification alors que Claude Code en accepte bien plus.

### Quels sont les meilleurs Claude Skills?

Pour la plupart des builders, les meilleurs Claude Skills sont les petits que vous écrivez vous-même, parce qu'un skill qui encode la façon dont votre équipe travaille vraiment se déclenche tous les jours, alors qu'un skill célèbre reste en général inutilisé à environ 100 tokens par session. Si vous voulez un ensemble de départ tiré du dépôt d'Anthropic: skill-creator vous aide à écrire et à évaluer d'autres skills, mcp-builder couvre la construction de MCP servers en Python ou TypeScript, webapp-testing pilote une application locale avec Playwright, et frontend-design, canvas-design et theme-factory sont les skills de design. Anthropic qualifie ce dépôt de matériel de démonstration et d'éducation, alors auditez tout avant d'installer.