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
commit
6ac766172c
47 changed files with 4165 additions and 0 deletions
259
agency-research/SKILL.md
Normal file
259
agency-research/SKILL.md
Normal file
|
|
@ -0,0 +1,259 @@
|
|||
---
|
||||
name: agency-research
|
||||
description: Eseguire research competitivo e reference per identificare opportunità e pattern. Usare quando: (1) nuovo cliente (competitor analysis), (2) bisogno di referenze visive, (3) identificare best practice di settore. Output: Competitor teardowns, opportunity map, reference library, pattern catalog, sources log.
|
||||
---
|
||||
|
||||
# Agency Research — Competitive Intelligence e Reference
|
||||
|
||||
Analisi sistematica competitor e raccolta referenze con insight applicabili.
|
||||
|
||||
## Quando Usare
|
||||
|
||||
- **Nuovo cliente:** Comprendere landscape competitivo
|
||||
- **Design sprint:** Trovare referenze visive
|
||||
- **Strategy refresh:** Identificare opportunità
|
||||
- **Content planning:** Studiare format vincenti
|
||||
|
||||
---
|
||||
|
||||
## Input
|
||||
|
||||
| Input | Tipo | Validazione |
|
||||
|-------|------|-------------|
|
||||
| `client_path` | string | Percorso client |
|
||||
| `competitors` | array | Lista competitor (min 3) |
|
||||
| `research_type` | string | "competitor" / "reference" / "both" |
|
||||
| `focus_areas` | array | Aree di focus (es. positioning, visual, UX) |
|
||||
|
||||
---
|
||||
|
||||
## Processo
|
||||
|
||||
### Fase 1: Competitor Research
|
||||
|
||||
**Obiettivo:** Analizzare 3+ competitor sistematicamente.
|
||||
|
||||
**Azioni:**
|
||||
|
||||
1. Per ogni competitor, compila teardown usando template:
|
||||
|
||||
```markdown
|
||||
## Competitor: {Nome}
|
||||
|
||||
### Positioning
|
||||
- Audience:
|
||||
- Promise:
|
||||
- Differentiator:
|
||||
|
||||
### Messaging
|
||||
- Headline hero:
|
||||
- Supporting messages:
|
||||
- Tone of voice:
|
||||
|
||||
### Offer Structure
|
||||
- Entry offer:
|
||||
- Core offer:
|
||||
- Premium offer:
|
||||
|
||||
### Conversion Mechanics
|
||||
- CTA primarie:
|
||||
- Lead magnet:
|
||||
- Friction reducers:
|
||||
|
||||
### Trust Signals
|
||||
- Social proof:
|
||||
- Proof of work:
|
||||
- Authority:
|
||||
|
||||
### UX Structure
|
||||
- Navigation:
|
||||
- Page flow:
|
||||
- Notable patterns:
|
||||
|
||||
### Visual Language
|
||||
- Style:
|
||||
- Colori:
|
||||
- Typography:
|
||||
|
||||
### Copy (da prendere)
|
||||
- {Elementi efficaci}
|
||||
|
||||
### Avoid
|
||||
- {Errori o debolezze}
|
||||
|
||||
### Opportunity
|
||||
- {Opportunità per cliente}
|
||||
```
|
||||
|
||||
2. Logga fonti in `sources_log.md` con ID `SRC-###`
|
||||
|
||||
**Output:**
|
||||
- `clients/{client}/research/competitor_teardowns.md`
|
||||
|
||||
---
|
||||
|
||||
### Fase 2: Opportunity Map
|
||||
|
||||
**Obiettivo:** Sintetizzare insight in opportunità prioritarie.
|
||||
|
||||
**Azioni:**
|
||||
|
||||
1. Analizza teardown e identifica pattern
|
||||
2. Categorizza opportunità:
|
||||
- **Copy:** Cosa adottare
|
||||
- **Avoid:** Cosa evitare
|
||||
- **Opportunity:** Gap nel mercato
|
||||
3. Prioritizza P0/P1/P2
|
||||
|
||||
**Template:**
|
||||
|
||||
```markdown
|
||||
# Opportunity Map
|
||||
|
||||
## Copy (da prendere)
|
||||
- P0: {Insight ad alto impatto}
|
||||
- P1: {Insight utile}
|
||||
- P2: {Nice to have}
|
||||
|
||||
## Avoid
|
||||
- {Errori competitor da non ripetere}
|
||||
|
||||
## Opportunity
|
||||
- {Gap o opportunità non sfruttate}
|
||||
```
|
||||
|
||||
**Output:**
|
||||
- `clients/{client}/research/opportunity_map.md`
|
||||
|
||||
---
|
||||
|
||||
### Fase 3: Reference Research
|
||||
|
||||
**Obiettivo:** Raccogliere 10-15 referenze di qualità.
|
||||
|
||||
**Azioni:**
|
||||
|
||||
1. Cerca referenze outside-industry per:
|
||||
- Hero sections
|
||||
- Layout structures
|
||||
- Navigation patterns
|
||||
- Case study formats
|
||||
- Animation/motion
|
||||
|
||||
2. Per ogni reference, compila:
|
||||
|
||||
```markdown
|
||||
## Reference: {Nome/Sito}
|
||||
|
||||
**URL:** {link}
|
||||
|
||||
**Why it works:**
|
||||
{Spiegazione}
|
||||
|
||||
**What to borrow:**
|
||||
{Elementi applicabili}
|
||||
|
||||
**Possible risks:**
|
||||
{Avvertenze}
|
||||
```
|
||||
|
||||
3. Logga fonti con ID `SRC-###`
|
||||
|
||||
**Output:**
|
||||
- `clients/{client}/research/reference_library.md`
|
||||
|
||||
---
|
||||
|
||||
### Fase 4: Pattern Catalog
|
||||
|
||||
**Obiettivo:** Catalogare pattern riutilizzabili.
|
||||
|
||||
**Azioni:**
|
||||
|
||||
1. Estrai pattern dalle referenze
|
||||
2. Organizza per categoria:
|
||||
- Hero patterns
|
||||
- Layout patterns
|
||||
- Navigation patterns
|
||||
- Content patterns
|
||||
3. Per ogni pattern, includi:
|
||||
- Nome
|
||||
- Descrizione
|
||||
- Quando usarlo
|
||||
- Esempio (screenshot o link)
|
||||
|
||||
**Output:**
|
||||
- `clients/{client}/research/pattern_catalog.md`
|
||||
|
||||
---
|
||||
|
||||
### Fase 5: Sources Log
|
||||
|
||||
**Obiettivo:** Tracciare tutte le fonti usate.
|
||||
|
||||
**Azioni:**
|
||||
|
||||
1. Per ogni fonte esterna, registra:
|
||||
- ID `SRC-###`
|
||||
- Data accesso
|
||||
- Titolo
|
||||
- Autore/Publisher
|
||||
- URL
|
||||
- Affidabilità (1-5) + motivazione
|
||||
- Note/estratti
|
||||
|
||||
**Template:**
|
||||
```markdown
|
||||
## SRC-001
|
||||
|
||||
- **Data:** 2026-03-09
|
||||
- **Titolo:** {Titolo pagina}
|
||||
- **Autore:** {Autore}
|
||||
- **URL:** {link}
|
||||
- **Affidabilità:** 4/5 — {Motivo}
|
||||
- **Note:** {Estratti o osservazioni}
|
||||
```
|
||||
|
||||
**Output:**
|
||||
- `clients/{client}/research/sources_log.md`
|
||||
|
||||
---
|
||||
|
||||
## Output
|
||||
|
||||
| File | Formato | Descrizione |
|
||||
|------|---------|-------------|
|
||||
| `clients/{client}/research/competitor_teardowns.md` | Markdown | Teardown 3+ competitor |
|
||||
| `clients/{client}/research/opportunity_map.md` | Markdown | Insight prioritizzati |
|
||||
| `clients/{client}/research/reference_library.md` | Markdown | 10-15 referenze |
|
||||
| `clients/{client}/research/pattern_catalog.md` | Markdown | Pattern catalog |
|
||||
| `clients/{client}/research/sources_log.md` | Markdown | Log fonti |
|
||||
|
||||
---
|
||||
|
||||
## References
|
||||
|
||||
- [research_playbook.md](../../references/research_playbook.md) — Metodo research
|
||||
- [research_citation_rules.md](../../references/research_citation_rules.md) — Regole citazione
|
||||
- [competitor_teardown.md](../../templates/competitor_teardown.md) — Template teardown
|
||||
- [reference_entry.md](../../templates/reference_entry.md) — Template reference
|
||||
|
||||
---
|
||||
|
||||
## Note
|
||||
|
||||
**Edge Cases:**
|
||||
|
||||
- **Competitor sconosciuti:** Chiedi al cliente o cerca per keyword di settore
|
||||
- **Nessuna fonte disponibile:** Usa knowledge generale e segnala limitazione
|
||||
- **Web research necessaria:** Usa solo domini whitelist (vedi policy)
|
||||
|
||||
**Limitazioni:**
|
||||
|
||||
- Web research richiede whitelist e logging obbligatorio
|
||||
- Referenze visive possono richiedere screenshot (tool esterno)
|
||||
- Analisi approfondita richiede tempo (min 2-3h per 3 competitor)
|
||||
|
||||
---
|
||||
|
||||
_Skill generata da framework-translator_
|
||||
1
agency-research/references
Symbolic link
1
agency-research/references
Symbolic link
|
|
@ -0,0 +1 @@
|
|||
../references
|
||||
Loading…
Add table
Add a link
Reference in a new issue