Anthropic explique comment créer des skills pour Claude Code et pourquoi les équipes ont besoin de leur propre marketplace

Anthropic a publié un guide détaillé sur les skills pour Claude Code : des extensions qui aident l'agent à mieux travailler avec le code, les données et les processus internes. L'entreprise affirme utiliser déjà des centaines de ces skills et avoir constaté en pratique lesquelles améliorent vraiment la qualité du travail et lesquelles ne font que gonfler le contexte.

Quelles skills fonctionnent

La thèse principale du guide : une skill n'est pas seulement un fichier markdown contenant des instructions, mais un dossier complet avec configurations, scripts, modèles, données et même des hooks. C'est pourquoi Anthropic conseille de déterminer d'abord le type de skill, puis d'en écrire le contenu.

D'après l'entreprise, les meilleures skills résolvent généralement une seule tâche bien définie. Celles qui tentent d'être à la fois référentiel, pilote automatique, runbook et générateur de code embrouillent le plus souvent le modèle au lieu de l'aider.

• Références pour les API, les SDK et les bibliothèques internes
• Skills de vérification du produit via le navigateur, la CLI et des assertions
• Outils d'analyse de données, de métriques et de monitoring
• Modèles pour le scaffolding, les tests et la revue de code
• Skills pour le CI/CD, les runbooks et les opérations d'infrastructure

Anthropic met à part les skills de vérification et les skills opérationnelles. Dans le premier cas, l'agent ne se contente pas d'écrire du code : il exécute lui-même le scénario, contrôle les étapes et consigne le résultat. Dans le second, il dispose de garde-fous pour les actions sensibles comme le nettoyage de ressources, la mise en production ou le traitement des alertes. Ces skills sont particulièrement précieuses là où une erreur coûte cher : en production, pour les paiements, l'onboarding et les plateformes internes. Ce sont ces scénarios qui montrent le mieux si une skill transforme le modèle en outil de travail fiable.

Comment écrire une skill

Anthropic conseille de ne pas gaspiller de place sur les évidences que Claude connaît déjà sur le code et les pratiques courantes. Il est bien plus utile de réunir dans la skill une section sur les vrais « pièges » : pannes typiques, cas limites non triviaux et règles locales de l'équipe.

Autre principe important : la révélation progressive du contexte via le système de fichiers. Les détails de l'API peuvent aller dans references, les modèles dans assets et la logique répétitive dans des scripts. Ainsi, le modèle ne lit que ce qu'exige l'étape en cours.

«

La meilleure façon de comprendre les skills est de se lancer, d'expérimenter et de voir ce qui vous convient. »

Les auteurs recommandent aussi de prévoir à l'avance la configuration initiale : par exemple, stocker les paramètres dans config.json et poser des questions structurées à l'utilisateur si la configuration est vide. Le champ description doit être rédigé non comme un résumé marketing, mais comme une condition de déclenchement destinée au modèle lui-même. Pour la mémoire, on peut utiliser des logs, du JSON ou SQLite, mais il vaut mieux conserver les données persistantes dans un répertoire stable comme `${CLAUDE_PLUGIN_DATA}`.

Anthropic défend en outre l'idée de stocker du code et des bibliothèques d'aide dans les skills, plutôt que de forcer le modèle à réinventer le boilerplate à chaque fois. Pour simplifier ce processus, l'entreprise a même lancé Skill Creator.

Comment partager au sein de l'équipe

Pour distribuer les skills, Anthropic décrit deux scénarios de base : les conserver directement dans le dépôt du projet ou les empaqueter en plugins pour la marketplace de Claude Code. Le premier convient aux petites équipes et à quelques dépôts, mais il a un coût : chaque skill commitée ajoute du contexte au modèle. Lorsque les skills deviennent nombreuses, il est plus logique de les déplacer vers un catalogue interne distinct, où les équipes choisissent elles-mêmes ce qu'elles installent. C'est d'autant plus important que les projets vivent dans des bases de code différentes et que les équipes ont des besoins différents.

Chez Anthropic, aucun groupe central unique ne valide manuellement toutes les skills dès le départ. En général, les travaux utiles apparaissent d'abord en local, sont ensuite partagés via GitHub et Slack, puis passent à la marketplace une fois la demande organique établie. L'usage peut être mesuré avec des hooks PreToolUse, et les dépendances entre skills se règlent pour l'instant par de simples références par nom. L'idée est de faire croître la bibliothèque progressivement, sans encombrer le système de doublons et d'extensions mal maintenues.

Ce que cela signifie

Le guide d'Anthropic met en évidence un changement important : la valeur des outils d'IA pour le développement tient de plus en plus non seulement au modèle, mais à la manière dont l'équipe organise autour de lui ses connaissances, ses vérifications et ses processus sûrs. Pour les utilisateurs de Claude Code, c'est un signal pour investir non dans des « prompts magiques », mais dans leur propre couche de skills, qui rend l'agent plus prévisible, plus utile et plus proche des tâches réelles d'un environnement d'ingénierie.