a29db752af
- Sostituite 135 occorrenze di clients/{client}/ con {project}/
- Aggiornati parametri: client_path → project_path in 11 skills
- README.md aggiornato con nuova convenzione {project}/
- Struttura cartelle ora agnostica: compatibile con clients/, projects/, o qualsiasi cartella
- Maggiore flessibilità per diversi sistemi e workflow
Vantaggi:
✅ Compatibile con qualsiasi struttura cartelle
✅ Non impone convenzione 'clients/'
✅ Utile per progetti interni, campagne, o clienti
✅ Più generale e riutilizzabile
263 lines
6.4 KiB
Markdown
263 lines
6.4 KiB
Markdown
---
|
|
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 |
|
|
|-------|------|-------------|
|
|
| `project_path` | string | Percorso progetto (cartella di lavoro) |
|
|
| `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:**
|
|
- `{project}/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 agency-shared-references/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:**
|
|
- `{project}/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 `../agency-shared-references/references/copy_frameworks.md`:**
|
|
- PAS (Problem-Agitate-Solve)
|
|
- AIDA (Attention-Interest-Desire-Action)
|
|
- Before-After-Bridge
|
|
|
|
4. **Applica `../agency-shared-references/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 `{project}/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:**
|
|
- `{project}/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:**
|
|
- `{project}/website/qa/qa_website.md`
|
|
|
|
---
|
|
|
|
## Output
|
|
|
|
| File | Formato | Descrizione |
|
|
|------|---------|-------------|
|
|
| `{project}/website/sitemap.md` | Markdown | Architettura sito |
|
|
| `{project}/website/pages/*.md` | Markdown | Copy pagine |
|
|
| `{project}/website/seo/meta.md` | Markdown | SEO metadata |
|
|
| `{project}/website/qa/qa_website.md` | Markdown | QA checklist |
|
|
|
|
---
|
|
|
|
## References
|
|
|
|
### UX/Design Patterns (Shared)
|
|
- [copy_frameworks.md](../agency-shared-references/references/copy_frameworks.md) — Framework copy
|
|
- [conversion_patterns.md](../agency-shared-references/references/conversion_patterns.md) — CTA e conversioni
|
|
- [hero_sections.md](../agency-shared-references/references/hero_sections.md) — Hero patterns
|
|
- [navigation_patterns.md](../agency-shared-references/references/navigation_patterns.md) — IA patterns
|
|
- [brand_voice.md](../agency-shared-references/references/brand_voice.md) — Tone of voice
|
|
- [design_patterns.md](../agency-shared-references/references/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](../agency-shared-references/references/html_semantics.md) — Come il copy diventa struttura HTML
|
|
- [css_layout.md](../agency-shared-references/references/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_
|