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: 15 (14 specialistiche + 1 shared references)
• References: 23 (tutte centralizzate in agency-shared-references)
• Lingua: Italiano/English
• Dominio: Digital Agency / Content Production / Multi-Agent System

Installazione

Istruzioni Generiche

La suite richiede una struttura directory specifica per funzionare correttamente. Segui questi passaggi:

1. Copia la suite nella directory delle skills:

   • Posiziona l'intera cartella agency-skills-suite nella directory delle skills del tuo sistema
   • Path tipico: ~/.openclaw/skills/agency-skills-suite/

2. Verifica la struttura:

   • Tutte le 15 cartelle delle skills devono essere presenti
   • La cartella agency-shared-references/ deve contenere tutti i file reference
   • Ogni skill deve avere un symlink references/ che punta a ../agency-shared-references/references

3. Verifica i symlink:

   • Ogni skill (tranne agency-shared-references) deve avere un symlink references → ../agency-shared-references/references
   • Su Unix/Linux/Mac: ls -la */references per verificare
   • Su Windows: usa dir */references o ricrea i symlink se necessario

4. Testa l'installazione:

   • Carica una skill (es. /skill agency-orchestrator)
   • Verifica che le references vengano caricate correttamente

Metodo 1: Script Automatico (Unix/Linux/Mac)

cd /path/to/agency-skills-suite
./INSTALL.sh

Metodo 2: Copia Manuale

# Copia l'intera suite
cp -r /path/to/agency-skills-suite ~/.openclaw/skills/

# Verifica i symlink (Unix/Linux/Mac)
cd ~/.openclaw/skills/agency-skills-suite
for skill in agency-*/; do
  if [ "$skill" != "agency-shared-references/" ]; then
    rm -rf "$skill/references"
    ln -s ../agency-shared-references/references "$skill/references"
  fi
done

Metodo 3: ClawHub (se pubblicato)

clawhub install agency-skills-suite

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
15	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. publishing_gates.md — Gate pre-publish (approval workflow, checklist)
19. weekly_report_template.md — Template report (KPI, highlights, actions)
20. 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

24. resource_types.md — Tipologie risorse e use case (immagini, video, documenti)

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-shared-references/     📚 References centralizzate
│   └── references/
│       ├── design_patterns.md
│       ├── hero_sections.md
│       ├── ... (23 references)
│       └── resource_types.md
├── agency-orchestrator/
│   ├── SKILL.md
│   └── references → ../agency-shared-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 → ../agency-shared-references/references
├── agency-strategy/
│   ├── SKILL.md
│   └── references → ../agency-shared-references/references
├── agency-research/
│   ├── SKILL.md
│   └── references → ../agency-shared-references/references
├── agency-creative-director/
│   ├── SKILL.md
│   └── references → ../agency-shared-references/references
├── agency-design-system/
│   ├── SKILL.md
│   └── references → ../agency-shared-references/references
├── agency-ux-copy/
│   ├── SKILL.md
│   └── references → ../agency-shared-references/references
├── agency-seo/
│   ├── SKILL.md
│   └── references → ../agency-shared-references/references
├── agency-social/
│   ├── SKILL.md
│   └── references → ../agency-shared-references/references
├── agency-youtube/
│   ├── SKILL.md
│   └── references → ../agency-shared-references/references
├── agency-visual-generator/
│   ├── SKILL.md
│   └── references → ../agency-shared-references/references
├── agency-web-developer/
│   ├── SKILL.md
│   └── references → ../agency-shared-references/references
├── agency-analytics/
│   ├── SKILL.md
│   └── references → ../agency-shared-references/references
├── agency-publisher/
│   ├── SKILL.md
│   └── references → ../agency-shared-references/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 ../agency-shared-references/references.

Uso di agency-archivist

Estrazione risorse:

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

Scansione e catalogo:

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 agency-shared-references/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 (15 skills, 23 references, workflow coordinati)
• Architecture: References centralizzate in agency-shared-references, accessibili tramite symlink da tutte le skills

Supporto

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

---

Agency Skills Suite v2.0 — References Centralizzate