# agency_v3_1-skills

Suite di AgentSkills per Agency AI OS v3.1 — trasformate da framework multi-agente a skills AgentSkills-compatibili.

## Panoramica

- **Skills:** 12
- **References:** 17
- **Lingua:** English (con note in italiano)
- **Dominio:** Digital Agency / Content Production / Multi-Agent System

## Installazione

### Metodo 1: Script Automatico

```bash
cd /home/noe/.openclaw/workspace/agency_v3_1/test/agency_v3_1_v1/agency_v3_1-skills-suite
./INSTALL.sh
```

### Metodo 2: Copia Manuale

```bash
cp -r /home/noe/.openclaw/workspace/agency_v3_1/test/agency_v3_1_v1/agency_v3_1-skills-suite ~/.openclaw/skills/agency_v3_1-skills
```

### Metodo 3: ClawHub (se pubblicato)

```bash
clawhub install agency_v3_1-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-analytics** | Report KPI settimanali, actions | Bassa |
| 12 | **agency-publisher** | Publish gate-based (social/YouTube) | Bassa |

## References Incluse

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

## Workflow Consigliato

1. **Onboarding:** `agency-orchestrator` → definisci MVP
2. **Research:** `agency-research` → competitor + reference
3. **Strategy:** `agency-strategy` → positioning, messaging
4. **Creative:** `agency-creative-director` → direzione visiva
5. **Design:** `agency-design-system` → design system
6. **Website:** `agency-ux-copy` + `agency-seo` → sitemap, copy, SEO
7. **Content:** `agency-social` + `agency-youtube` → calendar, script
8. **Visual:** `agency-visual-generator` → asset
9. **Publish:** `agency-publisher` → publish (post-approvazione)
10. **Analytics:** `agency-analytics` → report settimanali

## Struttura

```
agency_v3_1-skills/
├── README.md
├── INSTALL.sh
├── agency-orchestrator/
│   ├── SKILL.md
│   └── references → ../references
├── agency-strategy/
│   ├── SKILL.md
│   └── references → ../references
├── ... (altre 10 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`.

## 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.

## Auto-Learning

Questo framework supporta miglioramento continuo tramite:

- `agency-orchestrator` → propone improvements
- Workflow 90/92 (autolearn) → staging → proposal → eval → approved → merge

Vedi `core/learning/` e `core/policies/knowledge_promotion.md` nel framework originale.

## Note

- **Lingua:** Skills in inglese (framework originale), alcune references bilingue
- **Dominio:** Agency digitali, content production, multi-agente coordination
- **Complexity:** MEDIUM-HIGH (12 skills, 17 references, workflow coordinati)

## Supporto

Per issue o domande:
- Framework originale: vedi `agency_v3_1/README.md`
- Skill generation: vedi `framework-translator/SKILL.md`

---

_Generato da framework-translator il 2026-03-09_
_Framework source: agency_v3_1 v3.1_