---
name: mcp-office-expert
description: Read, create, and edit Word, Excel, and PDF files through MCP, including report generation and document export for docs indexing. Use when the task involves local documents, spreadsheet outputs, PDF extraction, or shared deliverables.
---

# MCP Office Expert

Questo skill guida l'agente nell'uso di `office-mcp-server` per leggere, produrre e rifinire documenti locali senza perdere controllo su struttura, range e destinazione finale.

## Tool Disponibili

| Tool | Formati | Descrizione |
| :--- | :--- | :--- |
| `word_document` | `.docx`, `.doc` | Legge, crea e modifica documenti Word |
| `excel_document` | `.xlsx`, `.xls` | Legge, scrive e crea file Excel |
| `pdf_document` | `.pdf` | Legge metadata e testo dei PDF ed esporta in `.md` o `.txt` |

## Workflow Base

### Word

1. Usa `word_document` `action: "list_paragraphs"` prima di modificare: non indovinare mai l'indice.
2. Usa `edit_paragraph`, `insert_paragraph` o `delete_paragraph` con l'indice corretto.
3. Per file `.doc`, limita il lavoro a `action: "read"` e chiedi conversione a `.docx` se serve scrivere.

### Excel

1. Usa `excel_document` `action: "list_sheets"` per scoprire la struttura del workbook.
2. Leggi il range target con `action: "read_sheet"` prima di sovrascrivere.
3. **Scrittura su Template**: Se devi popolare un template esistente in formato `.xlsx` (es. reportistica layout-oriented), **crea sempre prima una copia del file template** e usa `write_cells` sulla copia. Questo manterrà il template originale intatto per usi futuri. Il tool conserverà nativamente la formattazione, i colori e i grafici nel file generato.
4. Usa `create` solo per generare file vuoti e nuovi da zero.

### PDF

1. Parti da `pdf_document` `action: "metadata"`.
2. Leggi solo `read_page` o `read_range` finche possibile.
3. Usa `export_text` con `format: "md"` se il contenuto deve entrare in `mcp-docs-navigator`.

## Sinergie e Best Practices

* Combina `mcp-database-expert` + `excel_document` per produrre report tabellari riusabili.
* Dopo aver creato o esportato un documento che deve restare ricercabile, usa `mcp-docs-navigator` per `scan_file` e tagging.
* Le modifiche a `.docx` e `.xlsx` sono in-place e non reversibili dal tool: se il file e prezioso, crea prima una copia.
* Per output condivisi, preferisci un percorso chiaro e stabile invece di lasciare il file in cartelle temporanee.

## Regole di escalation prompt -> skill

Escala a `mcp-office-expert` quando il prompt richiede operazioni esplicite su file Office/PDF:

- lettura o modifica di `.docx`/`.xlsx`;
- estrazione testo da PDF;
- produzione report consegnabili in formati Office.

Escalation secondaria:

1. Se il deliverable deve diventare conoscenza ricercabile, passa a `mcp-docs-navigator` per indicizzazione e tagging.
2. Se il documento e solo punto di partenza di un'indagine tecnica cross-sorgente, passa a `mcp-technical-analyst`.
3. Se il prompt non richiede artefatti Office ma solo analisi codice/ticket/DB, usa lo skill specialistico pertinente come primario.

## Carica Riferimenti Solo Se Servono

* [references/report-workflow.md](references/report-workflow.md) per il flusso completo query -> Excel -> Word -> docs/ticket.

## Risoluzione Problemi

* Se un indice Word non torna, riesegui `list_paragraphs`: la struttura puo essere cambiata dopo una modifica precedente.
* Se un PDF non restituisce testo, segnala il limite del file scannerizzato invece di insistere.
* Se `save_path` fallisce, verifica percorso assoluto e permessi filesystem.