Skills, subagenti, MCP e plugin in Claude Code: quale scegliere

Al momento in Claude Code ci sono cinque modi per fare la stessa revisione del codice: un comando slash, una skill, un subagente, un plugin o semplicemente un prompt in chat. Nessuno di questi è migliore degli altri per impostazione predefinita: la scelta dipende dall’attività, dal budget di token e da chi, oltre a te, lo userà.

Questa guida è ciò che avrei voluto ricevere un anno fa. Un albero di 4 domande, una matrice «attività → livello» pronta all’uso e 5 errori comuni che fanno sprecare token a tutti gli altri vibe coder con cui lavoro.

Informazioni su come lavorare con il servizio sono disponibili nella documentazione di Ailoot.

Cosa sono skills, subagenti, MCP e plugin in una frase?#

Prima di scegliere, distinguiamo i termini. Tutti e quattro i livelli hanno un obiettivo: ampliare ciò che Claude può fare appena installato. Ma ciascun livello ha una natura diversa.

Skill è una directory con un file SKILL.md che descrive quando e come applicare una metodologia specifica. Anthropic paragona una skill alle istruzioni per un nuovo dipendente: non gli detti ogni giorno ogni passaggio; gli dai una procedura.

Subagente è una sessione separata di Claude, con un proprio contesto, avviata dalla conversazione principale. Ha una caratteristica fondamentale: l’isolamento. Un subagente può leggere 30 file, produrre un riepilogo e restituire solo quello alla chat principale. Il contesto della conversazione principale rimane pulito.

MCP (Model Context Protocol) è uno standard aperto di Anthropic per collegare Claude a sistemi esterni. In un post sul blog del 13 novembre 2025, Anthropic ha spiegato la distinzione nel modo più chiaro possibile:

Plugin è un pacchetto già pronto creato da qualcun altro, con skill, subagenti, hook e comandi, distribuito in un marketplace. Installalo con una sola riga usando /plugin install e ottieni tutto insieme. Se una skill è una procedura tua, un plugin è una procedura acquistata da un’altra azienda.

In breve, le skill sono ricette, i subagenti sono colleghi specializzati e MCP fornisce strumenti esterni con cui Claude può raggiungere servizi e dati. Il costo in token varia: una skill è l’opzione più economica (si carica quando viene attivata), mentre MCP è molto più costoso (ogni server collegato occupa continuamente spazio nella finestra di contesto).

Perché 4 livelli se puoi usare un solo CLAUDE.md?#

Nel progetto descritto, CLAUDE.md è una grande mappa di regole: dove mettere le cose, come pubblicare, quali accordi sono in vigore. Senza questo file, Claude ricomincerebbe da zero a ogni nuova sessione.

Ma CLAUDE.md ha un limite. Lascia che spieghi tre situazioni in cui smette di funzionare.

Situazione 1: una regola funziona solo a volte. CLAUDE.md dice: «esegui sempre npm run build prima di git push». Claude lo legge all’inizio della sessione, annuisce, inizia a scrivere codice dopo 25 messaggi e se ne dimentica. Mi è già capitato tre volte di eseguire il push senza una build; quei push sono falliti in produzione. Un hook correttamente configurato e provato può eseguire una build deterministica e rifiutare l’operazione coperta. La copertura dipende da evento e percorso: un hook Claude Code non intercetta da solo ogni push di altri terminali o applicazioni. Verifica che una build volutamente fallita blocchi il percorso effettivamente usato.

Situazione 2: un processo in 15 passaggi che si ripete. Nell’esempio descritto, ogni guida attraversa 14 fasi: ricerca → struttura → MDX → 7 controlli QA in parallelo → pubblicazione in produzione → IndexNow. Se ogni volta scrivo un prompt del tipo «esegui la Fase 1, poi la 2 e poi la 3», spreco token prima ancora di iniziare. Per questo l’intero flusso di lavoro è incluso nella skill build-masterskaya-guide: un insieme di istruzioni di 34 KB avviato con la frase «prepariamo una nuova guida per il progetto».

Situazione 3: un’attività che divora il contesto. Per verificare che una guida già pubblicata sia aggiornata, Claude deve leggere la trascrizione di una diretta da 30 KB, 20 retrospettive da 5 KB ciascuna e confrontarle con il sito attuale. Se lo faccio nella chat principale, alla fine della revisione mi ritrovo 200K token di materiale inutile nel contesto. Un subagente svolge lo stesso lavoro, restituisce alla conversazione principale solo un riepilogo di 300 parole e si chiude.

Situazione 4: voglio che il team abbia gli stessi modelli che ho io. Un insieme già pronto di regole per la progettazione frontend, hook per la pubblicazione tramite Coolify e MCP per i controlli con Playwright. Questo è un plugin: confeziono la mia configurazione, la pubblico nel marketplace e un collega la installa con una sola riga.

CLAUDE.md copre le basi: «come si lavora qui». I 4 livelli aggiuntivi coprono ciò che CLAUDE.md non può fare materialmente: ripetere attività tramite trigger, isolare il contesto, accedere al mondo esterno e condividere.

Quando ti serve una skill invece di CLAUDE.md?#

Il test per una skill è semplice: ti accorgi che stai copiando ogni volta lo stesso prompt lungo dai tuoi appunti alla chat. La terza volta è già un segnale.

Attualmente ho 7 directory in ~/.claude/skills/: build-masterskaya-guide, build-vc-spoke, build-reel-script, build-practicum-instruction, update-config, simplify e keybindings-help. La più usata è build-masterskaya-guide (questa guida è stata scritta usandola). Contiene 34 KB di metodologia: quali fasi seguire, quali controlli QA multi-agente eseguire, quali condizioni di blocco devono fermare il processo e quali artefatti salvare in /tmp/.

Quando non creare una skill.

• Una regola come «rispondi nella lingua preferita dall’utente» appartiene a CLAUDE.md, non a una skill. Una skill si carica quando viene attivata, ma questa regola dovrebbe applicarsi sempre.
• Un’istruzione una tantum come «esegui subito il refactoring» va in chat, non in una skill.
• Un compito che richiede un contesto separato può usare un subagente; se segue anche una procedura ricorrente, conserva la metodologia in una skill.

L’antipattern principale. L’errore più comune dei vibe coder è infilare una procedura in un subagente quando dovrebbe essere una skill. Un subagente costa più token (ha un proprio contesto), si avvia più lentamente ed è spesso eccessivo. Se l’attività si può descrivere con 1.500–2.000 parole di metodologia senza leggere file esterni, è una skill.

Come strutturare una skill, cosa inserire nel frontmatter e quali frasi di attivazione funzionano: nella guida Claude Code Skills nel 2026: come creare una libreria personale di Skills.

Quando ti serve un subagente invece di una skill?#

Una skill conserva la metodologia; un subagente svolge il lavoro. Sono livelli diversi, spesso confusi perché entrambi vengono avviati «dalla chat».

Un subagente ha senso solo per isolare il contesto. La sessione principale di Claude ha un budget di 200.000 token (o 1 milione in beta). Se chiedi alla chat principale di leggere 30 file e analizzarli uno per uno, metà della finestra verrà consumata dalla lettura intermedia. Un subagente svolge lo stesso lavoro in una sessione separata e restituisce alla chat principale solo il risultato.

Un esempio concreto di progetto. Ogni guida passa attraverso diversi controlli QA in parallelo: stile, citazioni e fatti verificati sulle fonti primarie, struttura per i motori di ricerca e integrità dei link interni ed esterni. Ogni controllo richiede un proprio contesto: un glossario di regole, WebFetch su decine di URL e ricerche nel testo.

Se eseguissi tutti questi controlli in una sola chat, il contesto mi soffocherebbe prima ancora che il primo fosse terminato. Avviare i subagenti in parallelo con run_in_background: true risolve il problema: lavorano in background, la chat principale prosegue e, dopo 4–6 minuti, ricevo rapporti compatti e applico le modifiche.

Un secondo esempio: ricerca impegnativa. Quando scelgo un argomento per una nuova guida, 4 subagenti raccolgono segnali in parallelo:

• V1 - forum e community negli ultimi 14 giorni
• V2 - social network
• V3 - piattaforme video + blog di Anthropic
• V4 - lacune SEO

Ognuno restituisce 30–40 elementi con punteggi di viralità. Li raccolgo in un insieme, li pondero su 9 dimensioni e scelgo il migliore. Senza subagenti, questa fase si prolungherebbe per 2–3 ore, consumando il contesto principale.

Quando non creare un subagente.

• Un’attività che non richiede di leggere file o usare WebFetch va svolta nella chat principale.
• Una procedura ripetibile appartiene a una skill, ma può essere svolta in un subagente se serve isolamento.
• L’accesso esterno richiede uno strumento autorizzato, come MCP o CLI; un subagente può usarlo quando riceve la delega.

L’antipattern principale. Creare un subagente chiamato backend-engineer o qa sperando che Claude capisca quando usarlo. I subagenti specifici (come migration-test-writer o api-route-reviewer) offrono una qualità molto superiore rispetto a quelli generici. Più il nome e le istruzioni del subagente sono precisi, più accuratamente Claude sceglierà quello giusto.

Come creare subagenti per attività specifiche, la sintassi del frontmatter e 5 esempi pronti all’uso: nella guida Subagenti di Claude Code nel 2026: guida passo dopo passo.

Quando ti serve MCP invece di una skill o di un subagente?#

Anthropic ha riassunto la differenza in una formula breve in un post sul blog: MCP collega Claude ai dati; le skill insegnano a Claude cosa fare con quei dati.

Per esempio, una skill di revisione delle issue richiede il contenuto. Forniscilo tramite MCP autorizzato, CLI o testo fornito. La skill stabilisce come revisionarlo e strutturare i risultati; il solo accesso MCP non prescrive la procedura.

Il mio stack MCP specifico.

• Playwright MCP - QA visiva per ogni guida. Apro la pagina su desktop e mobile, controllo la larghezza del contenitore e verifico che i blocchi siano stati renderizzati.
• Stitch MCP - accesso al sistema di design e generazione di componenti nello stile del brand.
• vidIQ MCP - analisi delle tendenze e verifica della viralità delle idee.
• Railway MCP - gestione dell’infrastruttura di deployment.

Ognuno di questi 4 è un ponte verso un sistema esterno. Senza MCP, dovrei scrivere codice wrapper personalizzato o passare al browser. Con MCP, tutto avviene all’interno della sessione Claude.

Costo in token. MCP è il livello più costoso. Ogni server collegato occupa continuamente spazio nella finestra di contesto: dichiarazioni degli strumenti, schemi degli argomenti e descrizioni. Ho 4 server MCP: circa 8–12K token in ogni nuova sessione prima ancora di fare una domanda.

Questo significa che colleghiamo MCP solo se è davvero necessario nella maggior parte delle sessioni. Se usi MCP di Sentry una volta alla settimana, è meglio attivarlo su richiesta con il flag --mcp sentry invece di tenerlo nell’elenco permanente.

Quando non usare MCP.

• La metodologia su «come lavorare con i dati» appartiene a una skill, non a MCP.
• Un compito di lettura lungo può beneficiare di un subagente; se file o record sono esterni, può servire anche accesso MCP.
• Per pubblicare con un solo comando serve un hook o un plugin, non MCP.

L’antipattern principale. Creare un server MCP per qualcosa che si gestisce meglio con una skill. Ho visto un esempio in una discussione su HN (proprio quella discussione con 422 punti il 27 maggio): l’autore aveva scritto un server MCP che forniva «istruzioni per la revisione del codice». Ma non si tratta di accedere al mondo esterno: è una procedura. Una skill fa la stessa cosa usando 10 volte meno token.

Un incidente di contesa per le risorse. Una volta MCP di Playwright si è bloccato con l’errore «Browser is already in use»: avevo una finestra di Chrome aperta contemporaneamente e MCP non riusciva a prendere il controllo del browser. È una lezione importante: un server MCP usa risorse di sistema condivise. Se una risorsa (browser, porta o file) è contesa, pensa all’isolamento fin dall’inizio.

Una guida pronta per collegare 7 MCP funzionanti è disponibile in Claude Code MCP Servers nel 2026: 7 configurazioni pronte all’uso.

Quando ti serve un plugin invece di una skill o di un subagente?#

Skills, subagenti e MCP riguardano la tua metodologia. Un plugin è una metodologia già pronta di qualcun altro, che importi nella tua configurazione.

Nell’ottobre 2025, Anthropic ha lanciato Claude Code Plugins, un meccanismo ufficiale di distribuzione. Un plugin è una directory che può contenere:

• i propri comandi slash
• le proprie skill
• i propri subagenti
• i propri hook
• le proprie configurazioni MCP
• i propri stili di output

Tutto viene confezionato in un unico pacchetto con plugin.json. L’installazione si effettua con una sola riga in ~/.claude/settings.json oppure con il comando /plugin install <name>.

Il mio stack di plugin specifico.

• frontend-design del marketplace ufficiale claude-plugins-official: 67 stili, 96 palette, 57 coppie di font, 13 framework. Quando creo un nuovo blocco per il sito o un modello email, carico questo plugin e ottengo subito l’intera libreria.
• playwright dello stesso marketplace ufficiale: un insieme di skill e configurazioni MCP per testare il browser.
• telegram: un pacchetto pronto per gestire un account Telegram da Claude Code (criteri, allowlist, pairing).
• trailofbits/skills: un insieme di skill di sicurezza di Trail of Bits, un’azienda di cui mi fido per la sicurezza.

Tutti e 4 occupano tre righe in settings.json. Senza plugin, passerei ore a creare a mano la stessa libreria.

Quando non usare un plugin.

• Se la metodologia è interamente tua e non è destinata a essere riutilizzata su larga scala, conservala come skill.
• Se non sai ancora chi la userà, provala prima su te stesso come skill.
• Se devi copiare rapidamente tre file su una nuova macchina, basta cp ~/.claude/skills/X /new/machine/.claude/skills/.

L’antipattern principale. Usare un plugin al posto di CLAUDE.md, per esempio un plugin con regole su «come lavoriamo in questo progetto». Un plugin è pensato per la distribuzione e il riuso. Se le regole sono specifiche di un solo repository, appartengono a CLAUDE.md, non a un plugin.

Guardando al 2026: Anthropic sta chiaramente puntando a un marketplace di plugin per i team. Questo permetterà alle aziende di pubblicare le proprie metodologie interne come plugin, versionarle e aggiornarle per tutti i dipendenti con un solo comando. Per chi lavora in proprio, il significato è semplice: installare ciò che è già pronto e non reinventare la ruota.

Albero decisionale: 4 domande da porsi prima di ogni attività#

Domanda 1: esiste una procedura ripetibile da conservare?

Se sì, confezionala in una skill, un file SKILL.md con descrizione chiara dei casi d’uso. Fornisce la metodologia, non di per sé accesso esterno o contesto separato.

Domanda 2: serve un contesto separato o un ruolo delegato mirato?

Se sì, usa un subagente con compito e strumenti precisi. Può seguire la metodologia di una skill nel contesto isolato.

Domanda 3: servono strumenti o dati esterni?

Se sì, fornisci accesso autorizzato tramite MCP o altro strumento appropriato, come una CLI già configurata. Una skill ne descrive l’uso; un subagente può essere l’esecutore.

Domanda 4: serve distribuire e mantenere il sistema come pacchetto?

Se sì, un plugin distribuisce skill, definizioni di agenti, hook o configurazioni MCP pertinenti. Può essere tuo o di un altro autore.

Esempio combinato: revisione ricorrente di issue GitHub. Una skill stabilisce procedura e formato, un MCP GitHub o CLI configurati forniscono accesso autorizzato, un subagente legge la discussione lunga nel proprio contesto e restituisce risultati, un plugin distribuisce la combinazione al team. Tutte le risposte possono essere «sì» senza escludersi.

5 errori nella scelta dei livelli che fanno i vibe coder#

Mi capita di vedere questi 5 schemi una volta alla settimana tra i vibe coder con cui lavoro. Una persona su due ne commette almeno uno nella prima settimana.

Errore 1: subagente invece di skill.

Sintomo: un autore ha creato un subagente per «scrivere un nuovo post sul blog». Ogni volta che lo avvia, il subagente si carica, legge 2 KB di metodologia, genera un post e si chiude. Dopo una settimana, l’autore si accorge che ogni esecuzione spreca 5K token in più per caricare il subagente.

Cosa sarebbe dovuto succedere: «come scrivere un post» è una metodologia, quindi serve una skill. Il trigger è la frase «nuovo post sul blog». La skill viene caricata nella chat principale e non apre una sessione separata. Costa da 3 a 5 volte meno.

Errore 2: server MCP invece di skill.

Sintomo: un autore ha scritto un server MCP che fornisce istruzioni su «come fare una revisione del codice». Le dichiarazioni degli strumenti, le descrizioni degli schemi degli argomenti e la documentazione continuano a occupare il contesto. Ogni richiesta spreca 2–3K token inutilmente.

Cosa sarebbe dovuto succedere: «come fare una revisione del codice» è una procedura, non l’accesso a un sistema esterno. Usa una skill. MCP è giustificato solo se serve accesso in tempo reale, per esempio a Sentry per recuperare gli errori più recenti.

Errore 3: plugin invece di CLAUDE.md.

Sintomo: un autore ha confezionato regole di progetto («usa sempre la modalità TypeScript strict», «non usare trattini», «usa solo pnpm, non npm») in un plugin e lo ha installato. Ora ogni nuova sessione carica un plugin che duplica ciò che dovrebbe stare in CLAUDE.md.

Cosa sarebbe dovuto succedere: le regole di un progetto appartengono al CLAUDE.md di quel progetto. Un plugin serve per una metodologia riutilizzabile da più persone o repository.

Errore 4: provare a creare una skill tramite un hook.

Sintomo: un autore ha visto che un hook viene eseguito automaticamente in risposta a un evento (per esempio prima di salvare un file). Ha deciso di creare una «skill tramite hook» affinché Claude applicasse automaticamente la metodologia a ogni modifica. Ha ottenuto un ciclo infinito di trigger, sprecato contesto e prodotto un comportamento imprevedibile.

Cosa sarebbe dovuto succedere: un hook è codice deterministico che esegue un comando, formatta il risultato o blocca un’operazione. Un hook non carica una skill e non invoca Claude. Se vuoi «applicare sempre la metodologia X», usa una skill con un trigger oppure una voce in CLAUDE.md.

Errore 5: aggiungere un livello quando non serve nulla.

Sintomo: un autore sente parlare di skill, legge delle guide, decide «devo confezionare questa metodologia» e passa una serata a creare una skill per un’attività che capita una volta al mese.

Cosa sarebbe dovuto succedere: un’attività una tantum va gestita al momento in chat. Una skill è giustificata solo se svolgi quell’attività più di una volta al giorno. Altrimenti è sovraingegnerizzazione che poi va mantenuta.

In questi esempi valuta indipendentemente procedura, isolamento del contesto o ruolo, strumenti e distribuzione. Aggiungi ogni livello con uno scopo concreto e combinali quando servono più esigenze.

Cosa dice Anthropic sulla frammentazione: dove sta andando Claude Code nel 2026#

Ecco cosa significa per i prossimi sei mesi o un anno.

Primo: le skill stanno diventando il livello principale per le attività procedurali. Anthropic punta chiaramente su questo livello perché è il più economico e prevedibile. Se nel 2026 non capisci perché ti serva una skill, inizia a studiarla. Tutti gli altri livelli ruoteranno attorno a essa.

Secondo: i subagenti stanno diventando più specializzati. Il ruolo principale dei subagenti è isolare il contesto per le attività impegnative. I subagenti generici come qa-engineer scompariranno; resteranno quelli specifici, come migration-test-writer e api-route-reviewer.

Terzo: i nuovi annunci di Anthropic nell’arco di 14 giorni — il comando /workflows (28 maggio 2026) per orchestrare decine di subagenti e la separazione della fatturazione dell’Agent SDK a partire dal 15 giugno — indicano che l’uso programmatico si sta spostando in un pool separato. È un segnale che Anthropic sta costruendo un’infrastruttura per sistemi automatizzati con oltre 10 agenti, anziché per singole sessioni.

Per un vibe coder nel 2026, questo significa una cosa semplice: i quattro livelli dureranno almeno altri sei mesi, poi alcuni si fonderanno. Ma l’albero decisionale delle quattro domande funzionerà anche dopo la fusione: riguarda la natura dell’attività, non il nome specifico del livello.

Matrice pronta all’uso: 10 attività tipiche → il livello giusto#

La regola principale per usare questa tabella è non provare a «fare tutte e 10 le cose insieme». La maggior parte dei vibe coder che lavorano da soli se la cava con CLAUDE.md + 5–7 skill + 2–4 server MCP. Subagenti e plugin si aggiungono man mano che il progetto cresce.

Prossimo passo: come creare il tuo workspace in Claude Code#

Questi cinque livelli non si dispongono uno dopo l’altro: si inseriscono l’uno nell’altro. CLAUDE.md è la base del progetto e gli altri quattro si collegano man mano che le attività crescono.

Scopri Ailoot.