a29db752af
- Sostituite 135 occorrenze di clients/{client}/ con {project}/
- Aggiornati parametri: client_path → project_path in 11 skills
- README.md aggiornato con nuova convenzione {project}/
- Struttura cartelle ora agnostica: compatibile con clients/, projects/, o qualsiasi cartella
- Maggiore flessibilità per diversi sistemi e workflow
Vantaggi:
✅ Compatibile con qualsiasi struttura cartelle
✅ Non impone convenzione 'clients/'
✅ Utile per progetti interni, campagne, o clienti
✅ Più generale e riutilizzabile
224 lines
9.7 KiB
Markdown
224 lines
9.7 KiB
Markdown
# 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_
|