# Claude Code rallenta: come scegliere skill, subagent, MCP e plugin

> Un confronto tra estensioni di Claude Code, uso del contesto, sette errori e una configurazione minima funzionante, con gli esempi tecnici preservati.

Source: https://ailoot.ai/blog/it/claude-code-skills-subagents-mcp-plugins/
Canonical: https://ailoot.ai/blog/it/claude-code-skills-subagents-mcp-plugins/
Language: it
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-038
Revision: sha256-239bf45fb9236aadf767339b025374af456dccb8864dc9d1e46e9caf764bd181


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Evidenziazioni della sezione">

Punto chiave

Una skill è un’istruzione ricorrente caricata da un trigger (~100 token quando è inattiva). Un subagent è un contesto isolato di 200K con autorizzazioni proprie. MCP si connette a dati e API esterni. Un plugin è un pacchetto pronto all’uso dei primi tre elementi. La formula principale per il 2026: un subagent Haiku + una skill precaricata per le convenzioni + un MCP con ambito ristretto per i dati aggiornati. Tutto il resto o allucina o sovraccarica il contesto.

</div>



<div class="aside" data-semantic="ailoot-docs-link" aria-label="Documentazione di Ailoot">

Le istruzioni pratiche per lavorare con Ailoot sono nella [documentazione](https://ailoot.ai/docs/).

</div>

## Perché «riempire Claude Code di roba» è diventato il problema più grande nel 2026?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Evidenziazioni della sezione">

Punto chiave

A giugno 2026, Claude Code dispone di quattro meccanismi di estensione: skill, subagent, MCP e plugin. Il registro ufficiale conta 101 plugin; i cataloghi della community ne contano migliaia. La tentazione di installare tutto porta Claude a rallentare, a confondere funzioni simili e a consumare i limiti a ogni messaggio. La domanda principale del pubblico è: quale meccanismo usare per quale attività, senza trasformare l’agente in una discarica?

</div>

Persino la documentazione ufficiale non offriva una risposta completa già pronta alla domanda «quando scegliere cosa?».

L’esperienza di un mese descritta in questo articolo comprende tutti e quattro i meccanismi in progetti operativi: una serie di subagent per un’attività complessa, un piccolo gruppo di skill per procedure ricorrenti, un paio di server MCP per dati aggiornati e una selezione di pochi plugin da circa due dozzine. Questa guida riunisce l’esempio in una matrice di selezione con un albero decisionale già pronto, citazioni di Anthropic e sette antipattern che rendono Claude inutilizzabile.

## In che cosa una skill differisce da un subagent, da MCP e da un plugin? Una tabella

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Evidenziazioni della sezione">

Punto chiave

I quattro meccanismi sono quattro livelli della stessa architettura. Una skill insegna a Claude una procedura. Un subagent isola un’attività in un contesto separato. MCP connette dati esterni. Un plugin riunisce i primi tre in un unico pacchetto. Ognuno ha una propria classe di attività, un proprio consumo di token e un proprio rischio di sovraccaricare il contesto. Entrano in conflitto solo quando si sceglie il livello sbagliato.

</div>

Matrice di selezione:

| Proprietà | Skill | Subagent | Server MCP | Plugin |
|----|----|----|----|----|
| Contesto isolato | No | **Sì** (nuovo 200K) | No | Tramite i propri subagent |
| Dati e API esterni | No | Solo tramite l’MCP assegnato | **Sì** | Tramite i propri server MCP |
| Risparmio di token | 70–90% (divulgazione progressiva) | Fino al 70% nelle attività complesse | Dipende dalla ricerca degli strumenti | Dipende dai contenuti del pacchetto |
| Restrizioni degli strumenti | Tramite `allowed-tools` | Rigorosamente nel frontmatter | Tramite subagent o criteri | Parte del pacchetto |
| Scegliere un modello più economico | Tramite il campo `model` | **Sì**, nel frontmatter | N/A | Tramite i propri subagent |
| Velocità di configurazione | Minuti | Minuti | Da ore a giorni | 1 clic dal marketplace |
| Caso d’uso principale | Liste di controllo, convenzioni, stile | Attività delegata con output rumoroso | Database, API, dati aggiornati | Flusso di lavoro della community pronto all’uso |
| Insidia principale | `SKILL.md` gonfio \> 500 righe | Subagent con autorizzazioni a livello di genitore | Più di 3 server MCP | Pacchetto dai contenuti non verificati |

Un’analogia semplice per un imprenditore: immagina di essere l’amministratore delegato di un’azienda di dieci persone:

- **CLAUDE.md** — lo statuto aziendale. È sempre appeso alla parete; tutti lo leggono; nessuno lo discute.
- **Skill** — una procedura interna. «Come facciamo le revisioni», «come scriviamo le note di rilascio», «come accettiamo i pagamenti».
- **Subagent** — uno specialista con un ufficio separato e un elenco ristretto di autorizzazioni. Se gli dai le chiavi di tutto, otterrai un secondo amministratore delegato, non un dipendente.
- **Server MCP** — i sistemi aziendali: CRM, banca, magazzino. Non è conoscenza; è una connessione.
- **Plugin** — una soluzione pronta all’uso acquistata in un negozio. Un pacchetto di procedure, specialisti e integrazioni in un’unica scatola.

Quando capisci che si tratta di quattro livelli di un unico sistema, non di quattro concorrenti, la domanda «qual è il migliore?» scompare. Resta la domanda «che cosa va dove?».

## Che cos’è una skill in Claude Code e quando conviene installarla?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Evidenziazioni della sezione">

Punto chiave

Una skill è una cartella contenente un file `SKILL.md` (frontmatter YAML + istruzioni Markdown) in `~/.claude/skills/<name>/` o `.claude/skills/<name>/` in un progetto. Funziona tramite divulgazione progressiva: all’avvio vengono caricati solo il nome e la descrizione (~100 token); il corpo completo viene recuperato solo quando un’attività corrisponde al trigger. Quando è inattivo, è il più economico dei quattro meccanismi.

</div>

La definizione ufficiale di Anthropic:

<figure>
<blockquote>
<p>Le skill sono risorse riutilizzabili basate su file che forniscono a Claude competenze di dominio: flussi di lavoro, contesto e best practice che trasformano un agente generalista in uno specialista.</p>
</blockquote>
<figcaption>— Anthropic Docs, https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview</figcaption>
</figure>

Una skill ha tre livelli:

1.  **Metadati.** Sempre caricati all’avvio della sessione: il nome e la descrizione dal frontmatter. Una skill usa circa 100 token all’avvio.
2.  **Istruzioni.** Caricate solo quando Claude rileva una richiesta di attivazione. Fino a 5.000 token: il corpo di SKILL.md.
3.  **Risorse.** Caricate solo quando le istruzioni le richiedono esplicitamente. File inclusi, script in `scripts/`, materiali di riferimento in `references/`. Gli script vengono eseguiti tramite `bash`; il codice in sé non entra nel contesto.

Anthropic chiama questo principio divulgazione progressiva:

<figure>
<blockquote>
<p>La divulgazione progressiva è un principio di progettazione fondamentale che rende Agent Skills flessibile e scalabile.</p>
</blockquote>
<figcaption>— Anthropic Engineering, https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills</figcaption>
</figure>

E nello stesso articolo, una metafora che spiega l’idea meglio di qualsiasi altra cosa:

<figure>
<blockquote>
<p>Creare una skill per un agente è come scrivere una guida di inserimento per un nuovo dipendente.</p>
</blockquote>
<figcaption>— Anthropic Engineering, https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills</figcaption>
</figure>

**Quando usare una skill:**

- Una procedura standard che ripeti più e più volte. Revisioni delle PR, note di rilascio, revisione del codice secondo la tua guida di stile.
- Quando una sezione di `CLAUDE.md` è passata da fatto a procedura e comincia a interferire con tutto il resto.
- Quando vuoi che la stessa istruzione venga seguita con coerenza in progetti diversi.

Una formula pratica: **se fai qualcosa più di un paio di volte, affidala al sistema**. La prima volta, usa un prompt manuale. La seconda volta, è una possibile skill.

**Quando NON usare una skill:**

- Se l’attività richiede **dati aggiornati** (database, API, ricerca, dati attuali di borsa). Serve MCP, non una skill. Una skill che cerca di «recuperare il prezzo attuale» allucinerà.
- Se l’attività richiede un **contesto isolato**. Serve un subagent.
- Se serve un **controllo applicato automaticamente** («blocca un commit che contiene .env»), usa un hook sul percorso di commit coperto anziché affidarti a una skill. Esamina e prova la copertura effettiva: un hook non limita ogni modo di leggere, copiare o pubblicare il file.

Limiti da conoscere in anticipo:

- Nome della skill: fino a 64 caratteri, solo lettere minuscole, cifre e trattini. Le parole `anthropic` e `claude` sono riservate.
- Descrizione: fino a 1.024 caratteri. La combinazione di `description` + `when_to_use` viene troncata a 1.536 caratteri nell’elenco.
- Corpo di SKILL.md: la raccomandazione è di non superare 500 righe. Sposta tutto ciò che va oltre in `references/` e `scripts/`.
- Durante la compattazione automatica del contesto (auto-compaction), vengono riagganciati i primi 5.000 token di ogni skill attiva. Il budget totale per tutte le skill è 25.000.

## Che cos’è un subagent e perché ci sono 5 livelli di annidamento?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Evidenziazioni della sezione">

Punto chiave

Un subagent è un Claude figlio con un proprio contesto di 200K token, prompt di sistema, elenco ristretto di strumenti e autorizzazioni indipendenti. Il suo scopo principale è l’isolamento: ricerche rumorose, log lunghi e lavoro esplorativo restano all’interno del subagent, mentre al contesto principale torna solo il riepilogo finale. Dal 10 giugno 2026, i subagent possono annidarsi fino a 5 livelli di ricorsione.

</div>

Dalla documentazione ufficiale:

<figure>
<blockquote>
<p>I subagent sono assistenti IA specializzati che gestiscono classi specifiche di attività. Usane uno quando un’attività secondaria potrebbe riempire la conversazione principale di risultati di ricerca, log o contenuti di file che non consulterai. Il subagent svolge questo lavoro nel proprio contesto e restituisce solo un riepilogo.</p>
</blockquote>
<figcaption>— Claude Code Docs, https://code.claude.com/docs/en/sub-agents</figcaption>
</figure>

Claude Code ha tre subagent integrati che usi già senza saperlo:

| Subagent | Modello | Accesso | Dove opera |
|----|----|----|----|
| **Explore** | Haiku | Sola lettura | Ricerca nel codice; risparmia contesto saltando CLAUDE.md e lo stato di git |
| **Plan** | Haiku | Sola lettura | Modalità di pianificazione: riflette prima di scrivere codice |
| **General-purpose** | Sonnet/Opus | Tutti gli strumenti | Attività complesse in più fasi |

Il 10 giugno 2026, Anthropic ha rilasciato Claude Code v2.1.172 e rimosso una restrizione in vigore fin dal lancio dei subagent: ora gli agenti figli possono avviare i propri subagent, fino a 5 livelli di profondità.

Il numero 5 è un limite di sicurezza, non un obiettivo di ottimizzazione.

Una descrizione dettagliata della funzione, con modelli YAML per l’orchestratore, è disponibile nella [guida ai subagent annidati](https://ailoot.ai/blog/it/claude-code-nested-subagents/).

**Quando usare un subagent:**

- Un’esplorazione del codice o dei log dopo la quale ti serve solo una breve conclusione.
- Attività parallele che possono essere eseguite in contemporanea.
- Delega per specializzazione: backend / frontend / test / revisione, ciascuno responsabile di una funzione.
- Controllo dei costi: un subagent Haiku al posto di Sonnet o Opus. Riduce il costo di 5–7 volte.

**Quando NON usare un subagent:**

- Un’attività banale e una tantum o una semplice chiamata a uno strumento. Un subagent comporta un costo di avvio.
- Quando le attività devono condividere lo stato. I subagent non possono vedere il contesto degli altri; il lavoro correlato dovrebbe restare nel thread principale.

Il principale antipattern:

Dare Opus e tutti gli strumenti a un subagent significa solo creare un’altra sessione principale. Se il suo elenco di strumenti corrisponde a quello dell’agente principale, il subagent non è vincolato in modo adeguato.

In altre parole, un subagent con le stesse autorizzazioni del genitore è solo un secondo amministratore delegato. Inutile e costoso.

## Che cos’è un server MCP e quando conviene collegarne uno a Claude Code?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Evidenziazioni della sezione">

Punto chiave

MCP (Model Context Protocol) è uno standard aperto di Anthropic per collegare l’IA a sistemi esterni: database, API, file system e SaaS. A giugno 2026, Claude, ChatGPT, Cursor, VS Code e decine di altri client lo supportano. Il sito modelcontextprotocol.io offre un’analogia utile: MCP è una porta USB-C per le applicazioni IA.

</div>

La definizione ufficiale:

<figure>
<blockquote>
<p>Pensa a MCP come a una porta USB-C per le applicazioni IA. Così come USB-C ha standardizzato il modo in cui si connettono i dispositivi elettronici, MCP offre un modo standard per collegare le applicazioni IA ai sistemi esterni.</p>
</blockquote>
<figcaption>— modelcontextprotocol.io, https://modelcontextprotocol.io/introduction</figcaption>
</figure>

Che cosa permette davvero di fare MCP nella pratica:

- Collegare Claude a Google Calendar e Notion per ottenere un assistente personale.
- Collegarsi a Figma affinché Claude generi un progetto web pronto all’uso a partire da un design.
- Collegare contemporaneamente un chatbot aziendale a diversi database.
- Collegarsi a Blender e a una stampante 3D per creare modelli e stamparli immediatamente.

I server MCP più noti che si installano per primi:

| Server MCP | A cosa si collega | Dove reperirlo |
|----|----|----|
| **Context7** | Documentazione aggiornata di qualsiasi libreria | Plugin di claude-plugins-official |
| **GitHub** | Issue, PR, repository | claude-plugins-official |
| **Filesystem** | File nelle cartelle consentite (in Claude Code, solo le cartelle di lavoro) | Il server di riferimento del progetto MCP, repository modelcontextprotocol/servers |
| **Postgres** | Accesso diretto al database | Il server di riferimento è stato dismesso; il sostituto attivo è DBHub di Bytebase |
| **Magic MCP by 21st.dev** | Animazioni e componenti UI | Catalogo MCP |
| **Slack / Linear / Jira / Notion** | Integrazioni per il lavoro | claude-plugins-official |

Le connessioni e i comandi d’installazione sono raccolti nel catalogo MCP.

**Quando usare MCP:**

- Per qualsiasi connessione a dati o azioni esterni: «recupera righe dal database», «leggi i ticket di Jira», «pubblica su Slack».
- Quando lo stesso servizio serve a più progetti o agenti, è più semplice mantenere un unico server centralizzato.

**Quando NON usare MCP:**

- Per conoscenze statiche o procedure. Serve una skill, non MCP. «Istruzioni per fare una revisione del codice» è una skill. «Leggi l’ultima PR su GitHub e revisionarla» richiede MCP.
- Per un comando CLI da usare una volta. È più semplice usare `Bash` che configurare un server.
- Se vuoi creare MCP «per il gusto di avere un’architettura corretta». È una questione estetica, non un’attività.

La principale insidia di MCP è una delle maggiori cause delle lamentele «Claude Code si comporta da stupido» nel 2026:

Quando installi tutti questi MCP insieme, finisci per soffocare la finestra di contesto dell’LLM: tutti gli strumenti disponibili vengono caricati nel contesto.

Una regola pratica: mantieni attivi non più di 2–3 server MCP, ciascuno dedicato a compiti specifici. Nell’esperienza descritta con molti server, l’avvio era più lento e gli errori più frequenti.

La **ricerca degli strumenti MCP** è stata aggiunta in Claude Code v2.1.x: gli strumenti non vengono più caricati avidamente nel contesto, ma indicizzati e recuperati su richiesta. Questo riduce il costo di avere «molti MCP in un progetto», ma non lo elimina del tutto.

## In che cosa un plugin differisce da una skill e perché il confine si è sfumato?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Evidenziazioni della sezione">

Punto chiave

Un plugin è un pacchetto pronto all’uso. Può contenere una skill, un subagent, un server MCP e un hook, in qualsiasi combinazione. Anthropic ha riunito tutto in un unico formato per consentire l’installazione con un solo comando `/plugin install` e l’aggiornamento automatico. Il marketplace `claude-plugins-official` è stato lanciato a febbraio 2026; a giugno contava già 101 plugin. La distinzione tra «skill autonoma» e «plugin composto da una skill» riguarda solo il confezionamento.

</div>

La formulazione ufficiale:

<figure>
<blockquote>
<p>I plugin estendono Claude Code con skill, agenti, hook e server MCP. I marketplace di plugin sono cataloghi che aiutano a trovare e installare queste estensioni senza doverle assemblare da sé. Immagina di collegare un app store: dopo aver aggiunto un negozio, hai accesso a una raccolta, ma sei tu a decidere quali app scaricare.</p>
</blockquote>
<figcaption>— Claude Code Docs, https://code.claude.com/docs/en/discover-plugins</figcaption>
</figure>

I più installati a giugno 2026:

| Posizione | Plugin | Installazioni | Contenuto |
|----|----|----|----|
| 1 | **Frontend Design** (Anthropic) | 829 316 | Skill + subagent per il design |
| 2 | **Context7** (Upstash) | 348 660 | Wrapper MCP per la documentazione |
| 3 | **Code Review** (Anthropic) | 347 221 | 5 subagent paralleli per le revisioni |
| 4 | **Code Simplifier** | 284 632 | Skill + hook per la semplificazione |
| 5 | **TypeScript LSP** | 177 136 | Plugin LSP |
| 6 | **Pyright LSP** | 91 225 | Plugin LSP |

L’analisi completa è disponibile nella guida ai 10 migliori plugin su 101.

**Quando usare un plugin:**

- Un pacchetto della community pronto all’uso che copre gran parte di un flusso di lavoro, come la progettazione o la revisione.
- Quando non vuoi assemblare a mano una configurazione «skill + subagent + MCP + hook», puoi usarne una già pronta.
- Distribuzione aziendale: un amministratore crea un marketplace per il team e gli sviluppatori installano i plugin da un unico prefisso.

**Quando NON usare un plugin:**

- L’attività si risolve con una sola skill, ma il pacchetto si porta dietro altri cinque MCP «per ogni evenienza». È solo confusione nel contesto.
- Un plugin closed source senza verifica. Viene eseguito con le tue autorizzazioni: controllane il contenuto prima di installarlo.
- Hai già un plugin tuo sullo stesso argomento. Un duplicato nel contesto raddoppia il problema.

Prima dell’installazione, Claude Code v2.1.143+ mostra **Context cost**, una stima dei token che il plugin aggiungerà a ogni messaggio. Dalla v2.1.145+, mostra il campo **Will install** con l’elenco completo di comandi, agenti, skill, hook, MCP e LSP inclusi nel pacchetto. Prima di fare clic su «installa», è la prima schermata da aprire.



## Quale matrice di selezione funziona nel 2026?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Evidenziazioni della sezione">

Punto chiave

L’elemento principale della guida è un albero decisionale con sei domande. Procedi dall’alto verso il basso e fermati alla prima risposta affermativa. Questo algoritmo copre il 95% delle attività. Il restante 5% riguarda scenari complessi che richiedono una combinazione di un subagent Haiku, una skill precaricata per le convenzioni e un server MCP con ambito ristretto per i dati aggiornati. Questa è la «formula 2026» che dà risultati.

</div>

Sei domande, in ordine di priorità:

1.  **È una procedura ricorrente, uno stile o una lista di controllo?** Se sì, **skill**.
2.  **Servono dati o azioni esterni** (database, API, Slack, GitHub, Figma)? Se sì, **server MCP**.
3.  **Voglio un contesto separato** per non sovraccaricare quello principale? Se sì, **subagent**.
4.  **Voglio un controllo o un passaggio automatico a un evento definito?** Se sì, **hook**, dopo averne verificato la copertura; per confini di accesso più ampi usa autorizzazioni o isolamento dell’ambiente.
5.  **Voglio un pacchetto pronto all’uso da 1–4 in un solo clic?** Se sì, **plugin** dal marketplace.
6.  **È un’attività complessa che richiede dati, contesto e stile?** Allora usa una **combinazione**: subagent Haiku + skill precaricata + un MCP con ambito ristretto.

Formula della combinazione:

Un subagent Haiku con una skill precaricata per le convenzioni e un server MCP con ambito ristretto per i dati aggiornati è uno schema che dà davvero risultati.

E la regola fondamentale sulla direzione delle dipendenze:

I subagent possono usare i server MCP. I server MCP non possono usare i subagent.

In altre parole, MCP serve sempre per dati e azioni, non per gli agenti. Se vuoi delegare un’attività, è un subagent che chiama MCP, non il contrario.

Un esempio concreto descritto qui: un motore editoriale di un’agenzia digitale che scrive un articolo SEO in 60 minuti. Al suo interno ci sono **25 subagent e 14 fasi di revisione**: operano in sequenza, ciascuno con il proprio contesto, le proprie autorizzazioni e la propria skill per le convenzioni editoriali. Un subagent si collega a un server MCP con un database di tag già pronti e vecchi articoli. L’agente orchestratore principale usa Opus; gli agenti figli usano Haiku, contenendo il budget.

Non si tratta di una «fabbrica di articoli», ma di un esempio di come tutti e quattro i meccanismi si combinano in un unico sistema quando il compito richiede profondità e qualità anziché velocità.

## Quali 7 errori dovresti eliminare subito da Claude Code?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Evidenziazioni della sezione">

Punto chiave

Questi sono i sette errori principali discussi nell’articolo. Ognuno riduce la qualità delle risposte e consuma token. Ognuno si corregge in 5–15 minuti. Se nell’ultimo mese hai installato più di dieci plugin, quasi certamente ne hai commessi almeno tre.

</div>

1.  **Hai installato tutti i 10 migliori plugin «perché vanno di moda».** Ognuno aggiunge token a ogni messaggio. Apri `/plugin list` e controlla il Context cost di ciascuno. Rimuovi quelli che non usi da due settimane.

2.  **Hai copiato 15 server MCP dal `.mcp.json` di qualcun altro.** Lo stack di un’altra persona è configurato per i suoi progetti e le sue attività. Mantieni attivi non più di 2–3 MCP per il progetto corrente. Sposta gli altri in una configurazione separata per un altro progetto oppure eliminali ora.

3.  **La skill e il plugin MCP fanno la stessa cosa.** La skill dice «fai una revisione del codice», mentre il plugin `pr-review-toolkit` segue il proprio flusso di revisione. Cominciano a contendersi la priorità. Il sintomo: «Claude, perché continui a cambiare idea?». Soluzione: mantieni un’unica fonte autorevole. Nella configurazione descritta è stata scelta la skill per mantenere il controllo sulle istruzioni.

4.  **Usi una skill per far rispettare una regola quando ti serve un hook.** Una skill è un suggerimento, non una garanzia. Per «blocca `.env` in un commit», un **hook pre-commit** può controllare quel percorso. Prova separatamente il contenuto nell’area di staging e i percorsi alternativi: non impedisce tutte le letture o altre forme di pubblicazione. Una skill da sola non può far rispettare questo confine.

5.  **Un subagent ha le stesse autorizzazioni del genitore.** Gli hai dato Opus e tutti gli strumenti e hai ottenuto un’altra sessione principale. Il prompt di sistema della documentazione ufficiale consiglia di assegnare al subagent un elenco ristretto di strumenti e un’attività vincolata. Altrimenti, è solo un clone costoso.

6.  **Non hai controllato Will install prima di installare un plugin.** Da Claude Code v2.1.145+, questo campo mostra il contenuto completo del pacchetto. Spesso un plugin «per una cosuccia» contiene tre server MCP, due subagent e cinque hook. Cominciano tutti a occupare il tuo contesto.

7.  **La vecchia cartella `.claude/commands/` duplica le nuove skill.** Anthropic afferma nella documentazione:

<figure>
<blockquote>
<p>I comandi personalizzati sono stati integrati nelle skill. Il file <code>.claude/commands/deploy.md</code> e la skill <code>.claude/skills/deploy/SKILL.md</code> creano entrambi <code>/deploy</code> e funzionano allo stesso modo.</p>
</blockquote>
<figcaption>— Claude Code Docs, https://code.claude.com/docs/en/skills</figcaption>
</figure>

La vecchia cartella `commands/` funziona ancora, ma le skill sono ormai lo standard. Nell’esempio descritto erano in uso entrambe le cartelle; `commands/` è stata rimossa, lasciando le skill con i file inclusi e i trigger.

Segnali che Claude Code è diventato «disordinato»:

- Ogni messaggio inizia elencando gli strumenti disponibili in oltre 200 righe.
- Le attività semplici richiedono più tempo rispetto a un mese fa.
- Claude si confonde tra due skill o plugin simili.
- All’avvio della sessione compaiono avvisi di conflitto tra nomi.
- Claude chiama lo strumento sbagliato: la skill A invece dell’MCP B, che serviva.

Se riconosci almeno due di questi sintomi, apri subito `/plugin list` e `/skill list`. Per prima cosa rimuovi ciò che non usi da due settimane. Poi controlla il Context cost di ogni elemento. Infine, affronta gli antipattern qui sopra.

## Quante skill e MCP puoi mantenere senza esaurire il contesto?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Evidenziazioni della sezione">

Punto chiave

Non ci sono limiti rigidi, ma esistono soglie pratiche. Mantieni fino a 10–12 skill attive, altrimenti i meta-limiti di Anthropic inizieranno a sottrarre spazio a ciascuna durante la compattazione automatica. Mantieni attivi non più di 2–3 server MCP in un progetto. Usa i plugin solo quando il loro Context cost è inferiore a 1.000 token per messaggio. Queste soglie si basano sulla pratica, non sulla teoria.

</div>

Ciò che Claude Code mostra direttamente:

- `/skill list` — tutte le skill attive e la loro dimensione in token.
- `/plugin list` — tutti i plugin e il loro Context cost.
- `/mcp list` — server MCP e conteggio dei relativi strumenti.

Budget di token in cifre reali:

| Meccanismo | Costo quando è inattivo | Costo quando si attiva | Capacità del contesto |
|----|----|----|----|
| **Skill** | ~100 token (solo metadati) | Istruzioni caricate e risorse effettivamente lette | Usa il contesto di chi la richiama |
| **Subagent** | ~50 token (nome e descrizione) | Input, output, risultati degli strumenti e turni ripetuti effettivi | Finestra separata; 200K è un esempio di capacità, non un addebito per delega |
| **Server MCP** | Descrizioni degli strumenti caricate dal client | Argomenti e risultati caricati; l’esecuzione del servizio può avere un costo proprio | Usa il contesto di chi lo richiama |
| **Plugin** | Somma dei componenti interni caricati | Uso effettivo dei suoi componenti interni | Dipende dai componenti |

La finestra di contesto è lo spazio di lavoro massimo, non il numero di token consumati da ogni attività. Per lo stesso risultato confronta input misurato, input in cache, output e turni ripetuti. L’isolamento può mantenere piccolo il contesto principale, mentre il subagent produce comunque un consumo proprio.

Nel suo blog tecnico, Anthropic indica questi valori per la compattazione automatica delle skill: vengono riagganciati i primi 5.000 token di ogni skill attiva, con un budget complessivo di 25.000. Ciò significa che con più di 5 skill «pesanti» attive contemporaneamente, Claude comincia a perdere alcune istruzioni.

Una semplice regola pratica:

- **Skill:** non più di 5–7 attive per il progetto corrente. Metti le altre in `~/.claude/skills/disabled/`; se ti servono, puoi rimetterle al loro posto.
- **MCP:** non più di 2–3 per progetto. Context7 per la documentazione è quasi sempre utile; mantieni gli altri specifici per attività.
- **Plugin:** installane rigorosamente uno alla volta e, dopo due settimane, controlla se lo hai usato. In caso contrario, rimuovilo.

Un’analisi dettagliata dell’Anthropic 2026 Agentic Coding Trends Report e del motivo per cui l’80% degli sviluppatori non riesce a delegare completamente un’attività a Claude è disponibile in una guida separata. Il dato principale del rapporto: le persone usano l’IA per il 60% del proprio lavoro, ma le delegano completamente solo lo 0–20% delle attività. Il motivo principale è il sovraccarico del contesto e la perdita di controllo sugli strumenti.

## Da dove dovrebbe iniziare un principiante: la configurazione minima funzionante

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Evidenziazioni della sezione">

Punto chiave

Se hai appena iniziato e non sai cosa scegliere, non installare nessuno degli elementi elencati qui. Prima costruisci le fondamenta: CLAUDE.md, una cartella separata con il contesto del progetto e una struttura di base per le attività. Dedica due settimane ad attività reali usando Claude Code senza aggiunte. Poi sarà chiaro dove hai una procedura ricorrente (serve una skill), dove ti mancano dati aggiornati (serve MCP) e dove un’attività comincia a riempire il contesto (serve un subagent).

</div>

Stack minimo dopo due settimane di lavoro:

1.  **CLAUDE.md** nella radice, con le regole del progetto.
2.  **AGENTS.md** per la compatibilità con altri strumenti, se prevedi di lavorare anche fuori da Claude Code. Maggiori dettagli in [«Come creare un unico file di istruzioni per Claude Code, Codex e Cursor»](https://ailoot.ai/blog/it/agents-md-claude-md-one-instruction-file/).
3.  **1 skill** per la tua attività ricorrente principale. Per esempio, inizia con `code-review` secondo la tua guida di stile.
4.  **1 server MCP**: Context7 per la documentazione aggiornata. Senza, Claude continua ad allucinare API inesistenti.
5.  **0 plugin e 0 subagent** nel primo mese. Non si tratta di risparmiare denaro, ma di avere il controllo. Finché non capisci le basi, i pacchetti ti confonderanno.

Da lì, segui le attività. Compare una procedura ricorrente? Trasformala in una skill. Servono dati aggiornati da un servizio specifico? Aggiungi MCP. Un’attività grande comincia a riempire il contesto principale? Delegala a un subagent.

Questa è la mappa a tre livelli: **prima il contesto**, poi **affida al sistema ciò che fai più di un paio di volte**, infine **controlli automatici affinché il sistema non commetta errori da solo**. Aggiungi ogni livello solo quando il precedente funziona già.

<div class="section" role="doc-bibliography" aria-label="Fonti">

### Fonti

- [Panoramica di Agent Skills - Anthropic Docs](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)
- [Skill - Claude Code Docs](https://code.claude.com/docs/en/skills)
- [Subagent - Claude Code Docs](https://code.claude.com/docs/en/sub-agents)
- [Plugin - Claude Code Docs](https://code.claude.com/docs/en/discover-plugins)
- [Equipaggiare gli agenti per il mondo reale con Agent Skills - Anthropic Engineering](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)
- [Introduzione a MCP - modelcontextprotocol.io](https://modelcontextprotocol.io/introduction)
- [GitHub anthropics/skills - repository aperto](https://github.com/anthropics/skills)
- [Anthropic 2026 Agentic Coding Trends Report](https://resources.anthropic.com/2026-agentic-coding-trends-report)

</div>







<div class="aside" data-semantic="ailoot-link" aria-label="Ailoot">

Puoi continuare a esplorare Ailoot su [ailoot.ai](https://ailoot.ai/).

</div>

## Domande frequenti

### Delegare a un subagent consuma automaticamente 200K token?

No. La finestra di contesto indica una capacità. Il consumo dipende da input e output effettivamente elaborati, risultati degli strumenti e turni successivi. Confronta il consumo totale misurato, incluso l’input in cache, senza considerare la finestra massima come una tariffa fissa per delega.

### Quando scelgo una skill, un server MCP o un subagent?

Usa una skill per una procedura ricorrente, MCP per accedere a sistemi aggiornati e un subagent quando un’attività circoscritta riempirebbe la conversazione principale di dettagli di lavoro. Un plugin raccoglie questi componenti: esaminane il contenuto prima di installarlo.


## Ailoot · L’azienda e il suo portafoglio di progetti

Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI.

L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.

Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.
