# Skill Claude Code : créer et partager en équipe > Skill Claude Code : où le ranger, un exemple d'équipe pas à pas, comment le versionner, le tester et le partager. Documentation lue le 16 octobre 2026. Source : https://waimia.com/blog/claude-code-skills --- [Accueil](/)/[Blog](/blog)/Skill Claude Code : créer et partager une compétence en équipe FR Édition française ◉ Disponible ![Un panneau d’atelier où chaque outil a sa place peinte ; un homme y raccroche une clé, une femme emporte un marteau] § Blog · Claude et assistants IA # Skill Claude Code : comment en créer un et le partager à toute l'équipe ? Skill Claude Code : où le ranger, un exemple d'équipe pas à pas, comment le versionner, le tester et le partager. Documentation lue le 16 octobre 2026. Simon Beros·16 octobre 2026·9 min de lecture [Simon Beros](/equipe/simon-beros)16 octobre 2026 · 9 min de lecture ## En bref - Un skill Claude Code est un dossier qui contient un fichier `SKILL.md`. Pour que toute l'équipe l'ait, on le range dans `.claude/skills/` du dépôt et on le commite : chacun le reçoit avec le code ([documentation Claude Code, skills](https://code.claude.com/docs/en/skills), lu le 16 octobre 2026). - Trois voies de partage : le dépôt, le plugin (par une marketplace Git) et les réglages gérés par l'administrateur. Ma recommandation, qui est une interprétation de Waimia : partir du dépôt, passer au plugin quand un second dépôt réclame le même skill. - Cinq pièges d'équipe : un skill personnel de même nom passe devant celui du dépôt, les sessions cloud ne lisent pas le dossier personnel, claude.ai refuse les champs propres à Claude Code, une commande injectée qui échoue arrête tout le skill, et la synchronisation avec claude.ai ne va que dans un sens. - Chez Waimia : l'audit gratuit de 45 minutes, puis un sprint de cadrage (999 € HT pour 10 heures) pour choisir les premiers skills de l'équipe. Ce billet complète le [guide des skills Claude](/ressources/guides/claude-skills), qui explique ce qu'est un skill et comment il se charge sur claude.ai, dans Claude Code et par l'API. Ici, on reste dans Claude Code et on travaille à plusieurs. Il suppose qu'une personne de l'équipe sait se servir de Git et d'un terminal. Sinon, le guide est le bon point de départ. Gratuit, 45 minutes : un ou deux chantiers classés. [Réserver l'audit gratuit →](/contact?offer=audit-ia-pme&intent=audit) ## Où ranger un skill, et lequel s'applique L'endroit où l'on enregistre le skill décide de qui le reçoit. Documentation officielle, lu le 16 octobre 2026. Les chemins, à partir de la racine du dépôt ou de votre dossier personnel : - Projet : `.claude/skills/nom-du-skill/SKILL.md` - Personnel : `~/.claude/skills/nom-du-skill/SKILL.md` - Plugin : `skills/nom-du-skill/SKILL.md` dans le dossier du plugin - Géré : `.claude/skills/` dans le dossier des réglages gérés | Emplacement | Qui le reçoit | À savoir | | --- | --- | --- | | Projet | Les sessions dans ce dépôt | À commiter pour que l'équipe l'ait aussi | | Personnel | Vous, dans tous vos projets, sur cette machine | Non lu par les sessions cloud ni par Cowork | | Plugin | Partout où le plugin est activé | Appelé sous la forme `/plugin:skill` | | Géré | Tous les utilisateurs des machines où l'organisation le déploie | Déployé par l'administrateur | Quand deux skills portent le même nom, la documentation fixe l'ordre : le géré passe avant le personnel, le personnel avant le projet. Si un collègue a gardé un skill personnel `deploy`, c'est le sien qui s'exécute, pas celui du dépôt. Les skills de plugin ont un préfixe et n'entrent pas en conflit. Donnez donc aux skills d'équipe des noms qui ne risquent pas d'être pris, par exemple `revue-avant-livraison` plutôt que `review`. Le détail des surfaces (claude.ai, API) est dans le [guide des skills Claude](/ressources/guides/claude-skills). Pour le cadre général de l'outil en entreprise, voir le [guide Claude Code en entreprise](/ressources/guides/claude-code-entreprise). ## Un exemple d'équipe, pas à pas : la revue avant livraison Scénario illustratif, pas un cas client. Une petite équipe livre des sites à ses clients. Elle veut que la relecture avant livraison se fasse toujours de la même façon, quelle que soit la personne qui livre. - **Créer le dossier dans le dépôt.** `mkdir -p .claude/skills/revue-avant-livraison`. Le nom du dossier devient la commande `/revue-avant-livraison`. - **Écrire le fichier `SKILL.md`.** Voici une version de départ : `--- name: revue-avant-livraison description: Prépare la relecture d'une livraison client, résume les changements en cours et liste les risques. disable-model-invocation: true argument-hint: "[nom-du-client]" allowed-tools: Bash(git diff *) Bash(git status *) --- # Revue avant livraison ## Changements en cours !`git diff HEAD --stat` ## Consignes Tu prépares une relecture pour $ARGUMENTS. Une personne décide de livrer. 1. Résume les changements en trois puces. 2. Liste les risques : secret en clair, test absent, lien cassé. 3. Applique la liste de contrôle de checklist.md. Si le diff est vide, dis-le et arrête-toi.` **Ajouter le fichier cité.** `checklist.md` se range à côté de `SKILL.md`. Claude ne l'ouvre que si la tâche le demande ; `SKILL.md` reste court (la documentation conseille moins de 500 lignes). **L'essayer.** Dans une session ouverte sur le dépôt : `/revue-avant-livraison client-a`. Claude Code surveille les dossiers de skills et prend en compte une modification dans la session en cours ; si le dossier `.claude/skills` n'existait pas au démarrage, la commande `/reload-skills` le charge. **Vérifier la syntaxe.** `claude plugin validate .claude/skills` (Claude Code 2.1.233 ou plus récent). Je l'ai lancé sur cet exemple le 16 octobre 2026 avec Claude Code 2.1.295 : « Validation passed ». Sur un en-tête volontairement cassé, la même commande échoue et prévient que le skill se chargerait sans aucune métadonnée. **Commiter et faire relire.** Le skill passe en revue comme du code. Ce que font les champs, d'après la documentation : - `disable-model-invocation: true` : seule une personne lance le skill, avec `/nom`. La description n'est alors pas chargée dans le contexte de Claude, qui ne peut pas le déclencher seul. C'est le bon réglage pour une action que l'on veut maîtriser. - `allowed-tools` : autorise ces commandes sans demander à chaque fois, pendant le tour où le skill est lancé. Le droit s'efface au message suivant. - La ligne qui commence par `!` : Claude Code exécute la commande avant que Claude lise le skill et colle le résultat à la place. Claude reçoit donc le diff réel, pas une description du diff. - `$ARGUMENTS` : le texte tapé après le nom du skill. ## Partager et versionner : du dépôt au plugin ### Première voie : le dépôt C'est la plus simple. Le dossier `.claude/skills/` est commité avec le code. Chaque personne qui récupère le dépôt reçoit le skill, et Git donne l'historique, la revue et le retour en arrière. Une règle de revue ressort de la documentation : le champ `allowed-tools` d'un skill de projet s'applique sans passer par la confiance accordée au dossier de travail. Relisez ce champ, et les lignes `!`, dans chaque demande de modification qui touche un skill. ### Deuxième voie : le plugin Un plugin regroupe des skills, et éventuellement des agents, des hooks et des serveurs MCP, en un seul paquet ([plugins, vue d'ensemble](https://code.claude.com/docs/en/plugins/overview), lu le 16 octobre 2026). On y pense quand plusieurs dépôts ou plusieurs équipes doivent partager les mêmes skills. Le chemin décrit par la documentation : - Copier le dossier `.claude/skills` dans un dossier de plugin qui contient un manifeste `.claude-plugin/plugin.json`. - Publier le plugin dans un dépôt Git qui porte un fichier `.claude-plugin/marketplace.json`. Quiconque peut cloner le dépôt peut installer : un dépôt privé donne une marketplace privée ([publier un plugin](https://code.claude.com/docs/en/plugins/publish), lu le 16 octobre 2026). - Chaque personne exécute `claude plugin marketplace add votre-org/votre-marketplace`, puis `claude plugin install nom@marketplace`. Activer le plugin dans les réglages du projet ne suffit pas : chaque collaborateur l'installe sur sa machine. Le versionnage demande un choix. Si vous renseignez `version` dans le manifeste et que vous publiez de nouveaux commits sans changer ce numéro, les utilisateurs gardent l'ancienne copie. Soit vous incrémentez le numéro à chaque publication, soit vous l'omettez et chacun suit les commits ([héberger une marketplace](https://code.claude.com/docs/en/plugins/host-marketplace), lu le 16 octobre 2026). La mise à jour automatique est désactivée par défaut ; sans elle, on met à jour avec `claude plugin update`. Un plugin peut aussi lancer du code (hooks, serveurs MCP). La page [sécurité des plugins](https://code.claude.com/docs/en/plugins/security) demande de le relire avant de l'installer, quelle que soit la marketplace. Le [guide des plugins Claude en entreprise](/ressources/guides/claude-plugins-entreprise) détaille la diffusion à une équipe. ### Troisième voie : les réglages gérés Un administrateur peut déployer des skills à tous les utilisateurs par les réglages gérés. Je ne détaille pas cette voie : elle concerne les organisations qui administrent leurs postes, et je n'ai pas relu en entier la page des réglages gérés. ## Tester avant de diffuser Voir un skill se déclencher prouve que Claude l'a trouvé, pas qu'il fait le travail voulu. La documentation propose une comparaison avec et sans le skill : quelques demandes réalistes, chacune lancée dans une session neuve avec le skill, puis sans. Pour couper un skill de projet ou personnel, on le passe à `"off"` dans le réglage `skillOverrides`. Le plugin `skill-creator` automatise cette boucle (cas de test, comparaison à l'aveugle de deux versions, réglage de la description). Trois points de contrôle, tirés de la même page : - **Le coût.** Chaque skill listé ajoute son nom et sa description au contexte à chaque tour. La commande `/skill-doctor` (Claude Code 2.1.252 ou plus récent) montre ce que coûte chaque skill et s'il sert. - **La description.** Elle décide du déclenchement. Description et `when_to_use` sont coupés à 1 536 caractères dans la liste : mettez l'usage principal au début. - **La compaction.** Quand la conversation est résumée, Claude Code ne rattache que les 5 000 premiers jetons de chaque skill invoqué, dans un budget commun de 25 000. Mettez les consignes critiques en tête de fichier. Pour une règle qui doit tenir à chaque fois, la documentation recommande un hook plutôt qu'une consigne. ## Cinq pièges d'équipe Ce sont des conséquences de la documentation lue le 16 octobre 2026, pas des incidents mesurés chez des clients. - **Le skill personnel qui masque celui du dépôt.** Voir l'ordre de priorité plus haut. Préfixez les noms d'équipe. - **Les sessions cloud et les routines.** Elles ne lisent pas `~/.claude/skills/` de votre machine. Une routine qui appelle un skill resté dans votre dossier personnel ne le trouve pas. Pour les sessions cloud, commitez le skill dans `.claude/skills/` du dépôt. - **Les champs propres à Claude Code.** `argument-hint` ou `disable-model-invocation` font échouer le téléversement vers claude.ai, qui n'accepte que six champs (`name`, `description`, `license`, `compatibility`, `metadata`, `allowed-tools`). Les lignes `!` ne fonctionnent pas non plus dans le chat de claude.ai. L'exemple ci-dessus est donc réservé à Claude Code. Pour des collègues qui n'utilisent que claude.ai, écrivez un skill limité à ces six champs. - **La commande injectée qui échoue.** Si une commande `!` échoue ou n'est pas autorisée, toute l'invocation du skill s'arrête et Claude ne voit pas le skill. Un administrateur peut aussi couper ces commandes avec le réglage `disableSkillShellExecution` : chaque commande est alors remplacée par un message indiquant que l'exécution est désactivée. - **La synchronisation à sens unique.** Les skills de votre compte claude.ai descendent dans Claude Code quand vous y êtes connecté avec ce compte ; Claude Code ne téléverse jamais les siens. La vérification a lieu environ toutes les 10 minutes pendant le travail et toutes les 40 minutes au repos. ## Ce que ce billet ne sait pas - L'exemple a passé `claude plugin validate`, qui contrôle la syntaxe. Je ne l'ai pas lancé dans une session : je n'ai pas vérifié que la règle `Bash(git diff *)` couvre bien la commande injectée, ni la qualité des relectures produites. - Aucun gain de temps chiffré : je n'ai aucune mesure sur des équipes réelles, et je n'en invente pas. - Je n'ai pas vérifié quelles offres Claude donnent accès à Claude Code, ni ce que permettent les réglages gérés selon l'offre. La documentation de cet outil change vite : les numéros de version cités sont ceux de la page du 16 octobre 2026. - Le [pack de 8 skills Waimia](/ressources/outils/pack-skills-claude-pme) est présenté pour claude.ai. Un dossier de skill suit le même format, mais je ne l'ai pas installé dans Claude Code pour ce billet. - Ma recommandation « le dépôt d'abord, le plugin ensuite » est une interprétation de Waimia, pas une règle d'Anthropic. ## Et après ? Pour savoir quels gestes de votre équipe méritent un skill, commencez par [l'audit IA gratuit](/contact?offer=audit-ia-pme&intent=audit) ([comment se passe l'audit de 45 minutes](/audit-ia-pme)). Le sprint de cadrage, à 999 € HT pour 10 heures, fixe ensuite les premiers skills et leur mode de diffusion. Les prix complets sont sur la page des [tarifs](/tarifs). Si votre équipe veut apprendre l'outil, voir la [formation Claude Code](/formations/claude-code). Pour confier une tâche à un agent plutôt qu'à un skill, voir [les quatre façons de construire un agent IA Claude](/blog/creer-agent-ia-claude). ZIP et PDF · envoyés par e-mail ## Recevez les 8 skills Claude prêts à installer Le pack part uniquement par e-mail, en deux pièces jointes : il n'existe pas de lien de téléchargement public. - Huit skills en ZIP : devis, compte rendu, relance de facture, fiche de poste, veille et trois autres - Le mode d'emploi PDF de 11 pages : installer, adapter, tester - Les erreurs fréquentes et les règles de sécurité - Un seul e-mail, sans inscription à une liste ZIP + PDF Pack de 8 skills Claude pour PME 8 skills · mode d'emploi de 11 pages waimia.com Partager [X](https://x.com/intent/tweet?url=https%3A%2F%2Fwaimia.com%2Fblog%2Fclaude-code-skills&text=Skill%20Claude%20Code%C2%A0%3A%20cr%C3%A9er%20et%20partager%20une%20comp%C3%A9tence%20en%20%C3%A9quipe%20%C2%B7%20Waimia) [LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fwaimia.com%2Fblog%2Fclaude-code-skills) § Sources - [Anthropic, Extend Claude with skills (documentation Claude Code), lu le 16 octobre 2026](https://code.claude.com/docs/en/skills) enterprise - [Anthropic, Plugins overview (documentation Claude Code), lu le 16 octobre 2026](https://code.claude.com/docs/en/plugins/overview) enterprise - [Anthropic, Publish and distribute a plugin (documentation Claude Code), lu le 16 octobre 2026](https://code.claude.com/docs/en/plugins/publish) enterprise - [Anthropic, Host and maintain a marketplace (documentation Claude Code), lu le 16 octobre 2026](https://code.claude.com/docs/en/plugins/host-marketplace) enterprise - [Anthropic, Plugin security and trust (documentation Claude Code), lu le 16 octobre 2026](https://code.claude.com/docs/en/plugins/security) enterprise À lire ensuite [§ Blog · Agents IA ### Agent IA Claude : quatre façons d'en construire un Agent IA Claude : n8n, Claude lui-même, Agent SDK ou Managed Agents. Ce que chaque voie demande, ses limites de données et le bon choix pour une PME. →](/blog/creer-agent-ia-claude)[§ Blog · Claude et assistants IA ### Connecter Claude à WordPress et à Shopify : API, MCP ou connecteur Claude et WordPress, Claude et Shopify : API, serveur MCP ou connecteur ? Ce que chaque voie permet, et les garde-fous avant de toucher au site. →](/blog/connecter-claude-wordpress-shopify-mcp)[§ Blog · Claude et assistants IA ### Claude Pro vs Team : lequel choisir pour une petite équipe Claude Pro ou Team pour une petite équipe : partage, administration, données et coût pour 2, 3 ou 5 personnes. Prix Anthropic relus le 16 octobre 2026. →](/blog/claude-pro-vs-team) § Auteur [Simon BerosFondateur · Architecte de systèmes IA (forward deployed engineer)](/equipe/simon-beros) § Audit IA Ce sujet vous concerne ? 45 minutes pour en parler sur vos processus. [Réserver l'audit gratuit →](/contact?offer=audit-ia-pme&intent=audit) ## Questions fréquentes Q.01 Où ranger un skill Claude Code pour que toute l'équipe l'ait ? ↓ Dans .claude/skills/nom-du-skill/SKILL.md à la racine du dépôt, puis on le commite : les sessions dans ce dépôt le chargent, et l'équipe le reçoit avec le code. Source : documentation Claude Code, lue le 16 octobre 2026. Q.02 Faut-il un plugin pour partager un skill ? ↓ Non. Le dépôt suffit pour une équipe qui travaille sur le même code. Le plugin sert quand plusieurs dépôts ou plusieurs équipes partagent les mêmes skills : il se publie dans une marketplace Git, privée si le dépôt est privé. Q.03 Comment mettre à jour un skill partagé ? ↓ Dans le dépôt, c'est un commit que chacun récupère. Pour un plugin, il faut incrémenter le numéro de version ou l'omettre, sinon les utilisateurs gardent l'ancienne copie ; la mise à jour automatique est désactivée par défaut et la commande claude plugin update met à jour à la demande. Q.04 Un skill Claude Code fonctionne-t-il dans claude.ai ? ↓ Pas toujours tel quel. Claude.ai n'accepte que six champs d'en-tête (name, description, license, compatibility, metadata, allowed-tools) et un téléversement avec un autre champ échoue. Les lignes de commande injectées ne fonctionnent pas non plus dans le chat de claude.ai. Q.05 Comment empêcher Claude de lancer un skill tout seul ? ↓ Avec le champ disable-model-invocation: true dans l'en-tête : seule une personne peut alors le lancer avec /nom, et sa description n'est pas chargée dans le contexte de Claude. Comment Claude s'intégrerait-il à vos outils et à vos équipes ? L'audit gratuit de 45 minutes part de vos tâches réelles et dit par où commencer, ou s'il vaut mieux ne rien faire. [Réserver l'audit gratuit →](/contact?offer=audit-ia-pme&intent=audit) Explorer aussi ## Sur le même sujet Services - [Agents IA pour entreprise](/services/agents-ia) - [Base de connaissance IA](/services/base-de-connaissance-ia) Guides et comparatifs - [LLM et RAG : définitions pour dirigeants](/ressources/guides/llm-rag-dirigeant) - [Guide Claude Code en entreprise](/ressources/guides/claude-code-entreprise) - [Claude Design en PME : usages et limites](/ressources/guides/claude-design) À lire - [Application métier : exemples par service en PME](/blog/application-metier-exemples-pme)