Initial release: agency_v3_1-skills-suite v1.0

- 12 AgentSkills generate da agency_v3_1 framework
- 17 references centralizzate
- Script INSTALL.sh per installazione automatica
- README.md con documentazione completa

Skills incluse:
- agency-orchestrator (coordinamento + QA)
- agency-strategy (positioning, messaging)
- agency-research (competitive intelligence)
- agency-creative-director (direzione visiva)
- agency-design-system (tokens, components)
- agency-ux-copy (sitemap, copy)
- agency-seo (SEO tecnico)
- agency-social (social strategy)
- agency-youtube (YouTube strategy)
- agency-visual-generator (asset visuali)
- agency-analytics (report KPI)
- agency-publisher (publish gate-based)

Generated by framework-translator v2.0
Approved by: MarcoB (2026-03-09)
This commit is contained in:
AgentePotente 2026-03-09 12:23:58 +01:00
commit 6ac766172c
47 changed files with 4165 additions and 0 deletions

245
agency-seo/SKILL.md Normal file
View file

@ -0,0 +1,245 @@
---
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_

1
agency-seo/references Symbolic link
View file

@ -0,0 +1 @@
../references