Le skills di Claude

Le Claude Skills: come trasformare l'IA in un vero collaboratore professionale

Sai già che Claude è un assistente potente. Ma sai davvero come farlo lavorare per te, in modo coerente, ripetibile e professionale?

Il documento "Skills di Claude in teoria e pratica" risponde esattamente a questa domanda. È una guida concreta — niente teoria fine a se stessa — pensata per chi usa Claude nel lavoro quotidiano e vuole smettere di riscrivere le stesse istruzioni ogni volta che apre una nuova chat.

Cosa trovi dentro

Le Claude Skills sono pacchetti di istruzioni riutilizzabili che insegnano all'IA come svolgere compiti specifici: quale tono usare, quali strumenti attivare, come strutturare l'output. La guida spiega cosa sono, come si creano e, cosa ancora più utile, quando conviene usarle e quando no.

Perché sì, ci sono anche i limiti: attivazioni imprevedibili, consumo di token, rigidità di configurazione, dipendenza dall'ecosistema Anthropic. Conoscerli in anticipo ti evita brutte sorprese.

Il paragone con il praticante di studio

C'è una sezione particolarmente riuscita: il paragone con il praticante di studio professionale. L'LLM come un giovane professionista brillante ma da guidare, i prompt come le istruzioni del titolare, il RAG come l'archivio documentale consultabile all'occorrenza.

Un modo semplice e immediato per capire davvero come funziona il sistema — e come trarne il massimo nel proprio contesto lavorativo.

Errori da evitare

La guida chiude con una lista pratica degli errori più comuni nell'uso di Claude e delle Skills, con la regola operativa per ciascuno. Pronti da applicare da subito:

• Fare richieste senza contesto
• Accettare dati fiscali o normativi senza verificare la fonte
• Incollare dati sensibili dei clienti su piano Free o Pro
• Fermarsi alla prima risposta senza iterare
• Usare una Skill senza verificare che si sia effettivamente attivata

A chi è utile

Se usi Claude nel tuo lavoro, o stai valutando di farlo e mi domando ancora se sia giusto o meno, questo documento è un punto di partenza basico: Niente hype, non amo la AI. È rivolto in particolare a professionisti e studi che vogliono integrare l'intelligenza artificiale nei propri flussi di lavoro in modo consapevole e strutturato.

La differenza tra un uso amatoriale e un uso professionale di Claude non sta nella complessità delle richieste. Sta nella consapevolezza dei limiti e nella disciplina con cui li si gestisce ogni giorno.

Le Claude Skills (o competenze) sono dei pacchetti di istruzioni specializzate e riutilizzabili che insegnano all’intelligenza artificiale come eseguire compiti specifici, quali strumenti utilizzare e quali standard seguire

Invece di dover riscrivere le stesse regole in ogni chat (es. “usa questo tono”, “formatta il codice così”, “crea un preventivo in questo modo”), puoi creare una Skill che Claude richiama automaticamente o manualmente quando serve.

cosa sono e come aggiungere le skills di claude

Le Claude Skills (o competenze) sono dei pacchetti di istruzioni specializzate e riutilizzabili che insegnano all’intelligenza artificiale come eseguire compiti specifici, quali strumenti utilizzare e quali standard seguire. Invece di dover riscrivere le stesse regole in ogni chat (es. “usa questo tono”, “formatta il codice così”, “crea un preventivo in questo modo”), puoi creare una Skill che Claude richiama automaticamente o manualmente quando serve.

A cosa servono

• Standardizzazione: Garantiscono che documenti, analisi o codici rispettino sempre le linee guida (es. il tono di voce del tuo brand).
• Automazione dei flussi: Insegnano a Claude a compiere azioni complesse in sequenza, come interagire con API esterne o usare ambienti di esecuzione del codice.
• Risparmio di memoria: Risolvono il problema della “finestra di contesto”, caricando istruzioni pesanti o complesse solo quando necessario

creare e aggiungere una Skill

La creazione di una Skill si basa generalmente su file di testo strutturati. Ecco i passaggi principali per impostarla: 1. Crea un file di istruzioni: Scrivi le regole, i passaggi operativi standard (SOP) e gli esempi del compito che vuoi automatizzare, spesso salvandoli in un file in formato Markdown (con estensione .md). 2. Abilita gli strumenti: Assicurati di avere l’esecuzione del codice abilitata nel tuo account, poiché molte Skills avanzate necessitano di questa funzione per testare script o elaborare dati. 3. Carica o configura la Skill: Puoi configurare la Skill tramite le impostazioni di Claude o caricarla come modulo nel tuo ambiente di sviluppo. 4. Richiama la competenza: Una volta aggiunta, puoi chiedere a Claude di utilizzarla nominandola direttamente in chat (es. tramite il comando /nome-skill) oppure lasciare che sia Claude ad attivarla in autonomia quando comprende l’intento della tua richiesta.

Perché usarle …e perché no

Utilizzare le Claude Skills trasforma il modo di lavorare con l’intelligenza artificiale, passando da conversazioni casuali a veri e propri flussi di lavoro automatizzati e professionali. Ecco i vantaggi principali per cui è opportuno integrarle nell’utilizzo di Claude:

⚡ Efficienza e Risparmio di Tempo

• Zero ripetizioni: Non devi riscrivere o incollare le stesse istruzioni, contesti aziendali o regole di formattazione in ogni nuova chat.
• Avvio immediato: Claude sa già cosa fare, come farlo e quale tono usare fin dal primo messaggio.

🎯 Massima Precisione e Standardizzazione

• Output uniformi: Garantiscono che i risultati (es. report, email, codice) rispettino sempre gli standard qualitativi richiesti.
• Riduzione degli errori: Limitano le allucinazioni dell’IA vincolando le risposte a regole rigide, passaggi sequenziali e database specifici.

🧠 Gestione Intelligente della Memoria

• Nessun sovraccarico: Evitano di riempire la “finestra di contesto” della chat con lunghe premesse, lasciando più spazio per l’elaborazione dei tuoi dati attuali.
• Richiamo dinamico: Claude attiva le competenze avanzate solo quando la richiesta lo richiede, ottimizzando le risorse della conversazione.

⚙️ Automazione Avanzata (Workflow)

• Integrazione di strumenti: Permettono a Claude di capire quando e come usare strumenti complessi, come l’esecuzione di codice Python o l’interrogazione di database.
• Autonomia operativa: L’IA non si limita a rispondere, ma esegue compiti multi-step (es. analizza un file, corregge gli errori, genera un grafico e compila un report finale).

Nonostante i numerosi vantaggi, l’utilizzo delle Claude Skills comporta diversi svantaggi, limitazioni tecniche e sfide operative che possono influire sull’efficacia del flusso di lavoro.

🧠 Problemi di Controllo e Attivazione (Unpredictable Invocation)

• Mancanza di attivazione forzata: Non esiste un comando algoritmico o deterministico per obbligare Claude ad attivare una Skill. Claude decide autonomamente se usarla basandosi sulla sua comprensione semantica della tua richiesta. Se non la ritiene pertinente, la ignorerà.
• Attivazioni errate: Al contrario, se la descrizione della Skill è troppo generica o ambigua, Claude potrebbe attivarla a sproposito, applicando regole rigide anche a domande fuori tema (off-topic).

📉 Effetto “Paraocchi” e Perdita di Flessibilità

• Restrizione delle capacità: Quando una Skill viene attivata, modifica radicalmente le istruzioni e i permessi degli strumenti di Claude. Ad esempio, una Skill focalizzata sulla lettura di file locali potrebbe inibire temporaneamente la capacità di Claude di fare ricerche sul web, limitando la sua visione d’insieme.
• Esecuzione incompleta: Claude potrebbe attivare correttamente la Skill ma saltare dei passaggi procedurali interni (soprattutto quelli che richiedono elaborazioni complesse senza produrre testo immediato), costringendoti a controllare sempre l’output.

💰 Consumo Imprevisto di Token e Costi

• Token Bloat silenzioso: Anche se le Skills utilizzano una logica di caricamento dinamico rispetto ad altri protocolli (come l’MCP), possedere una libreria con troppe Skills attive costringe Claude a scansionare i metadati di ognuna a ogni messaggio.
• Impatto sul contesto: Se Claude decide di attivare una Skill complessa, caricherà all’improvviso migliaia di token di istruzioni ed esempi nel contesto della chat, esaurendo molto più velocemente lo spazio disponibile per la conversazione corrente.

🛑 Limiti Tecnici e Rigidi di Configurazione

• Limiti quantitativi: Esistono tetti massimi invalicabili imposti da ⁠Anthropic, come il limite di massimo 8 Skills utilizzabili per singola richiesta e un peso complessivo dei file associati che non può superare i 30 MB.
• Sintassi restrittiva: I file di configurazione accettano solo formati specifici (come il frontmatter YAML) e hanno rigide restrizioni sui caratteri (es. nomi solo minuscoli, massimo 64 caratteri, divieto assoluto di usare parole riservate come “anthropic” o “claude”).

🔒 Dipendenza dall’Ecosistema (Vendor Lock-in)

• Non portabilità: Le Skills sono una funzionalità proprietaria sviluppata appositamente per l’ecosistema di Anthropic. Se in futuro deciderai di spostare i tuoi flussi di lavoro aziendali su altri modelli (come OpenAI o Google Gemini), non potrai esportarle direttamente e dovrai ricostruire da capo i tuoi prompt.

Il mio apprendista o praticante

Per comprendere il funzionamento di un sistema di intelligenza artificiale, può essere utile paragonarlo a un praticante che entra per la prima volta in uno studio professionale.

Un praticante arriva generalmente con una buona preparazione teorica: ha studiato all’università, conosce le norme, i principi e i concetti fondamentali della professione. Tuttavia, conoscere la teoria non significa ancora saper svolgere efficacemente il lavoro quotidiano. Le competenze operative, cioè le skills, sono la capacità di applicare quelle conoscenze per eseguire attività concrete: - predisporre una pratica, - analizzare un caso, - redigere un documento, - seguire una procedura o - risolvere un problema.

Allo stesso modo, un Large Language Model (LLM) possiede già un vasto patrimonio di conoscenze e una serie di capacità operative sviluppate durante il suo addestramento. Le sue skills non vengono normalmente acquisite durante la conversazione, ma sono già presenti nel modello e vengono utilizzate in funzione delle richieste ricevute.

Quando il praticante entra nello studio, il professionista senior gli fornisce (o dovrebbe) istruzioni, procedure, modelli e regole operative. Queste indicazioni non gli insegnano necessariamente una nuova professione, ma gli permettono di utilizzare meglio le conoscenze e le competenze che già possiede, applicandole al contesto specifico dello studio. In modo analogo, i prompt e le istruzioni fornite a un modello AI guidano l’utilizzo delle sue capacità, orientandolo verso il risultato desiderato.

Un altro elemento importante è la documentazione di supporto. In uno studio professionale il praticante può consultare manuali, circolari, pareri, pratiche precedenti e archivi interni per affrontare casi specifici. Nei sistemi di intelligenza artificiale questo ruolo è svolto dal RAG (Retrieval-Augmented Generation), che mette a disposizione del modello informazioni esterne e aggiornate quando servono. Tuttavia, così come un praticante non memorizza automaticamente ogni documento che consulta, anche il modello non apprende in modo permanente dai contenuti recuperati tramite il RAG: li utilizza per svolgere il compito richiesto, ma al termine dell’attività non li incorpora stabilmente nelle proprie conoscenze.

L’esperienza rappresenta invece un concetto diverso. Un professionista accumula esperienza affrontando nel tempo centinaia o migliaia di casi reali, affinando il proprio giudizio e migliorando progressivamente le proprie competenze. Nel mondo dell’intelligenza artificiale, l’equivalente non è il RAG, bensì un nuovo processo di addestramento o di aggiornamento del modello, che modifica realmente le sue capacità e le sue conoscenze in modo permanente.

In questa prospettiva, l’LLM può essere visto come il praticante con il suo bagaglio di conoscenze e competenze; le skills sono le sue capacità operative; i prompt rappresentano le istruzioni ricevute dai professionisti dello studio; il RAG equivale all’archivio documentale consultabile quando necessario; mentre il riaddestramento del modello corrisponde alla formazione e all’esperienza che, nel tempo, trasformano il praticante in un professionista sempre più preparato e competente.

Confronto: Studio professionale vs Sistema AI

AI vs Umano

Ma non è tutto fantastico e automatico!

Claude non apprende in modo permanente dall’uso quotidiano. Non aggiorna automaticamente le proprie competenze in base alle conversazioni passate. Ogni richiesta viene elaborata usando solo le informazioni presenti nel contesto corrente (istruzioni, eventuali documenti forniti, o sistemi di retrieval come RAG).

Per questo, se si vuole introdurre una nuova procedura o un nuovo metodo di lavoro, è necessario fornirlo esplicitamente nel contesto o aggiornarlo nel sistema esterno che alimenta il modello.

Il vantaggio è che il comportamento rimane stabile e coerente: non cambia in modo imprevedibile nel tempo e non “deraglia” accumulando esperienze errate. Lavora sempre alla massima velocità e senza fatica, applicando in modo consistente le istruzioni disponibili in quel momento.

• ✔ Claude non impara dalle chat → vero
• ✔ serve aggiornare il contesto → vero
• ❌ “usa sempre vecchie regole iniziali” → falso
• ❌ “Skill file nativo” → non esiste
• ✔ comportamento deterministico sul contesto → vero

Nel contesto di uno studio professionale, il funzionamento di un LLM come Claude può essere descritto come segue.

Immagina uno studio in cui lavora un praticante molto particolare che: - ha una formazione teorica enorme già “incorporata”; - sa svolgere moltissime attività operative fin da subito; - non si stanca mai, non dimentica per distrazione e lavora sempre alla stessa velocità;

ma - non apprende nuove procedure in autonomia durante il lavoro quotidiano.

Buongiorno a tutti

Ogni mattina il titolare può dargli istruzioni operative, checklist e procedure. Il praticante le esegue con precisione, finché restano valide.

Accanto a lui c’è una Knownledge base (basi di conoscenza ) dello studio: - banche dati e biblioteca - server con i testi (files) - manuali interni aggiornati (magari) - procedure operative (forse) - pratiche già svolte - circolari interne ed esterne - modulistica - manuali ed istruzioni fiscali e societarie

Quando deve lavorare su una pratica, il “praticante AI” non “impara” nulla dall’esperienza precedente (e questo è male), ma consulta sempre e solo ciò che trova nell’archivio in quel momento.

Se il titolare dello studio cambia una procedura, non serve “aspettare che il praticante capisca da solo” o che la memorizzi con l’esperienza.

Basta aggiornare l’archivio centrale!

Da quel momento in poi, il praticante applicherà la nuova procedura in modo immediato senza portarsi dietro abitudini precedenti senza contaminazioni da esperienze passate

Quindi il comportamento è questo: - lo studio evolve aggiornando i documenti - il praticante AI non evolve per esperienza personale - il praticante AI è estremamente veloce, coerente e instancabile

ma la sua “crescita” dipende interamente da ciò che viene aggiornato nello studio, non da ciò che gli capita nel tempo

In sintesi non è un praticante che impara facendo esperienza. È un praticante già formato che lavora sempre alla massima efficienza, ma che segue esclusivamente le procedure ufficiali dello studio, aggiornate centralmente dal titolare.

Claude Skills — Guida Pratica

Questo parte del documento è stato redatto con l’aiuto di Claude di Anthropic, minsbrava corretto farsi aiutare dalla fonte originale.

Cos’è una Skill

Come detto una Skill è un file di istruzioni strutturato che insegna a Claude come eseguire un compito specifico: quale tono usare, quali passaggi seguire, quali strumenti impiegare. Invece di riscrivere le stesse regole in ogni chat, la Skill viene caricata una volta e richiamata automaticamente o manualmente quando serve.

Dove funzionano le Skills:

Nota importante: Se usi Claude esclusivamente dal browser (claude.ai), le Skills non sono attive nelle tue conversazioni. Devi scaricare l’app desktop Claude per usarle. Una volta installate nell’app desktop, le Skills sono attive in tutte le conversazioni: chat, progetti e Cowork.

Struttura del file

Una Skill è una cartella che contiene obbligatoriamente un file chiamato SKILL.md.

nome-skill/
└── SKILL.md

Il file SKILL.md si apre con un blocco frontmatter YAML racchiuso tra ---, seguito dal corpo delle istruzioni in Markdown.

Esempio completo

---
name: analizzatore-bilanci
description: Analizza bilanci societari ed estrae anomalie fiscali. Usa quando l'utente fornisce un bilancio, una situazione contabile o chiede una riclassificazione CEE.
---

## Procedura operativa

Sei il Praticante Commercialista Esperto dello studio. Segui tassativamente questi passaggi:

### Fase 1 — Verifica documentale
1. Controlla che il file contenga Stato Patrimoniale e Conto Economico.
2. Se mancano dati, fermati e richiedili esplicitamente.

### Fase 2 — Riclassificazione
- Riclassifica il Conto Economico a Valore Aggiunto.
- Calcola l'EBITDA e la variazione percentuale rispetto all'anno precedente.

### Linee guida di output
- Tono professionale e formale.
- Dati numerici esclusivamente in tabelle Markdown.
- Niente introduzioni generiche: vai dritto al punto.

Regole da seguire per scrivere una Skill efficace

Il campo name

• Solo lettere minuscole, senza spazi (usa i trattini: formato kebab-case)
• Esempio corretto: controllo-contratti
• Massimo 64 caratteri
• Vietato usare le parole riservate claude e anthropic

Il campo description

• È il testo più importante: Claude lo legge per decidere se attivare la Skill
• Usa frasi esplicite come: “Usa quando l’utente chiede di…” oppure “Usa quando vengono forniti file di tipo…”
• Sii specifico: una descrizione vaga causa attivazioni errate o mancate

Il corpo delle istruzioni

• Usa elenchi numerati per i passaggi rigidi in sequenza (Claude tende a saltare i passaggi se non sono numerati)
• Usa punti elenco per le regole generali e le linee guida di stile
• Evita paragrafi lunghi e ambigui: Claude esegue meglio istruzioni brevi e dirette

Come installare la Skill

Opzione A — Installazione locale nel progetto (consigliata)

Adatta quando lavori su una cartella specifica con Claude Code o l’app desktop.

1. Apri la cartella del tuo progetto
2. Crea il percorso: .claude/skills/nome-skill/SKILL.md

Struttura finale:

TuaCartella/
└── .claude/
    └── skills/
        └── analizzatore-bilanci/
            └── SKILL.md

Quando avvii una sessione Claude puntando a quella cartella, la Skill viene rilevata e caricata automaticamente.

Opzione B — Installazione globale (Claude Code)

Se vuoi che la Skill sia disponibile in qualsiasi sessione Claude Code, indipendentemente dalla cartella di lavoro, inseriscila nella configurazione globale dell’utente:

~/.claude/skills/nome-skill/SKILL.md

Dove ~ è la tua home directory (/Users/tuonome/ su Mac, /home/tuonome/ su Linux).

Come richiamare la Skill

Una volta installata, hai due modalità:

Automatica — Claude legge la description e attiva la Skill da solo se capisce che il tuo messaggio è pertinente. Esempio: “Controlla questo bilancio” attiva analizzatore-bilanci se la descrizione è scritta bene.

Manuale (slash command) — Forza l’attivazione digitando / seguito dal nome della Skill, disponibile in Claude Code:

/analizzatore-bilanci analizza questo file

Cosa NON è vero (correzioni a fonti errate)

Riepilogo

SKILL.md
├── Frontmatter YAML        → name + description (obbligatori)
└── Corpo in Markdown       → istruzioni, fasi, linee guida

Installazione
├── Locale  → TuaCartella/.claude/skills/nome-skill/SKILL.md
└── Globale → ~/.claude/skills/nome-skill/SKILL.md

Disponibile in
└── Claude Code (CLI) e app desktop Claude
    ✗ Non nell'interfaccia web claude.ai

Digitalizzazione di base - Cos’è un file Markdown (.md)

e perché dovresti conoscerlo.

Parliamo di AI, di automazioni, di Skills e di strumenti avanzati. Ma se non sai cos’è un file di testo strutturato, rischi di fermarti al primo ostacolo pratico. Proviamo a spiegarlo

Il problema: siamo fermi a Word ed Excel

Nella maggior parte degli uffici e degli studi professionali, la “competenza digitale” si misura in ore passate su Microsoft Word ed Excel. Non è una critica: sono strumenti potenti e diffusissimi e proprietari. Ma il mondo dell’automazione, dell’intelligenza artificiale, degli strumenti moderni e open source si basa spesso su un formato molto più semplice e leggero che in pochi conoscono: il file Markdown, con estensione .md.

Ignorarlo significa non capire davvero come funzionano molti degli strumenti di cui sentiamo parlare ogni giorno.

Cos’è un file .md

Un file .md è semplicemente un file di testo. Puoi aprirlo con il Blocco Note di Windows o qualsiasi editor di testo su Linux e leggerne il contenuto senza problemi. La differenza rispetto a un .txt normale è che contiene una serie di simboli convenzionali che danno struttura e formattazione al testo — senza bisogno di menu, pulsanti o programmi costosi.

Questi simboli seguono una convenzione chiamata Markdown, inventata nel 2004 da John Gruber con l’obiettivo di scrivere testo formattato nel modo più leggibile possibile, anche nella versione “grezza”.

Come funziona in pratica

Invece di cliccare su “Grassetto” nella barra degli strumenti, scrivi:

**questa parola è in grassetto**

Invece di scegliere uno stile di titolo dal menu a tendina, scrivi:

# Titolo principale
## Sottotitolo
### Titolo di terzo livello

Invece di creare una lista puntata con il mouse, scrivi:

- Prima voce
- Seconda voce
- Terza voce

Il risultato, quando il file viene “renderizzato” (cioè interpretato da un programma), è identico a quello che otterresti con Word. Ma il file rimane leggerissimo, portabile e leggibile da qualsiasi macchina, anche senza software installato.

Perché è importante per chi usa l’AI

Molti strumenti di intelligenza artificiale, iincluse le Claude Skills di cui parliamo in questo blo, usano file .md come formato nativo per le istruzioni. Le ragioni sono pratiche:

• Un file .md è testo puro: l’AI lo legge senza dover interpretare formati binari complessi come .docx
• È versionabile (puoi tenere traccia delle modifiche con strumenti come Git)
• Funziona su qualsiasi sistema operativo senza installare nulla
• È lo stesso formato usato da Nextcloud, GitHub, Notion, Obsidian, Joplin, Marcor (che ho usato per scrivere questo articolo) e migliaia di altri strumenti

Se vuoi creare una Skill per Claude, scrivere documentazione tecnica, tenere un diario di lavoro strutturato o gestire un progetto senza abbonamenti costosi, Markdown è il punto di partenza.

Dove trovi già Markdown nel tuo lavoro quotidiano (senza saperlo)

Il formato Markdown è ovunque. Probabilmente lo usi già senza rendertene conto:

Software open source per note e todo list basati su Markdown

Se vuoi andare oltre l’editing e usare Markdown come sistema di organizzazione personale, questi strumenti sono tutti gratuiti e open source:

Joplin — joplinapp.org App di note con sincronizzazione opzionale (Dropbox, Nextcloud, OneDrive). Ottima alternativa open source a Evernote. Supporta todo list con checkbox, allegati e crittografia end-to-end.

Standard Notes — standardnotes.com Note cifrate end-to-end, minimaliste, con focus sulla privacy. I dati non appartengono a nessun server commerciale. Versione base gratuita.

Tasks.md — file .md con checkbox Il sistema più semplice di tutti: un file Markdown con righe come - [ ] Da fare e - [x] Fatto. Funziona in qualsiasi editor e non richiede nessuna app dedicata.

## Lista attività settimanale

- [x] Inviare fattura cliente Rossi
- [ ] Rivedere contratto di fornitura
- [ ] Chiamare il consulente del lavoro
- [ ] Aggiornare la skill analizzatore-bilanci

In sintesi

Un file .md è testo semplice con simboli convenzionali per la formattazione. Non serve Word, non serve nessun abbonamento, non serve nessun programma speciale per aprirlo. È leggero, portabile e usato da tutti i principali strumenti di AI, sviluppo software e gestione della conoscenza.

Imparare Markdown non richiede più di trenta minuti. Conoscerlo ti permette di capire davvero come funzionano gli strumenti di cui parliamo in questo blog — e di usarli con piena consapevolezza, non solo seguendo istruzioni alla cieca.

Esempio pratico di skill

Creiamo una skill per un commercialista che permetta di redigere un Business Plan a 5 anni per una startup che produce software e vende un servizio in saas.

Prima di produrre un solo numero, Claude ti chiede tutto quello che serve in un unico questionario strutturato (Fase 0). Poi costruisce in sequenza: modello MRR/ARR con le metriche SaaS standard (LTV, CAC, churn, NRR), conto economico a 5 anni in formato scalare con gross margin %, cash flow con runway e break-even, stato patrimoniale sintetico, tre scenari di sensitività e, ultima cosa, una sezione di flag di rischio dove Claude segnala esplicitamente se i dati del cliente sembrano ottimistici, sottostimati o incoerenti. Più la checklist delle agevolazioni fiscali applicabili (credito R&S, Patent Box, regime startup innovativa, ecc.).

Il tono è calibrato per essere utilizzata da un commercialista, non sull’imprenditore: nessuna spiegazione di concetti elementari, linguaggio tecnico diretto

In allegato trovi 3 file pronti: - budget-quinquennale-saas.zip — da caricare direttamente nell’app desktop (metodo più rapido) - SKILL.md — il file grezzo se vuoi vederlo o modificarlo - ISTRUZIONI-installazione-skill.md — guida completa all’installazione

Gli errori da non commettere mai

In questo ultimo paragrafo descrivo una breve guida pratica per l’uso professionale di Claude, perché vedere aprire Claude e scrivere: “fammi un budget di 5 anni di una startup” oppure “scrivimi la relazione al bilancio che ti allego” e poi sentirmi dire: - uso l’AI perché è fantastica, fa tutto da sé e perdo meno tempo - (dopo 5 minuti) sbaglia tutto - quale è la migliore - ma te non c’è lo spieghi (mentre la usi quando ti pare ma me lo chiedi al bar di spiegartelo)

Mi fa uscire il fumo dagli orecchi… vabbè d’altronde mica avete letto il manuale di Windows, dello smartphone, della macchina, del forno a microonde, o del folletto!?!?! Ecco il problema principale

Usare Claude ogni giorno in modo efficace non è solo questione di prompt. È anche capire cosa non fare — errori che sembrano banali ma che compromettono la qualità del lavoro e, in alcuni casi, la sicurezza dei dati.

Errori nella chat di Claude (claude.ai e app desktop)

❌ Non dare contesto sufficiente

Claude non sa chi sei, cosa fai, per chi lavori. Se scrivi “fammi un contratto” senza dire nient’altro, ottieni una risposta generica. Ogni conversazione parte da zero.

Regola: Prima di fare la richiesta, dai sempre il contesto minimo: chi sei, qual è il cliente, qual è l’obiettivo del documento, a chi è destinato.

❌ Trattare Claude come un motore di ricerca

Claude non naviga internet in tempo reale (salvo attivazione esplicita della ricerca web). Se chiedi “qual è l’aliquota IRAP 2025” senza abilitare la ricerca, potrebbe rispondere con dati obsoleti presentandoli come certi.

Regola: Per normativa fiscale, circolari, scadenze e dati aggiornati, attiva sempre la ricerca web oppure verifica la fonte. Non accettare mai cifre fiscali senza conferma.

❌ Non leggere le risposte criticamente

Claude può sbagliare. Può inventare riferimenti normativi che sembrano reali ma non esistono (il cosiddetto hallucination). In ambito professionale ( fiscale, legale, contabile) un errore non rilevato può avere conseguenze serie.

Regola: Trattalo come un collaboratore brillante ma da supervisionare. Ogni dato normativo, ogni calcolo, ogni riferimento va verificato prima di usarlo con un cliente.

❌ Incollare dati sensibili dei clienti senza pensarci

Codici fiscali, dati bancari, bilanci riservati, contratti in corso: tutto quello che scrivi nella chat viene inviato ai server di Anthropic per l’elaborazione. Il piano Free e Pro non prevedono garanzie di non utilizzo dei dati per il training per impostazione predefinita.

Regola: Per dati sensibili usa il piano Team o Enterprise (che esclude i dati dal training) oppure anonimizza i dati prima di incollarli (es. sostituisci il nome del cliente con “Cliente X”).

❌ Fidarsi dell’output senza verificare il formato

Claude produce testo. Se chiedi una tabella, un calcolo o un modulo, controlla sempre che i numeri tornino e che il formato sia quello che ti serve davvero, non quello che sembra corretto a prima vista.

Regola: Per output critici (budget, calcoli fiscali, contratti) chiedi sempre a Claude di riepilogare le assunzioni usate. Se qualcosa non torna, è lì che si nasconde l’errore.

❌ Iniziare una nuova chat senza riepilogare il contesto

Claude non ricorda le conversazioni precedenti. Se chiudi la chat e ne apri una nuova, ricomincia da zero. Molti professionisti perdono tempo a ricostruire il contesto ogni volta.

Regola: Per lavori continuativi, tieni aperta la stessa chat oppure inizia ogni nuova sessione con un riepilogo di 3-5 righe: “Stiamo lavorando su X per il cliente Y, abbiamo già definito Z, oggi dobbiamo fare…”

❌ Accettare la prima risposta senza iterare

Claude migliora con le istruzioni. Se la prima risposta non è quella giusta, non ricominciare da capo: correggila nella stessa chat con istruzioni specifiche su cosa cambiare.

Regola: Usa frasi come “modifica solo la sezione X”, “aggiungi il punto Y”, “riscrivi il paragrafo Z con un tono più formale”. L’iterazione è il modo corretto di lavorare.

Errori specifici nell’uso delle Skills (app desktop)

❌ Installare la Skill e dimenticare di attivare il toggle

Una Skill con il toggle disattivato è invisibile a Claude. Non genera errori, non avvisa — semplicemente viene ignorata.

Regola: Dopo ogni installazione o aggiornamento, vai su Customize → Skills e verifica che il toggle sia verde.

❌ Scrivere una description vaga

La description nel frontmatter YAML è ciò che Claude legge per decidere se attivare la Skill. Una descrizione come “Aiuta con i bilanci” è troppo generica: Claude potrebbe non attivarla mai, o attivarla a sproposito.

Regola: Scrivi trigger espliciti: “Usa quando l’utente fornisce un bilancio in formato PDF o Excel”, “Attiva quando si parla di budget previsionale per startup”. Più è specifica, meglio funziona.

❌ Mettere tutto in una sola Skill enorme

Una Skill con 50 regole diverse per 10 casi d’uso differenti diventa difficile da mantenere e confonde Claude su cosa applicare quando.

Regola: Una Skill, un compito. Crea analizzatore-bilanci, budget-saas, redazione-contratti come tre Skills separate. Sono più affidabili e più facili da aggiornare.

❌ Non aggiornare la Skill quando cambiano le regole

La Skill applica solo ciò che hai scritto la prima volta. Se cambia una normativa, se aggiorni le tue procedure, se trovi un errore nel flusso, Claude continuerà ad applicare le vecchie istruzioni fino a quando non modifichi il file.

Regola: Tratta il file SKILL.md come un documento vivo. Quando cambi procedura nel tuo studio, aggiorna la Skill. Annota in fondo al file la data dell’ultima modifica.

❌ Usare la Skill senza verificare che si sia attivata

Claude non sempre comunica esplicitamente quale Skill ha caricato. Potresti pensare che stia seguendo le tue istruzioni professionali mentre in realtà sta rispondendo in modo generico.

Regola: All’inizio di ogni sessione delicata, scrivi: “Quale skill stai usando per questa richiesta?” oppure “Conferma che stai applicando la procedura X.” Claude risponderà chiaramente.

Riepilogo rapido — stampa e tienilo a portata di mano

CHAT — COSA NON FARE MAI
────────────────────────────────────────────────
✗  Richiesta senza contesto
✗  Dati fiscali/normativi senza verifica della fonte
✗  Output accettato senza lettura critica
✗  Dati sensibili del cliente su piano Free/Pro
✗  Prima risposta accettata senza iterare
✗  Nuova chat senza riepilogo del contesto

SKILLS — COSA NON FARE MAI
────────────────────────────────────────────────
✗  Toggle disattivato dopo l'installazione
✗  Description generica nel frontmatter YAML
✗  Una sola Skill enorme per tutto
✗  Skill non aggiornata dopo cambi di procedura
✗  Dare per scontato che la Skill sia attiva