Projects e Skills di Claude per un piccolo team: come impostarli e mantenerli

Projects e Skills di Claude per un piccolo team rispondono a due bisogni diversi. Il primo è tenere in un unico posto il contesto e i documenti di un processo. Il secondo è trasformare le procedure che il team ripete ogni settimana in istruzioni che Claude segue sempre allo stesso modo.

Questo post propone un criterio semplice: un Project per ogni processo, una Skill per ogni procedura scritta. Il problema che risolve è concreto. In un team di poche persone ognuno finisce per spiegare a Claude le stesse cose con parole diverse, allegare versioni diverse dello stesso listino e ottenere risposte che non si somigliano.

Il risultato è lavoro ripetuto e una qualità che dipende da chi ha scritto la richiesta. Con una struttura condivisa, invece, il contesto è lo stesso per tutti e le procedure hanno una versione ufficiale con un responsabile.

La guida segue l'ordine in cui conviene lavorare. Prima i termini, poi la struttura, un esempio completo, la condivisione, la manutenzione e le verifiche. Alla fine trova una tabella per decidere dove mettere ogni elemento e i passi concreti per iniziare.

Una Skill, secondo il centro assistenza di Anthropic, è una cartella di istruzioni, script e risorse che Claude carica in modo dinamico per lavorare meglio su compiti specifici. Nella pagina che spiega che cosa sono le Skill si legge anche che sono disponibili sui piani Free, Pro, Max, Team ed Enterprise e che richiedono l'esecuzione di codice attiva.

Il meccanismo alla base si chiama progressive disclosure: Claude decide quali Skill sono pertinenti e carica solo le informazioni necessarie per il compito, così la finestra di contesto non si riempie di materiale inutile. È il motivo per cui un team può avere molte Skill senza rallentare ogni conversazione.

Un connettore MCP è un'altra cosa. Anthropic lo riassume così: le connessioni MCP danno a Claude l'accesso agli strumenti, le Skill gli insegnano a usarli bene. Le due parti si usano insieme.

Un Project, in questo post, è lo spazio condiviso in cui il team tiene le istruzioni generali e i documenti di riferimento di un processo. Le pagine ufficiali usate qui descrivono in dettaglio le Skill e Claude Code, dove lo stesso ruolo lo svolgono la cartella di progetto e il file CLAUDE.md. Per limiti e impostazioni dei Projects nell'interfaccia web conviene consultare direttamente il centro assistenza di Claude.

La scelta di struttura più utile è legare ogni Project a un processo aziendale: offerte, assistenza clienti, amministrazione, selezione del personale. Un Project per persona riproduce il disordine di partenza, perché ognuno accumula le proprie istruzioni e i propri file.

Dentro il Project va il contesto stabile, cioè ciò che vale per ogni richiesta di quel processo. Per esempio chi sono i clienti, il tono da usare, i termini da evitare, i documenti di riferimento. Le procedure che si eseguono passo per passo, invece, vanno nelle Skill.

La documentazione di Claude Code offre un buon criterio di misura. Consiglia di tenere il file CLAUDE.md sotto le 200 righe e, quando cresce, di spostare il materiale di riferimento nelle Skill. Precisa anche che i file CLAUDE.md si sommano tra livelli: tutti contribuiscono al contesto nello stesso momento. Lo stesso principio vale per le istruzioni generali di un Project: poche regole chiare, perché si aggiungono a tutto il resto.

Se il Suo team usa già Claude in modo intensivo a livello individuale, la guida su come usare Claude come un power user aiuta a capire quali abitudini personali meritano di diventare contesto condiviso.

Una Skill è, in pratica, una procedura operativa scritta in modo che Claude la possa seguire. Per le Skill semplici basta scrivere istruzioni in Markdown, senza programmare. Alle Skill personalizzate si possono allegare script eseguibili quando serve una funzione più avanzata.

In Claude Code la Skill è un file SKILL.md dentro una cartella dedicata, per esempio .claude/skills/deploy/SKILL.md. Claude la usa quando la ritiene pertinente, oppure la si richiama direttamente con /nome-skill. Il corpo della Skill si carica solo quando viene usata, quindi anche un materiale di riferimento lungo non pesa sul contesto finché non serve.

Tre dettagli che fanno la differenza

• La descrizione. Claude decide quando usare la Skill leggendo la sua descrizione. In Claude Code, descrizione e testo when_to_use insieme vengono troncati a 1.536 caratteri nell'elenco delle Skill: le informazioni decisive vanno all'inizio.
• L'uso solo manuale. Con disable-model-invocation: true nell'intestazione della Skill, Claude non la vede finché non la richiama una persona. È l'impostazione giusta per le procedure delicate.
• I campi ammessi. Il caricamento su claude.ai e la Skills API accettano solo i sei campi di intestazione previsti dalla specifica. Un campo in più non viene ignorato: blocca il caricamento con un errore.

Le Skill di Claude Code seguono lo standard aperto Agent Skills, pubblicato su agentskills.io, che funziona con più strumenti AI. Una procedura scritta bene non resta quindi chiusa in un solo prodotto.

Prendiamo un'azienda di otto persone che gestisce le richieste dei clienti in Zoho Desk. Il processo più ripetuto è la risposta alle segnalazioni di difetto, oggi scritta ogni volta da zero.

1. Il Project. Si crea un Project chiamato "Assistenza clienti". Nelle istruzioni generali si scrivono poche regole: si dà del Lei, non si promettono rimborsi, si cita sempre il numero della richiesta. Tra i documenti si carica la versione in vigore delle condizioni di garanzia.
2. La Skill. Si crea una cartella risposta-reclamo con un file SKILL.md. La descrizione dice: "Da usare quando un cliente segnala un difetto o chiede un reso". Il corpo elenca i passi: leggere la richiesta, verificare la copertura nelle condizioni di garanzia, preparare una bozza, segnalare i casi fuori garanzia a un responsabile.
3. Il caricamento. La cartella si comprime in un file ZIP e si carica nelle impostazioni delle Skill di Claude, in Customize > Skills.
4. La condivisione. La Skill si condivide con le persone dell'assistenza, che la possono attivare e usare ma non modificare.
5. Il collegamento ai dati. Se in seguito si collega Zoho Desk tramite un connettore MCP, la Skill resta identica: il connettore porta i dati, la Skill descrive che cosa farne.

Chi lavora in Claude Code può tenere la stessa Skill in .claude/skills/risposta-reclamo/SKILL.md e richiamarla con /risposta-reclamo. Se la risposta deve partire solo su richiesta esplicita, si aggiunge disable-model-invocation: true.

La documentazione di Claude Code distingue due tipi di contenuto in una Skill. Il contenuto di riferimento aggiunge conoscenza che Claude applica al lavoro in corso: convenzioni, guide di stile, conoscenza di settore. Il contenuto operativo dà istruzioni passo per passo per un'azione precisa.

Per un piccolo team la regola pratica è questa. Il materiale che serve a quasi ogni richiesta del processo sta nel Project. Quello lungo e consultato di rado, come un manuale tecnico o un listino completo, sta dentro una Skill, perché si carica solo quando la Skill viene usata.

Per i documenti in uscita non serve costruire nulla. Anthropic crea e mantiene Skill per creare e modificare fogli Excel, documenti Word, presentazioni PowerPoint e file PDF, e Claude le usa automaticamente quando sono pertinenti. Le Skill attivate nelle impostazioni di Claude sono disponibili anche nei componenti aggiuntivi Claude per Excel, PowerPoint, Word e Outlook, dettaglio che la pagina su come usare le Skill in Claude riporta esplicitamente.

Come tenere ordinati i file

• Un solo file per argomento, senza copie parallele in cartelle personali.
• Nel nome del file, la data della versione in vigore.
• Per ogni file, una persona che risponde del suo contenuto.

Il centro assistenza distingue due modi di mettere una Skill a disposizione degli altri. Condividere significa darla a persone o gruppi specifici mantenendone il controllo: i destinatari la vedono in sola lettura. Pubblicare significa inviarla alla libreria dell'organizzazione, dove chiunque la può installare e da quel momento la gestisce l'organizzazione.

Sui piani Team ed Enterprise gli Owner dell'organizzazione possono assegnare Skill a tutti gli utenti, attive o disattivate per impostazione predefinita. Compaiono in automatico nell'elenco di ogni membro, che in Customize > Skills è diviso in tre sezioni.

Chi usa anche Claude Code deve conoscere qualche regola in più:

• Se due Skill hanno lo stesso nome, prevale quella aziendale su quella personale e quella personale su quella di progetto.
• Le sessioni di Cowork e le sessioni cloud non leggono le Skill salvate in ~/.claude/skills/ sul computer locale.
• Claude Code scarica le Skill sincronizzate da claude.ai e non le carica mai; durante la sessione controlla le modifiche circa ogni 10 minuti.
• La sincronizzazione non avviene con accesso tramite chiave API o su un fornitore cloud come Amazon Bedrock.

Se il team lavora con Cowork, la guida su come usare Claude Cowork in azienda mostra come partire dai processi già esistenti.

Una Skill condivisa si aggiorna da sola per chi la riceve: se l'autore la modifica, i destinatari ottengono la nuova versione al successivo utilizzo. È comodo, ma vale anche per gli errori. Una frase sbagliata raggiunge tutto il team senza che nessuno se ne accorga.

Per questo ogni Project e ogni Skill ha bisogno di un responsabile con un nome. Il responsabile del Project controlla le istruzioni generali e i documenti. Il responsabile della Skill risponde della procedura e ne approva ogni modifica.

Nella pratica di Svennis, quando configuriamo Project e Skill presso i clienti, assegniamo a ogni procedura un solo responsabile e la proviamo su richieste reali già chiuse prima di condividerla con il resto del team. Dove questo passaggio viene saltato vediamo lo stesso problema: la Skill funziona sul caso scritto dall'autore e sbaglia sui casi che l'autore non aveva previsto.

Una routine di manutenzione sostenibile

• Una nota in fondo al file SKILL.md con data e motivo di ogni modifica.
• Un controllo periodico, per esempio a ogni cambio di listino o di condizioni contrattuali.
• Un canale unico dove il team segnala le risposte sbagliate al responsabile.

La documentazione di Claude Code è netta su un punto: un'istruzione come "non modificare mai questo file", scritta in CLAUDE.md o in una Skill, è una richiesta e non una garanzia. Un hook è diverso. Si attiva sempre al suo evento, mentre l'esito di una Skill può variare perché Claude interpreta le istruzioni. Un hook di tipo PreToolUse che blocca un'azione è un vincolo vero.

Ne deriva un metodo di verifica in tre passi. Primo, si prepara un piccolo insieme di casi reali, compresi quelli difficili, con la risposta attesa. Secondo, si esegue la Skill su ogni caso e si confronta il risultato. Terzo, si ripete la prova a ogni modifica della Skill o dei documenti del Project.

Sicurezza

Il centro assistenza indica come rischi principali la prompt injection, cioè la manipolazione di Claude perché compia azioni non volute, e l'esfiltrazione di dati. Le Skill possono anche includere pacchetti software di terze parti o chiedere a Claude di installarli. Una Skill scaricata va quindi letta prima di essere attivata.

Sul piano Enterprise si può attivare la scansione delle Skill: ogni Skill di terze parti caricata o modificata viene controllata prima di poter essere eseguita, e la maggior parte delle scansioni termina in uno o due minuti. Per fissare le regole su che cosa il personale può inserire, è utile la guida alla policy AI per i dipendenti.

La tabella riassume dove mettere ogni elemento, con il motivo e il responsabile tipico in un team piccolo. Le righe su hook e connettori riguardano Claude Code e i collegamenti ai sistemi aziendali, dove disponibili.

Quando il numero di Skill, connettori e hook cresce, conviene raggrupparli. Un plugin riunisce Skill, hook, subagent e server MCP in un'unica unità installabile, con le Skill distinte da un prefisso. La guida sui plugin Claude per una piccola impresa spiega quando ha senso farlo.

Per una piccola impresa italiana il primo vantaggio è linguistico. Anthropic indica che tutti i modelli attuali hanno capacità multilingue, e le Skill si scrivono in Markdown: le procedure possono restare in italiano, con il lessico dell'azienda e del settore, senza traduzioni intermedie.

Il secondo riguarda gli strumenti già in uso. Molte aziende lavorano su Excel, Word e Outlook, e le Skill attivate valgono anche nei relativi componenti aggiuntivi. Chi gestisce clienti e opportunità in Zoho CRM può aggiungere un connettore e lasciare alle Skill la procedura, come descritto nella guida al collegamento tramite MCP con permessi e controlli.

Il terzo riguarda la scelta del piano. Se l'obiettivo è distribuire le stesse Skill a tutto il personale, serve un piano Team o Enterprise, dove gli Owner possono assegnarle a tutti. La scansione delle Skill di terze parti è disponibile solo su Enterprise.

Infine, nelle organizzazioni con configurazioni regolamentate le Skill e la loro condivisione sono disattivate per impostazione predefinita e le attiva un amministratore. Chi opera in un settore regolamentato deve quindi prevedere questo passaggio e decidere prima chi ne ha l'autorità.

1. Scelga un processo. Quello ripetuto più spesso e con più variazioni tra una persona e l'altra, per esempio le risposte ai clienti o le prime bozze di offerta.
2. Scriva il contesto del Project. Poche regole generali e i documenti in vigore, ciascuno con un responsabile.
3. Trasformi una procedura in Skill. Una cartella, un file SKILL.md, una descrizione che dica chiaramente quando usarla, solo i campi di intestazione ammessi.
4. La verifichi su casi reali. Richieste già chiuse, compresi i casi difficili, confrontando il risultato con la risposta attesa.
5. La condivida con il gruppo giusto. Prima in condivisione controllata, poi, se regge, nella libreria dell'organizzazione.
6. Fissi la manutenzione. Nota delle modifiche, controllo a ogni cambio di documenti, un canale unico per le segnalazioni.

Se il team deve prima prendere confidenza con Claude, la guida su come imparare Claude con l'Anthropic Academy indica un percorso di formazione collegato ai processi aziendali. Se invece le basi ci sono già, il passo successivo è collegare le Skill ai sistemi che l'azienda usa ogni giorno.