Shorts animados 3D (three.js + Remotion)
Primeiro: escolha o estilo e acompanhe a pessoa
Quando alguém abrir a skill pela primeira vez ou não tiver escolhido um estilo, explique de forma breve que este pacote inclui dois caminhos e mostre os dois exemplos antes de pedir que escolha:
- Animação 3D realista com Blender: cenas criadas com modelos, materiais, luzes e câmera 3D, por exemplo animações explicativas de anatomia. O exemplo mostra um ferimento com pontos: avise antes de mostrá-lo. Ver imagem · Ver vídeo do Blender (pré-visualização de 9 s, sem áudio).
- Cartoon animado: personagens planos de cartoon em cenários 3D coloridos. É criado com código usando Three.js e Remotion. Ver imagem · Ver vídeo de Alexandre o Grande (pré-visualização de 9,8 s com áudio).
Se o ambiente permitir mostrar imagens ou reproduzir vídeos, mostre ambos os exemplos diretamente no chat; caso contrário, forneça links ou caminhos completos para os arquivos locais para que a pessoa os abra. Não afirme que foram mostrados ou reproduzidos se o ambiente não tiver conseguido fazer. Pergunte "Qual estilo você quer: realista com Blender ou cartoon?" e aguarde a resposta antes de instalar ou preparar ferramentas. Se já tiver indicado claramente o estilo, respeite e evite perguntar novamente.
Fale em português simples. Pergunte uma coisa por vez quando a pessoa for iniciante, explique qualquer termo técnico e acompanhe a instalação sem presumir que ela sabe programar. Verifique sistema operacional, programas disponíveis e requisitos da rota escolhida; explique as opções e possíveis custos antes de o usuário escolher fornecedores externos de voz ou outros serviços. Não solicite chaves no chat. O pacote contém modelos, não um vídeo acabado nem um projeto que funcione automaticamente ao ser baixado.
Depois peça a ideia e a duração. Ajude a preparar e revisar roteiro, voz e cenas; gere avanços e deixe espaço para a pessoa indicar correções. Continue para o render e verifique se foi produzido um MP4 com imagem e áudio quando as ferramentas e recursos estiverem disponíveis. Não prometa qualidade ou resultado automático: se faltar algo, explique o que está pendente e como resolver. Siga realista/REALISTA.md apenas para Blender; para cartoon siga o processo abaixo.
Entrega simples no Mac e Windows
Estas instruções são para você, Claude: acompanhe a pessoa sem obrigá-la a ler arquivos técnicos. Detecte o sistema operacional e pergunte onde ela quer salvar o projeto (por exemplo, uma pasta da sua Área de Trabalho); use a localização real que ela indicar, sem presumir que a Área de Trabalho se chama Desktop nem que está fora do OneDrive ou iCloud. Mantenha juntos os arquivos necessários, a narração, o projeto editável e a saída, sem copiar credenciais ou arquivos alheios. Se já entregou roteiro ou áudio, use-os e não peça novamente. Avise se faltar algo imprescindível.
Para Windows prepare na pasta escolhida um RENDERIZAR.bat; para Mac, um RENDERIZAR.command executável. Adapte-o ao projeto e ao motor selecionado: Blender para realista; Remotion para cartoon. Ao dar duplo clique, deve verificar se existem os programas e arquivos necessários, iniciar o render, indicar o progresso, parar e mostrar o erro se algo falhar, e manter a janela aberta com o caminho do resultado. Use caminhos relativos ao próprio projeto e admita espaços. Não apague projetos ou quadros existentes; evite misturar quadros de renders diferentes. Crie o MP4 final com a narração quando existir e verifique imagem, áudio e duração. Se houver um problema, não o anuncie como finalizado.
No Blender detecte e teste a GPU disponível: Metal no Mac; OptiX ou CUDA para NVIDIA no Windows, HIP para AMD e OneAPI para Intel, de acordo com o suporte real da versão do Blender. Confirme no registro o dispositivo que realmente está sendo usado; se não funcionar, explique a causa e ofereça CPU, sem afirmar que a GPU funcionou. A exportação do Remotion é diferente: não garanta que toda a codificação use a placa gráfica. Antes de entregar o lançador, execute um teste pequeno quando o ambiente permitir; se não puder testá-lo no sistema do usuário, diga isso claramente. O tempo para preparar e renderizar varia, não prometa dez minutos.
Skill de Cria com LuisPa, em português. É baseada na skill gratuita claude-animated-shorts de Mr omi (licença MIT): o motor, os modelos da ponte e os relatórios de medição são dele. O novo desta versão: tudo em português, o short de Alexandre o Grande como segundo exemplo completo (batalha, multidões enormes, câmera lenta, brasas), a ferramenta para medir qualquer short a 30 quadros por segundo e as regras que saíram da correção desse short.
Exemplos testados:
- Alexandre o Grande em Gaugamela (
modelos/alexandre/, composiçãoAlexandre, 1080x1920, 30 fps, 9,8 s). Roteiro emmodelos/alexandre/ROTEIRO_alexandre.md. - A ponte que caiu por uma música (
modelos/ponte/, 67 s, em inglês), de Mr omi.
O estilo foi estudado medindo 20 shorts de um canal de referência (referencias/). Esses quadros são apenas para
estudar o estilo:
- Nunca copie seus roteiros, personagens nem tomadas. História, personagens e voz são sempre seus.
- Não suba nem publique seus vídeos. Não diga o nome do canal na voz nem na descrição.
Shorts 3D realistas (Blender)
Se pedirem para parecer real (pele, ferimentos, pontos, corpo humano, "render do Blender"), NÃO use three.js:
siga realista/REALISTA.md. Lá está o processo, cada peça (pele, ferimento, linha, pelo, luz), os erros que já
surgiram e como diminuir o tempo de render. Há dois exemplos completos: realista/blender/pontos_braco/ (9 s) e
realista/blender/pontos_perna/ (31 s). A câmera é medida com realista/ferramentas/camera_fase.py.
Regras do estilo
- Voz em português, uma única voz uniforme, corrida: 3,2–3,8 palavras por segundo, quase sem silêncios.
- Sem legendas na versão principal (o estilo de referência sai sem elas). Se quiser uma versão com legendas, faça-a à parte.
- Nada de retângulos, sublinhados nem setas sobre os personagens. Um número importante (ex.: "47.000") vai discreto, no alto do quadro, sem tapar ninguém.
- As piadas e dados são fatos reais pesquisados, com sua fonte.
- Mixagem: voz na frente; música e efeitos de 5 a 10 dB abaixo; -14 LUFS no final.
- Exporte vertical 1080x1920 (ou 1440x2560 com
--scale 1.3333). - Salve após cada passo. Uma vez aprovado o roteiro, faça-o corrido.
Processo
- Tema e dados. Uma história real e surpreendente com causa e efeito que possa ser vista, mais uma comparação
cotidiana que a explique. Escreva os dados com sua fonte no início do
ROTEIRO.md.- Se os números variarem (fontes antigas contra historiadores modernos), use a estimativa moderna e diga isso.
- Roteiro (fórmula de
referencias/BIBLIA_DE_ESTILO.md):- Gancho: o dado absurdo em uma única frase, sem introdução.
- Lugar e época: ano, lugar, orgulho.
- Escalada: três ou quatro momentos, cada um maior.
- O momento em que se quebra.
- Linha dupla seca: "Por sorte… / Por azar…".
- Explicação com uma comparação cotidiana, entrando com um giro fixo ("Repare…").
- Consequência e remate com surpresa. O vídeo termina na última palavra.
- Nunca descreva com a voz o que já está sendo visto.
- Voz. Grave ou gere
voz.wave extraia os tempos por palavra parapalavras.json(qualquer transcritor com tempos por palavra). Corrija os tempos manualmente: tudo é sincronizado com esse arquivo. - Plano de tomadas em
story.ts. Copie o modelo mais parecido (modelos/alexandre/para batalhas e multidões,modelos/ponte/para povo e personagens que caminham) parasrc/videos/<nome>/e registre-a emsrc/Root.tsx(vermodelos/alexandre/Root_exemplo.tsx).SHOTS: cada tomada com seus quadros a/b e suas chaves de câmera{f, pos, look, fov, glide}.XFADE: fade de 6 quadros quando muda o lugar.- Cada reação na tela cai 0–3 quadros antes de sua palavra. Anote os quadros de cada palavra acima de
story.ts.
- Mundo.
lights.ts: luzes e paleta de céu/neblina por tipo de luz.shade.ts: sombreamento de dois tons.paint.ts: texturas pintadas com Canvas2D (chão, nuvens, madeira, pedra), com as junções pintadas escuras.world.ts: céu, neblina na cor do horizonte, poses por quadro. Em Alexandre também: chão queimado, fumaça, flechas acesas cravadas, montanhas com neve e brasas flutuantes (Points).
- Personagens.
toon.ts: a API de desenhoPen(tela 600x1000, pés em y = 975, cabeças de feijão, membros de palito, contorno ameixa de espessura variável, biblioteca de rostos).- Em Alexandre foram adicionadas vistas de frente (
horseFront,rideFront,chariotFront), cavalo, elefante, carro de guerra, a opção de levantar armas e a cara de grito. - Multidões:
troop.ts+crowd.tsdesenham milhares de soldados em um atlas e os distribuem no campo (100 mil desenhos, cada um em seu lugar). Todos os personagens vão na camadaNOINK. cardshade.ts: os personagens recebem a luz da cena (não brilham sozinhos) e projetam sombra.
- Pós (
Alex.tsx/Bridge.tsx+ink.ts+lensblur.ts+grade.ts). Ordem: contorno → desfoque → bloom → mapeamento de tom NEUTRAL → correção de cor (MSAA 4). Todo valor em pixels escala com altura / 1920. - Som.
- Opção A (ponte): tudo sintetizado com
modelos/audio/(efeitos e música original sob a voz). - Opção B (Alexandre): efeitos gravados de sua biblioteca com licença, colocados para que seu pico caia em
seu quadro (
modelos/alexandre/mixagem_exemplo.py). Um fogo que crepita ao fundo, whoosh em cada movimento de câmera, impacto em cada número, whoosh lento e grave na câmera lenta. - Nada de pops de bolha repetidos nem efeitos de cartoon baratos.
- Fixe os tempos da imagem antes de fazer o som.
- Opção A (ponte): tudo sintetizado com
- Revisão do visual. Tire fotos avulsas:
node modelos/scripts/fotos.mjs out/x_ 20,100,200 0.5. Coloque-as junto a quadros dereferencias/quadros/compython modelos/scripts/sbs_sheet.pye revise. - Medição. Meça seu render igual à referência:
python ferramentas/medir_30fps.py out/video.mp4 out/medida. Tire folhas de 60 quadros, cortes, % de quadros com a câmera em movimento, brilho, contraste e saturação. Meta: câmera se movendo em mais de 80% dos quadros e 0–1 cortes duros. - Render final.
npx remotion render src/index.ts <Composição> out/video.mp4 --codec h264 --crf 16e junte o áudio com-map 0:v:0 -map 1:a:0(Remotion escreve uma faixa de áudio muda). Revise cada quadro compython modelos/scripts/short_qa.py final.mp4 out/qa shots.json.
O que aprendemos com Alexandre (revise em cada short novo)
- A primeira versão sempre sai "bonita, de dia de campo". Se a história é uma guerra, que se veja guerra: luz laranja de fumaça, chão queimado, flechas ardendo, carros quebrados. Nada de um ambiente feliz.
- A tomada aérea muito alta (570 m) parece puro ruído. Para que se entenda o tamanho de um exército, baixe a
câmera e coloque-a alta atrás de um bando olhando para o outro (em Alexandre:
[0,60,-110] → [0,0,90], fov 58). - Um exército enorme nunca deve terminar dentro do quadro. Se se vê o fim dele, parece pequeno.
- Apresente cada protagonista de frente, passe a câmera na frente dele e coloque-a entre seu povo; depois suba para mostrar quantos são. Ao passar, seus soldados levantam as armas e gritam (a primeira fila primeiro).
- Câmera lenta no momento forte: o relógio do mundo corre a 22% (
worldFemstory.ts), com um som grave e lento. Entre e saia suave. - Brasas de fogo flutuando perto da câmera dão profundidade e vida a qualquer tomada de batalha.
- A câmera nunca fica parada: cada pausa leva uma aproximação lenta. Um trecho de 12 quadros sem movimento parece um vídeo travado.
- Antes de renderizar, revise quadros avulsos de cada tomada: câmeras presas dentro de uma casa, árvores verde-azuladas, uma corrente ou um objeto bem na frente dos rostos.
- Peça para compará-lo contra a referência por áreas (cor, contorno, luz e sombra, texturas, personagens, profundidade, movimento) com números, não com opiniões. Uma opinião não se pode recriar; um número, sim.
Valores finais do visual (da ponte, após 4 rodadas de revisão)
- Luz (
lights.ts, sol fixo por tomada e relativo à câmera):- dia: az 75 / el 48, luz [1,58;1,5;1,33], sombra [0,30;0,29;0,36], matiz frio SOMENTE na sombra; céu #3e7fd2 → horizonte #b8d0ec; neblina = horizonte, 25→300 m.
- entardecer: sol baixo contraluz (az 6 / el 7), luz #FFB36B ×1,5, sombras violeta-azul (nunca marrons), céu #ffc47c → #8a6f8a.
- Contorno (
ink.ts): #030303, 5,1 px de perto (6 m) → 3,3 px de longe (90 m) a 1080x1920. Os personagens não levam o contorno do mundo: trazem seu próprio contorno ameixa. - Desfoque (
lensblur.ts+dofAt): primeiros planos 12–16 px, planos médios 10–12, tomadas abertas 0. Foco nos olhos da primeira fila. - Personagens: cabeça de feijão (altura/largura 0,94), contorno ameixa #241726, olhos a 0,26 da largura, sem bochechas; adultos de 3,5 cabeças; piscar a cada 0,5–2,3 s; sombra de contato sob os pés.
- Câmera: cortes apenas em saltos grandes; o resto, deslizamentos suaves (smootherstep) de 18–40 quadros; sacudidas em impactos que mudam de sinal a cada quadro e se apagam em 7; giros de 4–4,6°.
- Cor de referência: br
…
[truncado para tradução]