Communitygithub.com

you-decide-story

Transforma uma história curta em um vídeo vertical estilizado (1080x1920 MP4), totalmente desenhado em código com cenas SVG animadas por GSAP, narração, legendas sincronizadas, um relógio e uma escolha final de duas palavras.

O que é you-decide-story?

Esta skill permite que um agente de IA (como Claude Code) crie vídeos verticais curtos (20 a 45 segundos, formato 1080x1920) no estilo 'Reels', 'Shorts' ou 'TikTok', sem usar câmera, atores ou geradores de imagem. A partir de um único parágrafo fornecido pelo usuário, a skill orquestra a criação de um vídeo narrativo interativo: cada linha da história é uma cena desenhada com SVG inline, animada com GSAP (entradas, movimentos, zoom), com narração gerada por voz (usando a voz nativa do macOS, ElevenLabs ou silenciosa), legendas exibidas em sincronia com a narração, um relógio ou contador regressivo no topo da tela e, ao final, uma tela preta com uma pergunta 'VOCÊ QUER?' e duas opções de uma palavra cada. O processo é dividido em etapas automatizadas: o agente escreve um arquivo `story.json` com a estrutura da história, executa scripts (`voice.mjs` para gerar áudio e tempos, `render.mjs` para gerar frames e o MP4 final), e edita um template HTML onde insere manualmente o código SVG das cenas e as animações GSAP. A skill enfatiza rigorosamente o uso de tempos baseados no arquivo de temporização gerado pela voz (`timing.json`) e impõe regras de design (como nunca animar elementos com `transform` diretamente) para garantir que a animação fique perfeitamente sincronizada com a narração e que o vídeo final tenha qualidade visual consistente. Esta ferramenta é ideal para produtores de conteúdo, criadores de narrativas interativas ou qualquer desenvolvedor que queira gerar vídeos de história visualmente ricos e de forma programática.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zeroedithq/claude-video-skills/tree/HEAD/you-decide-story

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Você Decide a História

Você cria um vídeo vertical curto (1080 x 1920, cerca de 20 a 45 segundos) que conta uma pequena história e para em uma escolha. Nada é filmado e nenhuma imagem é gerada. Você desenha cada cena como SVG inline, o GSAP a move, um narrador lê as falas e um script renderiza os quadros em um MP4. O usuário fornece um parágrafo. Você retorna o vídeo renderizado.

As quatro partes

Todo episódio tem todas as quatro.

  1. Uma premissa de uma frase, dita nos primeiros três segundos. Segunda pessoa, presente: "Você dirige o último ônibus da noite." O padrão é: você, um lugar, um detalhe que está ligeiramente errado. O espectador sabe quem e onde está antes de poder rolar.
  2. Um relógio ou contador que permanece na tela na faixa superior e muda pelo menos uma vez. "23:58" vira "23:59". "3 FÓSFOROS" vira "2 FÓSFOROS". A mudança indica ao espectador que o tempo está se esgotando.
  3. Uma cena desenhada para cada linha da história. A história tem 5 a 7 linhas. Cada linha tem sua própria imagem e sua própria legenda. A imagem muda no segundo em que o narrador começa a linha.
  4. Uma escolha de duas palavras no final. A tela escurece e pergunta VOCÊ QUER? Em seguida, duas opções, uma palavra cada (por exemplo RESPONDER / NÃO), depois COMENTE UMA PALAVRA. A história não se resolve. A escolha é o final.

Arquivos

SKILL_DIR abaixo é a pasta onde este arquivo está. Use seu caminho absoluto real nos comandos. O Claude Code mostra quando a skill carrega. Caso contrário, é .claude/skills/you-decide-story no projeto, ou ~/.claude/skills/you-decide-story.

SKILL_DIR/scripts/voice.mjs       story.json -> áudio do narrador + timing.json
SKILL_DIR/scripts/render.mjs      página do episódio -> verificar quadros, ou o MP4
SKILL_DIR/template/episode.html   a página que você copia para cada episódio

Um episódio é uma pasta dentro do projeto do usuário, nomeada de acordo com a história:

ultimo-onibus/
  story.json       você escreve (passo 1)
  timing.json      voice.mjs escreve (passo 2). Nunca edite manualmente.
  audio/           voice.mjs escreve (passo 2)
  episode.html     copiado do template (passo 3), então você desenha nele
  out/check/       verificar quadros (passo 6)
  out/episode.mp4  o vídeo (passo 8)

Antes do primeiro episódio

Execute estes comandos na pasta do projeto do usuário:

node --version           # deve ser v22 ou mais recente
ffmpeg -version          # deve imprimir uma versão
npm ls gsap playwright   # ambos devem estar listados

Se gsap ou playwright estiver faltando, instale-os na pasta do projeto: npm install gsap playwright, depois npx playwright install chromium. Se Node.js ou ffmpeg estiver faltando, pare e informe ao usuário o que instalar.

Passos

Siga os passos nesta ordem. Não renderize o vídeo completo antes do passo 7 estar limpo.

Passo 1. Escreva story.json

Transforme o parágrafo do usuário em 5 a 7 linhas mais a escolha. O parágrafo deve responder a quatro perguntas: onde você está, que horas são (ou o que está acabando), quem ou o que chega, quais são as duas palavras no final. Se alguma estiver faltando, invente-a e diga isso em seu relatório final. Não pare para perguntar. Se esta for uma parte posterior de uma série, o usuário informa qual palavra venceu. Comece com ela.

{
  "title": "ÚLTIMO ÔNIBUS",
  "lines": [
    { "id": "l1", "say": "Você dirige o último ônibus da noite.", "caption": "Você dirige o último ônibus.", "clock": "23:58", "pause": 0.8 },
    { "id": "l2", "say": "Um homem acena para você. Não há ponto aqui.", "caption": "Um homem acena. Sem ponto aqui.", "clock": "23:59" }
  ],
  "choice": {
    "question": "VOCÊ QUER?",
    "a": "PARAR", "aNote": "deixá-lo entrar",
    "b": "DIRIGIR", "bNote": "seguir em frente",
    "say": { "question": "Você quer?", "a": "Parar.", "b": "Ou dirigir.", "cta": "Comente uma palavra." }
  }
}
CampoO que é
titleO rótulo na faixa superior. Uma a três palavras. É desenhado em maiúsculas.
lines[].idl1, l2, ... na ordem da história. Grupos de cena e código de movimento usam esses ids.
lines[].sayO que o narrador fala. Uma ou duas frases curtas, 4 a 12 palavras, presente.
lines[].captionO que está escrito na tela. A linha reduzida ao seu núcleo, com menos de cerca de 40 caracteres.
lines[].clockO texto na faixa superior enquanto esta linha está na tela. Repita o valor para mantê-lo. Altere-o pelo menos uma vez, na linha onde a pressão aumenta.
lines[].pauseOpcional. Segundos de silêncio após a linha, para uma imagem que precisa de tempo (uma porta abrindo, um telefone tocando). Padrão 0.3.
choice.a, choice.bUma palavra cada, em maiúsculas.
choice.aNote, choice.bNoteDuas ou três palavras em minúsculas que dizem o que a palavra significa aqui.
choice.questionPadrão VOCÊ QUER?.
choice.sayO que o narrador diz enquanto o cartão é construído, em quatro partes, para que cada palavra caia quando for falada.

Regras para as linhas:

  • l1 é a premissa. Segunda pessoa, presente, 8 palavras ou menos, para terminar em 3 segundos.
  • Mantenha as próprias frases do usuário onde elas já se encaixam. Se o parágrafo abrir com uma frase em segunda pessoa, presente, de 8 palavras ou menos, essa frase é l1, palavra por palavra.
  • Uma linha é uma imagem. Se uma linha precisar de duas imagens, divida-a em duas linhas.
  • A última linha antes da escolha deixa a pergunta em aberto. Não a responda.
  • A história é original. Veja as regras de desenho.

Passo 2. Crie a voz e o timing.json

node SKILL_DIR/scripts/voice.mjs ultimo-onibus
  • No Mac, isso usa a voz say integrada. É gratuita. --voice Daniel e --rate 172 são os padrões. Para uma história em outro idioma, passe uma voz desse idioma (liste-as com say -v '?').
  • --provider elevenlabs --voice <voice_id> usa ElevenLabs. Precisa de ELEVENLABS_API_KEY e custa créditos ao usuário. Use apenas quando o usuário solicitar.
  • --provider silent escreve silêncio com duração estimada. Use quando o sistema não tiver voz. Informe ao usuário que o vídeo não tem narração.

O script imprime o segundo de início e fim de cada linha e escreve audio/voice.wav e timing.json. Ele também verifica o formato e imprime uma linha Aviso: para cada problema: a premissa termina após 3 segundos, o relógio nunca muda, uma escolha tem mais de uma palavra, uma linha fica na tela por menos de 2 segundos. Corrija cada aviso no story.json e execute o script novamente. Execute-o novamente após qualquer alteração em um texto say.

timing.json é o único relógio do episódio:

{ "duration": 24.6, "lines": [ { "id": "l1", "start": 0.3, "end": 2.71 }, { "id": "l2", "start": 3.51, "end": 6.4 }, { "id": "choice", "start": 19.2, "end": 19.9 } ] }

Passo 3. Copie o template

cp SKILL_DIR/template/episode.html ultimo-onibus/episode.html

Leia a cópia uma vez. Você edita dois lugares nela: as cenas (SVG) e a função motion. O resto é o motor. A partir de story.json e timing.json, o motor já cronometra os cortes de cena, o zoom lento de cada cena, as legendas, o relógio e o cartão de escolha. Não cronometre esses novamente e não edite o motor.

Altere a cópia com sua ferramenta de edição de arquivos. O episódio permanece um arquivo HTML: não o divida em partes e não escreva um script de construção.

Passo 4. Desenhe as cenas

Dentro de <g id="scenes">, exclua as duas cenas de exemplo e desenhe um grupo por linha:

<g class="scene" id="scene-l2" data-caption-y="1400">
  <!-- fundo primeiro, depois coisas, depois pessoas -->
  <g transform="translate(540 1250) scale(1.12) translate(-540 -1250)">
    <g id="l2-homem"> ... </g>
  </g>
</g>
  • O id do grupo é scene- mais o id da linha. O motor o mostra desde o início de sua linha até o início da próxima linha.
  • Dê a cada parte que se mover seu próprio grupo nomeado e comece o nome com o id da linha (l2-homem, l2-braco). Os ids devem ser únicos na página.
  • O tamanho e a posição vão em um grupo externo como transform. O movimento vai no grupo nomeado dentro dele. Nunca anime um elemento que tenha um atributo transform, e nunca anime ou transforme um grupo .scene.
  • Uma linha pode manter a cena anterior (não desenhe grupo para ela) apenas quando a imagem muda claramente nessa linha através do movimento: alguém sai, uma luz se apaga, um telefone acende.

O palco é 1080 x 1920. Uma unidade é um pixel do vídeo.

yO que vai lá
0 a 182Faixa superior: rótulo e relógio. O motor desenha. Mantenha a área atrás dela simples.
250 a 1250A imagem. O assunto principal vive aqui e a preenche.
1290 a 1500Banda da legenda. Uma cor escura plana atrás das palavras: um balcão, um chão, uma estrada, uma parede.
1560 a 1920Coberto pelos botões do aplicativo nos telefones. Nada que a história precise.

data-caption-y em uma cena move sua legenda (padrão 1400, o meio da legenda). data-zoom define o zoom lento (padrão 1.06, 1 para nenhum).

Passo 5. Escreva o movimento

Substitua o corpo de function motion({ tl, show, line }) pelo movimento de suas cenas.

const l1 = line('l1'), l2 = line('l2');   // { start, end, next } em segundos, do timing.json

// cair de cima do quadro e quicar
show('#l2-mala', l2.start + 1.0);
tl.fromTo('#l2-mala', { y: -1400 }, { y: 0, duration: 0.55, ease: 'bounce.out' }, l2.start + 1.0);
// andar para a direita
tl.to('#l3-homem', { x: 900, duration: 1.3, ease: 'power2.in' }, l3.start + 1.4);
// tremer: um telefone tocando vira um pouco em torno de seu próprio centro
tl.to('#l4-telefone', { rotation: 3, svgOrigin: '290 1680', duration: 0.06, repeat: 40, yoyo: true, ease: 'none' }, l4.start);
// pulsar: anéis de toque, uma luz de aviso
tl.fromTo('#l4-anéis', { opacity: 0 }, { opacity: 1, duration: 0.3, repeat: 7, yoyo: true, ease: 'sine.inOut' }, l4.start + 0.1);
// algo que dura a cena inteira
tl.fromTo('#l1-estrada', { x: 0 }, { x: -520, duration: l1.next, ease: 'none' }, 0);

Regras. Elas são o que mantém a imagem na voz:

  • Todo segundo de início vem do timing.json. Escreva-o como line('<id>').start mais um offset dentro dessa linha. 0, o primeiro quadro, é o único número simples permitido. Um segundo definido manualmente como 6.4 não é permitido: quando a voz for feita novamente, ele se desviaria.
  • line(id).start é o corte para a cena daquela linha. .end é onde o narrador para. .next é onde a próxima linha começa. line('choice') é o cartão de escolha.
  • Uma forma que aparece depois precisa de show(el, start) no mesmo segundo de sua animação de entrada. show(el, start, end) a esconde antes de start e depois de end.
  • Apenas animações. Sem tl.call, sem onComplete, sem Math.random(), sem timers. O renderizador salta para cada quadro, então apenas valores animados são desenhados.
  • Rotação e escala precisam de svgOrigin: 'x y', o ponto em torno do qual giram, em unidades de palco.
  • Dê a cada cena uma ou duas coisas em movimento além do zoom: uma entrada, um gesto, uma luz. Uma cena onde nada se move parece um slide.

O motor para com uma mensagem clara quando uma animação não tem segundo de início, quando um seletor não corresponde a nada, ou quando story.json e timing.json não correspondem mais.

Passo 6. Renderize quadros de verificação e observe-os

node SKILL_DIR/scripts/render.mjs ultimo-onibus --frames auto

Isso escreve arquivos PNG em ultimo-onibus/out/check/: o primeiro quadro, um quadro logo após cada corte (-corte), um no meio de cada linha (-meio) e o último quadro. Leia cada linha Nota: que ele imprime.

Abra cada PNG com a ferramenta de Leitura, um de cada vez, em tamanho real. Não pule quadros e não julgue pela lista de arquivos. Em cada quadro, verifique:

  1. Uma cena está na tela, e é a correta para a linha.
  2. A legenda pode ser lida de uma vez. Nada brilhante ou detalhado está atrás dela.
  3. O assunto principal da linha preenche pelo menos um terço da área da imagem.
  4. Nada está no quadro que ainda não chegou. Compare cada quadro -corte com os offsets no seu código de movimento.
  5. Nenhum texto é cortado pela borda de sua caixa ou do quadro.
  6. O relógio mostra o valor que story.json dá para esta linha.
  7. O primeiro quadro já mostra o lugar e o assunto principal.
  8. O último quadro mostra a pergunta, ambas as palavras, ambas as notas e COMENTE UMA PALAVRA.

Passo 7. Corrija e verifique novamente

Corrija o que você viu. Use a lista abaixo. Em seguida, renderize os quadros novamente e observe novamente. Por um momento, você pode pedir segundos exatos: --frames 6.5,7.2. Repita até que cada quadro passe em todas as oito verificações. Olhar uma vez não é suficiente: uma correção frequentemente move o problema.

Passo 8. Renderize o vídeo

node SKILL_DIR/scripts/render.mjs ultimo-onibus

Isso imprime uma linha de progresso a cada 150 quadros e termina com a contagem de quadros e os segundos que levou. O arquivo é ultimo-onibus/out/episode.mp4. --out nome.mp4 altera o nome. --width, --height e --fps alteram o tamanho e a taxa de quadros (padrão 1080 x 1920, 30). Em seguida, confirme que o arquivo tem imagem e som:

ffprobe -v error -show_entries stream=codec_type:format=duration -of default=nw=1 ultimo-onibus/out/episode.mp4

Passo 9. Relatório

Informe ao usuário: o caminho do MP4, sua duração, a premissa, as duas palavras, qualquer coisa que você inventou e qualquer aviso que não pôde remover.

Falhas conhecidas e correções

Estas quatro aconteceram no primeiro episódio feito desta forma. Procure por elas em cada quadro de verificação.

  1. Uma forma está visível antes do início de sua animação de entrada. Você a vê em um quadro -corte: algo que deveria chegar depois já está lá, muitas vezes pendurado em um lugar estranho. No primeiro episódio, uma mala pendurou na frente do rosto de um homem por um segundo antes de cair. Causa: uma animação coloca sua forma na posição inicial a partir do segundo 0, e essa posição estava dentro do quadro. Correção: esconda-a até seu início com show('#l2-mala', l2.start + 1.0) no mesmo segundo da animação, e comece a entrada fora do quadro (y: -1400, não y: -400).
  2. Uma legenda é colocada sobre uma área movimentada. As palavras ficam sobre prateleiras, janelas, um rosto ou formas brilhantes. Correção: mova a legenda para uma banda calma. Defina data-caption-y nessa cena para um y onde o fundo seja uma cor escura plana, ou redesenhe a cena para que y 1290 a 1500 seja calmo. Não torne a legenda menor para caber entre as coisas.
  3. O assunto principal é muito pequeno no quadro. Por exemplo, uma figura humana ocupa apenas um quinto da altura da imagem. Correção: mova a câmera para mais perto. Use um transform no grupo externo da cena para aumentar a escala (scale(1.5)) ou reposicione para que o assunto preencha a área da imagem. Não amplie todo o palco: a legenda e a faixa superior devem permanecer em seus lugares.
  4. A animação de rotação ou escala treme ou está no lugar errado. Causa: svgOrigin está faltando ou está em coordenadas SVG em vez de coordenadas de palco. O palco tem 1920 de altura. Um ponto no meio da tela é svgOrigin: '540 960'. Correção: para qualquer animação de rotação ou escala, adicione svgOrigin em coordenadas de palco.

Notas sobre os parece ser" É "dar prés input

O motor trata os seguintes detalhes. Você não precisa gerenciá-los.

  • Cartão de escolha: aparece no final de lN e desaparece no início do cartão de escolha. O motor desenha a pergunta, ambos choice.a e choice.b, ambas as notas e "COMENTE UMA PALAVRA".
  • Zoom: cada cena tem um zoom lento para frente (padrão 1.06) centrado no centro do palco. Defina data-zoom="1" para uma cena estática.
  • Corte: entre as cenas, um crossfade de 0.2 segundos. O motor o faz.
  • As legendas deslizam com a cena (scroll de paralaxe) para que pareçam fixas no mundo. O motor o faz.
  • Para cada cena, o motor executa sua função show e tween automático para a primeira linha cujo id corresponde ao grupo da cena.

O motor não faz:

  • Verificar se a cena está desenhada corretamente (imagem, tamanho, posição). Isso é sua responsabilidade no Passo 6.
  • Verificar se o story.json tem o formato correto. O voice.mjs verifica.
  • Gerar voz se ela estiver faltando.

Fluxo de trabalho

  1. O usuário fornece um parágrafo de história.
  2. Você escreve story.json.
  3. Você executa voice.mjs e corrige avisos.
  4. Você copia o template HTML.
  5. Você desenha as cenas SVG.
  6. Você escreve o movimento GSAP.
  7. Você renderiza quadros de verificação.
  8. Você corrige e repete.
  9. Você renderiza o MP4.
  10. Você relata o resultado ao usuário.

O usuário pode executar um vídeo de continuação fornecendo o story.json da parte anterior e qual palavra venceu.

Habilidades Relacionadas