Partager des compétences

Partager des compétences

Points clés à retenir

• Les Compétences de projet dans .claude/skills sont partagées automatiquement via Git — quiconque clone le dépôt les obtient
• Les plugins vous permettent de distribuer des Compétences entre dépôts via des marketplaces pour un usage communautaire plus large
• Les paramètres gérés en 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 explicitement lister les Compétences dans le champ skills de l'en-tête d'un agent personnalisé
• Les agents intégrés (Explorer, Plan, Verify) ne peuvent pas du tout accéder aux Compétences — seuls les sous-agents personnalisés définis dans .claude/agents le peuvent

Les Compétences prennent beaucoup plus de valeur lorsqu'elles sont partagées. Une Compétence de revue de PR que vous seul utilisez est utile, mais cette même Compétence partagée avec toute votre équipe standardise la revue de code et crée une expérience cohérente au sein de votre organisation. Examinons les différentes façons de distribuer des Compétences.

Valider les Compétences dans votre dépôt

La méthode de partage la plus simple consiste à valider les Compétences directement dans votre dépôt. Placez-les dans .claude/skills, et quiconque clone le dépôt obtient automatiquement ces Compétences — 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 workflows 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 — le tout versionné et partagé avec l'équipe via les workflows Git habituels.

Distribuer des 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 équipes et 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 possède son propre dossier avec un fichier SKILL.md à l'intérieur.

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



Cette approche est idéale 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 en 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 workflows de conformité et les pratiques de codage qui doivent être cohérentes 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, celui-ci démarre avec un contexte vierge et propre.

Il existe des distinctions importantes à comprendre :

• Les agents intégrés (comme Explorer, Plan et Verify) ne peuvent pas du tout accéder aux Compétences
• Les sous-agents personnalisés que vous définissez peuvent utiliser des Compétences, mais uniquement lorsque vous les listez explicitement
• Les Compétences sont chargées au démarrage du sous-agent, et non à 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 l'en-tête :

---
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, celui-ci a les deux Compétences chargées et les applique à chaque revue. 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 très bien lorsque :

• Vous souhaitez 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 (réviseur frontend vs. réviseur backend)
• Vous souhaitez imposer des normes dans le travail délégué sans dépendre des prompts

Réflexion sur la leçon

• Quelle méthode de partage (dépôt, plugin, entreprise) convient le mieux aux Compétences que vous envisagez de créer ?
• Avez-vous des workflows où des sous-agents personnalisés dotés de Compétences 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 Compétences — des Compétences qui ne se déclenchent pas, aux conflits de priorité, en passant par les erreurs d'exécution — avec une liste de contrôle pratique que vous pourrez consulter à tout moment.