agency-skills-suite/agency-ux-copy/SKILL.md

name	description
agency-ux-copy	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:

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

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

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

UX/Design Patterns (Shared)

• copy_frameworks.md — Framework copy
• conversion_patterns.md — CTA e conversioni
• hero_sections.md — Hero patterns
• navigation_patterns.md — IA patterns
• brand_voice.md — Tone of voice
• design_patterns.md — UI patterns (card grid, split layout, testimonial, FAQ)

Handoff a Developer

Dopo aver completato copy, passare a:

• agency-web-developer — Implementa HTML/CSS/JS dal copy
• html_semantics.md — Come il copy diventa struttura HTML
• css_layout.md — Come i layout diventano CSS

Nota: Questa skill produce sitemap + copy. Per implementazione codice, usare agency-web-developer.

---

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