---
name: "skill-report-docx"
description: "Genera un report DOCX dettagliato per una skill, estraendo informazioni da SKILL.md."
model_tier: 2
triggers:
  - "genera report docx skill"
  - "crea report skill"
  - "skill report docx"
  - "passport skill"
  - "skill passport"
  - "report skill"
tools:
  - exec
  - skill_view
---

# 📄 Skill Report DOCX Generator

## Scopo
Genera un report professionale in formato DOCX per qualsiasi skill esistente. Il report estrae automaticamente le informazioni chiave (nome, descrizione, triggers, input, output, workflow, specifiche tecniche) dal file `SKILL.md` e le formatta in un documento Word coerente.

L'output viene salvato in `~/.hermes/generated/<skill_name>_Skill_Report.docx`.

## Input

| Parametro | Obbligo | Descrizione |
|---|---|---|
| `skill_name` | Richiesto | Nome esatto della skill (es. `landsat-water-detection`) |

## Workflow

1. **Leggi SKILL.md** — Carica la skill con `skill_view(name)` per verificare che esista e leggerne il contenuto.
2. **Esegui script** — Chiama lo script Python con il nome della skill.
3. **Consegna** — Comunica il path del file DOCX generato e rendilo accessibile via HTTP.

### Esecuzione script

```bash
cd ~/.hermes && python3 skills/skill-report-docx/scripts/generate_skill_report_docx.py <skill_name>
```

Lo script restituisce il path assoluto del file DOCX generato.

### Consegna file

```bash
# Verifica esistenza
ls -la ~/.hermes/generated/<skill_name>_Skill_Report.docx

# Se l'utente è su Telegram, invia il file direttamente
# Includi nel messaggio: MEDIA:~/.hermes/generated/<skill_name>_Skill_Report.docx

# Se l'utente è su PC browser, fornisci link HTTP
# Assicurati che il server ascolti su 0.0.0.0 (non localhost!)
# URL: http://<tailscale-ip>:8088/<skill_name>_Skill_Report.docx
```

## Output
- File DOCX salvato in `~/.hermes/generated/<skill_name>_Skill_Report.docx`
- Il documento contiene: Overview (nome, descrizione, purpose, triggers), Input, Workflow, Outputs, Technical Specifications, Version History

## Pitfalls
- Lo script richiede `python-docx` (`pip install python-docx` se non presente).
- Per skill in sottodirectory (es. `gis/landsat-water-detection`), passare solo il nome base (`landsat-water-detection`), non il percorso.
- Se il server HTTP è su localhost, l'utente da remoto non vede il file. **Sempre `--bind 0.0.0.0`.**