---
name: doc-marketing
description: "Genera documenti marketing (.docx) professionali con infografiche AI e template brandizzati NexaData/Iridia. Supporta brochure, flyer, case study, white paper, one-pager. Usa questa skill quando l'utente dice marketing, brochure, flyer, whitepaper, white paper, case study, one-pager, material commerciale, doc marketing, materiale promozionale."
---

# doc-marketing — Documenti Marketing e Commerciali

Genera materiale marketing in .docx con:
- Cover page hero impattante
- Executive summary con numeri chiave
- Sezioni Problema/Soluzione/Benefit
- Case study con testimonianze
- Call-to-action e contatti
- Infografiche AI per architettura, confronti, data visualization

## Quando usarla

- Brochure prodotto
- Flyer commerciale / leaflet
- White paper tecnico-commerciale
- Case study (successo cliente)
- One-pager sintesi
- Executive briefing per stakeholder
- Materiale pre-sales

Per offerte specifiche usa `/doc-offerta`. Per manuali usa `/doc-manuale`. Per report analisi usa `/doc-report`. Per presentazioni board usa `/doc-presentazione`.

## Chiavi API richieste

- `GEMINI_API_KEY` (per infografiche)

## Sintassi

```
/doc-marketing <input.md> [--brand iridia|nexadata] [--tipo brochure|whitepaper|case-study|one-pager] [--output <path>] [--auto]
```

## Template

```bash
TEMPLATE_MARKETING_IRIDIA="$HOME/.claude/skills/doc-offerta/references/templates-variants/Template_Marketing_Iridia.docx"
TEMPLATE_MARKETING_NEXADATA="$HOME/.claude/skills/doc-offerta/references/templates-variants/Template_Marketing_NexaData.docx"
```

Il template Marketing e ottimizzato per impatto visivo: hero page, KPI tables, comparison tables, testimonials.

## Placeholder principali (37 totali)

### Cover / Hero
- `{{HEADLINE}}` — Titolo principale (5-8 parole, impattante)
- `{{SOTTOHEADLINE}}` — Sottotitolo esplicativo
- `{{CLAIM}}` — Claim di posizionamento
- `{{AZIENDA}}`, `{{DATA_PUBBLICAZIONE}}`

### Executive Summary
- `{{EXECUTIVE_SUMMARY}}` — 2-3 paragrafi sintesi
- `{{KPI_NOME}}`, `{{KPI_VALORE}}`, `{{KPI_TREND}}` — riga tabella KPI (duplicabile)

### Problema
- `{{PROBLEMA_DESCRIZIONE}}` — descrizione del problema di mercato
- `{{SFIDE}}` — sfide specifiche
- `{{SFIDA_PRINCIPALE}}` — sfida chiave sintetica

### Soluzione
- `{{SOLUZIONE_DESCRIZIONE}}` — descrizione estesa
- `{{COME_FUNZIONA}}` — spiegazione step-by-step
- `{{ARCHITETTURA_DESCRIZIONE}}` — descrizione architettura (precede infografica)

### Benefit
- `{{PERCHE_NOI_INTRO}}` — intro alla sezione benefit
- `{{BENEFIT_1..4}}` — bullet benefit (duplicabile)
- `{{FEATURE_1..3}}` — righe tabella comparison con competitor

### Case Study
- `{{CASE_CLIENTE}}` — Nome cliente del case study
- `{{CASE_CONTESTO}}`, `{{CASE_SFIDA}}`, `{{CASE_SOLUZIONE}}`, `{{CASE_RISULTATI}}`
- `{{CASE_TESTIMONIANZA}}` — Quote del referente cliente
- `{{CASE_REFERENTE}}`, `{{CASE_RUOLO}}`

### Call to Action
- `{{CTA_DESCRIZIONE}}`, `{{CTA_TEXT}}`, `{{CTA_URL}}`
- `{{EMAIL_COMMERCIALE}}`, `{{TELEFONO_COMMERCIALE}}`, `{{SITO_WEB}}`

## Tipi documento (flag `--tipo`)

| Tipo | Pagine | Focus |
|------|--------|-------|
| `brochure` | 2-4 | Visual-heavy, bullet, benefit |
| `whitepaper` | 8-15 | Profondità tecnica, riferimenti, ROI |
| `case-study` | 3-5 | Cliente specifico, numeri, testimonianza |
| `one-pager` | 1 | Sintesi estrema, il meno possibile |

Se `--tipo` non specificato, chiedi all'utente o default a `brochure`.

## Workflow

### 1. Identifica tipo + brand + input
- Tipo documento (brochure default)
- Brand (iridia default — piu adatto marketing commerciale)
- Input `.md` o prompt descrizione

### 2. Raccogli dati placeholder
Chiedi all'utente i valori mancanti. Per headline/claim, proponi 3 varianti e fai scegliere.

### 3. Genera infografiche
Marketing usa infografiche diverse dal manuale:

| Sezione | Tipo infografica | Prompt template |
|---------|------------------|-----------------|
| Problema | `data-pain-point` | Grafico con numeri del problema (es. "60% aziende soffre di X") |
| Soluzione → Architettura | `tech-architecture` | Schema layered architecture |
| Benefit | `icon-grid` | Griglia 4 benefit con icone |
| Case Study → Risultati | `before-after` | Confronto prima/dopo con metriche |
| Comparison | `comparison-matrix` | Tabella visuale competitor |

Vedi `prompt-templates.md` per i prompt Gemini completi.

### 4. Compila template
```bash
python3 "$HOME/.claude/skills/doc-offerta/../../scripts/compile-iridia-template.py" \
  --template "$HOME/.claude/skills/doc-offerta/references/templates-variants/Template_Marketing_Iridia.docx" \
  --data ./dati-marketing.json \
  --images ./output/infografiche/ \
  --output ./output/marketing-{prodotto}.docx
```

### 5. Verifica tone of voice
Marketing deve essere:
- **Iridia**: commerciale-divulgativo, benefit-oriented, linguaggio accessibile
- **NexaData**: tecnico-formale, data-driven, ROI e KPI enfatizzati

Se Claude scrive troppo "tecnichese" per Iridia, rephrasa in linguaggio business.

## Modalità Auto

Se `$ARGUMENTS` contiene `--auto`:
- Brand: iridia (default)
- Tipo: brochure
- Stile infografiche: modern-light (visual)
- Numeri benefit: 4 (grid standard)
- Output: `./output/marketing-{timestamp}.docx`

## Esempi

```bash
# Brochure prodotto Iridia
/doc-marketing brochure-presenta.md --brand iridia --tipo brochure

# White paper tecnico NexaData
/doc-marketing whitepaper-ai-governance.md --brand nexadata --tipo whitepaper

# Case study cliente
/doc-marketing case-study-ACME.md --brand iridia --tipo case-study

# One-pager veloce
/doc-marketing --tipo one-pager --auto
# Poi Claude chiede: "Descrivi il prodotto in una frase"
```

## File correlati

- Template: `$HOME/.claude/skills/doc-offerta/references/templates-variants/Template_Marketing_{Iridia,NexaData}.docx`
- Script compile: `$HOME/.claude/skills/doc-offerta/../../scripts/compile-{iridia-,}template.py`
- Script infografica: `$HOME/.claude/skills/doc-offerta/../../scripts/generate-infografica.ts`
- Stili: `$HOME/.claude/skills/doc-offerta/references/style-catalog.md`

## Prossimo passo

Materiale marketing utilizzato spesso insieme a:
- `/doc-offerta` — Offerta specifica post-marketing qualification
- `/doc-presentazione` — Slide board-level basate sul marketing
- `/doc-report` — Report KPI post-campagna