Initial release: agency_v3_1-skills-suite v1.0

- 12 AgentSkills generate da agency_v3_1 framework
- 17 references centralizzate
- Script INSTALL.sh per installazione automatica
- README.md con documentazione completa

Skills incluse:
- agency-orchestrator (coordinamento + QA)
- agency-strategy (positioning, messaging)
- agency-research (competitive intelligence)
- agency-creative-director (direzione visiva)
- agency-design-system (tokens, components)
- agency-ux-copy (sitemap, copy)
- agency-seo (SEO tecnico)
- agency-social (social strategy)
- agency-youtube (YouTube strategy)
- agency-visual-generator (asset visuali)
- agency-analytics (report KPI)
- agency-publisher (publish gate-based)

Generated by framework-translator v2.0
Approved by: MarcoB (2026-03-09)

agency-analytics/SKILL.md

@@ -0,0 +1,223 @@
+---
+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_

agency-analytics/references

@@ -0,0 +1 @@
+../references