agency-skills-suite/agency-analytics/SKILL.md

---
name: agency-analytics
description: Generare report settimanali KPI e identificare azioni per social e YouTube. Usare quando: (1) report settimanale, (2) analisi performance content, (3) pianificare azioni basate su dati. Output: Weekly report con KPI snapshot, highlights, lowlights, max 5 actions.
---

# Agency Analyst/KPI — Report Settimanali

Report KPI settimanali e azioni misurabili per social e YouTube.

## Quando Usare

- **Weekly check:** Report prestazioni settimana
- **Post-campaign:** Analisi campagna specifica
- **Monthly review:** Sintesi mensile (aggrega weekly)
- **Strategy adjust:** Identificare cosa cambiare

---

## Input

| Input | Tipo | Validazione |
|-------|------|-------------|
| `client_path` | string | Percorso client |
| `kpi_definitions` | object | KPI da tracciare |
| `dashboards_links` | array | Link a analytics (se disponibili) |
| `week_number` | string | Numero settimana (es. "2026-W10") |
| `published_content` | array | Content pubblicato nella settimana |

---

## Processo

### Fase 1: Raccolta Dati

**Obiettivo:** Raccogliere KPI della settimana.

**Azioni:**

1. Identifica fonti dati:
   - **Social:** LinkedIn Analytics, Instagram Insights, X Analytics
   - **YouTube:** YouTube Studio
   - **Website:** Google Analytics (se applicabile)

2. Per ogni piattaforma, raccogli:
   - Views / Impressions
   - Engagement (likes, comments, shares)
   - Clicks / CTR
   - Follower/Subscribers growth
   - Top content della settimana

3. Se dati NON disponibili:
   - Documenta mancanza
   - Proponi setup tracking
   - Usa stime basate su published log

**Template Raccolta:**

```markdown
# Dati Settimana {WW}

## LinkedIn
- Posts published: {N}
- Total impressions: {N}
- Total engagement: {N}
- Engagement rate: {N}%
- Top post: {titolo} ({impressions})

## Instagram
- Posts published: {N}
- Reach: {N}
- Engagement: {N}
- Saves: {N}
- Top post: {titolo}

## YouTube
- Videos published: {N}
- Views: {N}
- Watch time: {N} ore
- Avg retention: {N}%
- Top video: {titolo}
```

---

### Fase 2: KPI Snapshot

**Obiettivo:** Sintetizzare metriche chiave.

**Azioni:**

1. Crea snapshot conciso (max 10 metriche totali)
2. Includi:
   - Metriche di volume (views, impressions)
   - Metriche di engagement (rate, clicks)
   - Growth (follower, subscribers)
3. Evidenzia trend (vs settimana precedente, se disponibile)

**Template:**

```markdown
## KPI Snapshot — Week {WW}

| Metrica | Valore | vs Week Precedente |
|---------|--------|-------------------|
| Total Impressions | 12,450 | +15% |
| Engagement Rate | 4.2% | +0.3% |
| New Followers | +34 | +12% |
| YouTube Views | 2,340 | -5% |
| Avg Retention | 45% | stabile |
```

---

### Fase 3: Highlights e Lowlights

**Obiettivo:** Identificare cosa ha funzionato e cosa no.

**Azioni:**

1. **Highlights (2-3):**
   - Top content della settimana
   - Record battuti
   - Insight positivi

2. **Lowlights (1-2):**
   - Content underperforming
   - Metriche in calo
   - Problemi identificati

**Template:**

```markdown
## Highlights

1. **Post LinkedIn "3 errori comuni"** — 5,200 impressions, 8.4% engagement rate (2x media)
2. **YouTube video "Case Study X"** — 62% retention a 30s (record)
3. **+50 followers** — crescita più alta del mese

## Lowlights

1. **Instagram carousel** — 40% reach in meno vs media (algoritmo?)
2. **YouTube CTR thumbnail** — 3.2% (target: 5%+)
```

---

### Fase 4: Actions Next Week

**Obiettivo:** Definire max 5 azioni concrete.

**Azioni:**

1. Basa azioni su highlights/lowlights
2. Prioritizza impatto alto / sforzo basso
3. Specifica:
   - Cosa fare
   - Perché (data-driven)
   - Come misurare successo

**Template:**

```markdown
## Actions Next Week (max 5)

1. **Raddoppiare su formato "errori comuni"** — Engagement 2x media, produrre variante per Instagram
2. **Test nuove thumbnail YouTube** — CTR basso, A/B test 2 varianti
3. **Analizzare calo reach Instagram** — Check algoritmo, valuta posting times alternativi
4. **Pianificare case study Q2** — Top performing format, iniziare produzione
5. **Setup UTM tracking** — Migliorare attribution clicks → website
```

---

### Fase 5: Weekly Report

**Obiettivo:** Compilare report finale.

**Azioni:**

1. Usa template da `references/weekly_report_template.md`
2. Compila tutte le sezioni
3. Salva in `clients/{client}/analytics/weekly_reports/{YYYY-WW}.md`
4. Aggiorna backlog se azioni richiedono task

**Output:**
- `clients/{client}/analytics/weekly_reports/YYYY-WW.md`
- Update suggerito a `clients/{client}/ops/backlog.md`

---

## Output

| File | Formato | Descrizione |
|------|---------|-------------|
| `clients/{client}/analytics/weekly_reports/YYYY-WW.md` | Markdown | Report settimanale |
| `clients/{client}/ops/backlog.md` | Markdown | Update con actions (se necessario) |

---

## References

- [weekly_report_template.md](../../references/weekly_report_template.md) — Template report
- [quality_bar.md](../../references/quality_bar.md) — Standard V1

---

## Note

**Edge Cases:**

- **Nessun dato disponibile:** Documenta mancanza, proponi setup tracking, usa published log come proxy
- **Dati parziali:** Riporta cosa disponibile, segnala gap
- **Settimana corta (festività):** Nota contesto, non confrontare con settimane normali

**Limitazioni:**

- Richiede accesso a dashboard analytics (o export manuali)
- Alcuni dati potrebbero avere delay (24-48h)
- Attribution website → social richiede UTM setup

---

_Skill generata da framework-translator_