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
260 lines
6.1 KiB
Markdown
260 lines
6.1 KiB
Markdown
---
|
|
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 |
|
|
|-------|------|-------------|
|
|
| `project_path` | string | Percorso progetto (cartella di lavoro) |
|
|
| `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:**
|
|
- `{project}/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:**
|
|
- `{project}/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:**
|
|
- `{project}/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:**
|
|
- `{project}/website/changelog.md`
|
|
|
|
---
|
|
|
|
## Output
|
|
|
|
| File | Formato | Descrizione |
|
|
|------|---------|-------------|
|
|
| `{project}/website/seo/keywords.md` | Markdown | Keyword seed list |
|
|
| `{project}/website/seo/meta_library.md` | Markdown | Title e meta per pagine |
|
|
| `{project}/website/seo/schema_notes.md` | Markdown | Schema markup plans |
|
|
| `{project}/website/changelog.md` | Markdown | SEO changelog |
|
|
|
|
---
|
|
|
|
## References
|
|
|
|
- [seo_fundamentals.md](../agency-shared-references/references/seo_fundamentals.md) — Fondamentali SEO
|
|
- [metadata_rules.md](../agency-shared-references/references/metadata_rules.md) — Regole meta tag
|
|
- [navigation_patterns.md](../agency-shared-references/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)
|
|
|
|
---
|
|
|
|
## References
|
|
|
|
### SEO Core
|
|
- [navigation_patterns.md](../../references/navigation_patterns.md) — IA patterns
|
|
- [conversion_patterns.md](../../references/conversion_patterns.md) — CTA hierarchy
|
|
|
|
### Technical Implementation
|
|
**Per implementazione on-page SEO nel codice:**
|
|
- [html_semantics.md](../agency-web-developer/references/html_semantics.md) — Semantic HTML, heading hierarchy, meta tags
|
|
- [css_layout.md](../agency-web-developer/references/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_
|