Come creare un plugin Claude Cowork e sviluppare il tuo dipendente AI (Corso completo)

La maggior parte delle persone tratta Claude Cowork come un semplice organizzatore di file.

Salva questo :)

Chiedigli di ordinare alcuni file. Convertire un foglio di calcolo. Magari rinominare una cartella.

Questa è la versione junior di Cowork.

La versione senior consiste nel creare un plugin — un dipendente AI completo che conosce il tuo settore, segue il tuo esatto processo, produce il tuo formato di output specifico ed esegue i tuoi flussi di lavoro in autonomia mentre tu fai altro.

Un dipendente AI che si presenta ogni giorno, non si ammala mai, non ha bisogno di essere addestrato due volte e migliora ogni singola settimana.

Un plugin di Cowork è un pacchetto strutturato che contiene tutto ciò di cui Claude ha bisogno per svolgere un ruolo specifico: le competenze, i comandi, i materiali di riferimento, le regole e i controlli di qualità. Lo installi una volta e hai un dipendente.

Questo è il corso completo per crearne uno.

Cos'è realmente un Plugin

Un plugin è una cartella. Tutto qui. Una cartella con una struttura specifica che dice a Cowork esattamente cosa fare e come farlo.

All'interno di quella cartella:

markdown

1my-plugin/
2├── .claude-plugin/
3│   └── plugin.json        ← Identità: nome, ruolo, descrizione
4├── skills/
5│   └── primary-task/
6│       └── SKILL.md        ← Il flusso di lavoro: processo passo-passo
7├── commands/
8│   └── run-task.md         ← Comandi slash: /prefisso:comando
9├── references/
10│   └── templates.md        ← Materiali di riferimento: template, benchmark, esempi
11├── global-instructions.md  ← Ordini permanenti: personalità, preferenze, impostazioni predefinite
12└── folder-instructions.md  ← Contesto specifico del progetto

plugin.json dice a Cowork che questa cartella è un plugin, quale ruolo svolge e quando attivarsi.

SKILL.md è il cervello — il processo passo-passo che il tuo dipendente AI segue per ogni attività. Questo è il file più importante. Se lo fai bene, tutto il resto funziona.

Commands sono trigger tramite comando slash. Scrivi /prefisso:comando e l'intero flusso di lavoro si attiva.

References sono i template, i benchmark, i dati di settore e gli esempi di cui il tuo dipendente ha bisogno per svolgere correttamente il lavoro.

Global instructions sono gli ordini permanenti — personalità, stile di comunicazione, standard di qualità e presupposti predefiniti.

Folder instructions sono il contesto specifico del progetto — cosa c'è in questa cartella, quali sono le priorità correnti e come gestire i dati specifici qui presenti.

Fase 1: Ricerca del Ruolo (30 Minuti)

Prima di scrivere un singolo file, devi sapere esattamente cosa fa il tuo dipendente AI.

Apri Claude e usa questo prompt:

"Ricerca il flusso di lavoro professionale completo per un [RUOLO] nel settore [INDUSTRIA]. Includi: il processo passo-passo che segue, gli strumenti e le fonti di dati che utilizza, le metriche chiave e i criteri decisionali, i formati di output comuni e i casi limite e le insidie a livello esperto. Sii completo — sto costruendo un flusso di lavoro automatizzato da questo."

Leggi attentamente l'output. Questo è il materiale grezzo da cui verrà costruito il tuo file di skill.

Ora intervista te stesso. Che aspetto ha la TUA versione di questo processo? Quali scorciatoie prendi? Quali controlli di qualità esegui sempre? A quali errori presti sempre attenzione? Che aspetto ha "buono" rispetto a "cattivo"?

I migliori dipendenti AI non sono costruiti a partire da best practice generiche. Sono costruiti a partire dalla TUA esperienza specifica.

Fase 2: Scrivere il File Skill (60 Minuti)

Il file SKILL.md è il cervello del tuo dipendente AI. Tutto ciò che sa su come svolgere il suo lavoro vive qui.

Ecco la struttura:

name: [nome-skill]

description: [Quando dovrebbe attivarsi? Sii aggressivo con le frasi trigger.

"Usa questa skill quando l'utente dice: [elenca 5-7 frasi].

NON usare per: [elenca cose che sembrano simili ma sono diverse]."]

Panoramica

[Un paragrafo: cosa fa questa skill e cosa produce]

Processo

[Passaggi numerati. Ogni passaggio è specifico, testabile e inequivocabile.

Non "analizza i dati" ma "confronta il periodo corrente con il periodo precedente

e calcola la variazione percentuale per ogni metrica."]

[Passaggio con istruzione specifica]
[Passaggio con istruzione specifica]
[Passaggio con istruzione specifica] ...

Formato di Output

[Esattamente come si presenta il deliverable]

Formato del titolo
Intestazioni delle sezioni in ordine
Vincoli di lunghezza
Requisiti di formattazione

Regole

[I tuoi standard di qualità non negoziabili]

[Regola 1]
[Regola 2]
[Regola 3]

Casi Limite

[Cosa fare quando le cose non sono semplici]

Se [situazione]: [azione specifica]
Se [situazione]: [azione specifica]

Checklist di Qualità

[Esegui questo prima di consegnare qualsiasi output]

[ ] [Controllo 1]
[ ] [Controllo 2]
[ ] [Controllo 3]

Il campo description nel frontmatter YAML è la parte più critica. Se è troppo vago, la skill non si attiva mai. Se è troppo ampio, dirotta conversazioni non correlate. Elenca 5-7 frasi trigger specifiche E confini negativi espliciti.

Fase 3: Costruire i File di Supporto (30 Minuti)

Il plugin.json:

{

"name": "mio-dipendente-ai",

"description": "Un [RUOLO] che [COSA FA] per [CHI]",

"version": "1.0"

}

Il comando slash:

Crea un file markdown in /commands/ che attiva il tuo flusso di lavoro:

/dipendente:esegui

Esegui la skill [primary-task] sui dati nella cartella corrente.

Passaggi:

Leggi tutti i file rilevanti nella directory di lavoro
Esegui la skill seguendo ogni passaggio in SKILL.md
Esegui la checklist di qualità prima di consegnare
Salva l'output come [formato] nella cartella corrente
Fornisci un breve riepilogo di ciò che è stato prodotto

Istruzioni globali:

Sei un [RUOLO] con [ANNI] di esperienza nel settore [INDUSTRIA].

Ordini Permanenti:

Inizia con la raccomandazione, spiega dopo
Usa sempre numeri specifici, mai descrizioni vaghe
Se i dati mancano o sono ambigui, segnalalo — non indovinare mai
Formato di output predefinito: [TUA PREFERENZA]
Stile di comunicazione: [DIRETTO/CONVERSAZIONALE/FORMALE]
In caso di dubbio, chiedi piuttosto che presumere

File di riferimento:

Aggiungi tutti i template, i dati di benchmark, gli standard di settore o gli esempi di cui il tuo dipendente ha bisogno. Più specifici sono i tuoi materiali di riferimento, più il livello dell'output sarà esperto.

Fase 4: Installare, Testare e Perfezionare

Installa la cartella del plugin nel tuo ambiente Claude Cowork. Usa questo prompt in Cowork:

"Ho una cartella plugin in [PERCORSO]. Verifica che la struttura sia valida — controlla plugin.json, il frontmatter di SKILL.md e i file di comando. Installalo ed esegui un test rapido con il comando slash più semplice."

Ora testalo su lavoro reale. Non dati di esempio. Dati reali dal tuo flusso di lavoro effettivo.

Eseguilo 5 volte con input diversi. Dopo ogni esecuzione, valuta:

Ha seguito ogni passaggio in SKILL.md?
Ha seguito le regole?
L'output corrispondeva alle specifiche di formato?
Useresti questo output così com'è o necessita di modifiche significative?

Ogni volta che qualcosa non è all'altezza, aggiorna SKILL.md. Aggiungi una regola. Stringi un passaggio. Aggiungi un esempio che mostri cosa è buono rispetto a cosa è cattivo.

Questo ciclo di perfezionamento è ciò che trasforma un dipendente AI mediocre in uno eccezionale. Alla decima esecuzione, la qualità dell'output sarà drammaticamente superiore rispetto alla prima.

Fase 5: Scalare il Tuo Dipendente AI

Una volta che la tua skill principale funziona in modo affidabile, espandi le capacità del dipendente.

Aggiungi una seconda skill. Il tuo analista di ricerca ora può anche fare monitoraggio competitivo. Il tuo stratega dei contenuti ora può anche riutilizzare i contenuti. Ogni nuova skill è un nuovo file SKILL.md nella cartella skills.

Aggiungi flussi di lavoro automatizzati. Collega più skill in processi multi-passaggio attivati da un singolo comando slash. Ricerca → analisi → report → distribuzione. Un comando, quattro skill, zero passaggi manuali.

Aggiungi attività pianificate. Il tuo dipendente AI esegue il report settimanale ogni venerdì alle 16:00. Processa la posta in arrivo quotidiana ogni mattina alle 7:00. Scansiona i concorrenti ogni lunedì. Vera operatività autonoma.

Aggiungi sub-agenti. Per flussi di lavoro complessi, il tuo dipendente AI può attivare più sub-agenti che lavorano in parallelo. Cinque file elaborati simultaneamente invece che in sequenza. Il miglioramento della velocità si accumula con ogni sub-agente aggiuntivo.

Il Sistema di Revisione delle Performance

Ecco cosa separa chi costruisce un dipendente AI decente da chi ne costruisce uno eccezionale.

Ogni settimana, rivedi gli output. Nota cosa ha funzionato perfettamente, cosa ha richiesto correzioni e cosa hai dovuto rifare manualmente. Poi aggiorna SKILL.md.

Questo richiede 15 minuti a settimana. L'effetto cumulativo in due mesi è enorme.

Entro la settimana 1, il tuo dipendente è funzionale. Entro la settimana 4, è buono. Entro la settimana 8, produce lavoro che richiederebbe mesi di formazione a un assunto junior umano per eguagliare.

Lo strumento non migliora da solo. Le tue istruzioni migliorano. E le tue istruzioni sono interamente sotto il tuo controllo.

Da Dove Iniziare Subito

Scegli l'attività a cui dedichi più tempo ogni settimana. Quella che detesti. Quella che segue sempre lo stesso processo.

Dedica 2 ore a costruire il plugin seguendo questo corso.

Entro stasera avrai un dipendente AI che gestisce la tua attività più dispendiosa in termini di tempo. Entro il mese prossimo ti chiederai come hai mai fatto a farlo manualmente.

La maggior parte delle persone continuerà a fare tutto da sola perché costruire un dipendente AI "sembra complicato".

Quelli che dedicano 2 ore oggi avranno un dipendente AI autonomo che lavora per loro ogni giorno per il resto dell'anno.

Seguimi @eng_khairallah1 per altre architetture di automazione, progettazione di flussi di lavoro e playbook AI per il business.

spero ti sia stato utile, Khairallah ❤️