Anthropic a expliqué 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 qu'elle utilise déjà des centaines de tels skills et a découvert en pratique lesquels améliorent vraiment la qualité du travail et lesquels ne font que gonfler le contexte.

Quels skills fonctionnent

Le point principal du guide : une skill n'est pas simplement un fichier markdown avec des instructions, mais un dossier complet avec des configurations, des scripts, des templates, des données et même des hooks. C'est pourquoi Anthropic recommande d'abord de déterminer le type de skill, puis d'écrire son contenu. Selon les observations de l'entreprise, les meilleures skills résolvent généralement une tâche claire. Celles qui tentent d'être simultanément une référence, un pilote automatique, un runbook et un générateur de code confondent plus souvent le modèle qu'elles ne l'aident.

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

Anthropic met en évidence séparément les skills de vérification et opérationnels. Dans le premier cas, l'agent non seulement écrit du code, mais exécute lui-même le scénario, vérifie les étapes et enregistre le résultat. Dans le second cas, il obtient des garde-fous pour les actions sensibles comme le nettoyage des ressources, le déploiement ou le triage des alertes. De telles skills sont particulièrement précieuses là où les erreurs coûtent cher : en production, les paiements, l'onboarding et les plateformes internes. Ces scénarios montrent le mieux si une skill transforme le modèle en un outil de travail fiable.

Comment écrire une skill

Anthropic recommande de ne pas gaspiller de l'espace sur des choses évidentes que Claude connaît déjà sur le code et les pratiques typiques. Il est beaucoup plus utile de rassembler dans une skill une section avec des « pièges » réels : des défaillances typiques, des cas limites non triviaux et des règles locales de l'équipe. Un autre principe important est la divulgation progressive du contexte via le système de fichiers. Les détails d'API peuvent être mis dans les références, les templates dans les assets, et la logique répétitive dans les scripts. De cette façon, le modèle ne lit que ce dont il a besoin pour l'étape actuelle.

«

La meilleure façon de comprendre les skills est de commencer, d'expérimenter et de voir ce qui fonctionne pour vous. »

Les auteurs recommandent également de planifier à l'avance la configuration initiale : par exemple, stocker les paramètres dans config.json et poser à l'utilisateur des questions structurées si le config est vide. Le champ description doit être écrit non pas comme un résumé marketing, mais comme une condition de déclenchement pour le modèle lui-même. Pour la mémoire, vous pouvez utiliser des logs, JSON ou SQLite, mais les données persistantes sont mieux conservées dans un répertoire stable comme `${CLAUDE_PLUGIN_DATA}`. De plus, Anthropic promeut séparément l'idée de stocker le code et les bibliothèques d'aide dans les skills au lieu 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 d'une équipe

Pour distribuer les skills, Anthropic décrit deux scénarios de base : les stocker directement dans le référentiel du projet ou les empaqueter en tant que plugins pour la place de marché Claude Code. La première option est pratique pour les petites équipes et quelques référentiels, mais elle a un coût : chaque skill commitée ajoute du contexte au modèle. Quand il y a beaucoup de skills, il est judicieux de les déplacer vers un catalogue interne séparé où les équipes choisissent ce qu'elles installent. C'est particulièrement important si différents projets se trouvent dans différentes bases de code et que les équipes ont des besoins différents.

Cela dit, Anthropic n'a pas une équipe centrale unique qui approuve manuellement toutes les skills dès le départ. Généralement, les développements utiles apparaissent d'abord localement, puis sont partagés via GitHub et Slack, et après une demande organique, ils sont promus vers la place de marché. L'utilisation peut être mesurée via les hooks PreToolUse, et les dépendances entre les skills sont actuellement résolues par de simples liens basés sur le nom. L'idée est de faire croître la bibliothèque progressivement, sans encombrer le système avec des doublons et des extensions mal maintenues.

Ce que cela signifie

Le guide d'Anthropic montre un changement important : la valeur des outils d'IA pour le développement repose de plus en plus non seulement sur le modèle, mais sur la façon dont l'équipe empaquette ses connaissances, ses vérifications et ses processus sûrs autour de celui-ci. Pour les utilisateurs de Claude Code, c'est un signal d'investir non pas dans des « prompts magiques », mais dans une couche de skills personnalisée qui rend l'agent plus prévisible, utile et plus proche des tâches réelles de travail dans l'environnement d'ingénierie.