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)
This commit is contained in:
AgentePotente 2026-03-09 12:23:58 +01:00
commit 6ac766172c
47 changed files with 4165 additions and 0 deletions

253
agency-ux-copy/SKILL.md Normal file
View file

@ -0,0 +1,253 @@
---
name: agency-ux-copy
description: Progettare sitemap e scrivere copy per pagine web conversion-oriented. Usare quando: (1) nuovo sito web, (2) rewrite copy esistente, (3) ottimizzare conversioni. Output: Sitemap, page structures, copy V1, SEO notes.
---
# Agency UX Copy Architect — Sitemap e Copy
Progetta la struttura del sito e scrive copy chiaro e conversion-oriented.
## Quando Usare
- **Nuovo sito:** Creare sitemap e copy da zero
- **Website refresh:** Riscrivere copy esistente
- **Landing page:** Pagina campaign specifica
- **Conversion optimization:** Migliorare CTA e flow
---
## Input
| Input | Tipo | Validazione |
|-------|------|-------------|
| `client_path` | string | Percorso client |
| `strategy_docs` | array | Positioning, messaging, content pillars |
| `design_layouts` | array | Page layouts (da design system) |
| `seo_keywords` | array | Keyword seed (se disponibili) |
| `page_list` | array | Pagine richieste (opzionale) |
---
## Processo
### Fase 1: Sitemap
**Obiettivo:** Definire architettura informazione.
**Azioni:**
1. Identifica pagine necessarie:
- Obbligatorie: Home, About, Services, Contact
- Opzionali: Case Studies, Blog, Resources
2. Per ogni pagina, definisci:
- Nome
- Scopo/Intent
- CTA primaria
- Note SEO
**Template:**
```markdown
# Sitemap
## Homepage
- **Intent:** Presentare value prop e guidare a CTA
- **CTA:** "Prenota call"
- **SEO:** Keyword primaria + secondary
## Services
- **Intent:** Descrivere offerte
- **CTA:** "Richiedi preventivo"
- **SEO:** "servizi {settore}"
## About
- **Intent:** Costruire trust
- **CTA:** "Conosci il team"
- **SEO:** "chi siamo {settore}"
## Contact
- **Intent:** Facilitare contatto
- **CTA:** "Invia messaggio"
- **SEO:** "contatti {settore}"
```
**Output:**
- `clients/{client}/website/sitemap.md`
---
### Fase 2: Page Skeletons
**Obiettivo:** Creare struttura per ogni pagina.
**Azioni:**
1. Per ogni pagina in sitemap, definisci:
- H1 (headline principale)
- H2/H3 (sezioni)
- Hero section (headline, sub, CTA)
- Content sections (ordine logico)
- CTA sections (mid-page, footer)
- FAQ (se applicabile)
2. Usa pattern da references:
- `hero_sections.md` per hero
- `conversion_patterns.md` per CTA
- `design_patterns.md` per layout
**Template:**
```markdown
# Homepage
## Hero
- H1: {Headline}
- Sub: {Supporting copy}
- CTA: {Testo CTA}
- Proof: {Proof chips}
## Section 1: Services Overview
- H2: {Titolo}
- Content: {Card grid con 3-6 servizi}
## Section 2: Proof
- H2: {Titolo}
- Content: {Logo wall o testimonial}
## Section 3: CTA Finale
- H2: {Titolo}
- CTA: {Testo CTA}
```
**Output:**
- `clients/{client}/website/pages/{page_name}.md`
---
### Fase 3: Copywriting
**Obiettivo:** Scrivere copy per ogni sezione.
**Azioni:**
1. **Hero copy:**
- Headline: 6-12 parole, outcome-focused
- Sub: 1-2 frasi, meccanismo + proof
- CTA: Verbo chiaro ("Prenota", "Richiedi")
2. **Section copy:**
- Intro: 1-2 frasi
- Bullets: 3-5 punti chiave
- Microcopy: Label, button text
3. **Usa framework da `references/copy_frameworks.md`:**
- PAS (Problem-Agitate-Solve)
- AIDA (Attention-Interest-Desire-Action)
- Before-After-Bridge
4. **Applica `references/conversion_patterns.md`:**
- 1 CTA primaria per pagina
- Ripeti CTA 2-3 volte
- Friction reducers vicino a form
**Regole copy:**
- Parole semplici, niente gergo
- Frasi corte
- Focus su benefici, non features
- Proof ovunque possibile
**Output:**
- Copy completo in `clients/{client}/website/pages/*.md`
---
### Fase 4: SEO Metadata
**Obiettivo:** Ottimizzare on-page SEO.
**Azioni:**
1. Per ogni pagina, compila:
- Title tag (50-60 caratteri)
- Meta description (150-160 caratteri)
- H1 (unico per pagina)
- Keyword primaria
- Internal linking notes
**Template:**
```markdown
## SEO Metadata — Homepage
- **Title:** {Keyword primaria} | {Brand Name}
- **Meta description:** {Copy con keyword, 150-160 char}
- **H1:** {Headline hero}
- **Keyword primaria:** {keyword}
- **Internal links:** → Services, → Case Studies, → Contact
```
**Output:**
- `clients/{client}/website/seo/meta.md`
---
### Fase 5: QA Copy
**Obiettivo:** Verificare qualità copy.
**Azioni:**
1. Leggi tutto il copy ad alta voce
2. Verifica:
- Chiarezza (niente ambiguità)
- Coerenza tono (brand voice)
- CTA chiare e visibili
- Proof presente
- Niente gergo o fuffa
3. Compila QA checklist
**Output:**
- `clients/{client}/website/qa/qa_website.md`
---
## Output
| File | Formato | Descrizione |
|------|---------|-------------|
| `clients/{client}/website/sitemap.md` | Markdown | Architettura sito |
| `clients/{client}/website/pages/*.md` | Markdown | Copy pagine |
| `clients/{client}/website/seo/meta.md` | Markdown | SEO metadata |
| `clients/{client}/website/qa/qa_website.md` | Markdown | QA checklist |
---
## References
- [copy_frameworks.md](../../references/copy_frameworks.md) — Framework copy
- [conversion_patterns.md](../../references/conversion_patterns.md) — CTA e conversioni
- [hero_sections.md](../../references/hero_sections.md) — Hero patterns
- [navigation_patterns.md](../../references/navigation_patterns.md) — IA patterns
- [brand_voice.md](../../references/brand_voice.md) — Tone of voice
---
## Note
**Edge Cases:**
- **Nessuna keyword SEO:** Crea seed list ragionata basata su offering
- **Cliente non fornisce info:** Usa assunzioni documentate in decision log
- **Copy esistente da rewrite:** Mantieni struttura, migliora chiarezza e CTA
**Limitazioni:**
- Copywriting efficace richiede comprensione profonda del cliente
- SEO avanzata richiede keyword research dedicata
- Test A/B richiede implementazione tecnica
---
_Skill generata da framework-translator_

1
agency-ux-copy/references Symbolic link
View file

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