Chargement
Dans cette leçonÀ la fin, vous serez en mesure de
  • Partagez des skills avec votre équipe en les validant dans un dépôt Git
  • Distribuez des skills entre les projets via des plug-ins et des marketplaces
  • Déployez des skills à l'échelle de l'organisation à l'aide des paramètres gérés en entreprise
  • Configurez des subagents personnalisés pour utiliser des skills spécifiques

Partage des skills

Chargement

Partage des skills · 4 min

RésuméTranscription

Les skills deviennent bien plus utiles lorsqu'ils sont partagés au sein d'une équipe ou d'une organisation. Cette vidéo présente les trois principales méthodes de distribution — les validations dans un dépôt, les plug-ins et les paramètres gérés en entreprise — et explique comment configurer des subagents personnalisés pour utiliser des skills. Vous apprendrez quelle approche convient à quel scénario, ainsi que comment gérer un piège important : les subagents n'héritent pas automatiquement des skills.

Points clés à retenir

  • Les skills de projet dans .claude/skills sont partagés automatiquement via Git — toute personne qui clone le dépôt les obtient
  • Les plug-ins vous permettent de distribuer des skills entre les dépôts via des marketplaces, pour une utilisation plus large par la communauté
  • Les paramètres gérés en entreprise déploient des skills à l'échelle de l'organisation avec la priorité la plus élevée, ce qui est idéal pour les normes obligatoires et la conformité
  • Les subagents ne voient pas les skills que vous avez déjà invoqués. S'ils disposent de l'outil Skill, ils peuvent tout de même trouver et invoquer des skills
  • Les agents intégrés (comme Explore et Plan) ne préchargent pas les skills. Seuls les subagents personnalisés peuvent répertorier les skills à charger au démarrage, dans leur champ skills

Les skills deviennent bien plus utiles lorsqu'ils sont partagés. Un skill de revue de PR que vous seul utilisez est utile, mais ce même skill, partagé avec toute votre équipe, standardise la revue de code et crée une expérience cohérente dans toute votre organisation. Voyons les différentes façons de distribuer des skills.

Valider les skills dans votre dépôt

La méthode de partage la plus simple consiste à valider les skills directement dans votre dépôt. Placez-les dans .claude/skills, et toute personne qui clone le dépôt obtient automatiquement ces skills — sans installation supplémentaire nécessaire.

Lorsque vous poussez des mises à jour, tout le monde les reçoit au prochain pull. Cette approche fonctionne bien pour :

  • Les normes de codage de l'équipe
  • Les flux de travail spécifiques au projet
  • Les skills qui font référence à la structure de votre base de code

Le répertoire .claude contient vos agents, hooks, skills et paramètres — le tout versionné et partagé avec l'équipe via les flux de travail Git habituels.

Distribuer des skills via des plug-ins

Les plug-ins sont un moyen d'étendre Claude Code avec des fonctionnalités personnalisées conçues pour être partagées entre les équipes et les projets. Dans votre projet de plug-in, créez un répertoire skills qui suit une structure de fichiers similaire à celle du répertoire .claude — chaque skill obtient son propre dossier avec un fichier SKILL.md à l'intérieur.

Une fois que vous avez distribué votre plug-in sur une marketplace, d'autres utilisateurs peuvent le découvrir et l'installer eux-mêmes dans Claude Code.

Claude Code Discover plugins, une liste consultable de plug-ins provenant de claude-plugins-official avec le nombre d'installations.

Cette approche est la meilleure lorsque vos skills ne sont pas trop spécifiques à un projet et peuvent être utiles aux membres de la communauté au-delà de votre équipe immédiate.

Déploiement en entreprise via les paramètres gérés

Les administrateurs peuvent déployer des skills à l'échelle de l'organisation via les paramètres gérés. Chaque skill est placé dans .claude/skills/ à l'intérieur du répertoire des paramètres gérés sur chaque machine, par exemple /etc/claude-code/.claude/skills/ sous Linux. Les skills d'entreprise ont la priorité la plus élevée : ils remplacent les skills personnels et de projet portant le même nom.

managed-settings.json avec des variables d'environnement de télémétrie, deux annonces d'entreprise et une liste strictKnownMarketplaces.

Les paramètres gérés contrôlent également les plug-ins. Par exemple, strictKnownMarketplaces limite les marketplaces à partir desquelles les utilisateurs peuvent ajouter et installer des plug-ins. La capture d'écran ci-dessus inclut une entrée npm, qui ne correspond à rien, donc cet exemple utilise à la place une entrée url :

json
"strictKnownMarketplaces": [
  {
    "source": "github",
    "repo": "acme-corp/approved-plugins"
  },
  {
    "source": "url",
    "url": "https://plugins.example.com/marketplace.json"
  }
]

Le déploiement en entreprise est le bon choix pour les normes obligatoires, les exigences de sécurité, les flux de conformité et les pratiques de codage qui doivent être cohérentes dans toute l'organisation. Le mot clé ici est « doivent ».

Skills et subagents

Voici quelque chose qui surprend les gens : un subagent ne voit pas les skills que vous avez déjà invoqués. Lorsque vous déléguez une tâche à un subagent, il démarre avec un contexte propre et nouveau, sauf s'il s'agit d'un fork, qui démarre avec une copie de votre conversation. Un subagent qui démarre avec un contexte nouveau peut tout de même trouver et invoquer des skills via l'outil Skill, tant qu'il dispose de cet outil.

Il existe des distinctions importantes à comprendre :

  • Les agents intégrés (comme Explore et Plan) ne préchargent pas les skills
  • Les subagents personnalisés que vous définissez peuvent précharger les skills répertoriés dans leur champ skills. Si vous attribuez à l'un d'eux une liste tools, conservez-y Skill afin que le subagent puisse toujours invoquer des skills non répertoriés
  • Les skills préchargés sont chargés intégralement au démarrage du subagent, et non à la demande comme dans la conversation principale

Pour créer un subagent personnalisé avec des skills, ajoutez un fichier markdown d'agent dans .claude/agents. Vous pouvez rédiger le fichier vous-même ou demander à Claude de le créer pour vous. Si .claude/agents n'existait pas au démarrage de votre session, redémarrez Claude Code pour charger le nouveau subagent. La capture d'écran ci-dessous montre l'assistant /agents, qui a été supprimé dans Claude Code v2.1.198.

Invite de nouvel agent Claude Code, texte saisi commençant par « Je veux que vous révisiez le frontend pour détecter tout problème d'accessibilité ».

Le champ skills du fichier de l'agent répertorie les skills à charger. Voici à quoi ressemble le frontmatter :

yaml
---
name: frontend-security-accessibility-reviewer
description: "Use this agent when you need to review frontend code for accessibility..."
tools: Bash, Glob, Grep, Read, WebFetch, WebSearch, Skill...
model: sonnet
color: blue
skills: accessibility-audit, performance-check
---

Lorsque vous déléguez à ce subagent, les deux skills sont déjà chargés et il les applique à chaque revue. Assurez-vous d'abord que les skills existent dans votre répertoire .claude/skills, puis créez un nouveau subagent ou ajoutez le champ skills au fichier markdown d'un agent existant.

Ce modèle fonctionne particulièrement bien lorsque :

  • Vous souhaitez une délégation de tâches isolée avec une expertise spécifique
  • Différents subagents ont besoin de skills différents (relecteur frontend contre relecteur backend)
  • Vous souhaitez appliquer des normes dans le travail délégué sans dépendre des requêtes

Réflexion sur la leçon

  • Quelle méthode de partage (dépôt, plug-in, entreprise) est la plus pertinente pour les skills que vous envisagez de créer ?
  • Avez-vous des flux de travail où des subagents personnalisés dotés de skills spécifiques amélioreraient la cohérence du travail délégué ?

Et ensuite ?

Dans la dernière leçon, vous apprendrez à résoudre les problèmes courants liés aux skills — des skills qui ne se déclenchent pas aux conflits de priorité, en passant par les erreurs d'exécution — à l'aide d'une liste de contrôle pratique que vous pourrez consulter à tout moment.