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

README.md

@@ -4,30 +4,62 @@ Suite completa di AgentSkills per agenzie digitali e content producer — un sis
 
 ## Panoramica
 
-- **Skills:** 14
-- **References:** 21
+- **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
 
-### Metodo 1: Script Automatico
+### 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 /home/noe/.openclaw/workspace/agency-skills-suite
+cd /path/to/agency-skills-suite
 ./INSTALL.sh
 ```
 
 ### Metodo 2: Copia Manuale
 
 ```bash
-cp -r /home/noe/.openclaw/workspace/agency-skills-suite ~/.openclaw/skills/agency-skills
+# 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
+clawhub install agency-skills-suite
 ```
 
 ## Skills Incluse
@@ -48,38 +80,47 @@ clawhub install agency-skills
 | 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
+## References Incluse (in agency-shared-references)
 
-### Agency Core (17)
-1. `design_patterns.md` — Pattern UI riusabili
-2. `hero_sections.md` — Layout hero efficaci
-3. `layout_systems.md` — Grid, spacing, density
-4. `navigation_patterns.md` — IA e navigazione
-5. `conversion_patterns.md` — CTA e conversioni
-6. `trust_signal_patterns.md` — Proof e credibilità
-7. `case_study_structures.md` — Template case study
-8. `copy_frameworks.md` — Framework copywriting
-9. `content_formats.md` — Formati social/YouTube
-10. `brand_voice.md` — Tone of voice
-11. `audience_personas.md` — Template personas
-12. `platform_patterns.md` — Pattern per piattaforma
-13. `quality_bar.md` — Standard qualità V1
-14. `publishing_gates.md` — Gate pre-publish
-15. `research_citation_rules.md` — Regole citazione fonti
-16. `strategy_playbook.md` — Framework positioning
-17. `research_playbook.md` — Metodo research
-18. `youtube_script_framework.md` — Struttura script
-19. `qa_visual.md` — QA checklist visual
-20. `weekly_report_template.md` — Template report
+Tutte le references sono centralizzate in un'unica cartella condivisa:
 
-### Web Developer (3)
-21. `html_semantics.md` — Semantic HTML best practices (in agency-web-developer/references)
-22. `css_layout.md` — Layout Bootstrap/custom (in agency-web-developer/references)
-23. `js_interactivity.md` — jQuery + GSAP patterns (in agency-web-developer/references)
+### 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)
 
-### Archivist (1)
-24. `resource_types.md` — Tipologie risorse e use case (in agency-archivist/references)
+### 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
 
@@ -114,9 +155,15 @@ 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 → ../references
+│   └── references → ../agency-shared-references/references
 ├── agency-archivist/ ⭐
 │   ├── SKILL.md
 │   ├── README.md
@@ -124,16 +171,43 @@ agency-skills-suite/
 │   │   ├── extract_archive.js    # Estrazione zip/URL
 │   │   ├── scan_resources.js     # Scansione metadata
 │   │   └── generate_catalog.js   # Generazione catalogo
-│   └── references/
-│       └── resource_types.md
+│   └── references → ../agency-shared-references/references
 ├── agency-strategy/
 │   ├── SKILL.md
-│   └── references → ../references
-├── ... (altre 11 skills)
-└── references/
-    ├── design_patterns.md
-    ├── hero_sections.md
-    └── ... (17 references)
+│   └── 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
@@ -146,7 +220,7 @@ Ogni skill è auto-contenuta e usa references centralizzate tramite symlink.
 /skill agency-orchestrator
 ```
 
-La skill caricherà automaticamente le references necessarie dal percorso `../references`.
+La skill caricherà automaticamente le references necessarie dal percorso `../agency-shared-references/references`.
 
 ### Uso di agency-archivist
 
@@ -173,7 +247,7 @@ node scripts/generate_catalog.js --client demo_co_srl
 - Mai publish senza `PUBLISH_APPROVED.md` = YES
 - QA obbligatorio prima di publish
 
-Vedi `references/publishing_gates.md` per dettagli.
+Vedi `agency-shared-references/references/publishing_gates.md` per dettagli.
 
 ## Miglioramento Continuo
 
@@ -188,7 +262,8 @@ Vedi documentazione interna per dettagli.
 
 - **Lingua:** Skills in inglese, alcune references bilingue (IT/EN)
 - **Dominio:** Agency digitali, content production, multi-agent coordination
-- **Complexity:** MEDIUM-HIGH (13 skills, 20 references, workflow coordinati)
+- **Complexity:** MEDIUM-HIGH (15 skills, 23 references, workflow coordinati)
+- **Architecture:** References centralizzate in agency-shared-references, accessibili tramite symlink da tutte le skills
 
 ## Supporto
 
@@ -196,4 +271,4 @@ Per issue o domande sulla suite, consulta la documentazione interna o il reposit
 
 ---
 
-_Agency Skills Suite v1.0_
+_Agency Skills Suite v2.0 — References Centralizzate_