Robots/agency-skills-suite
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
agency-skills-suite/README.md
AgentePotente b289d87033 Conversione references in skill condivisa agency-shared-references 
- Creata nuova skill agency-shared-references con 24 references centralizzate
- Spostate tutte le references da cartelle sparse (references/, agency-web-developer/, agency-archivist/) in un'unica posizione
- Aggiornati tutti i symlink delle 14 skills per puntare a ../agency-shared-references/references
- Aggiornati tutti i riferimenti nei SKILL.md (percorsi coerenti)
- README.md aggiornato con nuova struttura e istruzioni generiche
- INSTALL.sh semplificato con istruzioni platform-agnostic
- Eliminata cartella references/ dal root (ora centralizzata)
- Struttura più pulita e mantenibile, facile da installare su qualsiasi piattaforma
2026-03-11 00:11:03 +01:00

274 lines
11 KiB
Markdown
Raw Blame History

# 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)
```bash
cd /path/to/agency-skills-suite
./INSTALL.sh
```
### Metodo 2: Copia Manuale
```bash
# 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)
```bash
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:**
```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:** `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_
Reference in a new issue View git blame Copy permalink