# xlsx - **Autore:** Anthropic - **Repository:** [anthropics/skills](https://github.com/anthropics/skills), la raccolta di skill di esempio di Anthropic - **Sorgente:** [skills/xlsx/SKILL.md](https://github.com/anthropics/skills/blob/main/skills/xlsx/SKILL.md), con `LICENSE.txt` e una cartella `scripts/` - **Pagina su skills.sh:** [anthropics/skills/xlsx](https://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: ```bash 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 ```bash 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 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`): ```text /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: ```bash npx skills list -g # skill installate npx skills update xlsx # aggiornamento npx skills remove xlsx # rimozione ``` ```text /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ì: ```bash 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](https://github.com/anthropics/skills) - [SKILL.md di xlsx](https://github.com/anthropics/skills/blob/main/skills/xlsx/SKILL.md) - [Cartella skills/xlsx](https://github.com/anthropics/skills/tree/main/skills/xlsx) - [xlsx su skills.sh](https://skills.sh/anthropics/skills/xlsx) - [Use skills in Claude – Claude Help Center](https://support.claude.com/en/articles/12512180-use-skills-in-claude) - [Skills in ChatGPT – OpenAI Help Center](https://help.openai.com/en/articles/20001066-skills-in-chatgpt)