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:

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

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

# 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

{
  "@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 — Fondamentali SEO
• metadata_rules.md — Regole meta tag
• 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)

---

References

SEO Core

• navigation_patterns.md — IA patterns
• conversion_patterns.md — CTA hierarchy

Technical Implementation

Per implementazione on-page SEO nel codice:

• html_semantics.md — Semantic HTML, heading hierarchy, meta tags
• css_layout.md — Mobile-first, performance

Nota: Questa skill produce strategia SEO + metadata. Per implementazione HTML, usare agency-web-developer.

---

Skill generata da framework-translator