Partager des compétences

Ce que vous apprendrez

Durée estimée : 20 minutes

À la fin de cette leçon, vous serez capable de :

Partager des compétences avec votre équipe en les validant dans un référentiel Git
Distribuer des compétences entre les projets via des plugins et des places de marché
Déployer des compétences à l'échelle de l'organisation en utilisant les paramètres gérés d'entreprise
Configurer des sous-agents personnalisés pour utiliser des compétences spécifiques

(4 minutes)

Les compétences deviennent beaucoup plus précieuses lorsqu'elles sont partagées au sein d'une équipe ou d'une organisation. Cette vidéo couvre les trois principales méthodes de distribution — les validations de référentiel, les plugins et les paramètres gérés d'entreprise — et explique comment configurer des sous-agents personnalisés pour utiliser des compétences. Vous apprendrez quelle approche convient à quel scénario et comment gérer un piège important : les sous-agents n'héritent pas automatiquement des compétences.

Points clés à retenir

Les compétences de projet dans . claude/skills sont partagées automatiquement via Git — quiconque clone le référentiel les obtient
Les plugins vous permettent de distribuer des compétences entre les référentiels via des places de marché pour une utilisation plus large par la communauté
Les paramètres gérés d'entreprise déploient des compétences à l'échelle de l'organisation avec la priorité la plus élevée, idéal pour les normes obligatoires et la conformité
Les sous-agents ne voient pas automatiquement vos compétences — vous devez les lister explicitement dans le champ frontmatter skills d'un agent personnalisé
Les agents intégrés (Explorer, Plan, Verify) ne peuvent pas accéder aux compétences du tout — seuls les sous-agents personnalisés définis dans . claude/agents le peuvent

Les compétences deviennent beaucoup plus précieuses lorsqu'elles sont partagées. Une compétence d'examen de PR que seul vous utilisez est utile, mais cette même compétence partagée dans toute votre équipe standardise l'examen du code et crée une expérience cohérente dans votre organisation. Examinons les différentes façons de distribuer les compétences.

Valider les compétences dans votre référentiel

La méthode de partage la plus simple consiste à valider les compétences directement dans votre référentiel. Placez-les dans . claude/skills, et quiconque clone le référentiel obtient automatiquement ces compétences — aucune installation supplémentaire nécessaire.

Lorsque vous poussez les mises à jour, tout le monde les obtient à la prochaine extraction. Cette approche fonctionne bien pour :

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

Le répertoire . claude contient vos agents, hooks, compétences et paramètres — tous contrôlés par version et partagés avec l'équipe via les flux de travail Git normaux.

Distribuer les compétences via des plugins

Les plugins 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 plugin, créez un répertoire skills qui suit une structure de fichiers similaire au répertoire . claude — chaque compétence obtient son propre dossier avec un fichier SKILL. md à l'intérieur.

Après avoir distribué votre plugin à une place de marché, d'autres utilisateurs peuvent le découvrir et l'installer dans Claude Code pour eux-mêmes.

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

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

Les administrateurs peuvent déployer des compétences à l'échelle de l'organisation via les paramètres gérés. Les compétences d'entreprise ont la priorité la plus élevée — elles remplacent les compétences personnelles, de projet et de plugin portant le même nom.

Le fichier de paramètres gérés prend en charge des fonctionnalités comme strictKnownMarketplaces pour contrôler d'où les plugins peuvent être installés :

"strictKnownMarketplaces": [ { "source": "github", "repo": "acme-corp/approved-plugins" }, { "source": "npm", "package": "@acme-corp/compliance-plugins" } ]

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

Compétences et sous-agents

Voici quelque chose qui surprend les gens : les sous-agents ne voient pas automatiquement vos compétences. Lorsque vous déléguez une tâche à un sous-agent, il commence avec un contexte frais et propre.

Il y a des distinctions importantes à comprendre :

Les agents intégrés (comme Explorer, Plan et Verify) ne peuvent pas accéder aux compétences du tout
Les sous-agents personnalisés que vous définissez peuvent utiliser des compétences, mais seulement lorsque vous les listez explicitement
Les compétences sont chargées au démarrage du sous-agent, pas à la demande comme dans la conversation principale

Pour créer un sous-agent personnalisé avec des compétences, ajoutez un fichier markdown d'agent dans . claude/agents. Vous pouvez utiliser la commande /agents dans Claude Code pour en créer un de manière interactive :

Le fichier d'agent généré inclut un champ skills qui liste les compétences à charger. Voici à quoi ressemble le frontmatter :

--- 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 sous-agent, il a les deux compétences chargées et les applique à chaque examen. Assurez-vous d'abord que les compétences existent dans votre répertoire . claude/skills, puis créez un nouveau sous-agent ou ajoutez le champ skills au fichier markdown d'un agent existant.

Ce modèle fonctionne vraiment bien quand :

Vous voulez une délégation de tâche isolée avec une expertise spécifique
Différents sous-agents ont besoin de compétences différentes (examinateur frontend vs examinateur backend)
Vous voulez appliquer des normes dans le travail délégué sans vous fier aux invites

Réflexion sur la leçon

Quelle méthode de partage (référentiel, plugin, entreprise) a le plus de sens pour les compétences que vous avez pensé construire ?
Avez-vous des flux de travail où des sous-agents personnalisés avec des compétences spécifiques amélioreraient la cohérence du travail délégué ?

Prochaines étapes

Dans la dernière leçon, vous apprendrez comment dépanner les problèmes courants de compétences — des compétences qui ne se déclenchent pas, aux conflits de priorité, aux erreurs d'exécution — avec une liste de contrôle pratique que vous pouvez consulter à tout moment.

Retours

Au fur et à mesure que vous progressez dans le cours, nous aimerions entendre comment vous utilisez les compétences dans votre travail, ainsi que tout retour que vous pourriez avoir. Partagez vos retours ici.