# Agency Skills Suite

Suite completa di AgentSkills per agenzie digitali e content producer — un sistema multi-agente coordinato per deliverare progetti end-to-end.

## Panoramica

- **Skills:** 14 (13 specialistiche + 1 shared references)
- **References:** 22 (tutte centralizzate in agency-shared-references)
- **Lingua:** Italiano/English
- **Dominio:** Digital Agency / Content Production / Multi-Agent System

## Installazione

Posiziona l'intera cartella `agency-skills-suite` nella directory delle skills del tuo sistema (es. `~/.openclaw/skills/`). Nessun symlink o configurazione necessaria: le skills usano percorsi diretti verso `agency-shared-references/references/`.

**Opzioni:**
- **Chiedi all'agente:** Fornisci l'archivio completo e chiedi l'installazione nella cartella skills del tuo software agentico
- **Copia diretta:** Trasferisci manualmente la cartella `agency-skills-suite` nella directory delle skills

**Verifica:** Assicurati che tutte le 14 cartelle siano presenti e che `agency-shared-references/references/` contenga i 22 file reference.

## Skills Incluse

| # | Skill | Descrizione | Complessità |
|---|-------|-------------|-------------|
| 1 | **agency-orchestrator** | Coordinamento agenti, backlog, QA | Alta |
| 2 | **agency-strategy** | Positioning, messaging, content pillars | Media |
| 3 | **agency-research** | Competitive intelligence, reference library | Media |
| 4 | **agency-creative-director** | Direzione visiva, moodboard | Media |
| 5 | **agency-design-system** | Design tokens, components, layouts | Media |
| 6 | **agency-ux-copy** | Sitemap, page copy, conversion | Media |
| 7 | **agency-seo** | SEO tecnico, metadata, schema | Bassa |
| 8 | **agency-social** | Social strategy, calendario, post queue | Media |
| 9 | **agency-youtube** | YouTube strategy, script retention-first | Media |
| 10 | **agency-visual-generator** | Asset visuali (card, carousel, thumbnail) | Media |
| 11 | **agency-web-developer** | Siti web statici (HTML/CSS/JS) | Media |
| 12 | **agency-analytics** | Report KPI settimanali, actions | Bassa |
| 13 | **agency-archivist** | Gestione risorse (immagini, video, documenti) | Media |
| 14 | **agency-shared-references** | References condivise (tutte le skills) | — |

## References Incluse (in agency-shared-references)

Tutte le references sono centralizzate in un'unica cartella condivisa:

### Design & UX Patterns
1. `design_patterns.md` — Pattern UI riusabili (card grid, split layout, testimonial, FAQ)
2. `hero_sections.md` — Layout hero efficaci (formula, checklist, esempi)
3. `layout_systems.md` — Grid, spacing, density, vertical rhythm
4. `navigation_patterns.md` — IA e navigazione (primary nav, mobile nav, footer)
5. `conversion_patterns.md` — CTA e conversioni (hierarchy, forms, friction reducers)
6. `trust_signal_patterns.md` — Proof e credibilità (loghi, testimonial, numeri)
7. `qa_visual.md` — QA checklist visual (accessibilità, responsive, performance)

### Copy & Content
8. `copy_frameworks.md` — Framework copywriting (AIDA, PAS, FAB, 4U)
9. `content_formats.md` — Formati social/YouTube (post, carousel, video, blog)
10. `brand_voice.md` — Tone of voice (dimensioni, esempi, do/don't)
11. `audience_personas.md` — Template personas (demografici, psicografici, bisogni)
12. `case_study_structures.md` — Template case study (problema, soluzione, risultati)
13. `youtube_script_framework.md` — Struttura script (hook, retention, CTA)

### Strategy & Research
14. `strategy_playbook.md` — Framework positioning (positioning statement, pillars)
15. `research_playbook.md` — Metodo research (fonti, validazione, sintesi)
16. `research_citation_rules.md` — Regole citazione fonti (quando, come, formato)

### Quality & Publishing
17. `quality_bar.md` — Standard qualità V1 (criteri, checklist, scoring)
18. `weekly_report_template.md` — Template report (KPI, highlights, actions)
19. `platform_patterns.md` — Pattern per piattaforma (Instagram, LinkedIn, YouTube)

### Technical (Web Development)
21. `html_semantics.md` — Semantic HTML best practices (structure, accessibility, SEO)
22. `css_layout.md` — Layout, responsive, Bootstrap/custom (grid, breakpoints)
23. `js_interactivity.md` — jQuery + GSAP patterns (animations, interactions)

### Resources & Assets
22. `resource_types.md` — Tipologie risorse e use case (immagini, video, documenti)

**Totale:** 22 references

## Workflow Disponibili

La suite supporta 5 workflow principali, attivabili tramite `agency-orchestrator`:

| Workflow | Descrizione | Skills Coinvolte |
|----------|-------------|------------------|
| **Analisi** | Research competitivo e audit completo | agency-research, agency-analytics |
| **Posizionamento Strategico** | Positioning, messaging, content pillars | agency-strategy, agency-creative-director |
| **Sito Web Aziendale** | Sito completo da sitemap a publish | agency-ux-copy, agency-design-system, agency-web-developer, agency-seo |
| **Landing Page di Prodotto** | Landing page conversion-focused | agency-ux-copy, agency-design-system, agency-web-developer |
| **Strategia Social** | Piano editoriale e content calendar | agency-social, agency-youtube, agency-visual-generator |

## Workflow Consigliato (End-to-End)

1. **Onboarding:** `agency-orchestrator` → definisci MVP e workflow
2. **Upload Risorse:** `agency-archivist` → estrai e cataloga asset (opzionale, Fase 1)
3. **Analisi:** `agency-research` → competitor + reference
4. **Posizionamento:** `agency-strategy` → positioning, messaging
5. **Creative:** `agency-creative-director` → direzione visiva
6. **Design:** `agency-design-system` → design system (usa asset da archivist)
7. **Sito Web:** `agency-ux-copy` → sitemap, copy → `agency-web-developer` → sito HTML/CSS/JS (usa immagini da archivist) → `agency-seo` → metadata
8. **Content:** `agency-social` + `agency-youtube` → calendar, script
9. **Visual:** `agency-visual-generator` → asset (usa risorse da archivist)
10. **Publish:** Manuale o script custom (vedi sezione "Publishing Gates")
11. **Analytics:** `agency-analytics` → report settimanali

## Struttura

```
agency-skills-suite/
├── README.md
├── INSTALL.sh
├── AGENCY_ARCHIVIST_DELIVERY.md
├── agency-shared-references/     References centralizzate
│   └── references/
│       ├── design_patterns.md
│       ├── hero_sections.md
│       ├── ... (24 references)
│       └── resource_types.md
├── agency-orchestrator/
│   └── SKILL.md
├── agency-archivist/
│   ├── SKILL.md
│   ├── README.md
│   └── scripts/
│       ├── extract_archive.js
│       ├── scan_resources.js
│       └── generate_catalog.js
├── agency-strategy/
│   └── SKILL.md
├── agency-research/
│   └── SKILL.md
├── agency-creative-director/
│   └── SKILL.md
├── agency-design-system/
│   └── SKILL.md
├── agency-ux-copy/
│   └── SKILL.md
├── agency-seo/
│   └── SKILL.md
├── agency-social/
│   └── SKILL.md
├── agency-youtube/
│   └── SKILL.md
├── agency-visual-generator/
│   └── SKILL.md
├── agency-web-developer/
│   └── SKILL.md
├── agency-analytics/
│   └── SKILL.md
└── agency-archivist/
    └── SKILL.md
```

**Skills totali:** 14 (13 specialistiche + 1 shared references)
```

**Nota:** 
- Nessun symlink necessario. Ogni SKILL.md contiene percorsi diretti verso `../agency-shared-references/references/`.
- Struttura cartelle: le skills usano `{project}/` come path di lavoro (es. `demo_co_srl/`, `campagna_x/`, o qualsiasi cartella progetto).

## Uso

Invocare agency-orchestrator per iniziare un workflow

**Esempio:**

```
/skill agency-orchestrator
```

## Publishing Gates

**Importante:** Il publish è gestito manualmente (o con script custom). Ogni content pubblicabile deve superare gate di approvazione:

**Gate obbligatori:**
- ✅ `APPROVED: YES` nel frontmatter del content file
- ✅ `PUBLISH_APPROVED.md` = `YES` (approvazione esplicita del cliente)
- ✅ QA checklist compilata e passata

**Workflow manuale:**
1. Completa content (post, script, copy, etc.)
2. Compila QA checklist specifica
3. Ottieni approvazione (`APPROVED: YES` + `PUBLISH_APPROVED.md`)
4. Pubblica manualmente sulla piattaforma (LinkedIn, Instagram, YouTube, web)
5. Aggiorna `{project}/ops/publish_log.md` con data, URL e note

**Publish log template:**
```markdown
# Publish Log — {Client}

| Data | Platform | Content ID | Status | URL | Note |
|------|----------|------------|--------|-----|------|
| 2026-03-11 | LinkedIn | post_001 | Published | https://... | Good engagement |
```

**Nota:** La suite non include automazione di publish per evitare dipendenze da API/webhook esterne. Utenti tecnici possono aggiungere script custom se necessario.

## Note

- **Lingua:** Skills in inglese, references bilingue (IT/EN) per facilitare adozione
- **Dominio:** Digital agency, content production, multi-agent coordination
- **Complexity:** MEDIUM-HIGH (14 skills, 22 references, 5 workflow coordinati)
- **Architecture:** References centralizzate, percorsi diretti (`../agency-shared-references/references/`)
- **Project Structure:** `{project}/` come cartella di lavoro agnostica (compatibile con qualsiasi sistema)
- **Publish:** Manuale gate-based (nessuna automazione per evitare dipendenze esterne)

## Supporto

Per issue o domande sulla suite, consulta la documentazione interna o il repository principale.

---

_Agency Skills Suite v2.1 — No Publisher, Manual Publish Gate-Based_