Communitygithub.com

shorts-animados-3d

Cria shorts verticais animados em dois estilos: cartoon 2D em mundo 3D com Three.js e Remotion, ou animação 3D realista com Blender. Use quando pedirem a skill de shorts do LuisPa, um vídeo como o do Alejandro ou da ponte, ou animações realistas como as de pontos em Blender.

O que é shorts-animados-3d?

Esta skill permite criar dois tipos de short vertical animado: animação 3D realista com Blender (cenas com modelos, materiais, luzes e câmera 3D, como explicações de anatomia) ou animação cartoon 2D em mundo 3D colorido usando Three.js e Remotion. A skill é baseada no projeto de código aberto `claude-animated-shorts` de Mr omi (licença MIT) e oferece um fluxo completo: desde a escolha do estilo, elaboração de roteiro, geração de voz, planejamento de cenas, até o render final. Exemplos incluem o short sobre Alexandre o Grande (batalha, multidões, câmera lenta) e o short da ponte. A skill enfatiza a criação de conteúdo original (nunca copiar roteiros ou personagens) e inclui ferramentas para medir e revisar o resultado final, garantindo que o vídeo atenda aos padrões de estilo definidos.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/EdsonAP1/animation-tree.js-Remotion-/tree/HEAD

Perguntar na sua IA favorita

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

Prévia

Do README da skill

Documentação

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:

  1. 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).
  2. 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ção Alexandre, 1080x1920, 30 fps, 9,8 s). Roteiro em modelos/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

  1. 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.
  2. 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.
  3. Voz. Grave ou gere voz.wav e extraia os tempos por palavra para palavras.json (qualquer transcritor com tempos por palavra). Corrija os tempos manualmente: tudo é sincronizado com esse arquivo.
  4. 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) para src/videos/<nome>/ e registre-a em src/Root.tsx (ver modelos/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.
  5. 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).
  6. Personagens.
    • toon.ts: a API de desenho Pen (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.ts desenham 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 camada NOINK.
    • cardshade.ts: os personagens recebem a luz da cena (não brilham sozinhos) e projetam sombra.
  7. 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.
  8. 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.
  9. Revisão do visual. Tire fotos avulsas: node modelos/scripts/fotos.mjs out/x_ 20,100,200 0.5. Coloque-as junto a quadros de referencias/quadros/ com python modelos/scripts/sbs_sheet.py e revise.
  10. 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.
  11. Render final. npx remotion render src/index.ts <Composição> out/video.mp4 --codec h264 --crf 16 e junte o áudio com -map 0:v:0 -map 1:a:0 (Remotion escreve uma faixa de áudio muda). Revise cada quadro com python 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% (worldF em story.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]

Habilidades Relacionadas