Aggiornato agency-shared-references/SKILL.md: Indice referenze dettagliato
- Sostituita sezione 'Uso dalle Skills' con 'Indice delle Referenze' - 24 documenti organizzati per categoria (Design, Copy, Strategy, Quality, Technical, Resources) - Per ogni riferimento: titolo, descrizione contenuti, quando usarlo - Struttura più utile per consultazione rapida - Descrizione aggiornata nel frontmatter YAML
This commit is contained in:
AgentePotente
parent
d0d3bcad35
commit
0234cd0aaa
1 changed files with 118 additions and 44 deletions
|
|
@ -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/<file>.md`)
|
||||
|
||||
---
|
||||
|
||||
_Agency Shared References v1.0_
|
||||
_Agency Shared References v2.0 — No Symlink, Direct Paths_
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue