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)
2026-03-09 12:23:58 +01:00 · 2026-03-09 12:23:58 +01:00 · 6ac766172c
commit 6ac766172c
47 changed files with 4165 additions and 0 deletions
--- a/agency-youtube/SKILL.md
+++ b/agency-youtube/SKILL.md
@ -0,0 +1,246 @@
+---
+name: agency-youtube
+description: Creare YouTube strategy, calendario e script retention-first. Usare quando: (1) nuovo canale YouTube, (2) pianificare content video, (3) scrivere script. Output: YouTube strategy, calendario, 2+ script completi con thumbnail brief.
+---
+
+# Agency YouTube Producer — Strategy e Script
+
+Strategia YouTube, calendario e script orientati a retention.
+
+## Quando Usare
+
+- **Nuovo canale:** Impostare strategy da zero
+- **Content planning:** Pianificare episodi
+- **Script writing:** Scrivere script retention-first
+- **Channel refresh:** Aggiornare approccio
+
+---
+
+## Input
+
+| Input | Tipo | Validazione |
+|-------|------|-------------|
+| `client_path` | string | Percorso client |
+| `content_pillars` | array | Da strategy |
+| `brand_voice` | object | Tone of voice |
+| `target_audience` | object | Audience YouTube |
+| `video_frequency` | string | Frequenza upload (es. "1x settimana") |
+
+---
+
+## Processo
+
+### Fase 1: YouTube Strategy
+
+**Obiettivo:** Definire approccio al canale.
+
+**Azioni:**
+
+1. **Channel positioning:**
+   - Scopo del canale
+   - Audience target
+   - Value proposition unica
+
+2. **Format/Serie:**
+   - Identifica 2-4 format ricorrenti
+   - Per ogni formato: nome, descrizione, frequenza
+
+3. **KPI:**
+   - Views
+   - Watch time / retention
+   - Subscribers
+   - Engagement (comments, likes)
+
+**Template:**
+
+```markdown
+# YouTube Strategy
+
+## Channel Positioning
+- **Scopo:** {Perché esiste il canale}
+- **Audience:** {Chi guarderà i video}
+- **Value Prop:** {Perché guardare questo canale}
+
+## Format / Serie
+
+### Format 1: {Nome}
+- **Descrizione:** {Cosa è}
+- **Frequenza:** {Ogni quanto}
+- **Durata target:** {Minuti}
+
+### Format 2: {Nome}
+...
+
+## KPI Target
+- Views/episodio: {target}
+- Retention media: {target}%
+- Subscriber growth: {target}/mese
+```
+
+**Output:**
+- `clients/{client}/youtube/youtube_strategy.md`
+
+---
+
+### Fase 2: Calendario Episodi
+
+**Obiettivo:** Pianificare 4-8 episodi.
+
+**Azioni:**
+
+1. Crea calendario con:
+   - Episodio #
+   - Titolo working
+   - Formato
+   - Pillar
+   - Status (idea/script/filmed/edited/published)
+   - Data target publish
+
+**Template:**
+
+```markdown
+# YouTube Calendar
+
+| Ep # | Titolo | Formato | Pillar | Status | Data Target |
+|------|--------|---------|--------|--------|-------------|
+| 001 | "3 errori comuni in {settore}" | Tutorial | Education | Script | 2026-03-15 |
+| 002 | "Case Study: {Cliente}" | Case Study | Proof | Idea | 2026-03-22 |
+| 003 | "Come {risultato} in 5 step" | Tutorial | Education | Script | 2026-03-29 |
+```
+
+**Output:**
+- `clients/{client}/youtube/calendar.md`
+
+---
+
+### Fase 3: Script Writing
+
+**Obiettivo:** Scrivere 2+ script completi retention-first.
+
+**Azioni:**
+
+1. Usa struttura da `references/youtube_script_framework.md`:
+   - 0-10s: Hook (promise + curiosity)
+   - 10-25s: Credibility (why listen)
+   - 25-60s: Problem definition
+   - Main: 3-5 chapters con open loops
+   - End: Summary + CTA
+
+2. Per ogni script, compila:
+
+**Template:**
+
+```markdown
+# Episode 001 — {Titolo}
+
+**Format:** {Tutorial/Teardown/Case Study}
+**Durata target:** {minuti}
+**Status:** Draft
+
+## Hook (0-10s)
+{Promise + curiosity. Esempio: "In questo video ti mostro come X in Y tempo. La maggior parte sbaglia Z..."}
+
+## Credibility (10-25s)
+{Perché ascoltarti. Esempio: "Ho aiutato 50+ clienti a fare X..."}
+
+## Problem (25-60s)
+{Definisci problema relatable. Esempio: "Se sei qui, probabilmente stai lottando con..."}
+
+## Chapter 1: {Titolo}
+- Punto chiave 1
+- Esempio concreto
+- Mini-recap
+
+## Chapter 2: {Titolo}
+...
+
+## Chapter 3: {Titolo}
+...
+
+## Summary + CTA
+- Recap punti chiave
+- CTA: "Iscriviti", "Commenta", "Guarda il prossimo video"
+
+## Thumbnail Brief
+
+**Titolo su thumbnail:** {3-5 parole max}
+**Visual:** {Cosa mostrare}
+**Colori:** {Palette}
+
+## Metadata
+
+**Titolo video (3 opzioni):**
+1. {Opzione 1}
+2. {Opzione 2}
+3. {Opzione 3}
+
+**Descrizione:**
+{Copy descrizione YouTube con link e timestamp}
+
+**Tags:** {tag1, tag2, tag3}
+
+**Chapters:**
+0:00 Intro
+0:45 Chapter 1
+2:30 Chapter 2
+...
+```
+
+**Output:**
+- `clients/{client}/youtube/scripts/ep_001.md`, `ep_002.md`, etc.
+
+---
+
+### Fase 4: Published Log (Opzionale)
+
+**Obiettivo:** Tracciare video pubblicati.
+
+**Azioni:**
+
+1. Dopo publish, aggiorna:
+   - Data publish
+   - Video URL
+   - Performance (views, retention, etc.)
+
+**Output:**
+- `clients/{client}/youtube/published_log.md`
+
+---
+
+## Output
+
+| File | Formato | Descrizione |
+|------|---------|-------------|
+| `clients/{client}/youtube/youtube_strategy.md` | Markdown | Strategy canale |
+| `clients/{client}/youtube/calendar.md` | Markdown | Calendario episodi |
+| `clients/{client}/youtube/scripts/*.md` | Markdown | 2+ script completi |
+| `clients/{client}/youtube/published_log.md` | Markdown | Log publish (opzionale) |
+
+---
+
+## References
+
+- [youtube_script_framework.md](../../references/youtube_script_framework.md) — Struttura script
+- [content_formats.md](../../references/content_formats.md) — Formati YouTube
+- [brand_voice.md](../../references/brand_voice.md) — Tone of voice
+- [youtube_script.md](../../templates/youtube_script.md) — Template script
+
+---
+
+## Note
+
+**Edge Cases:**
+
+- **Nessun dato audience:** Usa personas da strategy o assumi basandoti su content pillars
+- **Cliente non vuole video:** Focus su script per voiceover + B-roll
+- **Thumbnail:** Usa brief per `agency-visual-generator`
+
+**Limitazioni:**
+
+- Upload video richiede tool esterno o integrazione YouTube API
+- Performance tracking richiede YouTube Studio access
+- Script efficaci richiedono pratica e testing
+
+---
+
+_Skill generata da framework-translator_
--- a/agency-youtube/references
+++ b/agency-youtube/references
@ -0,0 +1 @@
+../references