Skills et Plugins Claude : Analyse technique du contenu vs contenant

Les termes « skill Claude » et « plugin Claude » sont souvent utilisés de manière interchangeable, créant une confusion pour les développeurs qui cherchent à étendre Claude Code. En réalité, ce ne sont pas les mêmes choses. Comprendre cette distinction n'est pas seulement académique ; c'est fondamental pour construire, installer et déboguer efficacement des comportements personnalisés.

Chez SkillProof, nous travaillons quotidiennement avec ces mécanismes. Nous ne nous contentons pas de lire la documentation ; nous installons et exécutons des skills sur des projets réels, à partir de dossiers bruts et de paquets de plugins. Sur les 1877 skills que nous avons testés à ce jour, seuls 1159 (62 %) ont réussi notre évaluation. 624 autres ont nécessité une configuration, un skill compagnon ou une intégration avant de fonctionner, et 94 ont obtenu un score inférieur à la référence sans skill — soit ils ne pouvaient pas s'exécuter du tout, soit leur exécution a dégradé le résultat par rapport à ne rien installer. Cette expérience nous donne une perspective claire et factuelle sur la différence entre un skill et un plugin Claude, et sur lequel vous devriez utiliser.

La manière la plus simple de voir les choses est la suivante : un skill est le contenu — l'ensemble d'instructions qui enseigne un nouveau comportement à Claude. Un plugin est un contenant — un paquet de distribution qui peut regrouper un ou plusieurs skills, ainsi que d'autres types d'extensions.

Cet article distingue les deux concepts, en utilisant les chemins de fichiers et les commandes exacts que nous employons dans nos tests quotidiens. Nous aborderons ce qu'est un skill, ce qu'est un plugin, comment ils sont installés, et quand il est préférable de construire l'un plutôt que l'autre.

Qu'est-ce qu'un skill Claude Code ? L'unité de comportement atomique

Un skill Claude est le bloc de construction le plus fondamental. C'est, littéralement, un dossier contenant un fichier nommé SKILL.md. C'est tout. Le nom du dossier devient l'identifiant du skill.

Le fichier SKILL.md a une structure simple en deux parties :

1. Frontmatter YAML : Un bloc en haut du fichier, délimité par ---, qui définit les métadonnées du skill. Le champ qui importe est description. name est optionnel et prend par défaut le nom du répertoire, et il existe une douzaine d'autres champs optionnels (allowed-tools, when_to_use, model, paths et leurs dérivés) que la plupart des skills n'utilisent jamais.
2. Instructions Markdown : Sous le frontmatter, vous écrivez du Markdown simple qui explique la tâche à Claude. C'est votre prompt, votre ensemble d'instructions sur la manière d'exécuter le comportement.

Point crucial, le format SKILL.md n'inclut pas de syntaxe complexe pour définir des fonctions d'outils, des schémas d'API ou des types de paramètres. Il n'y a pas de bloc requis pour les exemples 'few-shot'. L'ensemble du système est basé sur le langage naturel.

Le champ le plus important dans le frontmatter est description. Il n'est pas seulement destiné aux lecteurs humains ; c'est le déclencheur principal du skill. Lorsque vous donnez une tâche à Claude, il analyse les champs description de tous les skills installés pour trouver une correspondance. Si la description de votre tâche correspond à la description d'un skill, Claude charge les instructions Markdown de ce skill dans son contexte pour guider sa réponse. Si vous l'omettez, Claude se rabat sur le premier paragraphe du corps du texte, qui est rarement écrit pour servir de déclencheur.

C'est un point d'échec fréquent que nous documentons dans nos tests. Nous avons vu de nombreux skills avec des instructions brillantes dans le corps du Markdown que Claude n'utilise jamais parce que la description dans le frontmatter était trop vague, trop spécifique ou totalement absente. Un skill avec une description comme "Aids in development" ne sera presque jamais déclenché. Pour une analyse plus approfondie de ce qui constitue un bon skill, consultez notre guide sur ce que sont les skills Claude.

Comment installer un skill brut

Si un skill n'est qu'un dossier, son installation est aussi simple que de copier ce dossier au bon endroit. Claude Code recherche les skills à deux emplacements :

1. Global : ~/.claude/skills/
2. Spécifique au projet : <your-project-directory>/.claude/skills/

Les skills dans le répertoire global sont disponibles dans n'importe quel projet que vous ouvrez avec Claude Code. Les skills dans un répertoire spécifique à un projet ne sont chargés que lorsque vous travaillez dans ce projet. C'est utile pour les tâches spécifiques à une seule base de code.

Pour installer un skill que vous avez téléchargé depuis un dépôt Git, le processus est une opération de fichier directe. Par exemple, après avoir cloné un dépôt contenant un skill, vous exécuteriez :

# Example: Installing a skill into the global directory
cp -r path/to/cloned-repo/the-skill-folder ~/.claude/skills/

Claude Code surveille ces répertoires de skills, donc un skill que vous ajoutez, modifiez ou supprimez est pris en compte dans la session en cours sans redémarrage. L'exception est un répertoire de skills qui n'existait pas au début de la session ; si vous en créez un, vous devrez redémarrer pour que Claude Code commence à le surveiller.

Il n'y a pas d'interface en ligne de commande spéciale pour installer un skill brut, et pas de flag --skill qui indique à Claude un fichier SKILL.md pour une seule exécution. La copie du dossier constitue l'installation.

Cette approche directe, basée sur les fichiers, est la manière dont nous installons la majorité des skills listés dans notre catalogue. C'est simple, transparent et facile à déboguer. Vous trouverez des exemples d'installation plus détaillés dans notre guide pour installer les skills Claude.

Qu'est-ce qu'un plugin Claude ? Un paquet de distribution

Si un skill est le contenu, un plugin est la caisse d'expédition. Un plugin est un répertoire autonome de composants, contenant généralement un manifeste .claude-plugin/plugin.json qui contient ses métadonnées d'identité (nom, description, version, auteur) et peut indiquer où se trouvent ses composants.

C'est la différence fondamentale entre un skill et un plugin Claude : un plugin est conçu pour être un paquet. Bien qu'il puisse contenir un seul skill, sa véritable puissance réside dans sa capacité à regrouper plusieurs extensions connexes. Un plugin peut fournir :

• Skills : Un ou plusieurs dossiers SKILL.md.
• Agents : Des sous-agents spécialisés auxquels l'agent principal de Claude peut déléguer du travail.
• Commandes Slash : Des commandes / personnalisées que vous pouvez exécuter directement dans l'interface de chat de Claude Code.
• Hooks : Des scripts qui s'exécutent automatiquement à certains moments du cycle de vie de la session.
• Serveurs MCP : Des connexions à un serveur Model Context Protocol, afin qu'un plugin puisse configurer une intégration externe lors de son installation au lieu de vous laisser le faire manuellement. Pour en savoir plus, consultez notre analyse comparative des skills vs MCP.
• Serveurs LSP : Des connexions à un serveur de langage qui fournissent à Claude les erreurs de type et la navigation dans le code.

Un plugin n'est pas seulement un emballage pour un seul skill. C'est une boîte à outils complète. Par exemple, un plugin pour un framework de test spécifique pourrait regrouper un skill pour écrire de nouveaux tests, une commande slash pour les exécuter, et un hook pour lancer les tests avant chaque commit. Le skill n'est qu'une pièce du puzzle.

Fonctionnement des plugins et des marketplaces

Comme les plugins sont des paquets plus complexes, leur processus d'installation est différent. Vous ne copiez pas manuellement les dossiers des plugins. Vous passez par des marketplaces : une marketplace est un dépôt Git contenant un fichier .claude-plugin/marketplace.json qui liste les plugins qu'elle propose.

Anthropic gère une marketplace officielle, claude-plugins-official, que Claude Code ajoute pour vous automatiquement au démarrage, ainsi qu'une marketplace communautaire à anthropics/claude-plugins-community que vous ajoutez vous-même et dont les plugins ont passé une validation automatisée et un contrôle de sécurité. Mais le système n'est pas fermé : n'importe qui peut publier une marketplace en plaçant un fichier marketplace.json dans un dépôt, et rien ne vous empêche de l'ajouter. L'inclusion dans le catalogue officiel est à la discrétion d'Anthropic ; tout ce qui est en dehors a la qualité que le mainteneur a choisi de lui donner.

Pour installer un plugin, vous ajoutez sa marketplace, puis vous installez le plugin par son nom :

1. Ajoutez la marketplace :

   /plugin marketplace add anthropics/claude-code
   

2. Installez le plugin :

   /plugin install commit-commands@claude-code-plugins
   

Ensuite, exécutez /reload-plugins pour l'activer dans la session en cours.

La gestion des plugins ne se limite cependant pas à l'interface interactive. Il existe un groupe de commandes shell claude plugin (avec l'alias claude plugins) couvrant install, uninstall, enable, disable, update, list, details, init et validate — la manière documentée d'installer sans l'étape interactive, et ce que vous utilisez pour scripter la configuration d'une équipe :

claude plugin install commit-commands@claude-code-plugins --scope project

Il existe également les flags --plugin-dir et --plugin-url pour charger un plugin pour une seule session, ce qui permet d'essayer quelque chose avant de s'engager.

La distinction entre une marketplace et un répertoire organisé est importante ici, et ce n'est pas le même axe que skill versus plugin. Une marketplace est un canal de distribution : elle vous informe qu'un plugin existe et l'installe. Le filtrage, quand il a lieu, est automatisé. Rien de tout cela ne vous dit si l'outil fonctionnera pour votre tâche.

Skills vs Plugins Claude Code : Comparaison côte à côte

Pour que la distinction soit parfaitement claire, voici une comparaison directe des attributs clés :

Caractéristique	Skill brut	Plugin
Définition	Un dossier avec un fichier SKILL.md définissant un comportement unique.	Un répertoire autonome de composants, agissant comme un paquet.
Fichier principal	SKILL.md	.claude-plugin/plugin.json
Portée	Un unique ensemble d'instructions pour une tâche.	Un paquet de skills, agents, commandes, hooks, serveurs MCP et LSP.
Installation	Copie manuelle : cp -r ... ~/.claude/skills/	/plugin install <name>@<market>, ou claude plugin install
Distribution	Partage direct de dossier, dépôt Git.	Via une Marketplace (un dépôt Git avec un manifeste).
Cas d'usage	Usage personnel, outils à usage unique, prototypage rapide.	Distribution en équipe, boîtes à outils complexes, comportements multi-parties.

Comment SkillProof teste les deux

Notre méthodologie de test est agnostique à la méthode d'installation. Qu'un skill arrive sous forme de dossier brut ou dans un paquet de plugin, notre processus est le même. Nous l'installons, puis nous évaluons la performance des instructions SKILL.md sous-jacentes par rapport à un ensemble de tâches standardisées.

La méthode de distribution ne change pas le comportement du skill. Un fichier SKILL.md mal écrit fonctionnera tout aussi mal, que vous le copiiez manuellement ou que vous l'installiez avec /plugin install.

En fait, un échec récurrent que nous rencontrons est un paquet qui s'installe parfaitement mais contient un skill qui ne se déclenche jamais. L'installation se termine sans erreur, le skill apparaît dans la liste, puis Claude ne l'utilise jamais, car la description dans son SKILL.md est trop faible pour correspondre à ce qu'un utilisateur taperait réellement. Rien dans l'installation ne le signale. Vous ne le découvrez qu'en donnant à Claude la tâche que le skill était censé gérer et en le regardant répondre comme si le skill n'était pas là — ce qui est exactement le test que nous effectuons.

C'est en partie pourquoi 624 des 1877 skills que nous avons testés reçoivent un verdict « Fonctionne avec configuration » plutôt qu'une réussite : ils fonctionnent, mais pas immédiatement, et le packaging a tendance à en masquer la raison.

Dois-je créer un skill ou un plugin ?

Cela nous amène à la question pratique : lorsque vous avez un nouveau comportement pour Claude, devez-vous créer un skill ou un plugin ?

La réponse est simple : commencez toujours par créer un skill.

1. Créez votre fichier your-skill-name/SKILL.md. Concentrez-vous sur la rédaction d'instructions claires et efficaces et d'une description précise et facile à déclencher. Testez-le localement en le copiant dans ~/.claude/skills/.

2. Itérez sur le fichier SKILL.md jusqu'à ce qu'il fonctionne de manière fiable. Cela représente 99 % du travail. Le contenu de ce fichier est ce qui apporte la valeur.

Ce n'est qu'après avoir un skill éprouvé et fonctionnel que vous devriez envisager de le packager en tant que plugin. La décision de créer un plugin doit être motivée par des besoins de distribution, et non par la complexité du skill lui-même.

Packagez-le en tant que plugin si :

• Vous livrez plus d'un composant. Par exemple, un skill pour générer de la documentation d'API et une commande slash /generate-docs pour le déclencher pour tout le projet.
• Vous devez distribuer un ensemble de skills à une équipe avec une seule commande d'installation simple.
• Vous construisez une extension plus avancée qui repose sur des hooks, des sous-agents ou d'autres fonctionnalités exclusives aux plugins.

Si vous avez un seul skill pour votre usage personnel, la création d'un plugin est une surcharge inutile. Un dossier de skill brut dans ~/.claude/skills/ est plus simple et plus direct.

En résumé : concentrez-vous sur le skill, pas sur l'emballage

L'idée centrale à retenir est que la performance vient de la qualité du fichier SKILL.md, pas de son packaging. Un plugin est un mécanisme de distribution, pas une garantie de qualité. Comme le montrent nos données, même des skills proprement packagés échouent : 94 de ceux que nous avons testés ont obtenu un score inférieur à ce que Claude fait sans aucun skill installé.

La différence entre les skills et les plugins Claude n'est pas une question de bon ou de mauvais, mais de portée et d'objectif. L'un est l'instruction ; l'autre est la boîte dans laquelle elle est livrée.

Lectures complémentaires : pour une analyse approfondie du packaging — manifestes, structure de la marketplace, et ce qu'il faut vérifier avant d'ajouter le dépôt de quelqu'un — consultez notre guide des plugins Claude Code. Pour le côté contenu, ce que sont les skills Claude explique le fonctionnement du format avant que vous n'écriviez votre premier skill.

Trouver les 1159 skills qui réussissent réellement nos tests est la raison pour laquelle nous avons créé SkillProof. Si vous voulez éviter les essais et les erreurs, notre catalogue de skills de codage testés est un bon point de départ. Si vous préférez installer un ensemble déjà testé, nous vendons des packs de dix basés sur des rôles — Developer Toolkit, Writer Pack, Security & Code Review et cinq autres — pour 10 $ chacun sur /bundles.