davideandClaude Sonnet 5.5
5051b50902
Nel README nascono gli argomenti Ufficio e Second brain (presenti in entrambi i gruppi, anche se vuoti): pdf, pptx e xlsx vanno sotto Ufficio, claude-obsidian, obsidian-skills e obsidian-wiki sotto Second brain. Conoscenza e note resta per graphify; ecc si affianca a superpowers. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
158 lines
8.9 KiB
Markdown
158 lines
8.9 KiB
Markdown
# 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>` | 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)
|