diff --git a/INSTALL.sh b/INSTALL.sh index 3fd59d0..9e53e0d 100755 --- a/INSTALL.sh +++ b/INSTALL.sh @@ -1,6 +1,7 @@ #!/bin/bash # Installazione Agency Skills Suite # Script generico per Unix/Linux/Mac +# Nota: Nessun symlink necessario - percorsi diretti nei SKILL.md set -e @@ -23,36 +24,40 @@ mkdir -p "$(dirname "$TARGET")" echo "πŸ“¦ Copia skills in $TARGET..." cp -r "$SOURCE" "$TARGET" -# Verifica/Crea symlink per tutte le skills -echo "πŸ”— Configurazione symlink references..." +# Verifica struttura +echo "πŸ” Verifica struttura..." cd "$TARGET" + +# Verifica che agency-shared-references esista +if [ ! -d "agency-shared-references/references" ]; then + echo "❌ Errore: agency-shared-references/references non trovato" + exit 1 +fi + +# Conta i file reference +REF_COUNT=$(ls -1 agency-shared-references/references/*.md 2>/dev/null | wc -l) +echo " βœ“ agency-shared-references/references/ ($REF_COUNT file)" + +# Verifica che tutte le skills esistano +SKILL_COUNT=0 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 + if [ -d "$skill_dir" ] && [ -f "$skill_dir/SKILL.md" ]; then + SKILL_COUNT=$((SKILL_COUNT + 1)) + echo " βœ“ $skill_dir" 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 "" echo "βœ… Installation complete!" echo "" echo "Skills installate in: $TARGET" +echo "Totale skills: $SKILL_COUNT" +echo "Totale references: $REF_COUNT" echo "" -echo "Skills disponibili:" -ls -1 "$TARGET" | grep -v references | sed 's/^/ - /' +echo "Nota: Nessun symlink necessario. I SKILL.md usano percorsi diretti." +echo "" +echo "Verifica installazione:" +echo " cd $TARGET" +echo " ls agency-shared-references/references/" echo "" 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 a55f5e4..9351eed 100644 --- a/README.md +++ b/README.md @@ -21,13 +21,13 @@ La suite richiede una struttura directory specifica per funzionare correttamente 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` + - La cartella `agency-shared-references/` deve contenere tutti i 24 file reference + - Nessun symlink necessario: le skills puntano direttamente ai file con percorsi relativi -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 +3. **Verifica i file:** + - I file reference sono accessibili direttamente da `agency-shared-references/references/` + - Ogni SKILL.md contiene percorsi completi verso le reference necessarie + - Su qualsiasi piattaforma: `ls agency-shared-references/references/` per verificare 4. **Testa l'installazione:** - Carica una skill (es. `/skill agency-orchestrator`) @@ -40,20 +40,15 @@ cd /path/to/agency-skills-suite ./INSTALL.sh ``` -### Metodo 2: Copia Manuale +### Metodo 2: Copia Manuale (Tutte le piattaforme) ```bash # Copia l'intera suite cp -r /path/to/agency-skills-suite ~/.openclaw/skills/ -# Verifica i symlink (Unix/Linux/Mac) +# Verifica la struttura (nessun symlink necessario) 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 +ls agency-shared-references/references/ # Deve mostrare 24 file ``` ### Metodo 3: ClawHub (se pubblicato) @@ -155,44 +150,35 @@ agency-skills-suite/ β”œβ”€β”€ README.md β”œβ”€β”€ INSTALL.sh β”œβ”€β”€ AGENCY_ARCHIVIST_DELIVERY.md -β”œβ”€β”€ agency-shared-references/ πŸ“š References centralizzate +β”œβ”€β”€ agency-shared-references/ πŸ“š References centralizzate (24 file) β”‚ └── references/ β”‚ β”œβ”€β”€ design_patterns.md β”‚ β”œβ”€β”€ hero_sections.md -β”‚ β”œβ”€β”€ ... (23 references) +β”‚ β”œβ”€β”€ ... (24 references) β”‚ └── resource_types.md β”œβ”€β”€ agency-orchestrator/ -β”‚ β”œβ”€β”€ SKILL.md -β”‚ └── references β†’ ../agency-shared-references/references +β”‚ └── SKILL.md # Puntano direttamente a ../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 +β”‚ └── scripts/ +β”‚ β”œβ”€β”€ extract_archive.js +β”‚ β”œβ”€β”€ scan_resources.js +β”‚ └── generate_catalog.js β”œβ”€β”€ agency-strategy/ -β”‚ β”œβ”€β”€ SKILL.md -β”‚ └── references β†’ ../agency-shared-references/references +β”‚ └── SKILL.md β”œβ”€β”€ agency-research/ -β”‚ β”œβ”€β”€ SKILL.md -β”‚ └── references β†’ ../agency-shared-references/references +β”‚ └── SKILL.md β”œβ”€β”€ agency-creative-director/ -β”‚ β”œβ”€β”€ SKILL.md -β”‚ └── references β†’ ../agency-shared-references/references +β”‚ └── SKILL.md β”œβ”€β”€ agency-design-system/ -β”‚ β”œβ”€β”€ SKILL.md -β”‚ └── references β†’ ../agency-shared-references/references +β”‚ └── SKILL.md β”œβ”€β”€ agency-ux-copy/ -β”‚ β”œβ”€β”€ SKILL.md -β”‚ └── references β†’ ../agency-shared-references/references +β”‚ └── SKILL.md β”œβ”€β”€ agency-seo/ -β”‚ β”œβ”€β”€ SKILL.md -β”‚ └── references β†’ ../agency-shared-references/references +β”‚ └── SKILL.md β”œβ”€β”€ agency-social/ -β”‚ β”œβ”€β”€ SKILL.md -β”‚ └── references β†’ ../agency-shared-references/references +β”‚ └── SKILL.md β”œβ”€β”€ agency-youtube/ β”‚ β”œβ”€β”€ SKILL.md β”‚ └── references β†’ ../agency-shared-references/references @@ -206,13 +192,16 @@ agency-skills-suite/ β”‚ β”œβ”€β”€ SKILL.md β”‚ └── references β†’ ../agency-shared-references/references β”œβ”€β”€ agency-publisher/ -β”‚ β”œβ”€β”€ SKILL.md -β”‚ └── references β†’ ../agency-shared-references/references +β”‚ └── SKILL.md +└── agency-youtube/ + └── SKILL.md ``` +**Nota:** Nessun symlink necessario. Ogni SKILL.md contiene percorsi diretti verso `../agency-shared-references/references/`. + ## Uso -Ogni skill Γ¨ auto-contenuta e usa references centralizzate tramite symlink. +Ogni skill Γ¨ auto-contenuta e punta direttamente ai file reference necessari. **Esempio:** @@ -220,7 +209,7 @@ Ogni skill Γ¨ auto-contenuta e usa references centralizzate tramite symlink. /skill agency-orchestrator ``` -La skill caricherΓ  automaticamente le references necessarie dal percorso `../agency-shared-references/references`. +La skill caricherΓ  automaticamente le references necessarie dai percorsi specificati nel SKILL.md (`../agency-shared-references/references/*`). ### Uso di agency-archivist diff --git a/agency-analytics/SKILL.md b/agency-analytics/SKILL.md index e63d366..c167b8d 100644 --- a/agency-analytics/SKILL.md +++ b/agency-analytics/SKILL.md @@ -177,7 +177,7 @@ Report KPI settimanali e azioni misurabili per social e YouTube. **Azioni:** -1. Usa template da `references/weekly_report_template.md` +1. Usa template da `../agency-shared-references/references/weekly_report_template.md` 2. Compila tutte le sezioni 3. Salva in `clients/{client}/analytics/weekly_reports/{YYYY-WW}.md` 4. Documenta azioni nel run log del progetto se richiedono follow-up diff --git a/agency-analytics/references b/agency-analytics/references deleted file mode 120000 index 56c0254..0000000 --- a/agency-analytics/references +++ /dev/null @@ -1 +0,0 @@ -../agency-shared-references/references \ No newline at end of file diff --git a/agency-archivist/references b/agency-archivist/references deleted file mode 120000 index 56c0254..0000000 --- a/agency-archivist/references +++ /dev/null @@ -1 +0,0 @@ -../agency-shared-references/references \ No newline at end of file diff --git a/agency-creative-director/references b/agency-creative-director/references deleted file mode 120000 index 56c0254..0000000 --- a/agency-creative-director/references +++ /dev/null @@ -1 +0,0 @@ -../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 489649e..692073a 100644 --- a/agency-design-system/SKILL.md +++ b/agency-design-system/SKILL.md @@ -180,7 +180,7 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile. - Sezione header (hero) - Sezioni content (ordine) - Sezione footer - - Pattern usati (da references) + - Pattern usati (da agency-shared-references/references) **Template:** @@ -268,7 +268,7 @@ Traduce la direzione creativa in un design system coerente e riutilizzabile. - **Brand esistente:** Adatta tokens ai colori/font esistenti - **Progetto piccolo:** Semplifica (tokens essenziali + 5-6 components base) -- **Nessun designer:** Usa pattern standard da references +- **Nessun designer:** Usa pattern standard da agency-shared-references/references **Limitazioni:** diff --git a/agency-design-system/references b/agency-design-system/references deleted file mode 120000 index 56c0254..0000000 --- a/agency-design-system/references +++ /dev/null @@ -1 +0,0 @@ -../agency-shared-references/references \ No newline at end of file diff --git a/agency-orchestrator/SKILL.md b/agency-orchestrator/SKILL.md index 6f3c731..e326adc 100644 --- a/agency-orchestrator/SKILL.md +++ b/agency-orchestrator/SKILL.md @@ -175,7 +175,7 @@ L'orchestratore deve leggere il documento ed estrarre tutte le informazioni rile └── assets/ (immagini, video, documenti β€” gestito da agency-archivist) ``` -4. **Leggi `references/quality_bar.md`** per standard di qualitΓ  +4. **Leggi `../agency-shared-references/references/quality_bar.md`** per standard di qualitΓ  5. **Registra assunzioni in `clients/{client}/ops/decisions.md`** @@ -236,7 +236,7 @@ L'orchestratore deve leggere il documento ed estrarre tutte le informazioni rile 1. Raccogli output da tutti gli agenti 2. Verifica coerenza cross-deliverable -3. Esegui QA checklist (vedi `references/quality_bar.md`) +3. Esegui QA checklist (vedi `../agency-shared-references/references/quality_bar.md`) 4. Crea `clients/{client}/ops/qa_notes.md` con issue + fix proposti **QA Checklist:** @@ -253,7 +253,7 @@ L'orchestratore deve leggere il documento ed estrarre tutte le informazioni rile **Azioni:** -1. Verifica `references/publishing_gates.md` +1. Verifica `../agency-shared-references/references/publishing_gates.md` 2. Imposta `APPROVED: YES` nei file content (post-review) 3. Crea `PUBLISH_APPROVED.md` se pronto 4. Triggera `agency-publisher` solo se gate superato diff --git a/agency-orchestrator/references b/agency-orchestrator/references deleted file mode 120000 index 56c0254..0000000 --- a/agency-orchestrator/references +++ /dev/null @@ -1 +0,0 @@ -../agency-shared-references/references \ No newline at end of file diff --git a/agency-publisher/references b/agency-publisher/references deleted file mode 120000 index 56c0254..0000000 --- a/agency-publisher/references +++ /dev/null @@ -1 +0,0 @@ -../agency-shared-references/references \ No newline at end of file diff --git a/agency-research/references b/agency-research/references deleted file mode 120000 index 56c0254..0000000 --- a/agency-research/references +++ /dev/null @@ -1 +0,0 @@ -../agency-shared-references/references \ No newline at end of file diff --git a/agency-seo/references b/agency-seo/references deleted file mode 120000 index 56c0254..0000000 --- a/agency-seo/references +++ /dev/null @@ -1 +0,0 @@ -../agency-shared-references/references \ No newline at end of file diff --git a/agency-social/references b/agency-social/references deleted file mode 120000 index 56c0254..0000000 --- a/agency-social/references +++ /dev/null @@ -1 +0,0 @@ -../agency-shared-references/references \ No newline at end of file diff --git a/agency-strategy/SKILL.md b/agency-strategy/SKILL.md index 06baf23..4c386f8 100644 --- a/agency-strategy/SKILL.md +++ b/agency-strategy/SKILL.md @@ -55,7 +55,7 @@ Definisce la direzione strategica di un brand: positioning, messaging e content **Azioni:** -1. Usa formula da `references/strategy_playbook.md`: +1. Usa formula da `../agency-shared-references/references/strategy_playbook.md`: > "For [audience] who want [outcome], we provide [solution] unlike [alternative] because [proof]." 2. Compila ogni elemento: @@ -120,7 +120,7 @@ Definisce la direzione strategica di un brand: positioning, messaging e content 2. Per ogni pillar, definisci: - Nome - Descrizione (1 frase) - - Format suggeriti (da `references/content_formats.md`) + - Format suggeriti (da `../agency-shared-references/references/content_formats.md`) **Esempio:** diff --git a/agency-strategy/references b/agency-strategy/references deleted file mode 120000 index 56c0254..0000000 --- a/agency-strategy/references +++ /dev/null @@ -1 +0,0 @@ -../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 8bcc4fb..fdaaf2d 100644 --- a/agency-ux-copy/SKILL.md +++ b/agency-ux-copy/SKILL.md @@ -91,7 +91,7 @@ Progetta la struttura del sito e scrive copy chiaro e conversion-oriented. - CTA sections (mid-page, footer) - FAQ (se applicabile) -2. Usa pattern da references: +2. Usa pattern da agency-shared-references/references: - `hero_sections.md` per hero - `conversion_patterns.md` per CTA - `design_patterns.md` per layout @@ -141,12 +141,12 @@ Progetta la struttura del sito e scrive copy chiaro e conversion-oriented. - Bullets: 3-5 punti chiave - Microcopy: Label, button text -3. **Usa framework da `references/copy_frameworks.md`:** +3. **Usa framework da `../agency-shared-references/references/copy_frameworks.md`:** - PAS (Problem-Agitate-Solve) - AIDA (Attention-Interest-Desire-Action) - Before-After-Bridge -4. **Applica `references/conversion_patterns.md`:** +4. **Applica `../agency-shared-references/references/conversion_patterns.md`:** - 1 CTA primaria per pagina - Ripeti CTA 2-3 volte - Friction reducers vicino a form diff --git a/agency-ux-copy/references b/agency-ux-copy/references deleted file mode 120000 index 56c0254..0000000 --- a/agency-ux-copy/references +++ /dev/null @@ -1 +0,0 @@ -../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 f3434cb..db80eae 100644 --- a/agency-visual-generator/SKILL.md +++ b/agency-visual-generator/SKILL.md @@ -174,7 +174,7 @@ Genera asset visuali platform-ready basati su content approvato e style guide. **Azioni:** -1. Usa checklist da `references/qa_visual.md`: +1. Usa checklist da `../agency-shared-references/references/qa_visual.md`: **Readability:** - [ ] Text readable at mobile size (320px) diff --git a/agency-visual-generator/references b/agency-visual-generator/references deleted file mode 120000 index 56c0254..0000000 --- a/agency-visual-generator/references +++ /dev/null @@ -1 +0,0 @@ -../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 6b622b0..ad2a248 100644 --- a/agency-web-developer/SKILL.md +++ b/agency-web-developer/SKILL.md @@ -132,7 +132,7 @@ Trasforma copy e design system in siti web funzionanti con HTML semantico, CSS e - CTA sections - Form di contatto -6. **Segui `references/html_semantics.md`:** +6. **Segui `../agency-shared-references/references/html_semantics.md`:** - Semantic HTML best practices - Accessibility (ARIA labels dove necessario) - SEO on-page (heading structure, alt text) @@ -173,7 +173,7 @@ Trasforma copy e design system in siti web funzionanti con HTML semantico, CSS e - Crea grid system (o usa CSS Grid/Flexbox) - Stilizza componenti uno a uno -3. **Implementa da `references/css_layout.md`:** +3. **Implementa da `../agency-shared-references/references/css_layout.md`:** - Responsive design (mobile-first) - Breakpoints (mobile, tablet, desktop) - Typography scale @@ -225,7 +225,7 @@ Trasforma copy e design system in siti web funzionanti con HTML semantico, CSS e - Hover animations complesse - Timeline per sequenze animate -4. **Segui `references/js_interactivity.md`:** +4. **Segui `../agency-shared-references/references/js_interactivity.md`:** - Best practices jQuery - GSAP patterns - Performance considerations @@ -360,8 +360,8 @@ $(document).ready(function() { **Flusso consigliato:** 1. Leggi catalogo risorse (`assets/catalog.md`) 2. Verifica asset disponibili o richiedi ad @agency-archivist -3. Leggi pattern UX da shared references (COSA fare) -4. Implementa con technical references (COME codificare) +3. Leggi pattern UX da `agency-shared-references/references` (COSA fare) +4. Implementa con technical references da `agency-shared-references/references` (COME codificare) --- diff --git a/agency-web-developer/references b/agency-web-developer/references deleted file mode 120000 index 56c0254..0000000 --- a/agency-web-developer/references +++ /dev/null @@ -1 +0,0 @@ -../agency-shared-references/references \ No newline at end of file diff --git a/agency-youtube/SKILL.md b/agency-youtube/SKILL.md index dd61548..a6617da 100644 --- a/agency-youtube/SKILL.md +++ b/agency-youtube/SKILL.md @@ -119,7 +119,7 @@ Strategia YouTube, calendario e script orientati a retention. **Azioni:** -1. Usa struttura da `references/youtube_script_framework.md`: +1. Usa struttura da `../agency-shared-references/references/youtube_script_framework.md`: - 0-10s: Hook (promise + curiosity) - 10-25s: Credibility (why listen) - 25-60s: Problem definition diff --git a/agency-youtube/references b/agency-youtube/references deleted file mode 120000 index 56c0254..0000000 --- a/agency-youtube/references +++ /dev/null @@ -1 +0,0 @@ -../agency-shared-references/references \ No newline at end of file