diff --git a/INSTALL.sh b/INSTALL.sh index 6843cff..3fd59d0 100755 --- a/INSTALL.sh +++ b/INSTALL.sh @@ -1,12 +1,13 @@ #!/bin/bash -# Installazione agency_v3_1-skills +# Installazione Agency Skills Suite +# Script generico per Unix/Linux/Mac set -e SOURCE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" -TARGET="$HOME/.openclaw/skills/agency_v3_1-skills" +TARGET="$HOME/.openclaw/skills/agency-skills-suite" -echo "πŸš€ Installing agency_v3_1-skills..." +echo "πŸš€ Installing Agency Skills Suite..." echo "" # Rimuovi installazione precedente se esiste @@ -22,16 +23,24 @@ mkdir -p "$(dirname "$TARGET")" echo "πŸ“¦ Copia skills in $TARGET..." cp -r "$SOURCE" "$TARGET" -# Verifica symlink -echo "πŸ”— Verifica symlink..." -for skill_dir in "$TARGET"/*/; do - if [ -d "$skill_dir" ] && [ "$skill_dir" != "$TARGET/references/" ]; then - if [ ! -L "$skill_dir/references" ]; then - echo " Fix symlink: $skill_dir" - rm -rf "$skill_dir/references" - ln -s ../references "$skill_dir/references" - fi +# Verifica/Crea symlink per tutte le skills +echo "πŸ”— Configurazione symlink references..." +cd "$TARGET" +for skill_dir in agency-*/; do + # Salta la cartella shared-references + if [ "$skill_dir" = "agency-shared-references/" ]; then + echo " βœ“ $skill_dir (shared references, no symlink needed)" + continue fi + + # Rimuovi references esistenti (file o symlink) + if [ -e "$skill_dir/references" ]; then + rm -rf "$skill_dir/references" + fi + + # Crea symlink verso agency-shared-references/references + ln -s ../agency-shared-references/references "$skill_dir/references" + echo " βœ“ $skill_dir β†’ ../agency-shared-references/references" done echo "" @@ -42,4 +51,8 @@ echo "" echo "Skills disponibili:" ls -1 "$TARGET" | grep -v references | sed 's/^/ - /' echo "" -echo "Per usare una skill, riferisciti a lei come 'agency_v3_1-skills/'" +echo "Per usare una skill, riferisciti a lei come 'agency-skills-suite/'" +echo "" +echo "Verifica symlink:" +echo " cd $TARGET" +echo " ls -la */references" diff --git a/README.md b/README.md index 8051b7c..a55f5e4 100644 --- a/README.md +++ b/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_ diff --git a/agency-analytics/SKILL.md b/agency-analytics/SKILL.md index d3c8093..e63d366 100644 --- a/agency-analytics/SKILL.md +++ b/agency-analytics/SKILL.md @@ -198,8 +198,8 @@ Report KPI settimanali e azioni misurabili per social e YouTube. ## References -- [weekly_report_template.md](../../references/weekly_report_template.md) β€” Template report -- [quality_bar.md](../../references/quality_bar.md) β€” Standard V1 +- [weekly_report_template.md](../agency-shared-references/references/weekly_report_template.md) β€” Template report +- [quality_bar.md](../agency-shared-references/references/quality_bar.md) β€” Standard V1 --- diff --git a/agency-analytics/references b/agency-analytics/references index 3dc6b5c..56c0254 120000 --- a/agency-analytics/references +++ b/agency-analytics/references @@ -1 +1 @@ -../references \ No newline at end of file +../agency-shared-references/references \ No newline at end of file diff --git a/agency-archivist/SKILL.md b/agency-archivist/SKILL.md index faa580b..3aaf5ff 100644 --- a/agency-archivist/SKILL.md +++ b/agency-archivist/SKILL.md @@ -311,8 +311,7 @@ node scripts/generate_catalog.js --client ## References -- [resource_types.md](./references/resource_types.md) β€” Tipologie risorse e use case -- [metadata_schema.md](./references/metadata_schema.md) β€” Schema metadata per catalogazione +- [resource_types.md](../agency-shared-references/references/resource_types.md) β€” Tipologie risorse e use case --- diff --git a/agency-archivist/references b/agency-archivist/references new file mode 120000 index 0000000..56c0254 --- /dev/null +++ b/agency-archivist/references @@ -0,0 +1 @@ +../agency-shared-references/references \ No newline at end of file diff --git a/agency-creative-director/SKILL.md b/agency-creative-director/SKILL.md index cdd68f8..20eb1d3 100644 --- a/agency-creative-director/SKILL.md +++ b/agency-creative-director/SKILL.md @@ -202,10 +202,10 @@ Ogni claim supportato da evidence visibile. ## References -- [design_patterns.md](../../references/design_patterns.md) β€” Pattern UI -- [hero_sections.md](../../references/hero_sections.md) β€” Hero patterns -- [layout_systems.md](../../references/layout_systems.md) β€” Grid e spacing -- [brand_voice.md](../../references/brand_voice.md) β€” Tone of voice +- [design_patterns.md](../agency-shared-references/references/design_patterns.md) β€” Pattern UI +- [hero_sections.md](../agency-shared-references/references/hero_sections.md) β€” Hero patterns +- [layout_systems.md](../agency-shared-references/references/layout_systems.md) β€” Grid e spacing +- [brand_voice.md](../agency-shared-references/references/brand_voice.md) β€” Tone of voice --- diff --git a/agency-creative-director/references b/agency-creative-director/references index 3dc6b5c..56c0254 120000 --- a/agency-creative-director/references +++ b/agency-creative-director/references @@ -1 +1 @@ -../references \ No newline at end of file +../agency-shared-references/references \ No newline at end of file diff --git a/agency-design-system/SKILL.md b/agency-design-system/SKILL.md index d269625..489649e 100644 --- a/agency-design-system/SKILL.md +++ b/agency-design-system/SKILL.md @@ -244,19 +244,19 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile. ## References ### UX/Design Patterns (Shared) -- [layout_systems.md](../../references/layout_systems.md) β€” Grid e spacing -- [navigation_patterns.md](../../references/navigation_patterns.md) β€” IA patterns -- [design_patterns.md](../../references/design_patterns.md) β€” UI patterns -- [qa_visual.md](../../references/qa_visual.md) β€” QA checklist +- [layout_systems.md](../agency-shared-references/references/layout_systems.md) β€” Grid e spacing +- [navigation_patterns.md](../agency-shared-references/references/navigation_patterns.md) β€” IA patterns +- [design_patterns.md](../agency-shared-references/references/design_patterns.md) β€” UI patterns +- [qa_visual.md](../agency-shared-references/references/qa_visual.md) β€” QA checklist ### Resources & Assets -- [resource_types.md](../agency-archivist/references/resource_types.md) β€” Tipologie risorse e use case +- [resource_types.md](../agency-shared-references/references/resource_types.md) β€” Tipologie risorse e use case ### Technical Implementation (Handoff) **Per handoff a developer o implementazione diretta:** -- [html_semantics.md](../agency-web-developer/references/html_semantics.md) β€” Semantic HTML structure -- [css_layout.md](../agency-web-developer/references/css_layout.md) β€” Bootstrap/custom CSS implementation -- [js_interactivity.md](../agency-web-developer/references/js_interactivity.md) β€” jQuery + GSAP patterns +- [html_semantics.md](../agency-shared-references/references/html_semantics.md) β€” Semantic HTML structure +- [css_layout.md](../agency-shared-references/references/css_layout.md) β€” Bootstrap/custom CSS implementation +- [js_interactivity.md](../agency-shared-references/references/js_interactivity.md) β€” jQuery + GSAP patterns **Nota:** Questa skill produce design system documentato. Per implementazione codice, consultare agency-web-developer. diff --git a/agency-design-system/references b/agency-design-system/references index 3dc6b5c..56c0254 120000 --- a/agency-design-system/references +++ b/agency-design-system/references @@ -1 +1 @@ -../references \ No newline at end of file +../agency-shared-references/references \ No newline at end of file diff --git a/agency-orchestrator/SKILL.md b/agency-orchestrator/SKILL.md index b7c204b..6f3c731 100644 --- a/agency-orchestrator/SKILL.md +++ b/agency-orchestrator/SKILL.md @@ -373,10 +373,10 @@ clients/{client}/assets/ ## References -- [quality_bar.md](../../references/quality_bar.md) β€” Standard V1 -- [publishing_gates.md](../../references/publishing_gates.md) β€” Gate pre-publish -- [research_citation_rules.md](../../references/research_citation_rules.md) β€” Citazione fonti -- [resource_types.md](../agency-archivist/references/resource_types.md) β€” Tipologie risorse e use case +- [quality_bar.md](../agency-shared-references/references/quality_bar.md) β€” Standard V1 +- [publishing_gates.md](../agency-shared-references/references/publishing_gates.md) β€” Gate pre-publish +- [research_citation_rules.md](../agency-shared-references/references/research_citation_rules.md) β€” Citazione fonti +- [resource_types.md](../agency-shared-references/references/resource_types.md) β€” Tipologie risorse e use case --- diff --git a/agency-orchestrator/references b/agency-orchestrator/references index 3dc6b5c..56c0254 120000 --- a/agency-orchestrator/references +++ b/agency-orchestrator/references @@ -1 +1 @@ -../references \ No newline at end of file +../agency-shared-references/references \ No newline at end of file diff --git a/agency-publisher/SKILL.md b/agency-publisher/SKILL.md index dcfdd8f..b38fd69 100644 --- a/agency-publisher/SKILL.md +++ b/agency-publisher/SKILL.md @@ -194,9 +194,8 @@ Pubblica (o programma) content su social e YouTube solo dopo approvazione esplic ## References -- [publishing_gates.md](../../references/publishing_gates.md) β€” Gate rules -- [quality_bar.md](../../references/quality_bar.md) β€” Standard qualitΓ  -- [publish_webhook.md](../../skills/publish_webhook.md) β€” Webhook config +- [publishing_gates.md](../agency-shared-references/references/publishing_gates.md) β€” Gate rules +- [quality_bar.md](../agency-shared-references/references/quality_bar.md) β€” Standard qualitΓ  --- diff --git a/agency-publisher/references b/agency-publisher/references index 3dc6b5c..56c0254 120000 --- a/agency-publisher/references +++ b/agency-publisher/references @@ -1 +1 @@ -../references \ No newline at end of file +../agency-shared-references/references \ No newline at end of file diff --git a/agency-research/SKILL.md b/agency-research/SKILL.md index c0391f1..736df64 100644 --- a/agency-research/SKILL.md +++ b/agency-research/SKILL.md @@ -233,10 +233,8 @@ Analisi sistematica competitor e raccolta referenze con insight applicabili. ## References -- [research_playbook.md](../../references/research_playbook.md) β€” Metodo research -- [research_citation_rules.md](../../references/research_citation_rules.md) β€” Regole citazione -- [competitor_teardown.md](../../templates/competitor_teardown.md) β€” Template teardown -- [reference_entry.md](../../templates/reference_entry.md) β€” Template reference +- [research_playbook.md](../agency-shared-references/references/research_playbook.md) β€” Metodo research +- [research_citation_rules.md](../agency-shared-references/references/research_citation_rules.md) β€” Regole citazione --- diff --git a/agency-research/references b/agency-research/references index 3dc6b5c..56c0254 120000 --- a/agency-research/references +++ b/agency-research/references @@ -1 +1 @@ -../references \ No newline at end of file +../agency-shared-references/references \ No newline at end of file diff --git a/agency-seo/SKILL.md b/agency-seo/SKILL.md index a3fb8e2..9a9c2e0 100644 --- a/agency-seo/SKILL.md +++ b/agency-seo/SKILL.md @@ -220,9 +220,9 @@ SEO tecnico, metadata e schema markup per visibilitΓ  search. ## References -- [seo_fundamentals.md](../../references/seo_fundamentals.md) β€” Fondamentali SEO -- [metadata_rules.md](../../references/metadata_rules.md) β€” Regole meta tag -- [navigation_patterns.md](../../references/navigation_patterns.md) β€” IA patterns +- [seo_fundamentals.md](../agency-shared-references/references/seo_fundamentals.md) β€” Fondamentali SEO +- [metadata_rules.md](../agency-shared-references/references/metadata_rules.md) β€” Regole meta tag +- [navigation_patterns.md](../agency-shared-references/references/navigation_patterns.md) β€” IA patterns --- diff --git a/agency-seo/references b/agency-seo/references index 3dc6b5c..56c0254 120000 --- a/agency-seo/references +++ b/agency-seo/references @@ -1 +1 @@ -../references \ No newline at end of file +../agency-shared-references/references \ No newline at end of file diff --git a/agency-shared-references/SKILL.md b/agency-shared-references/SKILL.md new file mode 100644 index 0000000..1917cd2 --- /dev/null +++ b/agency-shared-references/SKILL.md @@ -0,0 +1,67 @@ +--- +name: agency-shared-references +description: "References condivise per la suite agency-skills. Contiene pattern, framework, template e linee guida trasversali usate da multiple skills: design patterns, copy frameworks, research playbook, quality bar, publishing gates, resource types, e altri. Usare quando: (1) serve consultare pattern UX/UI, (2) applicare framework copywriting, (3) seguire standard qualitΓ , (4) citare fonti correttamente, (5) gestire risorse catalogate." +--- + +# Agency Shared References + +References condivise per tutte le skills della suite agency-skills. + +## Quando Usare + +Questa skill viene caricata automaticamente quando le altre skills della suite necessitano di: + +- **Pattern UX/UI:** design_patterns, hero_sections, layout_systems, navigation_patterns, conversion_patterns, trust_signal_patterns +- **Framework Copy:** copy_frameworks, brand_voice, content_formats, case_study_structures +- **Research:** research_playbook, research_citation_rules, strategy_playbook +- **Quality & Publishing:** quality_bar, publishing_gates, qa_visual, weekly_report_template +- **Risorse:** resource_types (tipologie asset e use case) +- **YouTube:** youtube_script_framework +- **Personas:** audience_personas +- **Platform:** platform_patterns + +## Struttura + +``` +agency-shared-references/ +└── references/ + β”œβ”€β”€ design_patterns.md + β”œβ”€β”€ hero_sections.md + β”œβ”€β”€ layout_systems.md + β”œβ”€β”€ navigation_patterns.md + β”œβ”€β”€ conversion_patterns.md + β”œβ”€β”€ trust_signal_patterns.md + β”œβ”€β”€ case_study_structures.md + β”œβ”€β”€ copy_frameworks.md + β”œβ”€β”€ content_formats.md + β”œβ”€β”€ brand_voice.md + β”œβ”€β”€ audience_personas.md + β”œβ”€β”€ platform_patterns.md + β”œβ”€β”€ quality_bar.md + β”œβ”€β”€ publishing_gates.md + β”œβ”€β”€ research_citation_rules.md + β”œβ”€β”€ research_playbook.md + β”œβ”€β”€ strategy_playbook.md + β”œβ”€β”€ youtube_script_framework.md + β”œβ”€β”€ qa_visual.md + β”œβ”€β”€ weekly_report_template.md + └── resource_types.md +``` + +## Uso dalle Skills + +Ogni skill della suite punta a queste references tramite symlink: + +```bash +ln -s ../agency-shared-references/references ./references +``` + +## Note + +- **Non modificare** queste references senza approvazione dell'orchestrator +- **Mantenere coerenti** i riferimenti incrociati tra documenti +- **Aggiornare** quando si scoprono pattern migliori o si standardizzano nuovi workflow + +--- + +_Agency Shared References v1.0_ diff --git a/references/audience_personas.md b/agency-shared-references/references/audience_personas.md similarity index 100% rename from references/audience_personas.md rename to agency-shared-references/references/audience_personas.md diff --git a/references/brand_voice.md b/agency-shared-references/references/brand_voice.md similarity index 100% rename from references/brand_voice.md rename to agency-shared-references/references/brand_voice.md diff --git a/references/case_study_structures.md b/agency-shared-references/references/case_study_structures.md similarity index 100% rename from references/case_study_structures.md rename to agency-shared-references/references/case_study_structures.md diff --git a/references/content_formats.md b/agency-shared-references/references/content_formats.md similarity index 100% rename from references/content_formats.md rename to agency-shared-references/references/content_formats.md diff --git a/references/conversion_patterns.md b/agency-shared-references/references/conversion_patterns.md similarity index 100% rename from references/conversion_patterns.md rename to agency-shared-references/references/conversion_patterns.md diff --git a/references/copy_frameworks.md b/agency-shared-references/references/copy_frameworks.md similarity index 100% rename from references/copy_frameworks.md rename to agency-shared-references/references/copy_frameworks.md diff --git a/agency-web-developer/references/css_layout.md b/agency-shared-references/references/css_layout.md similarity index 100% rename from agency-web-developer/references/css_layout.md rename to agency-shared-references/references/css_layout.md diff --git a/references/design_patterns.md b/agency-shared-references/references/design_patterns.md similarity index 100% rename from references/design_patterns.md rename to agency-shared-references/references/design_patterns.md diff --git a/references/hero_sections.md b/agency-shared-references/references/hero_sections.md similarity index 100% rename from references/hero_sections.md rename to agency-shared-references/references/hero_sections.md diff --git a/agency-web-developer/references/html_semantics.md b/agency-shared-references/references/html_semantics.md similarity index 100% rename from agency-web-developer/references/html_semantics.md rename to agency-shared-references/references/html_semantics.md diff --git a/agency-web-developer/references/js_interactivity.md b/agency-shared-references/references/js_interactivity.md similarity index 100% rename from agency-web-developer/references/js_interactivity.md rename to agency-shared-references/references/js_interactivity.md diff --git a/references/layout_systems.md b/agency-shared-references/references/layout_systems.md similarity index 100% rename from references/layout_systems.md rename to agency-shared-references/references/layout_systems.md diff --git a/references/navigation_patterns.md b/agency-shared-references/references/navigation_patterns.md similarity index 100% rename from references/navigation_patterns.md rename to agency-shared-references/references/navigation_patterns.md diff --git a/references/platform_patterns.md b/agency-shared-references/references/platform_patterns.md similarity index 100% rename from references/platform_patterns.md rename to agency-shared-references/references/platform_patterns.md diff --git a/references/publishing_gates.md b/agency-shared-references/references/publishing_gates.md similarity index 100% rename from references/publishing_gates.md rename to agency-shared-references/references/publishing_gates.md diff --git a/references/qa_visual.md b/agency-shared-references/references/qa_visual.md similarity index 100% rename from references/qa_visual.md rename to agency-shared-references/references/qa_visual.md diff --git a/references/quality_bar.md b/agency-shared-references/references/quality_bar.md similarity index 100% rename from references/quality_bar.md rename to agency-shared-references/references/quality_bar.md diff --git a/references/research_citation_rules.md b/agency-shared-references/references/research_citation_rules.md similarity index 100% rename from references/research_citation_rules.md rename to agency-shared-references/references/research_citation_rules.md diff --git a/references/research_playbook.md b/agency-shared-references/references/research_playbook.md similarity index 100% rename from references/research_playbook.md rename to agency-shared-references/references/research_playbook.md diff --git a/agency-archivist/references/resource_types.md b/agency-shared-references/references/resource_types.md similarity index 100% rename from agency-archivist/references/resource_types.md rename to agency-shared-references/references/resource_types.md diff --git a/references/strategy_playbook.md b/agency-shared-references/references/strategy_playbook.md similarity index 100% rename from references/strategy_playbook.md rename to agency-shared-references/references/strategy_playbook.md diff --git a/references/trust_signal_patterns.md b/agency-shared-references/references/trust_signal_patterns.md similarity index 100% rename from references/trust_signal_patterns.md rename to agency-shared-references/references/trust_signal_patterns.md diff --git a/references/weekly_report_template.md b/agency-shared-references/references/weekly_report_template.md similarity index 100% rename from references/weekly_report_template.md rename to agency-shared-references/references/weekly_report_template.md diff --git a/references/youtube_script_framework.md b/agency-shared-references/references/youtube_script_framework.md similarity index 100% rename from references/youtube_script_framework.md rename to agency-shared-references/references/youtube_script_framework.md diff --git a/agency-social/SKILL.md b/agency-social/SKILL.md index c1782b7..d0f9e0b 100644 --- a/agency-social/SKILL.md +++ b/agency-social/SKILL.md @@ -192,10 +192,9 @@ Social strategy, calendario editoriale e post queue con visual brief. ## References -- [content_formats.md](../../references/content_formats.md) β€” Formati social -- [platform_patterns.md](../../references/platform_patterns.md) β€” Pattern per piattaforma -- [brand_voice.md](../../references/brand_voice.md) β€” Tone of voice -- [social_post_spec.md](../../templates/social_post_spec.md) β€” Template post +- [content_formats.md](../agency-shared-references/references/content_formats.md) β€” Formati social +- [platform_patterns.md](../agency-shared-references/references/platform_patterns.md) β€” Pattern per piattaforma +- [brand_voice.md](../agency-shared-references/references/brand_voice.md) β€” Tone of voice --- diff --git a/agency-social/references b/agency-social/references index 3dc6b5c..56c0254 120000 --- a/agency-social/references +++ b/agency-social/references @@ -1 +1 @@ -../references \ No newline at end of file +../agency-shared-references/references \ No newline at end of file diff --git a/agency-strategy/SKILL.md b/agency-strategy/SKILL.md index c832959..06baf23 100644 --- a/agency-strategy/SKILL.md +++ b/agency-strategy/SKILL.md @@ -179,11 +179,11 @@ perchΓ© **specializzati in clarity-first e conversioni**. ## References -- [strategy_playbook.md](../../references/strategy_playbook.md) β€” Framework positioning -- [copy_frameworks.md](../../references/copy_frameworks.md) β€” Framework copy -- [content_formats.md](../../references/content_formats.md) β€” Formati content -- [audience_personas.md](../../references/audience_personas.md) β€” Template personas -- [brand_voice.md](../../references/brand_voice.md) β€” Tone of voice +- [strategy_playbook.md](../agency-shared-references/references/strategy_playbook.md) β€” Framework positioning +- [copy_frameworks.md](../agency-shared-references/references/copy_frameworks.md) β€” Framework copy +- [content_formats.md](../agency-shared-references/references/content_formats.md) β€” Formati content +- [audience_personas.md](../agency-shared-references/references/audience_personas.md) β€” Template personas +- [brand_voice.md](../agency-shared-references/references/brand_voice.md) β€” Tone of voice --- diff --git a/agency-strategy/references b/agency-strategy/references index 3dc6b5c..56c0254 120000 --- a/agency-strategy/references +++ b/agency-strategy/references @@ -1 +1 @@ -../references \ No newline at end of file +../agency-shared-references/references \ No newline at end of file diff --git a/agency-ux-copy/SKILL.md b/agency-ux-copy/SKILL.md index 2094197..8bcc4fb 100644 --- a/agency-ux-copy/SKILL.md +++ b/agency-ux-copy/SKILL.md @@ -227,18 +227,18 @@ Progetta la struttura del sito e scrive copy chiaro e conversion-oriented. ## References ### UX/Design Patterns (Shared) -- [copy_frameworks.md](../../references/copy_frameworks.md) β€” Framework copy -- [conversion_patterns.md](../../references/conversion_patterns.md) β€” CTA e conversioni -- [hero_sections.md](../../references/hero_sections.md) β€” Hero patterns -- [navigation_patterns.md](../../references/navigation_patterns.md) β€” IA patterns -- [brand_voice.md](../../references/brand_voice.md) β€” Tone of voice -- [design_patterns.md](../../references/design_patterns.md) β€” UI patterns (card grid, split layout, testimonial, FAQ) +- [copy_frameworks.md](../agency-shared-references/references/copy_frameworks.md) β€” Framework copy +- [conversion_patterns.md](../agency-shared-references/references/conversion_patterns.md) β€” CTA e conversioni +- [hero_sections.md](../agency-shared-references/references/hero_sections.md) β€” Hero patterns +- [navigation_patterns.md](../agency-shared-references/references/navigation_patterns.md) β€” IA patterns +- [brand_voice.md](../agency-shared-references/references/brand_voice.md) β€” Tone of voice +- [design_patterns.md](../agency-shared-references/references/design_patterns.md) β€” UI patterns (card grid, split layout, testimonial, FAQ) ### Handoff a Developer **Dopo aver completato copy, passare a:** - **agency-web-developer** β€” Implementa HTML/CSS/JS dal copy -- [html_semantics.md](../agency-web-developer/references/html_semantics.md) β€” Come il copy diventa struttura HTML -- [css_layout.md](../agency-web-developer/references/css_layout.md) β€” Come i layout diventano CSS +- [html_semantics.md](../agency-shared-references/references/html_semantics.md) β€” Come il copy diventa struttura HTML +- [css_layout.md](../agency-shared-references/references/css_layout.md) β€” Come i layout diventano CSS **Nota:** Questa skill produce sitemap + copy. Per implementazione codice, usare agency-web-developer. diff --git a/agency-ux-copy/references b/agency-ux-copy/references index 3dc6b5c..56c0254 120000 --- a/agency-ux-copy/references +++ b/agency-ux-copy/references @@ -1 +1 @@ -../references \ No newline at end of file +../agency-shared-references/references \ No newline at end of file diff --git a/agency-visual-generator/SKILL.md b/agency-visual-generator/SKILL.md index 2fd3ea3..f3434cb 100644 --- a/agency-visual-generator/SKILL.md +++ b/agency-visual-generator/SKILL.md @@ -239,10 +239,10 @@ Genera asset visuali platform-ready basati su content approvato e style guide. ## References -- [qa_visual.md](../../references/qa_visual.md) β€” QA checklist -- [platform_patterns.md](../../references/platform_patterns.md) β€” Pattern per piattaforma -- [publishing_gates.md](../../references/publishing_gates.md) β€” Gate pre-publish -- [resource_types.md](../agency-archivist/references/resource_types.md) β€” Tipologie risorse e use case +- [qa_visual.md](../agency-shared-references/references/qa_visual.md) β€” QA checklist +- [platform_patterns.md](../agency-shared-references/references/platform_patterns.md) β€” Pattern per piattaforma +- [publishing_gates.md](../agency-shared-references/references/publishing_gates.md) β€” Gate pre-publish +- [resource_types.md](../agency-shared-references/references/resource_types.md) β€” Tipologie risorse e use case --- diff --git a/agency-visual-generator/references b/agency-visual-generator/references index 3dc6b5c..56c0254 120000 --- a/agency-visual-generator/references +++ b/agency-visual-generator/references @@ -1 +1 @@ -../references \ No newline at end of file +../agency-shared-references/references \ No newline at end of file diff --git a/agency-web-developer/SKILL.md b/agency-web-developer/SKILL.md index f7ff8ed..6b622b0 100644 --- a/agency-web-developer/SKILL.md +++ b/agency-web-developer/SKILL.md @@ -346,21 +346,16 @@ $(document).ready(function() { ## References -### Technical (Web Developer Specific) -- [html_semantics.md](./references/html_semantics.md) β€” Semantic HTML best practices -- [css_layout.md](./references/css_layout.md) β€” Layout, responsive, Bootstrap -- [js_interactivity.md](./references/js_interactivity.md) β€” jQuery + GSAP patterns - -### UX/Design Patterns (Shared References) -**Consultare PRIMA di implementare:** -- [hero_sections.md](../references/hero_sections.md) β€” Hero checklist, formula, layouts -- [design_patterns.md](../references/design_patterns.md) β€” Card grid, split layout, testimonial, FAQ patterns -- [navigation_patterns.md](../references/navigation_patterns.md) β€” Primary nav, mobile nav, IA -- [conversion_patterns.md](../references/conversion_patterns.md) β€” CTA hierarchy, forms, friction reducers -- [layout_systems.md](../references/layout_systems.md) β€” Grid, spacing, vertical rhythm - -### Resources & Assets -- [resource_types.md](../agency-archivist/references/resource_types.md) β€” Tipologie risorse e use case +### Shared References (Agency Suite) +- [html_semantics.md](../agency-shared-references/references/html_semantics.md) β€” Semantic HTML best practices +- [css_layout.md](../agency-shared-references/references/css_layout.md) β€” Layout, responsive, Bootstrap +- [js_interactivity.md](../agency-shared-references/references/js_interactivity.md) β€” jQuery + GSAP patterns +- [hero_sections.md](../agency-shared-references/references/hero_sections.md) β€” Hero checklist, formula, layouts +- [design_patterns.md](../agency-shared-references/references/design_patterns.md) β€” Card grid, split layout, testimonial, FAQ patterns +- [navigation_patterns.md](../agency-shared-references/references/navigation_patterns.md) β€” Primary nav, mobile nav, IA +- [conversion_patterns.md](../agency-shared-references/references/conversion_patterns.md) β€” CTA hierarchy, forms, friction reducers +- [layout_systems.md](../agency-shared-references/references/layout_systems.md) β€” Grid, spacing, vertical rhythm +- [resource_types.md](../agency-shared-references/references/resource_types.md) β€” Tipologie risorse e use case **Flusso consigliato:** 1. Leggi catalogo risorse (`assets/catalog.md`) diff --git a/agency-web-developer/references b/agency-web-developer/references new file mode 120000 index 0000000..56c0254 --- /dev/null +++ b/agency-web-developer/references @@ -0,0 +1 @@ +../agency-shared-references/references \ No newline at end of file diff --git a/agency-youtube/SKILL.md b/agency-youtube/SKILL.md index 9cfb368..dd61548 100644 --- a/agency-youtube/SKILL.md +++ b/agency-youtube/SKILL.md @@ -220,10 +220,9 @@ Strategia YouTube, calendario e script orientati a retention. ## References -- [youtube_script_framework.md](../../references/youtube_script_framework.md) β€” Struttura script -- [content_formats.md](../../references/content_formats.md) β€” Formati YouTube -- [brand_voice.md](../../references/brand_voice.md) β€” Tone of voice -- [youtube_script.md](../../templates/youtube_script.md) β€” Template script +- [youtube_script_framework.md](../agency-shared-references/references/youtube_script_framework.md) β€” Struttura script +- [content_formats.md](../agency-shared-references/references/content_formats.md) β€” Formati YouTube +- [brand_voice.md](../agency-shared-references/references/brand_voice.md) β€” Tone of voice --- diff --git a/agency-youtube/references b/agency-youtube/references index 3dc6b5c..56c0254 120000 --- a/agency-youtube/references +++ b/agency-youtube/references @@ -1 +1 @@ -../references \ No newline at end of file +../agency-shared-references/references \ No newline at end of file