Agenti, skill, hook, plugin e MCP in Claude Code: cosa sono e quando usarli

Tutte e cinque sono opzionali: Claude Code funziona anche senza. Servono quando vuoi automatizzare, specializzare o collegare qualcosa. Se non hai ancora Claude Code, parti dalla guida all’installazione.

Un agente è un file Markdown con un’intestazione che lo descrive e, sotto, le sue istruzioni. Ha il suo contesto e i suoi permessi. Si salva in .claude/agents/ (solo per il progetto) o in ~/.claude/agents/ (per tutti i tuoi progetti). Questo è l’esempio che abbiamo provato, un revisore di testi:

---
name: revisore-testi
description: Controlla un testo in italiano e segnala errori di ortografia e punteggiatura. Usalo quando si chiede di rivedere un testo.
tools: Read, Grep, Glob
model: haiku
---

Sei un revisore di testi in italiano. Leggi il file indicato e rispondi con un elenco puntato dei soli errori trovati, ciascuno con la correzione. Non riscrivere il testo e non modificare file.

name e description sono obbligatori; tools limita cosa può fare (qui solo leggere); model sceglie il modello. Per usarlo basta chiederlo a parole:

Usa l'agente revisore-testi per controllare bozza.txt

Nel nostro test ha trovato l’unico errore del file di prova («un ora» al posto di «un’ora») e non ha modificato nulla. Puoi anche richiamarlo digitando @ e scegliendolo dall’elenco.

Una skill è un file SKILL.md dentro una cartella con il suo nome. Claude la carica quando la descrizione corrisponde alla richiesta, oppure la richiami tu con /nome. L’esempio provato:

---
description: Riassume un file di testo in al massimo due righe che iniziano con "RIASSUNTO:". Usala quando l'utente chiede un riassunto breve.
---

Leggi il file indicato e rispondi con una sola riga che inizia con "RIASSUNTO:" seguita da una frase di massimo 15 parole.

Salvata in .claude/skills/riassunto-breve/SKILL.md, la richiamiamo così:

/riassunto-breve bozza.txt

Risposta: una riga che comincia con «RIASSUNTO:», come da istruzioni. Quando invece abbiamo chiesto a parole «dammi un riassunto breve», Claude ha risposto bene ma senza usare la skill (niente «RIASSUNTO:»).

Un hook è un comando che Claude Code esegue in un momento preciso, ogni volta, senza dipendere da una scelta del modello. Eventi che abbiamo visto nella documentazione: prima o dopo l’uso di uno strumento, all’invio di un messaggio (UserPromptSubmit), alla fine di una risposta (Stop), a inizio e fine sessione, quando Claude chiede la tua attenzione (Notification). Si scrivono nel file settings.json:

{
  "hooks": {
    "UserPromptSubmit": [
      { "matcher": "", "hooks": [ { "type": "command", "command": "echo \"messaggio inviato\" >> hook.log" } ] }
    ],
    "Stop": [
      { "matcher": "", "hooks": [ { "type": "command", "command": "echo \"risposta finita\" >> hook.log" } ] }
    ]
  }
}

Nella cartella di prova, dopo due domande, il file hook.log conteneva due coppie «messaggio inviato / risposta finita». Per vedere gli hook attivi, dentro Claude Code scrivi /hooks.

MCP (Model Context Protocol) è uno standard aperto per collegare Claude Code a strumenti esterni, per esempio un programma di grafica 3D, una documentazione o un servizio online. Si aggiunge con claude mcp add e si controlla con:

claude mcp list

Dentro Claude Code, /mcp mostra lo stato dei server. L’ambito predefinito è «local»: vale solo per il progetto corrente. Con --scope user vale per tutti i tuoi progetti.

Un plugin raggruppa agenti, skill, hook e server MCP in un’unica cartella che si installa con un comando, da un «marketplace» (un catalogo). Dentro Claude Code scrivi /plugin e apri la scheda Discover. Il marketplace ufficiale di Anthropic viene aggiunto al primo avvio interattivo. Dal Terminale puoi gestire i plugin con comandi come claude plugin enable, claude plugin disable e claude plugin details.

Un plugin attivo fa parte di ogni sessione: nome e descrizione di agenti e skill occupano spazio nel contesto e contano nei tuoi limiti d’uso anche quando non li usi, e i suoi hook scattano ogni volta. Se non lo usi più, disattivalo.

• Una cosa che deve succedere sempre (notifica, controllo, registro) → hook.
• Un compito specializzato, con le sue regole e il suo contesto → agente.
• Una procedura da riusare, che vuoi richiamare con /nome → skill.
• Collegare un servizio o un programma esterno → MCP.
• Condividere o installare tutto insieme → plugin.

Per darti un’idea di come si usano insieme, ecco la nostra configurazione, descritta in modo generico: 5 agenti (uno per la grafica, uno per i testi, uno per l’analisi dei dati e due per attività di contenuti), circa 60 skill (per esempio per revisione di testi, controllo della qualità, creazione di materiali), 3 eventi hook (invio di un messaggio, fine di una risposta, fine sessione), una decina di plugin (tra quelli del marketplace ufficiale, frontend-design, cloudflare e chrome-devtools-mcp) e 4 server MCP. Non è una configurazione da copiare: parti da un agente e da una skill, e aggiungi solo ciò che ti serve davvero.