# 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 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 15 cartelle siano presenti e che `agency-shared-references/references/` contenga i 24 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-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 (24 file) β”‚ └── references/ β”‚ β”œβ”€β”€ design_patterns.md β”‚ β”œβ”€β”€ hero_sections.md β”‚ β”œβ”€β”€ ... (24 references) β”‚ └── resource_types.md β”œβ”€β”€ agency-orchestrator/ β”‚ └── SKILL.md # Puntano direttamente a ../agency-shared-references/references/ β”œβ”€β”€ 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-publisher/ β”‚ └── SKILL.md └── agency-archivist/ └── SKILL.md ``` **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 Ogni skill Γ¨ auto-contenuta e punta direttamente ai file reference necessari. **Esempio:** ``` /skill agency-orchestrator ``` La skill caricherΓ  automaticamente le references necessarie dai percorsi specificati nel SKILL.md (`../agency-shared-references/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:** `{project}/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, percorsi diretti da tutte le skills - **Project Structure:** `{project}/` come cartella di lavoro (agnostico, compatibile con qualsiasi sistema) ## Supporto Per issue o domande sulla suite, consulta la documentazione interna o il repository principale. --- _Agency Skills Suite v2.0 β€” References Centralizzate_