Communitygithub.com

stage3d-shorts

Crie um curta animado vertical (1080x1920, 30 fps) no estilo "palco preto" 3D, a partir de um roteiro com timings de palavras até um MP4 finalizado. Use para qualquer novo curta neste estilo, independentemente do tema. O visual reside em um kit que um vídeo não pode alterar; um vídeo é um arquivo de plano.

O que é stage3d-shorts?

A skill `stage3d-shorts` permite gerar curtas animados verticais (1080x1920, 30 fps) no estilo "palco preto" 3D, com figuras brancas tipo pílula, props desenhadas com linhas de néon e um spotlight teatral. O visual é encapsulado em um kit (`kit/src/`) que o vídeo não pode modificar — o vídeo é apenas um plano (`kit/plans/<nome>/plan.js`) que importa a API do kit. A skill foi desenvolvida para reproduzir o look icônico de vídeos de referência (medidos e melhorados, nunca copiados) e é adequada para qualquer tópico de curta. Ela suporta renderização local (com GPU para velocidade) ou em nuvem, e exige que o roteiro venha com timings de palavras no formato JSON. O pipeline inclui etapas como verificação de fatos, quebra do roteiro em estações, escrita do plano, mixagem de áudio, renderização de stills para verificação visual, e por fim a renderização completa com controle de qualidade automatizado via `qa.py`. A skill é compatível com sistemas Windows (pasta `C:\Users\Pimbo\work\anymation\stage3d\skill`) e requer Node.js, ffmpeg, Python com numpy/opencv para QA, e scipy para áudio. Ela já foi testada em clipes curtos (9,7 s e 5 s), mas ainda não em vídeos completos — o guia alerta sobre limitações atuais, como falta de transições de fade/corte, gráficos de barras e mais de um spotlight por estação.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pimboto/claude-skills/tree/HEAD/skills/stage3d-shorts

Perguntar na sua IA favorita

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

Documentação

stage3d shorts

Um palco escuro com piso espelhado. Figuras brancas planas em forma de pílula, adereços desenhados com linhas de néon, um holofote teatral sobre a pessoa, uma câmera que se move em 3D real, uma palavra de legenda por vez. O visual foi obtido por engenharia reversa a partir de medições de vídeos de referência (material de estudo privado: nunca copie seu conteúdo, nomes ou roteiros) e depois melhorado.

Status: v0.1. Comprovado em um clipe de 9,7 s com duas estações (pricetag_demo) e um teste de 5 s (test5). Ainda não comprovado em um vídeo de tamanho completo. Leia "O que o kit ainda não tem" antes de prometer uma cena.

A ideia

  • O kit é o visual. kit/src/ contém cores, brilho, lente, piso, luz, curvas de câmera, legendas. Um vídeo nunca o edita.
  • Um vídeo é um plano. kit/plans/<nome>/plan.js diz o que está no palco, quando cada coisa acontece e como a câmera se move. Ele importa apenas kit/src/api.js. A construção recusa um plano que acesse o visual.
  • Números decidem, não opiniões. Cada renderização é medida por scripts/qa.py. Um vídeo que falha não é entregue.

Onde o kit reside

Esta skill é apenas instruções. O código que desenha o vídeo e os arquivos de referência estão em uma pasta no PC do Pimbo: C:\Users\Pimbo\work\anymation\stage3d\skill (contém kit/, references/ e uma cópia deste arquivo). Todo caminho nesta skill é relativo a essa pasta.

  • A pasta anymation deve estar conectada à conversa. Se não estiver, peça ao Pimbo para conectá-la: sem o kit nenhum vídeo pode ser feito, e nada aqui deve ser reconstruído de memória.
  • O Pimbo não executa scripts manualmente. Você os executa. Ele dá o tópico ou a pasta do vídeo, olha os stills e aprova.
  • As entradas de um vídeo vêm do pipeline dele: anymation/v2/v8/<video>/ (script.json, asr_<lang>.json para os timings das palavras, premix_<lang>.wav para voz e música, events_<lang>.json).
  • Se você puder executar comandos no PC dele, trabalhe na própria pasta. Se você tiver apenas um espaço de trabalho em nuvem: copie stage3d/skill para ele (deixe de fora node_modules, out e dist), execute npm install dentro de kit/, escreva o plano e renderize stills lá (cerca de 2 s cada sem placa de vídeo), mostre os stills a ele, depois escreva a pasta kit/plans/<nome>/ finalizada de volta na pasta dele.
  • A renderização final pertence ao PC dele: a placa de vídeo dele é cerca de 20 vezes mais rápida que uma máquina em nuvem. Se você não puder executar comandos lá, deixe um arquivo .cmd em stage3d/skill que execute node scripts\make_video.cjs <nome> --gpu --workers=4 a partir de kit, peça a ele para dar duplo clique e colar o que imprimir. Leia as linhas de QA antes de considerar o vídeo finalizado.

Regras que não são negociáveis

  1. Nunca edite kit/src/ para fazer um vídeo funcionar. Se um adereço ou tipo de tomada estiver faltando, adicione-o ao kit como uma parte reutilizável (veja references/PLAN_GUIDE.md, "Adicionando um adereço") e re-verifique pricetag_demo depois.
  2. Todo número de quadro em um plano vem do áudio real (tímings de palavras), nunca de um palpite.
  3. Todo movimento de câmera tem uma razão que você pode dizer em uma frase. Escreva essa frase como um comentário acima do movimento.
  4. Olhe os stills antes de renderizar um clipe. Olhe a imagem, não o código de saída.
  5. Diga o que foi medido e o que foi assumido. Se você não verificou algo, diga.
  6. Uma pessoa ouve o áudio antes de um vídeo sair: esses scripts definem níveis por números.

Pipeline

Trabalhe dentro de kit/. Primeira vez em uma máquina: npm install (three, esbuild, playwright-core; usa o Chrome ou Edge instalado, nada mais é baixado). A renderização precisa do ffmpeg no PATH; o QA precisa de Python com numpy e opencv (pip install numpy opencv-python); os scripts de áudio precisam de scipy.

EtapaO quêComando ou arquivo
1Roteiro e voz, com um timing para cada palavrafora desta skill; resultado: words.json = [{ w, t0, t1, line }], segundos
1bVerifique cada fato do roteiro no dia, antes de gravar a vozpesquisa na web; escreva SOURCES.md junto ao plano (exemplo: plans/no_trick/SOURCES.md)
2Divida o roteiro em estações: uma frase ou ideia cadaanotações no topo de plan.js
3Escreva o plano: construir, animar, câmerakit/plans/<nome>/plan.js; comece a partir de pricetag_demo
4Áudio: mix base mais efeitos nos eventoskit/plans/<nome>/make_audio.py -> audio.wav
5Verificar e construirnode scripts/build.cjs <nome>
6Stills nos quadros-chave; corrija o enquadramento; repitanode scripts/render.cjs <nome> stills 0,17,62,88
7Veja-o se mover com somabra kit/dist/<nome>/preview.html em um navegador
8Renderizar, codificar, QA de uma só veznode scripts/make_video.cjs <nome> --gpu --workers=4
9Leia as linhas de QA; um FALHA significa corrigir e repetirkit/out/<nome>/logs/qa.log, qa.json

A etapa 8 imprime uma linha por etapa. Em um PC com placa de vídeo, um vídeo de 5 s leva cerca de 10 s; sem uma (omitindo --gpu) cada quadro leva cerca de 2 s, então renderize lá apenas o que for necessário.

Escrevendo um plano, em resumo

Guia completo e a lista de partes: references/PLAN_GUIDE.md. O exemplo trabalhado é kit/plans/pricetag_demo/plan.js.

  • O palco é uma fileira de estações com 14 m de distância. Uma frase ou ideia por estação. A câmera permanece em uma estação para uma tomada e faz panorâmica chicote para a próxima entre as frases.
  • build(stage) cria as coisas e as coloca: stage.station(i).add(thing). Figuras ganham um holofote: stage.station(i).spotlight(figure).
  • animate(f, o) define onde tudo está no quadro f. Deve ser uma função pura de f: os quadros são renderizados em qualquer ordem e em paralelo. Sem estado carregado de um quadro para o próximo, sem Math.random, sem relógio.
  • As coisas aparecem na sua palavra: pop(thing, f, wordFrame). Um número que importa é executado enquanto está sendo falado. Algo que aterrissa ganha um anel de piso (pulse), um curto flare e um som.
  • Cores apenas por nome. Dourado = a coisa valiosa. Vermelho = preço, custo, perigo. Branco = pessoas e rótulos neutros.
  • Texto que muda (um contador) precisa de maxChars para que sua caixa não redimensione.

Câmera, em resumo

Regras completas com as medições por trás delas: references/CAMERA_RULES.md.

  • Uma tomada tem um movimento, às vezes dois ou três. Entre movimentos a câmera segura (o kit adiciona um rastejar lento).
  • Existem apenas três tipos de movimento: hook (aproximação de abertura, a partir do quadro 0), reframe (20-28 quadros, entre duas frases, aterrissa alguns quadros antes da nova coisa aparecer), slow (uma aproximação ou órbita por toda uma tomada).
  • Enquanto um gráfico anima, a câmera segura. Uma lista ganha um deslocamento; uma afirmação mais ampla ganha um recuo; um objeto por uma linha longa ganha uma órbita lenta.
  • Uma visão 3/4 (guinada em torno de 35-40 graus) é o que mostra profundidade. Use-a quando um segundo objeto precisar de espaço.
  • Panorâmicas chicote apenas entre ideias. Cada uma precisa de um whoosh no áudio que começa cerca de 3 quadros antes.

Portões de qualidade

scripts/qa.py reprova o vídeo se: um quadro está faltando ou congelado; o fundo não é o preto levantado; o hook ou um reframe não está carregado na frente; a câmera não segura entre movimentos; uma panorâmica chicote não se move ou não escurece; o MP4 não é h264 / yuv420p / BT.709, tem o número errado de quadros, ou seu áudio está faltando ou com o comprimento errado.

Ele não verifica gosto, corte nas bordas do quadro, ou se as legendas dizem as palavras certas. Estes são verificados nos stills, a olho, antes da renderização: nada importante cortado pela borda do quadro, a faixa de legenda (75-83 % da altura) livre de linhas brilhantes, figuras entre 25 % e 85 % da altura (a lente estica coisas perto das bordas).

Após qualquer alteração em kit/src/: reconstrua pricetag_demo, renderize os stills 0,17,88,150,174,236 e compare-os com references/frames/. Na renderização por software eles devem corresponder exatamente; em uma placa de vídeo, dentro de cerca de 1 nível.

O que o kit tem

Figura (pessoa pílula com headset), pílula de rótulo, cartão com um rótulo e um grande valor, token, baú que abre (dourado, ou um cinza simples para uma multidão de baús), bússola redonda com agulha, faixa de bússola de uma tela de jogo, moldura de contorno (uma tela, uma miniatura), dado, botão de play, marcas de talha, guia tracejada, imagem (um SVG ou PNG preto e branco desenhado como luz), anel de piso, linha de chão tracejada, partículas flutuantes, holofote teatral com poça de luz no chão e sombra, poças de luz coloridas no chão, halo, raios, faíscas, panorâmica chicote com desfoque de movimento, legendas, uma biblioteca de sons (whoosh, tick, ding, thud, clunk, sparkle, fizz) e um mixer que coloca um arquivo de voz e um arquivo de música sob eles.

Dois planos para ler: pricetag_demo (10 s, duas estações, o visual aprovado) e no_trick (47 s, cinco estações, um curta completo com sua voz, música e fontes). starts_clean (62 s, seis estações) é branco até um único payoff dourado, como as regras de roteiro do Pimbo pedem. avatar não é um vídeo: ele faz stills para uma foto de perfil.

O que o kit ainda não tem

  • Um deslocamento ao longo de uma fileira de coisas (para listas), barras e gráficos de linha.
  • Mais de um holofote em uma estação: não testado (as partículas são iluminadas por no máximo dois holofotes por vez). Várias figuras em uma estação funcionam com um holofote e as outras escurecidas (no_trick, estação 2).
  • Fades ou cortes: a única transição é a panorâmica chicote.
  • Close-ups: a câmera precisa do chão sob seu sujeito dentro do quadro e perde a mira a menos de cerca de 2 m. Uma imagem mais próxima é recortada de uma mais ampla (plans/avatar).
  • Mais do que os três tipos de movimento, e qualquer rotação de câmera.
  • Voz, música e timing de palavras: eles vêm de fora (o pipeline v2/v8 do Pimbo os faz).

Cada um destes tem que ser construído no kit e testado em um vídeo real antes que um plano possa usá-lo.

Arquivos

CaminhoO que é
kit/src/O visual. api.js é o único arquivo que um plano importa
kit/plans/<nome>/Um vídeo: plan.js, words.json, make_audio.py, audio.wav
kit/scripts/build.cjs, render.cjs, encode.cjs, make_video.cjs, qa.py
kit/audio/sfx.pyEfeitos sonoros e mixer
references/STYLE_BIBLE.mdCada número do visual, marcado como medido, nosso ou palpite
references/CAMERA_RULES.mdComo a câmera é editada, com as medições
references/PLAN_GUIDE.mdComo escrever um plano; toda função de api.js; adicionar um adereço
references/KNOWN_ERRORS.mdErros já cometidos uma vez, e o que agora impede cada um
references/frames/Quadros alvo de pricetag_demo

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas