Communitygithub.com

interactive-storyboard

Transforme um storyboard finalizado em uma **história visual interativa**: uma página web onde o espectador avança a história clicando, segurando e arrastando sobre os próprios desenhos, com som, legendas/diálogos e transições que respeitam o ritmo do filme.

O que é interactive-storyboard?

Esta skill transforma um storyboard finalizado em uma história visual interativa em uma única página HTML. Ela é voltada para pessoas que já conhecem storyboards (quadros, planos, slugs, anotações) e não é um gerador de animatics. O usuário fornece os quadros (PDF ou imagens) e a skill gera uma página onde o espectador interage com os desenhos por meio de gestos como clicar, segurar e arrastar, com som, legendas e transições que respeitam o ritmo do filme original. Ela suporta múltiplos idiomas, diferentes estilos visuais (como filme/risografia, quadrinhos americanos ou pixel art), e sons sintetizados ou gravados. A skill pergunta apenas o que é necessário para a construção (quais cenas, estilo visual, texto, som e idiomas) e assume valores sensatos para o restante. O resultado é uma página HTML autônoma que pode ser compartilhada ou embutida em um site existente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/beiabei10/interactive-storyboard/tree/HEAD/interactive-storyboard

Perguntar na sua IA favorita

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

Documentação

Storyboard interativo

Transforme um storyboard finalizado em uma história visual interativa: uma página web onde o espectador avança a história clicando, segurando e arrastando sobre os próprios desenhos, com som, legendas/diálogos e transições que respeitam o ritmo do filme. É para pessoas que já sabem o que é um storyboard (quadros, planos, slugs, anotações); não é um gerador de animatic.

Exemplos de casos do autor desta skill, Ding Yilin: The Joy of the White Room e Fahrenheit 451 (cenas 1, 8, 9) — veja em examples/; experimente-os ao vivo: The Joy of the White Room, Fahrenheit 451, cenas 1 → 8 → 9.

0. Pergunte antes de construir (uma rodada, depois vá)

Pergunte apenas o que muda a construção; assuma valores sensatos para o restante e informe quais.

  1. Quais cenas / quadros (um storyboard longo: pilote uma cena primeiro, depois faça as outras da mesma forma).
  2. Visual: um dos presets abaixo, ou "manter meus desenhos como estão".
  3. Texto: somente diálogo / narração / ambos / nenhum. Use as falas do próprio storyboard; nunca invente diálogo ou narração.
  4. Som: gravações do usuário (peça os arquivos e a qual quadro cada um pertence) ou som sintetizado.
  5. Idiomas: sempre pergunte quais idiomas a peça precisa; não há conjunto padrão. Construa apenas esses. Cada string na tela (títulos, slugs, dicas, balões, créditos) reside em uma tabela por idioma e é alternável ao vivo; com mais de um idioma, o inicial pode seguir uma página hospedeira (?lang=, um postMessage, ou <html lang>). As traduções que você fizer são rascunhos que o usuário deve verificar.
  6. Onde viverá: apenas uma página compartilhável, ou também embutida no site do usuário (então pergunte pelo pacote do site e edite a cópia deles).
  7. Linha de crédito: use exatamente as palavras que o usuário fornecer (ex.: "Feito por …"); não adicione papéis que ele não listou.

1. Leia o storyboard

  • Storyboarder / exportações PDF: pdfimages -png fornece cada quadro no tamanho completo incluindo a área de NOTA; encontre o quadro de desenho uma vez (varra linhas/colunas em busca das linhas do quadro) e corte todos os quadros da mesma forma para a área de desenho (mantenha uma janela 16:9 se o palco for 16:9). Renderize as páginas com pdftoppm -r 150 e leia as notas, slugs (EXT./INT. … – DIA/NOITE), durações e diálogos; pdftotext -layout obtém os slugs.
  • Faça uma folha de contato e uma vista gradeada (linhas a cada 0,1 da largura/altura) de cada quadro: toda coordenada posterior (onde uma figura está, onde tocar, onde uma tela está) é medida nestas, em frações da imagem, nunca adivinhada.
  • Escreva uma lista de batidas: quadro → o que acontece → o gesto que faria o espectador realizar essa ação → som → texto.

2. Planos antes de efeitos

  • Encontre as tomadas longas. Quadros consecutivos com a mesma configuração e sujeitos em movimento (A→B→C de pessoas andando) são uma tomada contínua: construa um fundo limpo (remova o sujeito usando os outros quadros), recorte o sujeito e mova-o, com a câmera acompanhando. Não faça cross-dissolve de quadros inteiros aqui.
  • Plano fechado → plano aberto dos mesmos sujeitos (ou o inverso) é um movimento: enquadre o quadro aberto ampliado para que seus sujeitos tenham o mesmo tamanho e posição que no quadro fechado (calcule o zoom e o centro a partir das posições medidas da cabeça/pés), finalize o cross-fade nesse enquadramento correspondente, então recue. Verifique o quadro correspondente em uma captura de tela; fantasmas significam que os números estão errados.
  • Quadros que devem ser lidos como um movimento compartilham uma paleta (processe-os com a mesma cor predefinida).
  • Quando o usuário disser que um quadro mostra a parte de trás de uma TV, uma porta vista por trás, etc., não desenhe nada que o quadro não mostre: luz e som podem sugerir o que está fora da tela.

3. Presets visuais

Todos os presets mantêm o desenho a traço do usuário; nunca o redesenham.

  • Filme / risografia (o visual da White Room): gradagem por cena (cor brilhante e saturada contra escuridão), textura suave de papel, grão leve; oscilação de quadro, cintilação e arranhões sutis ocasionais — não constantes; uma sombra de registro. Efeitos são raros e silenciosos: cintilação ou tremor constantes cansam.
  • Quadrinho americano: suavização bilateral; uma camada de tinta a partir de um limite escuro mais black-hat para que traços finos a lápis sejam entintados; uma cor chapada plana nas áreas desenhadas, pontos Ben-Day a 45° nos meios-tons e uma tela clara sobre todo o painel, mais densa nas bordas; a placa de cor deslocada 1–2 px da placa de tinta; saída ~1,5×. Uma cor chapada por local/horário (dia quente, noite azul, CCTV verde, alarme vermelho…). Lettering: caixas de legenda amarelas para slugs, palavras SFX em quadrinhos na imagem, balões de fala para diálogo.
  • Pixel: reduza para uma grade pequena com uma paleta limitada e dithering ordenado, amplie com nearest-neighbour; texto em fonte pixel.

A cromática da página segue o preset (sala de projeção, página de jornal, tela de jogo). As fontes web carregam com uma corrida de fallback de 2–3 s para que a história nunca espere por elas.

4. Construção: uma página HTML, um canvas

  • Um palco 16:9, um canvas, uma área de legenda/dica abaixo dele, um seletor de idioma (se houver mais de um) e um botão de som.
  • Máquina de estados de cena: cada cena é um objeto com enter / render(t) / tap / drag / down / up / hover / key; go(cena) alterna; st() é o tempo na cena. Um auxiliar de câmera (setCam(img, zoom, cx, cy), toScreen, toImg) para que toda área de clique e efeito seja posicionada em frações da imagem e siga a câmera.
  • Toda cena tem uma saída: uma tecla de atalho e um fallback automático lento (10–20 s) para que ninguém fique preso, além de um link "pular" nas cenas longas.
  • Envolva toda chamada de som para que um contexto de áudio ausente ou uma decodificação falhada nunca quebre a história.
  • Carregue imagens com <img> (funciona também em file://); áudio via fetch + decodeAudioData, com fallback para elementos <audio> quando fetch estiver bloqueado.

5. Design de interação

  • O gesto é a ação da história. Correr = cliques rápidos; prender a respiração = não tocar; inclinar-se para olhar = segurar; escalar = arrastar repetidamente para cima; entregar algo = carregá-lo; virar uma página = arrastar sobre o livro; desligar = segurar na mão sobre o botão. Prefira estes gestos a "clique para continuar" genérico; mantenha toques simples para diálogo e para batidas que são puro ritmo.
  • Carregue o desenho do próprio usuário, nunca um adereço inventado. Recorte a figura/objeto ao longo de seu contorno (polígono traçado no zoom gradeado, borda suave), adicione uma fina borda branca como um recorte de papel, levante com uma pequena sombra e incline enquanto arrasta, deixe o papel vazio onde estava, encaixe de volta se soltar no lugar errado. Verifique o recorte em relação ao quadro: não inclua escadas, móveis ou a mão de outro personagem por engano.
  • Efeitos adicionados sobre um quadro (uma tela acendendo, ondas de rádio, um visor) devem seguir a geometria do desenho — recorte um brilho de tela ao quadrilátero de perspectiva da tela, não a um retângulo — e devem ser apontados ao usuário como adições.
  • Dicas dizem onde e como: "Segure no peixe e rabisque para frente e para trás", não "interaja". Maior que o corpo do texto, sob a imagem.
  • Guias na imagem, silenciosas por padrão (pense em What Remains of Edith Finch): um pequeno sinal no ponto de toque que já diz a ação — um pulso para toque, um anel preenchendo para segurar, chevrons fluindo na direção do arrasto, um arco giratório para circulação (no estilo quadrinho: marcas de tinta "olhe aqui"). Uma mão demonstra o gesto duas vezes quando o passo começa, então recua; ela retorna somente após ~3 s de hesitação. Esconda tudo enquanto o dedo estiver pressionado. Nunca cubra a imagem com longos caminhos tracejados.

6. Transições

  • Combine com o tom: suave por padrão (dissolves onde o novo painel se assenta de um pouco maior, tinta-saindo/tinta-entrando, um leve bloom para uma TV ligando ou um fogo pegando). Mantenha um corte seco (quadro negativo, linhas de velocidade, tremor) para o único choque da cena. Todos os cortes secos = rígidos.
  • Um avanço contínuo para o próximo espaço é um movimento longo: o que estiver entre eles (uma parede) pega a cor e textura do painel de destino e se funde nele; sem calhas no meio de um movimento.
  • Nunca mostre as bordas pretas de uma imagem girada ou ampliada: trave a câmera.

7. Som

  • Som gravado: corte para a ação (uma porta abrindo sincronizada com a maçaneta desenhada), nivele tudo, loop de ambientes com fades.
  • Som sintetizado (WebAudio, sem arquivos): passos, papel, portas, cães mecânicos, alarmes, batimentos cardíacos, murmúrio de TV… Randomize cada batida (tempo, tom, envelope) e modele envelopes de forma irregular para que nada soe repetido por máquina; evite cliques e bipes secos em cenas silenciosas.
  • Use pontes sonoras para significado (uma máquina de lavar se tornando lentamente o mar do sonho; um som continuando sobre o título). Pergunte antes de adicionar sons que o storyboard não implica.

8. Texto

  • Diálogo: balões de fala (quadrinhos) ou legendas (filme), rabo apontando para a cabeça do falante, mantido dentro do painel, quebrado medindo, nunca começando uma linha com pontuação de fechamento. Preencha o corpo e o rabo de cada balão separadamente para que nenhum traço cruze o texto.
  • Slugs como caixas de legenda no canto; mantenha-os fora de desenhos importantes (pule a legenda em um quadro onde cobriria o sujeito).
  • Citações que você adicionar (ex.: o que personagens recitam) devem ser de domínio público e sinalizadas ao usuário.

9. Performance

  • Limite o canvas a ~1600 px de largura (DPR = max(1, min(devicePixelRatio, 2, 1600 / cssWidth))).
  • Pré-renderize sobreposições estáticas (textura de papel, vinheta) uma vez por tamanho e aplique-as em cada quadro; nunca reconstrua gradientes ou padrões por quadro.
  • Para dissolves, mantenha o quadro anterior na metade do tamanho, não uma cópia completa a cada quadro.
  • Carregamento preguiçoso da história na página hospedeira (pôster + botão "Entrar na história"); cada página de cena carrega apenas suas próprias imagens.

10. Teste como um espectador

  • Uma execução em navegador headless (ex.: Playwright) com gestos reais de mouse (cliques, segurar, arrastar medidos a partir de toScreen) através de toda a história, em todos os idiomas, falhando em qualquer erro de página. Exponha um __go(cena, estado) somente para teste para pular para uma batida.
  • Capturas de tela de cada quadro-chave e do meio de cada transição/combinação; olhe para elas.
  • Verifique a sintaxe do script após edições (node --check). Não coloque comentários // no meio de uma instrução de uma linha (isso comenta silenciosamente o resto da linha e a página fica em branco).
  • Meça a taxa de quadros antes/depois de mudanças pesadas. Diga claramente que o som e a sensação foram verificados por medição e capturas de tela, não por reprodução.

11. Entrega

  • Uma página hospedada compartilhável para revisão; para o site do usuário, um zip do pacote do site deles com a história em sua própria pasta (ex.: story/<projeto>/), um bloco de incorporação com carregamento preguiçoso, e nada mais alterado. Se o usuário adaptou a história dentro de seu site, sempre edite essa cópia (faça merge de 3 vias de suas alterações nela), nunca sobrescreva com o original.
  • Várias cenas: uma página por cena compartilhando uma pasta de assets, encadeada (fim da cena → próxima cena, idioma mantido; a última retorna à primeira). A capa de cada cena precisa de um clique para desbloquear o áudio após a navegação.
  • Nunca implemente nada em nome do usuário; entregue o zip.
  • Um único arquivo aberto por conta própria ficará preto: a página precisa da pasta de assets a/ ao lado dele. Diga isso ao entregar os arquivos.

Habilidades Relacionadas