Claude Skills : comment fonctionnent les Agent Skills et comment créer les vôtres


Image de couverture - Claude Skills : comment fonctionnent les Agent Skills et comment créer les vôtres

Les Claude Skills, ou Agent Skills, sont des dossiers d’instructions, de scripts et de ressources que Claude découvre et charge à la demande pour exécuter une tâche précise de façon fiable et reproductible. Chaque skill repose sur un fichier SKILL.md avec un en-tête YAML (nom et description) et fonctionne par divulgation progressive : seules les métadonnées sont chargées au démarrage, le contenu complet ne l’est que si la tâche le justifie. Lancées le 16 octobre 2025, les skills sont disponibles sur claude.ai pour les abonnés Pro, Max, Team et Enterprise, dans Claude Code et via l’API.

Qu’est-ce qu’une Claude Skill exactement ?

Une skill est la réponse d’Anthropic à un problème que vous avez forcément rencontré : répéter les mêmes consignes à chaque conversation. Plutôt que de recopier votre charte graphique, votre format de rapport ou votre procédure interne, vous les packagez une fois dans un dossier que Claude mobilise automatiquement quand la demande s’y prête, comme l’explique l’annonce officielle.

Anthropic fournit déjà des skills prêtes à l’emploi pour les tâches documentaires courantes :

  • feuilles Excel avec formules fonctionnelles ;
  • présentations PowerPoint ;
  • documents Word ;
  • PDF remplissables.

Les premiers retours d’entreprises donnent la mesure du gain. Box transforme ses fichiers stockés en présentations aux couleurs de la marque, Notion enchaîne question et exécution, Canva adapte ses agents aux workflows de design.

Chez Rakuten, une skill de traitement de feuilles de calcul a ramené une tâche comptable d'une journée complète à une heure.

Un dossier organisé autour d’un fichier SKILL.md

Techniquement, une skill est un simple répertoire contenant un fichier SKILL.md. Celui-ci commence obligatoirement par un en-tête YAML avec deux champs : name (le nom de la skill) et description (ce qu’elle fait et quand l’utiliser). Le corps du fichier contient ensuite vos instructions, et peut référencer d’autres fichiers du dossier, comme reference.md pour la documentation avancée ou des scripts exécutables.

Anatomie d'un fichier SKILL.md avec son en-tete YAML name et description
L’anatomie d’un SKILL.md : en-tête YAML puis instructions. Source : documentation d’ingénierie Anthropic.

La divulgation progressive en trois niveaux

Le mécanisme clé s’appelle progressive disclosure, la divulgation progressive. Au démarrage, l’agent ne précharge que le nom et la description de chaque skill installée : juste assez pour savoir quand elle est pertinente. Si votre demande correspond, Claude charge alors le SKILL.md complet, puis, seulement si la tâche l’exige, les fichiers annexes référencés.

Anthropic compare ce fonctionnement à un manuel : la table des matières d’abord, le chapitre ensuite, l’annexe si besoin. Conséquence directe : la quantité de savoir-faire que vous pouvez embarquer dans une skill est quasi illimitée, puisqu’elle ne pèse sur la fenêtre de contexte qu’au moment utile.

Schema de la divulgation progressive des Claude Skills en trois niveaux
La divulgation progressive : métadonnées, puis SKILL.md, puis fichiers annexes. Source : Anthropic.

Skills, MCP et outils : quelles différences ?

Si vous suivez l’écosystème Claude, vous connaissez déjà le principe d’un MCP, le protocole qui connecte l’IA à des services externes. Les skills ne le remplacent pas : elles s’y superposent. Un serveur MCP donne l’accès à un logiciel, la skill enseigne le mode d’emploi métier qui va avec.

ApprocheCe qu’elle apporte à Claude
SkillUn savoir-faire complet : instructions, scripts et ressources chargés à la demande
Serveur MCPUne connexion à des services et données externes (CRM, base, navigateur…)
Outil classiqueUne fonction unique exposée au modèle, sans contexte métier

Autre différence structurante : une skill peut embarquer du code exécutable. La skill PDF d’Anthropic contient par exemple un script Python d’extraction de champs de formulaires que Claude exécute directement, sans même charger le script dans son contexte.

Un script embarqué s'exécute de façon déterministe et ne consomme pas de tokens de génération : pour les opérations répétitives, c'est plus fiable et moins cher que de laisser le modèle improviser.
Schema du flux d'execution de code au sein d'une Claude Skill
Le flux d’exécution de code dans une skill. Source : documentation d’ingénierie Anthropic.

Où activer les Claude Skills ?

Les skills couvrent aujourd’hui l’ensemble des produits Claude, avec trois portes d’entrée selon votre profil.

Sur claude.ai : abonnés Pro, Max, Team et Enterprise

Rendez-vous dans Réglages puis Capacités : vous y activez les skills une par une et téléversez les vôtres au format zip via le bouton Upload skill. Sur les offres Team et Enterprise, un administrateur doit d’abord activer la fonction pour l’organisation. L’exécution de code et la création de fichiers doivent également être actives, car les skills s’appuient dessus.

Dans Claude Code et via l’API

Dans Claude Code, la commande /plugin ouvre directement la marketplace : vous parcourez le catalogue anthropics/skills et installez une skill en quelques secondes, sans quitter le terminal. Vous pouvez aussi déposer simplement vos dossiers de skills dans ~/.claude/skills. Côté API, l’endpoint /v1/skills et l’outil d’exécution de code (en bêta) permettent d’attacher des skills à vos agents en production.

Le marketplace /plugin de Claude Code : onglet Discover avec 252 plugins, dont skill-creator
Le marketplace /plugin dans Claude Code : 252 plugins disponibles, dont skill-creator (347 500 installations). Capture d’écran du 7 juillet 2026.

Le dépôt public github.com/anthropics/skills centralise les skills officielles et communautaires. Avec plus de 150 000 étoiles, c’est devenu l’un des dépôts les plus populaires de GitHub, et le README rappelle la spécification ouverte agentskills.io adoptée au-delà de Claude.

Capture d'ecran du depot GitHub anthropics/skills avec 154k etoiles
Le dépôt anthropics/skills sur GitHub, capture du 7 juillet 2026.

Comment créer votre propre skill ?

Générateur de SKILL.md

Décrivez votre skill, l'outil génère le fichier SKILL.md prêt à déposer dans le dossier de votre agent (claude.ai, Claude Code ou API).

Arborescence du dossier

Contenu de SKILL.md

Vous n’avez besoin d’aucun outil de build : un dossier, un fichier texte, et votre skill existe. Utilisez le générateur de SKILL.md proposé dans cette section pour produire votre premier fichier, puis affinez-le à l’usage.

Plus simple encore : demandez directement à Claude de créer la skill à votre place. Décrivez la tâche en langage naturel (par exemple : créez-moi une skill qui rédige mes rapports hebdomadaires au format maison) et il génère lui-même le dossier complet, SKILL.md et fichiers annexes compris, que vous n’avez plus qu’à relire.

La structure minimale pour démarrer

Le strict minimum tient en trois éléments : un dossier au nom de votre skill, un SKILL.md avec l’en-tête YAML (name, description) et un corps d’instructions. La description mérite un soin particulier : c’est elle que Claude lit pour décider de déclencher la skill, précisez donc le quoi ET le quand. Anthropic propose aussi une skill nommée skill-creator qui vous guide de façon interactive dans la création, sans éditer les fichiers à la main.

Les bonnes pratiques recommandées par Anthropic

L’équipe d’ingénierie d’Anthropic recommande une démarche pilotée par l’observation plutôt que par l’intuition :

  • partez des échecs réels : faites tourner votre agent sur des tâches représentatives et identifiez où il se trompe ;
  • scindez les SKILL.md volumineux en fichiers référencés pour économiser des tokens ;
  • observez comment Claude utilise la skill en conditions réelles et itérez ;
  • demandez à Claude d’analyser ses propres échecs et de capturer les approches gagnantes dans la skill.

Sécurité : n’installez que des skills de confiance

Une skill donne à Claude de nouvelles capacités par des instructions et du code exécuté : une skill malveillante peut donc introduire de vraies vulnérabilités. Avant toute installation, vérifiez la source, auditez les scripts embarqués, leurs dépendances et toute instruction demandant un accès réseau externe.

Limitez-vous aux skills officielles d’Anthropic, à celles de votre organisation ou à du code que vous avez relu. Pour aller plus loin, la documentation officielle des Agent Skills détaille le format complet et les options d’intégration API.


Articles à ne pas manquer

  • L’IA dans l’administration d’un site : les assistants d’hébergement changent-ils la donne ?

    L’IA dans l’administration d’un site : les assistants d’hébergement changent-ils la donne ?

    Jusqu’à récemment, la gestion d’un site internet nécessitait une bonne connaissance du panneau d’administration, des bases de la configuration des serveurs et la capacité de résoudre soi-même certains problèmes techniques. Le développement de l’intelligence artificielle transforme progressivement cette approche. Les outils modernes peuvent analyser les paramètres d’hébergement, détecter des anomalies et faciliter les tâches quotidiennes.…

  • Factures ChatGPT : TVA et comptabilisation pour un professionnel

    Factures ChatGPT : TVA et comptabilisation pour un professionnel

    Une facture ChatGPT ou API payée par une entreprise française arrive normalement hors taxe, avec la mention « Reverse Charge ». Ce n’est pas une exonération : c’est à vous de calculer la TVA française à 20 %, de la déclarer comme TVA due et de la déduire sur la même déclaration. Pour que ce…

  • Candy AI avis : test complet, prix et limites (2026)

    Candy AI avis : test complet, prix et limites (2026)

    Candy AI vaut son abonnement si vous cherchez un compagnon IA avec images et personnages prêts à l’emploi, à condition de prendre la formule annuelle à 3,99 € par mois. La version gratuite sert surtout de vitrine : lors de mon test, l’écran d’abonnement est arrivé après cinq messages et la seule image reçue était…