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.
- 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.
- 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.
- 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.
- 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." }
}
}
| Campo | O que é |
|---|---|
title | O rótulo na faixa superior. Uma a três palavras. É desenhado em maiúsculas. |
lines[].id | l1, l2, ... na ordem da história. Grupos de cena e código de movimento usam esses ids. |
lines[].say | O que o narrador fala. Uma ou duas frases curtas, 4 a 12 palavras, presente. |
lines[].caption | O que está escrito na tela. A linha reduzida ao seu núcleo, com menos de cerca de 40 caracteres. |
lines[].clock | O 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[].pause | Opcional. 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.b | Uma palavra cada, em maiúsculas. |
choice.aNote, choice.bNote | Duas ou três palavras em minúsculas que dizem o que a palavra significa aqui. |
choice.question | Padrão VOCÊ QUER?. |
choice.say | O 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
sayintegrada. É gratuita.--voice Daniele--rate 172são os padrões. Para uma história em outro idioma, passe uma voz desse idioma (liste-as comsay -v '?'). --provider elevenlabs --voice <voice_id>usa ElevenLabs. Precisa deELEVENLABS_API_KEYe custa créditos ao usuário. Use apenas quando o usuário solicitar.--provider silentescreve 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 atributotransform, 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.
| y | O que vai lá |
|---|---|
| 0 a 182 | Faixa superior: rótulo e relógio. O motor desenha. Mantenha a área atrás dela simples. |
| 250 a 1250 | A imagem. O assunto principal vive aqui e a preenche. |
| 1290 a 1500 | Banda da legenda. Uma cor escura plana atrás das palavras: um balcão, um chão, uma estrada, uma parede. |
| 1560 a 1920 | Coberto 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>').startmais um offset dentro dessa linha.0, o primeiro quadro, é o único número simples permitido. Um segundo definido manualmente como6.4nã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 destarte depois deend. - Apenas animações. Sem
tl.call, semonComplete, semMath.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:
- Uma cena está na tela, e é a correta para a linha.
- A legenda pode ser lida de uma vez. Nada brilhante ou detalhado está atrás dela.
- O assunto principal da linha preenche pelo menos um terço da área da imagem.
- Nada está no quadro que ainda não chegou. Compare cada quadro
-cortecom os offsets no seu código de movimento. - Nenhum texto é cortado pela borda de sua caixa ou do quadro.
- O relógio mostra o valor que story.json dá para esta linha.
- O primeiro quadro já mostra o lugar e o assunto principal.
- 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.
- 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 comshow('#l2-mala', l2.start + 1.0)no mesmo segundo da animação, e comece a entrada fora do quadro (y: -1400, nãoy: -400). - 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-ynessa 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. - 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
transformno 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. - A animação de rotação ou escala treme ou está no lugar errado. Causa:
svgOriginestá 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, adicionesvgOriginem 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
lNe desaparece no início do cartão de escolha. O motor desenha a pergunta, amboschoice.aechoice.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
showe tween automático para a primeira linha cujoidcorresponde 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
- O usuário fornece um parágrafo de história.
- Você escreve story.json.
- Você executa voice.mjs e corrige avisos.
- Você copia o template HTML.
- Você desenha as cenas SVG.
- Você escreve o movimento GSAP.
- Você renderiza quadros de verificação.
- Você corrige e repete.
- Você renderiza o MP4.
- 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.