Plugin

Un plugin est un bundle distribuable d'extensions de Claude Code. Il regroupe une collection de composants, tels que des skills, des agents, des hooks, des serveurs MCP ou des serveurs LSP, en une seule unité pour une distribution et une gestion plus faciles.

Le manifeste du plugin, un fichier nommé plugin.json, est situé dans le répertoire .claude-plugin/ du plugin. Les skills inclus dans un plugin résident dans le sous-répertoire skills/. Ces skills sont automatiquement nommés en utilisant le nom du plugin. Par exemple, un skill situé à my-plugin/skills/review/SKILL.md est accessible sous /my-plugin:review. Cette organisation par nom d'espace évite les conflits avec les skills installés localement ou dans un projet.

Pour un skill situé directement dans le répertoire racine du plugin (un SKILL.md racine du plugin), le nom de la commande est déterminé par le champ name dans son frontmatter. Si le champ name est absent, le nom du répertoire du plugin est utilisé comme nom de commande.

Inversement, un répertoire de skill peut également fonctionner comme un plugin en incluant un fichier .claude-plugin/plugin.json. Cela permet à un seul répertoire de skill de regrouper des composants supplémentaires tels que des agents, des hooks et des serveurs MCP. Lors de l'utilisation de cette méthode dans le répertoire .claude/skills/ d'un projet, la boîte de dialogue de confiance de l'espace de travail doit d'abord être acceptée.

Pour des raisons de sécurité, les sous-agents dans les plugins ont certains champs de frontmatter désactivés : hooks, mcpServers et permissionMode. Pour appliquer les modifications apportées aux répertoires hooks/, .mcp.json, agents/ et output-styles/ d'un plugin, vous devez exécuter la commande /reload-plugins.