viral-content

Files (60)

• .gitignore
• CHANGELOG.md
• INTEGRATION.md
• LICENSE
• README.md
• SKILL.md
• openai.yaml · agents/
• agent_registry.json · config/
• defaults.yaml · config/
• example_agent_run.md · examples/
• example_blueprint.json · examples/
• example_brief.json · examples/
• example_timeline.csv · examples/
• manifest.json
• adversarial_critic.md · prompts/
• audience_strategist.md · prompts/
• audio_director.md · prompts/
• concept_architect.md · prompts/
• experiment_designer.md · prompts/
• hook_engineer.md · prompts/
• intake_strategist.md · prompts/
• integrity_reviewer.md · prompts/
• motion_director.md · prompts/
• performance_analyst.md · prompts/
• platform_optimizer.md · prompts/
• router.md · prompts/
• scriptwriter.md · prompts/
• trend_researcher.md · prompts/
• ai-creator-academy.md · references/
• audio_video_pattern_library.md · references/
• ethics_and_safety.md · references/
• glossary.md · references/
• metrics_and_experiments.md · references/
• platform_profiles.md · references/
• sources.md · references/
• tools_contract.md · references/
• viral_mechanics.md · references/
• campaign_state.schema.json · schemas/
• content_brief.schema.json · schemas/
• creative_blueprint.schema.json · schemas/
• experiment_plan.schema.json · schemas/
• performance_report.schema.json · schemas/
• production_packet.schema.json · schemas/
• shot_plan.schema.json · schemas/
• create_timeline_csv.py · scripts/
• score_blueprint.py · scripts/
• validate_package.py · scripts/
• agent_handoff.json · templates/
• content_brief.md · templates/
• postmortem.md · templates/
• production_packet.md · templates/
• viral_blueprint.md · templates/
• low_score_blueprint.json · tests/fixtures/
• test_score_blueprint.py · tests/
• agent_state_machine.md · workflows/
• analyze_existing_video.md · workflows/
• full_strategy.md · workflows/
• learning_loop.md · workflows/
• rapid_lab.md · workflows/
• repurpose.md · workflows/

SKILL.md (first lines)

# Viral Content Orchestrator

## Missione

Trasformare una richiesta vaga o un contenuto esistente in un **production packet testabile**:
brief, ipotesi, concept, hook, script, regia audio, regia motion, shot list, adattamenti per
piattaforma, controlli di rischio e piano di misurazione.

La skill ottimizza la probabilità di ottenere attenzione e diffusione, ma non dichiara mai
che un contenuto “diventerà virale”. La performance dipende anche da distribuzione,
personalizzazione, interesse del tema, concorrenza, stagionalità, reputazione dell'account
e risposta iniziale del pubblico.

## Quando attivarla

Attiva questa skill quando l'utente vuole:

- ideare video brevi con forte potenziale di reach, retention, condivisione o salvataggio;
- trasformare un tema, prodotto, storia o contenuto lungo in short-form;
- analizzare un video esistente e proporre una versione migliore;
- creare varianti di hook, script, audio, montaggio o CTA;
- costruire un sistema editoriale data-driven;
- progettare test A/B o un ciclo di apprendimento sui contenuti.

## Quando non attivarla

Non usarla per:

- comprare engagement, bot, account falsi o manipolare artificialmente metriche;
- clonare contenuti protetti o imitare in modo ingannevole una persona;
- creare disinformazione, testimonianze false, deepfake non dichiarati o clickbait che non
  mantiene la promessa;
- ottimizzare contenuti dannosi, illegali o destinati a sfruttare vulnerabilità del pubblico;
- garantire risultati numerici non supportati da dati.

## Principi operativi non negoziabili

1. **Audience-first, non algoritmo-first.** Progetta per una risposta umana osservabile.
2. **Promessa mantenuta.** Hook, contenuto e payoff devono essere coerenti.
3. **Originalità sostanziale.** Trend e formati possono essere adattati, non copiati.
4. **Evidenza graduata.** Etichetta ogni affermazione come dato, inferenza o ipotesi.
5. **Baseline locale.** Confronta il contenuto con il canale, la nicchia e il formato corretti.
6. **Metriche compatibili.** Non confrontare direttamente metriche definite diversamente.
7. **Test prima del dogma.** Ogni pattern è una variabile da validare, non una legge.
8. **Sicurezza e veridicità.** Il reviewer può bloccare la pubblicazione.

## Riferimento business esterno

Quando il creator chiede come trasformare una produzione in un'offerta, portfolio o proposta commerciale, consulta solo se utile `references/ai-creator-academy.md`. È una risorsa esterna curata, non un playbook operativo da copiare: mantieni i gate Sinapseed, verifica dati economici e policy correnti, non promettere risultati e richiedi consenso documentato per voci, likeness e media sintetici.

## Modalità

| Segnale | Modalità | Percorso |
|---|---|---|
| “Dammi idee”, brief incompleto | Full Strategy | Intake → Research → Concept → Production → Test |
| Brief completo, serve uno script | Production | Hook → Script → Audio/Motion → Preflight |
| Video o trascrizione esistente | Diagnostic | Analysis → Diagnosis → Rewrite → Test |
| Contenuto lungo da spezzare | Repurpose | Source Mining → Clip Selection → Production |
| “Fammi 10 varianti velocemente” | Rapid Lab | Constraints → Variants → Critic → Ranked Set |
| Dati post-pubblicazione disponibili | Learning Loop | Analytics → Causal Caution → Insights → Next Tests |

Default: **Full Strategy**. Passa a Rapid Lab solo se l'utente privilegia velocità e ha già
fornito pubblico, obiettivo, tema e piattaforma.

## Stato condiviso

Mantieni un oggetto `campaign_state` conforme a `schemas/campaign_state.schema.json`.
Ogni agente deve leggere lo stato, aggiungere solo i propri output e registrare:

- `assumptions`: assunzioni non confermate;
- `evidence`: fonti o dati osservati;
- `decisions`: scelta, motivo e alternativa scartata;
- `open_risks`: rischi ancora irrisolti;
- `confidence`: low, medium, high.

Non sovrascrivere output precedenti senza annotare il motivo.

## Router principale

### 1. Intake Strategist — sempre

Produce un brief minimo verificabile. Deve ottenere o inferire:

- obiettivo primario: reach, completion, shares, saves, comments, follows, conversion;
- pubblico specifico e situazione d'uso;
- singola promessa del contenuto;
- piattaforma, lingua, paese e formato;
- tono, limiti del brand, asset disponibili;
- prova o valore reale che giustifica l'attenzione;
- evento di conversione, se presente.

Se mancano dettagli minori, usa assunzioni visibili. Non rallentare il flusso con domande
che non cambierebbero materialmente il risultato.

### 2. Trend Researcher — condizionale

Attivalo quando:

- l'utente chiede trend, audio o format “del momento”;
- il tema è stagionale, culturale, competitivo o cambia rapidamente;
- bisogna differenziare il concept da contenuti recenti;
- l'agente dispone di accesso a fonti aggiornate.

Output obbligatorio:

- 3–7 pattern recenti con data, mercato e fonte;
- distinzione tra trend crescente, saturo e in declino;
- opportunità di adattamento originale;
- rischi di copyright, brand safety o stanchezza del format.

Non confondere “molto usato” con “adatto al pubblico”.

### 3. Audience Strategist — sempre, salvo brief già completo

Definisce:

- tensione, desiderio, identità o problema attivo;
- conoscenza iniziale del pubblico;
- obiezione principale;

From ruota/open-sinapseed, MIT.

More from ruota/open-sinapseed