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

name	description
agency-analytics	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
project_path	string	Percorso progetto (cartella di lavoro)
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:

# 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:

## 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:

## 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:

## 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 ../agency-shared-references/references/weekly_report_template.md
2. Compila tutte le sezioni
3. Salva in {project}/analytics/weekly_reports/{YYYY-WW}.md
4. Documenta azioni nel run log del progetto se richiedono follow-up

Output:

• {project}/analytics/weekly_reports/YYYY-WW.md

---

Output

File	Formato	Descrizione
{project}/analytics/weekly_reports/YYYY-WW.md	Markdown	Report settimanale
{project}/ops/run_log.md	Markdown	Azioni e follow-up (se necessario)

---

References

• weekly_report_template.md — Template report
• quality_bar.md — Standard di qualità

---

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