Partager des skills — Introduction aux Agent Skills

Un skill qui ne sert qu’à vous est déjà rentable ; un skill qui sert à l’équipe l’est dix fois plus, à condition que chacun l’ait, à jour, sans procédure d’installation. Claude Code offre cinq canaux, du plus simple au plus industriel : le dépôt Git, le plugin, les réglages gérés de l’organisation, le compte claude.ai, et le préchargement dans un sous-agent. Cette leçon les compare et montre ce que chacun exige.

Commiter les skills dans le dépôt

La méthode la plus simple est aussi la plus efficace pour une équipe : placez vos skills dans .claude/skills/ et commitez-les. Toute personne qui clone le dépôt les reçoit du même geste, sans installation ni documentation à lire. Quand vous poussez une mise à jour de votre liste de revue, chacun l’obtient à son prochain git pull, exactement comme une modification de code.

C’est le bon canal pour les standards de code de l’équipe, les workflows propres au projet, et surtout pour les skills qui font référence à la structure du dépôt : un skill qui explique où se trouvent les migrations et comment on les nomme n’a aucun sens ailleurs. Deux précautions. Dans un monorepo, un skill peut vivre dans le .claude/skills/ d’un sous-dossier : il se charge quand Claude y travaille, sous le nom /apps/web:nom si un skill du même nom existe à la racine. Et un skill commité est du code exécuté chez vos collègues : ses allowed-tools et ses commandes !`…` s’appliquent chez eux, donc relisez les contributions à .claude/skills/ comme vous relisez le reste.

Distribuer par un plugin

Certains skills dépassent le cadre d’un projet. Une convention de documentation, une méthode de revue d’accessibilité, un guide de votre API interne peuvent servir à des équipes qui ne partagent aucun code avec vous. Le plugin répond à ce besoin : un dossier qui regroupe des skills (et, au besoin, des sous-agents, des hooks et des serveurs MCP) que Claude Code installe et charge comme un tout. Le squelette minimal :

mon-plugin/
  .claude-plugin/plugin.json   # le manifeste : nom, description, version, auteur
  skills/
    revue-accessibilite/SKILL.md

{
  "name": "mon-plugin",
  "description": "Skills de revue partagés entre les équipes front",
  "version": "1.0.0",
  "author": { "name": "Équipe plateforme" }
}

Le name du manifeste préfixe chaque skill : celui-ci s’appelle /mon-plugin:revue-accessibilite, ce qui élimine les collisions de noms. Vérifiez la structure avec claude plugin validate ./mon-plugin, puis testez sans rien installer : claude --plugin-dir ./mon-plugin charge le plugin pour une session. Pour un skill personnel que vous voulez faire grandir en plugin, claude plugin init mon-outil crée le squelette dans ~/.claude/skills/mon-outil/, chargé automatiquement sous le nom mon-outil@skills-dir.

Trois façons de diffuser un plugin fini. Envoyez le dossier ou une archive .zip à quelques personnes, sans rien publier. Listez-le dans votre propre marketplace, un dépôt avec un fichier .claude-plugin/marketplace.json : vos collègues l’ajoutent une fois (/plugin marketplace add) puis installent par nom (/plugin install mon-plugin@ma-marketplace), et reçoivent vos mises à jour. Ou soumettez-le au répertoire d’Anthropic, pour qu’il soit disponible sur claude.ai, dans Cowork et dans Claude Code. À l’installation, chacun choisit une portée : utilisateur (tous ses projets), projet (commité dans .claude/settings.json, chaque collaborateur installe ensuite) ou locale. Réservez ce canal aux skills assez généraux pour voyager : un skill truffé de références à vos noms de services internes ne survivra pas au voyage.

Le déploiement par l’organisation

Quand un standard n’est pas négociable, il ne peut pas dépendre du bon vouloir de chacun. Les administrateurs déposent alors des skills dans le dossier .claude/skills/ des réglages gérés (managed settings), déployés sur toutes les machines de l’organisation. Ces skills ont la priorité la plus élevée : à nom égal, ils l’emportent sur les skills personnels et de projet. C’est le mécanisme des standards obligatoires, des exigences de sécurité et des workflows de conformité.

Les réglages gérés contrôlent aussi la provenance : une liste de marketplaces autorisées (allowedMarketplaces, alias de strictKnownMarketplaces) ferme la porte aux plugins d’origine inconnue, et skillOverrides peut masquer ou désactiver un skill sans toucher à son fichier. Dans un dépôt partagé, ce même réglage, écrit dans .claude/settings.local.json par le menu /skills (touche Espace), vous permet de couper un skill de projet que vous ne voulez pas chez vous.

Le compte claude.ai

Depuis 2026, votre compte claude.ai est lui-même un canal. Les skills que vous créez ou activez dans vos réglages claude.ai (ou dans Personnaliser de l’application de bureau), ceux de votre organisation, et les skills intégrés d’Anthropic comme pdf ou xlsx sont synchronisés dans les sessions Cowork, les sessions cloud, et les sessions du terminal où vous êtes connecté avec ce compte (version 2.1.273 et au-delà), dans ~/.claude/skills/synced/. C’est le seul canal qui atteint Cowork et le cloud : ces sessions ne lisent pas ~/.claude/skills/ de votre machine. Un skill personnel qu’une tâche planifiée dans le cloud invoque sera « introuvable » tant que vous ne l’avez pas activé sur votre compte, ou commité dans le dépôt pour les sessions cloud ordinaires. Deux limites : un skill synchronisé n’exécute pas ses commandes !`…` sur votre machine, et un skill téléversé sur claude.ai reste individuel, sans distribution centralisée par l’organisation.

Skills et sous-agents

Un sous-agent démarre avec un contexte vierge : il ne voit ni votre conversation ni les skills que vous avez déjà invoqués. Pour qu’un sous-agent personnalisé parte avec votre expertise, listez les skills dans son en-tête ; leur contenu complet est injecté à son démarrage, jusqu’à 32 skills :

---
name: relecteur-frontend
description: Relit le code front pour l'accessibilité et les performances. À utiliser après toute modification d'un composant.
tools: Read, Grep, Glob, Bash
model: sonnet
skills:
  - audit-accessibilite
  - verification-performance
---

Ce préchargement donne sa pleine mesure quand des sous-agents différents ont besoin de skills différents (un relecteur front et un relecteur back ne partagent pas grand-chose) et quand vous voulez imposer un standard dans le travail délégué sans dépendre du prompt que quelqu’un aura tapé ce jour-là. Deux précisions de la documentation : sans ce champ, un sous-agent peut quand même découvrir et invoquer les skills par son outil Skill ; et un skill réservé à l’utilisateur (disable-model-invocation: true) ne peut pas être préchargé. Les agents intégrés (Explore, Plan) ne préchargent rien.

Au-delà de Claude Code

Le même format sert ailleurs. L’Agent SDK charge les skills de .claude/ et ~/.claude/ comme une session interactive, ce qui fait d’un skill de dépôt une brique de vos scripts. Sur claude.ai, un skill se téléverse en archive .zip dans les réglages (offres Pro, Max, Ultra, Team et Enterprise, avec l’exécution de code activée). Dans l’API Claude, un skill s’envoie par les points de terminaison /v1/skills, est partagé par tout l’espace de travail, et s’exécute dans le conteneur de l’outil d’exécution de code, sans accès réseau. Aucune synchronisation automatique entre ces surfaces : vous publiez séparément là où vous voulez l’utiliser.

À vous de jouer

Commitez le skill pr-description du projet et demandez à un collègue (ou clonez le dépôt ailleurs) de taper /pr : il doit apparaître sans rien installer.
Transformez-le en plugin : manifeste, dossier skills/, claude plugin validate, puis claude --plugin-dir et appelez /mon-plugin:pr-description.
Créez un sous-agent dans .claude/agents/ qui précharge ce skill et demandez-lui de rédiger la description d’une PR.
Si vous utilisez Cowork ou les sessions cloud, activez un skill sur votre compte claude.ai et vérifiez qu’il apparaît dans /skills d’une session de terminal connectée.

Sources officielles : Extend Claude with skills · Create a Claude Code plugin · Install and manage plugins · Create custom subagents · Agent Skills (API Claude)

Points clés à retenir

Le dépôt (.claude/skills/ commité) est le canal d’équipe le plus simple ; relisez les contributions, elles s’exécutent chez tous
Un plugin regroupe des skills préfixés /plugin:nom ; claude plugin validate, --plugin-dir, puis diffusion par archive, marketplace ou répertoire d’Anthropic
Les réglages gérés déploient des skills prioritaires et contrôlent les marketplaces ; skillOverrides masque sans éditer
Le compte claude.ai synchronise les skills vers Cowork, le cloud et le terminal connecté ; c’est le seul canal qui atteint le cloud
Un sous-agent précharge des skills avec skills: ; sans ce champ, il peut encore les invoquer lui-même