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
• ✅ QA checklist compilata e passata

Workflow manuale:

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

Publish log template:

# 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: Italiano
• Dominio: Digital agency, content production, multi-agent coordination
• Complexity: MEDIUM-HIGH
• 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