agency-skills-suite/agency-seo/SKILL.md

---
name: agency-seo
description: Gestire SEO tecnico per siti web: keyword research, metadata, schema markup. Usare quando: (1) nuovo sito needs SEO setup, (2) ottimizzare pagine esistenti, (3) implementare schema markup. Output: Keyword list, meta library, schema notes, SEO changelog.
---

# Agency Dev/SEO — SEO Tecnico

SEO tecnico, metadata e schema markup per visibilità search.

## Quando Usare

- **Nuovo sito:** Setup SEO fondamentale
- **SEO audit:** Ottimizzare pagine esistenti
- **Schema markup:** Implementare structured data
- **Ongoing:** Mantenere changelog SEO

---

## Input

| Input | Tipo | Validazione |
|-------|------|-------------|
| `client_path` | string | Percorso client |
| `website_pages` | array | Lista pagine da ottimizzare |
| `copy_docs` | array | Copy pagine (da ux-copy) |
| `keyword_seed` | array | Keyword iniziali (opzionale) |
| `competitors` | array | Competitor per benchmark (opzionale) |

---

## Processo

### Fase 1: Keyword Seed List

**Obiettivo:** Creare lista keyword di base.

**Azioni:**

1. Se keyword seed fornite: espandi con varianti
2. Se non fornite: crea lista ragionata basata su:
   - Offering del cliente
   - Audience personas
   - Competitor (se noti)

3. Categorizza keyword:
   - **Primary:** 1-2 per pagina principale
   - **Secondary:** 2-3 per pagina
   - **Long-tail:** Per blog/content

**Template:**

```markdown
# Keyword Seed List

## Homepage
- Primary: "agency {settore}", "servizi {niche}"
- Secondary: "consulenza {settore}", "agenzia {città}"

## Services
- Primary: "servizi {settore}", "{servizio} prezzo"
- Secondary: "miglior {servizio}", "{servizio} professionale"

## About
- Primary: "chi siamo {settore}", "{brand} recensioni"
```

**Output:**
- `clients/{client}/website/seo/keywords.md`

---

### Fase 2: Meta Library

**Obiettivo:** Creare title e meta description per ogni pagina.

**Azioni:**

1. Per ogni pagina in sitemap:

**Title tag:**
- 50-60 caratteri
- Keyword primaria all'inizio
- Brand name alla fine
- Formula: `{Primary Keyword} | {Brand Name}`

**Meta description:**
- 150-160 caratteri
- Include keyword primaria
- Copy compelling con CTA implicita
- Formula: `{Beneficio} + {Proof} + {CTA}`

**Template:**

```markdown
# Meta Library

## Homepage
- **Title:** Agency {Settore} per {Audience} | {Brand}
- **Meta:** Aiutiamo {audience} a ottenere {outcome} con {approccio}. 
  {Proof}. Prenota una call gratuita.

## Services
- **Title:** Servizi di {Settore} | {Brand}
- **Meta:** {Servizio 1}, {Servizio 2}, {Servizio 3}. 
  Risultati concreti per {audience}. Richiedi preventivo.

## About
- **Title:** Chi Siamo | {Brand} - {Settore}
- **Meta:** {Anni} anni di esperienza in {settore}. 
  Scopri il nostro approccio e il team.
```

**Output:**
- `clients/{client}/website/seo/meta_library.md`

---

### Fase 3: Schema Markup Notes

**Obiettivo:** Pianificare structured data per rich snippets.

**Azioni:**

1. Identifica schema types rilevanti:
   - **Organization** (homepage/about)
   - **LocalBusiness** (se business locale)
   - **Service** (service pages)
   - **FAQPage** (se FAQ presenti)
   - **Article/BlogPosting** (blog posts)

2. Per ogni pagina, specifica:
   - Schema type
   - Proprietà richieste
   - Valori da inserire

**Template:**

```markdown
# Schema Notes

## Homepage — Organization Schema

```json
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "{Brand Name}",
  "url": "{website_url}",
  "logo": "{logo_url}",
  "description": "{meta description}",
  "sameAs": [
    "{social_link_1}",
    "{social_link_2}"
  ]
}
```

## Services — Service Schema

```json
{
  "@context": "https://schema.org",
  "@type": "Service",
  "serviceType": "{Servizio}",
  "provider": {
    "@type": "Organization",
    "name": "{Brand}"
  },
  "areaServed": {
    "@type": "Country",
    "name": "Italia"
  }
}
```
```

**Output:**
- `clients/{client}/website/seo/schema_notes.md`

---

### Fase 4: SEO Changelog

**Obiettivo:** Tracciare cambiamenti SEO nel tempo.

**Azioni:**

1. Crea log con:
   - Data
   - Pagina modificata
   - Tipo di cambiamento
   - Motivazione

**Template:**

```markdown
# SEO Changelog

| Data | Pagina | Cambiamento | Motivazione |
|------|--------|-------------|-------------|
| 2026-03-09 | Homepage | Update title + meta | Ottimizzazione keyword |
| 2026-03-09 | Services | Aggiunto schema Service | Rich snippets |
```

**Output:**
- `clients/{client}/website/changelog.md`

---

## Output

| File | Formato | Descrizione |
|------|---------|-------------|
| `clients/{client}/website/seo/keywords.md` | Markdown | Keyword seed list |
| `clients/{client}/website/seo/meta_library.md` | Markdown | Title e meta per pagine |
| `clients/{client}/website/seo/schema_notes.md` | Markdown | Schema markup plans |
| `clients/{client}/website/changelog.md` | Markdown | SEO changelog |

---

## References

- [seo_fundamentals.md](../../references/seo_fundamentals.md) — Fondamentali SEO
- [metadata_rules.md](../../references/metadata_rules.md) — Regole meta tag
- [navigation_patterns.md](../../references/navigation_patterns.md) — IA patterns

---

## Note

**Edge Cases:**

- **Nessun dato keyword:** Crea seed list basata su offering e buon senso
- **Sito esistente:** Esegui audit prima di cambiare (usa tool SEO se disponibili)
- **Multi-lingua:** Piano SEO separato per ogni lingua

**Limitazioni:**

- Keyword research approfondita richiede tool dedicati (Ahrefs, SEMrush)
- Implementazione tecnica richiede accesso al codice
- Risultati SEO richiedono tempo (3-6 mesi minimi)

---

_Skill generata da framework-translator_