agency-skills-suite/README.md

# 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
- **References:** 21
- **Lingua:** Italiano/English
- **Dominio:** Digital Agency / Content Production / Multi-Agent System

## Installazione

### Metodo 1: Script Automatico

```bash
cd /home/noe/.openclaw/workspace/agency-skills-suite
./INSTALL.sh
```

### Metodo 2: Copia Manuale

```bash
cp -r /home/noe/.openclaw/workspace/agency-skills-suite ~/.openclaw/skills/agency-skills
```

### Metodo 3: ClawHub (se pubblicato)

```bash
clawhub install agency-skills
```

## 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-publisher** | Publish gate-based (social/YouTube) | Bassa |
| 14 | **agency-archivist** ⭐ | Gestione risorse (immagini, video, documenti) | Media |

## References Incluse

### Agency Core (17)
1. `design_patterns.md` — Pattern UI riusabili
2. `hero_sections.md` — Layout hero efficaci
3. `layout_systems.md` — Grid, spacing, density
4. `navigation_patterns.md` — IA e navigazione
5. `conversion_patterns.md` — CTA e conversioni
6. `trust_signal_patterns.md` — Proof e credibilità
7. `case_study_structures.md` — Template case study
8. `copy_frameworks.md` — Framework copywriting
9. `content_formats.md` — Formati social/YouTube
10. `brand_voice.md` — Tone of voice
11. `audience_personas.md` — Template personas
12. `platform_patterns.md` — Pattern per piattaforma
13. `quality_bar.md` — Standard qualità V1
14. `publishing_gates.md` — Gate pre-publish
15. `research_citation_rules.md` — Regole citazione fonti
16. `strategy_playbook.md` — Framework positioning
17. `research_playbook.md` — Metodo research
18. `youtube_script_framework.md` — Struttura script
19. `qa_visual.md` — QA checklist visual
20. `weekly_report_template.md` — Template report

### Web Developer (3)
21. `html_semantics.md` — Semantic HTML best practices (in agency-web-developer/references)
22. `css_layout.md` — Layout Bootstrap/custom (in agency-web-developer/references)
23. `js_interactivity.md` — jQuery + GSAP patterns (in agency-web-developer/references)

### Archivist (1)
24. `resource_types.md` — Tipologie risorse e use case (in agency-archivist/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:** `agency-publisher` → publish (post-approvazione)
11. **Analytics:** `agency-analytics` → report settimanali

## Struttura

```
agency-skills-suite/
├── README.md
├── INSTALL.sh
├── AGENCY_ARCHIVIST_DELIVERY.md
├── agency-orchestrator/
│   ├── SKILL.md
│   └── references → ../references
├── agency-archivist/ ⭐
│   ├── SKILL.md
│   ├── README.md
│   ├── scripts/
│   │   ├── extract_archive.js    # Estrazione zip/URL
│   │   ├── scan_resources.js     # Scansione metadata
│   │   └── generate_catalog.js   # Generazione catalogo
│   └── references/
│       └── resource_types.md
├── agency-strategy/
│   ├── SKILL.md
│   └── references → ../references
├── ... (altre 11 skills)
└── references/
    ├── design_patterns.md
    ├── hero_sections.md
    └── ... (17 references)
```

## Uso

Ogni skill è auto-contenuta e usa references centralizzate tramite symlink.

**Esempio:**

```
/skill agency-orchestrator
```

La skill caricherà automaticamente le references necessarie dal percorso `../references`.

### Uso di agency-archivist

**Estrazione risorse:**

```bash
node scripts/extract_archive.js brand_assets.zip --client demo_co_srl
```

**Scansione e catalogo:**

```bash
node scripts/scan_resources.js --client demo_co_srl --pass 1
node scripts/generate_catalog.js --client demo_co_srl
```

**Risultato:** `clients/{client}/assets/catalog.md` con tutte le risorse catalogate.

## Publishing Gates

⚠️ **Importante:** Le skills `agency-publisher` e tutte le skills che producono content pubblicabile seguono gate rigorosi:

- Mai publish senza `APPROVED: YES` nel frontmatter
- Mai publish senza `PUBLISH_APPROVED.md` = YES
- QA obbligatorio prima di publish

Vedi `references/publishing_gates.md` per dettagli.

## Miglioramento Continuo

La suite supporta miglioramento continuo tramite:

- `agency-orchestrator` → propone improvements
- Workflow di auto-learning → staging → proposal → eval → approved → merge

Vedi documentazione interna per dettagli.

## Note

- **Lingua:** Skills in inglese, alcune references bilingue (IT/EN)
- **Dominio:** Agency digitali, content production, multi-agent coordination
- **Complexity:** MEDIUM-HIGH (13 skills, 20 references, workflow coordinati)

## Supporto

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

---

_Agency Skills Suite v1.0_