diff --git a/agency-shared-references/SKILL.md b/agency-shared-references/SKILL.md index 1917cd2..6120a2d 100644 --- a/agency-shared-references/SKILL.md +++ b/agency-shared-references/SKILL.md @@ -1,67 +1,141 @@ --- 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." +description: "References condivise per la suite agency-skills. Contiene 24 documenti con pattern UX/UI, framework copywriting, standard qualitΓ , playbook strategici, specifiche tecniche e template. Usare quando: (1) serve consultare pattern UX/UI, (2) applicare framework copywriting, (3) seguire standard qualitΓ , (4) citare fonti correttamente, (5) gestire risorse catalogate, (6) implementare siti web statici." --- # Agency Shared References -References condivise per tutte le skills della suite agency-skills. +Repository centralizzato di 24 documenti di riferimento per tutte le skills della suite agency-skills. -## Quando Usare +## Indice delle Referenze -Questa skill viene caricata automaticamente quando le altre skills della suite necessitano di: +### 🎨 Design & UX Patterns (7 documenti) -- **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 +**design_patterns.md** β€” Pattern UI riusabili per siti agency/services +_Cosa contiene:_ Card grid, split layout, section header, logo wall, testimonial block, FAQ, footer actionable +_Quando usarlo:_ Per strutturare sezioni di pagine web con pattern collaudati -## Struttura +**hero_sections.md** β€” Formula e checklist per hero section efficaci +_Cosa contiene:_ Hero checklist (5 secondi), formula H1, 6 layout tipi (value prop, problem-agitate, social proof, portfolio, CTA-only, video) +_Quando usarlo:_ Per progettare la sezione above-the-fold di homepage e landing page -``` -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 -``` +**layout_systems.md** β€” Grid, spacing e ritmo verticale +_Cosa contiene:_ Grid 12 colonne, scala spaziatura modulare (4/8/16/24/32/48/64), vertical rhythm, density levels +_Quando usarlo:_ Per creare design system coerenti e mantenere consistenza tra pagine -## Uso dalle Skills +**navigation_patterns.md** β€” Information architecture e navigazione +_Cosa contiene:_ Primary nav structure, mobile nav patterns, footer navigation, breadcrumbs, IA per agency sites +_Quando usarlo:_ Per definire struttura di navigazione e menu di siti web -Ogni skill della suite punta a queste references tramite symlink: +**conversion_patterns.md** β€” CTA, forms e riduzione attrito +_Cosa contiene:_ CTA hierarchy, form design best practices, friction reducers, urgency/scarcity ethics +_Quando usarlo:_ Per ottimizzare pagine per conversioni (contact, signup, download) -```bash -ln -s ../agency-shared-references/references ./references -``` +**trust_signal_patterns.md** β€” Pattern per costruire fiducia +_Cosa contiene:_ Social proof (loghi, testimonial), numeri/risultati, authority badge, transparency signals +_Quando usarlo:_ Per aumentare credibilitΓ  e ridurre rischio percepito + +**qa_visual.md** β€” Checklist QA per asset visuali +_Cosa contiene:_ Readability check, contrast check, mobile preview, brand consistency, platform specs +_Quando usarlo:_ Prima di pubblicare card, carousel, thumbnail o altri asset visuali + +--- + +### ✍️ Copy & Content (6 documenti) + +**copy_frameworks.md** β€” Framework copywriting clarity-first +_Cosa contiene:_ Regole generali, AIDA, PAS, FAB, 4U, Before-After-Bridge, job-to-be-done +_Quando usarlo:_ Per scrivere copy di homepage, landing page, ads, email + +**brand_voice.md** β€” Linee guida tono di voce +_Cosa contiene:_ Attributi tono (3-5), dimensioni voce, esempi pratici, do's/don'ts per web e social +_Quando usarlo:_ Per mantenere coerenza di tono across tutti i content + +**content_formats.md** β€” Formati content per social e YouTube +_Cosa contiene:_ Content pillars β†’ formats mapping, LinkedIn posts, Instagram carousel, YouTube video structures +_Quando usarlo:_ Per pianificare e produrre content per social media + +**case_study_structures.md** β€” Template per case study +_Cosa contiene:_ Snapshot, challenge, solution, results, testimonial structure +_Quando usarlo:_ Per documentare progetti e dimostrare competenza + +**audience_personas.md** β€” Template per ICP e personas +_Cosa contiene:_ Persona fields (demografici, psicografici, bisogni, obiezioni), ICP definition +_Quando usarlo:_ Per definire target audience e allineare strategia + +**youtube_script_framework.md** β€” Script structure retention-first +_Cosa contiene:_ Timeline script (hook, intro, content, CTA), retention tactics, pattern interrupts +_Quando usarlo:_ Per scrivere script YouTube che mantengono engagement + +--- + +### πŸ“Š Strategy & Research (3 documenti) + +**strategy_playbook.md** β€” Framework positioning e messaging +_Cosa contiene:_ Positioning statement, messaging hierarchy, content pillars definition +_Quando usarlo:_ Per definire strategia di posizionamento e messaggi chiave + +**research_playbook.md** β€” Metodo research competitor +_Cosa contiene:_ Competitor analysis framework, teardown template, synthesis patterns +_Quando usarlo:_ Per analizzare competitor e raccogliere reference di settore + +**research_citation_rules.md** β€” Regole citazione fonti +_Cosa contiene:_ Obbligo logging, formato citazione, sources log template +_Quando usarlo:_ Ogni volta che si usano fonti esterne in research o content + +--- + +### βœ… Quality & Publishing (4 documenti) + +**quality_bar.md** β€” Standard minimo accettabile V1 +_Cosa contiene:_ V1 principles, complete > perfect, tracciabilitΓ  decision log +_Quando usarlo:_ Per definire criterio di "done" per deliverable + +**publishing_gates.md** β€” Gate di approvazione pre-publish +_Cosa contiene:_ Publishing rules, approval checklist, required approvals per piattaforma +_Quando usarlo:_ Prima di pubblicare qualsiasi content (website, social, YouTube) + +**weekly_report_template.md** β€” Template report KPI settimanali +_Cosa contiene:_ Report structure, KPI sections, highlights/lowlights, actions next week +_Quando usarlo:_ Per reportistica settimanale analytics + +**platform_patterns.md** β€” Pattern specifici per piattaforma social +_Cosa contiene:_ LinkedIn, Instagram, YouTube patterns (hook, format, best practices) +_Quando usarlo:_ Per ottimizzare content per piattaforma specifica + +--- + +### πŸ’» Technical β€” Web Development (3 documenti) + +**html_semantics.md** β€” Semantic HTML best practices +_Cosa contiene:_ Document structure, semantic tags, accessibility (ARIA), SEO on-page +_Quando usarlo:_ Per scrivere HTML accessibile e SEO-friendly + +**css_layout.md** β€” Bootstrap e CSS custom +_Cosa contiene:_ Bootstrap vs custom decision, responsive breakpoints, grid implementation +_Quando usarlo:_ Per stilizzare siti web responsive + +**js_interactivity.md** β€” jQuery + GSAP patterns +_Cosa contiene:_ Setup librerie, DOM manipulation, animations, scroll effects, performance +_Quando usarlo:_ Per aggiungere interattivitΓ  e animazioni a siti web + +--- + +### πŸ“¦ Resources & Assets (1 documento) + +**resource_types.md** β€” Classificazione risorse e use case +_Cosa contiene:_ Immagini (logo, prodotto, team), video, documenti β€” formati, risoluzioni, use case per skill +_Quando usarlo:_ Per catalogare asset e capire quali risorse servono per ogni task + +--- ## 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 +- **Percorsi:** Tutte le skills puntano a questi file con percorsi diretti (`../agency-shared-references/references/.md`) --- -_Agency Shared References v1.0_ +_Agency Shared References v2.0 β€” No Symlink, Direct Paths_