my-skills/skills/xlsx.md

xlsx

• Autore: Anthropic
• Repository: anthropics/skills, la raccolta di skill di esempio di Anthropic
• Sorgente: skills/xlsx/SKILL.md, con LICENSE.txt e una cartella scripts/
• Pagina su skills.sh: anthropics/skills/xlsx
• Diffusione (ottobre 2026): circa 190.400 installazioni (su skills.sh dal 19 gennaio 2026); il repository ha circa 184.900 stelle e 21.900 fork su GitHub
• Controlli di sicurezza su skills.sh: Gen Agent Trust Hub e Snyk superati; Socket segnala un avviso (la pagina non spiega il motivo). La pagina avverte inoltre che SKILL.md contiene direttive di shell che possono eseguire comandi di sistema, da controllare prima di installare.
• Licenza: proprietaria (termini in LICENSE.txt). Il README del repository precisa che le skill per i documenti (docx, pdf, pptx, xlsx) sono source-available, non open source, e che le skill del repository sono dimostrative: conviene provarle bene prima di affidarsi a loro.

A cosa serve

Fa creare, modificare, leggere e ripulire fogli di calcolo Excel all'agente, con formule vere (non risultati incollati) e senza errori nei calcoli. Un foglio che l'agente produce da solo si ricalcola quando cambiano i dati, ha una formattazione professionale e viene controllato prima di essere consegnato.

Cosa fa

Quando si attiva

Quando un foglio di calcolo è l'ingresso o il risultato principale del lavoro, in formato .xlsx, .xlsm, .xltx, .csv o .tsv:

• creare una cartella di lavoro nuova;
• modificare un file esistente, aggiungere colonne, calcolare formule, formattare, fare grafici;
• pulire dati disordinati e trasformarli in un foglio ben fatto;
• convertire tra formati tabellari.

Non si attiva quando il risultato è un documento Word, un rapporto HTML, uno script a sé, una pipeline su database o un'integrazione con Google Sheets.

Come lavora

1. Sceglie lo strumento:
   • openpyxl per creare e modificare file con formule e formattazione;
   • pandas (read_excel, to_excel) per importare ed esportare molti dati;
   • markitdown file.xlsx per una lettura rapida in sola lettura (non mostra le coordinate delle celle). Per leggere sia le formule sia i valori di un modello servono due caricamenti del file con load_workbook. Le librerie sono già installate: la skill dice di non lanciare pip install se non fallisce un import.
2. Scrive formule, non risultati: il foglio deve ricalcolarsi se cambiano gli ingressi.
3. Ricalcola e controlla. openpyxl salva le formule senza i valori già calcolati, quindi lancia:

   python scripts/recalc.py output.xlsx [secondi_di_attesa]
   

   (30 secondi per impostazione predefinita). LibreOffice ricalcola il file e lo script restituisce un JSON con status, total_formulas, total_errors e error_summary. Un'uscita senza errori non garantisce un foglio corretto: la skill dice di provare a mano alcune formule.
4. Consegna senza errori di formula; se il file ne aveva già, controlla l'originale prima di dare la colpa al proprio lavoro.

Regole per ogni risultato

• carattere professionale (Arial o Times New Roman), salvo indicazioni diverse;
• nomi dei fogli, intestazioni e formule come li chiedi tu, alla lettera;
• ipotesi e numeri scritti a mano documentati nel file, con la fonte quando possibile;
• se modifica un file esistente: adotta le sue convenzioni, scrive solo nelle celle di ingresso previste e non tocca le formule esistenti.

Formule: cosa usa e cosa evita

Tipo	Funzioni
Preferite (Excel 2007)	SUMIFS, INDEX, MATCH, IFERROR, SUMPRODUCT
Più recenti, con prefisso _xlfn.	TEXTJOIN, CONCAT, IFS, SWITCH, MAXIFS, MINIFS
Da evitare	XLOOKUP, XMATCH, SORT, FILTER, UNIQUE, SEQUENCE (ordina e filtra in Python)

Trappole di openpyxl che la skill segnala

• data_only=True toglie le formule: salvare quel file le sostituisce per sempre con i valori.
• Nelle celle unite si scrive solo in quella in alto a sinistra.
• I file .xlsm vanno aperti con keep_vba=True, altrimenti perdono le macro.
• I nomi dei fogli con spazi vanno tra apici nei riferimenti tra fogli.
• Salvare di nuovo una cartella che rimanda ad altri file ne toglie i collegamenti: prima copia i valori.

Convenzioni dei modelli finanziari

Valgono salvo diversa indicazione tua o del file:

Elemento	Convenzione
Colori	blu per gli ingressi scritti a mano, nero per le formule, verde per i collegamenti ad altri fogli, rosso per quelli ad altri file, sfondo giallo per le ipotesi chiave
Numeri	formato valuta con le unità nelle intestazioni, zeri come trattino, negativi tra parentesi, percentuali salvate come frazioni, multipli come 0.0x, anni salvati come testo
Struttura	un'ipotesi per cella con etichetta, formule coerenti tra i periodi, divisori protetti dallo zero

Da sapere

• Macro VBA: non le scrive. La skill non tratta la scrittura né la modifica di codice VBA. Dice soltanto di conservare le macro esistenti aprendo i .xlsm con keep_vba=True. Per VBA servono altre skill.
• Grafici e tabelle pivot: la descrizione dice che copre i grafici, ma il testo non dà indicazioni specifiche su grafici o tabelle pivot.
• Requisiti: Python con openpyxl, pandas e markitdown (preinstallati negli ambienti previsti) e LibreOffice (soffice), che la skill configura da sola negli ambienti isolati tramite scripts/office/soffice.py.
• Script eseguiti: scripts/recalc.py e scripts/office/soffice.py. Non li ho letti uno per uno, e non ho potuto vedere il contenuto della cartella scripts/ su GitHub.
• Nessun accesso esterno dichiarato: lavora sui file locali.

Installazione

Claude Code e Codex

npx skills add anthropics/skills --skill xlsx -g -a codex -a claude-code

Opzione	Significato
--skill xlsx	installa solo questa skill del repository
-g	installazione globale (~/.claude/skills/, ~/.codex/skills/); senza, solo nel progetto corrente (.claude/skills/, .agents/skills/)
-a <agente>	agente di destinazione, ripetibile (claude-code, codex, ...)
-y	salta le domande di conferma
--copy	copia i file invece di creare collegamenti simbolici

La pagina di skills.sh indica la forma npx skills add https://github.com/anthropics/skills --skill xlsx; la sintassi con anthropics/skills è equivalente.

Alternativa solo per Claude Code, dal marketplace di Anthropic (installa tutte le skill per i documenti: docx, pdf, pptx, xlsx):

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

Dopo l'installazione riavvia la sessione. Claude Code la usa da solo quando la richiesta è pertinente. In Codex la richiami con $xlsx o la vedi con /skills.

Gestione:

npx skills list -g              # skill installate
npx skills update xlsx          # aggiornamento
npx skills remove xlsx          # rimozione

/plugin uninstall document-skills@anthropic-agent-skills   # rimozione del plugin

App desktop di Claude e ChatGPT

Queste app richiedono di caricare la skill come ZIP. Preparalo così:

git clone --depth 1 https://github.com/anthropics/skills.git
cd skills/skills && zip -r ~/xlsx.zip xlsx

Lo ZIP deve contenere la cartella xlsx/ con dentro SKILL.md e la cartella scripts/.

Claude (desktop o web)

1. Attiva l'esecuzione del codice in Settings → Capabilities.
2. Vai in Customize → Skills → + → Create skill → Upload a skill e scegli lo ZIP.
3. Attiva l'interruttore della skill.

ChatGPT (desktop o web)

1. Vai in Skills nella barra laterale, poi Create → Upload from your computer, e scegli lo ZIP o la cartella.
2. Attendi l'analisi di sicurezza di ChatGPT.
3. Richiamala con @ nella chat.

Le skill personali caricate su desktop e web non si sincronizzano: vanno caricate su ciascuna.

Limite: nelle app di chat la skill gira in un ambiente isolato con esecuzione del codice. Funziona solo se lì sono disponibili openpyxl, pandas e LibreOffice (non l'ho verificato), e legge solo i file che alleghi alla conversazione. Il README del repository dice che le skill di esempio sono già disponibili sui piani a pagamento di Claude.ai, ma non specifica se xlsx sia tra queste.

Fonti

• README di anthropics/skills
• SKILL.md di xlsx
• Cartella skills/xlsx
• xlsx su skills.sh
• Use skills in Claude – Claude Help Center
• Skills in ChatGPT – OpenAI Help Center