Plugin

Un plugin è un bundle distribuibile di estensioni di Claude Code. Impacchetta una collezione di componenti, come skill, agent, hook, server MCP o server LSP, in un'unica unità per una più facile distribuzione e gestione.

Il manifest del plugin, un file chiamato plugin.json, si trova all'interno della directory .claude-plugin/ del plugin. Le skill incluse in un plugin risiedono nella sottodirectory skills/. Queste skill vengono automaticamente namespace utilizzando il nome del plugin. Ad esempio, una skill in my-plugin/skills/review/SKILL.md viene acceduta come /my-plugin:review. Questo namespacing previene conflitti con skill installate localmente o all'interno di un progetto.

Per una skill situata direttamente nella directory principale del plugin (una SKILL.md nella root del plugin), il nome del comando è determinato dal campo name nel suo frontmatter. Se il campo name è assente, il nome della directory del plugin viene utilizzato come nome del comando.

Al contrario, una directory di skill può anche funzionare come plugin includendo un file .claude-plugin/plugin.json. Ciò consente a una singola directory di skill di raggruppare componenti aggiuntivi come agent, hook e server MCP. Quando si utilizza questo metodo all'interno della directory .claude/skills/ di un progetto, è necessario prima accettare la finestra di dialogo di fiducia dello spazio di lavoro.

Per motivi di sicurezza, gli agent secondari all'interno dei plugin hanno alcuni campi frontmatter disabilitati: hooks, mcpServers e permissionMode. Per applicare le modifiche apportate alle directory hooks/, .mcp.json, agents/ e output-styles/ di un plugin, è necessario eseguire il comando /reload-plugins.