Vídeos de Animação Educacional com Código
Todas as cenas são desenhadas puramente com código usando Remotion, e os efeitos sonoros são sintetizados com Python. Primeiro, forneça três propostas e uma prévia; depois que o usuário escolher, escreva um brief.md e então produza cena por cena.
Regras Rígidas
- Use apenas a abordagem deste Skill. Não substitua os passos descritos aqui por outros fluxos de trabalho ou abordagens de outros projetos.
- As fontes devem ser reais e ter links. Cada uma deve ser aberta ou baixada pessoalmente para verificação. Se não for possível verificar, marque como "não verificado". Interpretações de segunda mão devem indicar claramente quem as leu. Não invente números, não escreva afirmações sem origem.
- Peça confirmação do usuário antes de cada etapa: lista de fontes → três propostas e prévias → mixagem de áudio → capas. Após escrever o
brief.md, informe ao usuário onde ele está. - Não inclua narração (a menos que o usuário peça). Toda a informação deve ser transmitida por texto na tela. Use a música de fundo fornecida pelo usuário (que deve ter direitos de uso) e sintetize efeitos sonoros de ação sincronizados com o ritmo. O repositório não deve conter arquivos de música.
- Texto: sem sobreposição, legível, tempo de permanência suficiente, sem grandes blocos de texto. As cenas devem ser ricas, com personagens (pessoas, animais ou objetos) desenhados de forma detalhada e viva.
- Especificações padrão: horizontal 1920×1080, 30fps; quando o usuário pedir vertical/TikTok/vídeo curto, use 1080×1920 (defina
stylecomo"vflash"noscenes.json). A duração é igual à da música de fundo (se não houver música, a duração e o BPM podem ser especificados).
Diretório de Trabalho
<topic>/ Exemplo: ~/videos/<topic>
demo.mp3 / demo.mp4 Música de fundo, vídeo de referência fornecidos pelo usuário (opcional)
source/ sources.md (lista de fontes), ref-notes.md (análise de vídeo de referência), materiais brutos
previews/ plan-a.png, plan-b.mp4, plan-c.png (prévias das três propostas)
brief.md Plano completo confirmado, também um prompt reutilizável
video/ Projeto Remotion (gerado por new_project.py ou new_project.ps1)
qa/ Quadros congelados por cena, quadros extraídos do vídeo completo, review_log.md
<video_name>.mp4 Vídeo final
capas/ capa_3por4_vertical.jpg, capa_4por3_horizontal.jpg
Etapa 0: Criar o Projeto
python <skill>/scripts/new_project.py --project "<topic_dir>"
# Sem música de fundo: ... --no-music --duration 60 --bpm 120
No Windows, também pode usar scripts/new_project.ps1. Este script executa as seguintes etapas:
- Verificar o ambiente (
scripts/check_env.py). Ele imprime o que falta; peça permissão ao usuário antes de instalar. - Criar o diretório de trabalho.
- Copiar o modelo.
- Copiar fontes.
- Executar npm install.
- Medir o ritmo e escrever em
src/grid.json. - Gerar a primeira versão da mixagem de áudio.
Todo o processo leva de 1 a 3 minutos. Se estiver em um ambiente que exija comandos longos em segundo plano, inicie em segundo plano e consulte a saída periodicamente (veja references/pitfalls.md).
O modelo contém um exemplo de espaço reservado genérico de cerca de 12 segundos para confirmar que o projeto pode renderizar. Depois de alterar o tema, reescreva as cenas, legendas e efeitos sonoros. Exemplos completos de várias cenas podem ser encontrados em examples/bait-color/ (opcional para consulta, não é o conteúdo padrão).
Etapa 1: Perguntar o que Fazer
O usuário pode fornecer qualquer combinação dos seguintes materiais brutos:
- Ideia: pode ser um tema de uma frase.
- Conteúdo original: artigo, roteiro para narração, URL do produto, repositório de código, planilha de dados.
- Vídeo de referência, música de fundo.
Faça no máximo 3 perguntas de acompanhamento, apenas sobre o que pode mudar o plano: duração, proporção, se quer narração, cores ou fontes da marca especificadas. Use valores padrão para o que o usuário não mencionou e especifique no plano para que o usuário possa alterar.
Processamento dos materiais brutos:
- Tópicos educacionais, factuais: pesquise e verifique as fontes conforme
references/research.md, escreva emsource/sources.mde envie para confirmação do usuário. - Artigo, roteiro para narração: extraia as informações principais, o público-alvo e os fatos que devem aparecer. Os fatos só podem vir dos materiais brutos; não escreva informações incertas.
- URL do produto: leia a página, anote o nome do produto, funcionalidades, slogan e cores da marca. Peça permissão antes de fazer capturas de tela.
- Repositório de código: leia o README e os arquivos principais, extraia os pontos de funcionalidade, não invente funcionalidades.
- Vídeo de referência:
- Peça permissão antes de baixar links.
- Meça as especificações com
ffprobe. - Encontre pontos de corte de cena com
ffmpeg -vf "select='gt(scene,0.3)',showinfo". - Extraia 1 quadro por segundo para criar um quadro de contato.
- Escreva a estrutura da cena, ritmo, paleta de cores, fontes e técnicas em
source/ref-notes.md. - Aprenda apenas a estrutura e as técnicas, não copie materiais ou texto.
- Música de fundo: o script de criação do projeto já mediu o ritmo. Ele imprimirá o BPM, limites das seções e deriva; organize o plano e o storyboard de acordo.
Etapa 2: Fornecer Três Propostas
Escreva de acordo com references/plans.md. A divisão de trabalho das três propostas é fixa:
| Proposta | Estilo | Técnica | Abordagem |
|---|---|---|---|
| A | Animação FLASH (ilustração plana) | Remotion + componentes de ilustração SVG | Seguro: pergunta → experimento/dados → conclusão → lembre-se de três coisas |
| B | Pixel Art Retrô (console de videogame antigo + TV CRT) | Canvas 2D pixelado → Shader CRT WebGL | Gamificado: selecionar o cartucho é selecionar o nível, HUD mostra dados, diálogo dá conclusões, tela de resultados |
| C | Sugestão na hora: escolha da tabela de candidatos em plans.md que melhor se adequa ao tema, ou sugira um que possa ser feito com Remotion | Diferente de A e B | Uma abordagem diferente: plano-sequência, um personagem que atravessa todo o vídeo, flashback, uma metáfora para explicar tudo |
Cada proposta deve incluir: nome, resumo em uma frase, estilo (valores de cores e fontes), especificações, combinação técnica, resumo cena por cena (com intervalos de tempo), áudio, tempo estimado de renderização, dificuldades e riscos, e por que é adequada para este material bruto.
As três propostas devem ser claramente diferentes em estilo, técnica e abordagem, não apenas uma mudança de paleta de cores.
Etapa 3: Criar Prévia para Cada Proposta
- Em
video/src/preview/PlanA.tsx,PlanB.tsx,PlanC.tsx, monte uma cena que melhor represente a proposta, começando do tempo 0 e com duração de 2 a 4 segundos. Os modelos têm exemplos de espaço reservado genéricos; modifique-os:- A use componentes SVG de
src/art/,src/ui/. - B use o motor
src/pixel/, desenhe dentro dePixelStage. - C escreva do zero, seguindo a abordagem de
PlanC.tsx: a cena é determinada apenas por t, monte uma cena.
- A use componentes SVG de
- Execute:
node tools/preview.mjs --out ../previews --estimate A:2.4 B:2.5 C:3.9- Por padrão, cada proposta gera um quadro-chave; os segundos após os dois pontos indicam o momento de captura.
- Para propostas cujo apelo está no movimento, escreva como
B:clippara gerar um clipe de 3 segundos. - O script imprimirá o tempo por quadro e a estimativa de tempo de renderização do vídeo completo; insira esse número na proposta.
- Revise as imagens de prévia você mesmo: texto estourando, elementos aglomerados, cena vazia, se os três estilos estão realmente diferenciados. Corrija antes de enviar ao usuário.
- Envie o texto das três propostas e as imagens de prévia juntos ao usuário (incorpore as imagens na resposta; cada assistente pode ter uma abordagem diferente). O usuário pode escolher uma, pedir uma mistura ou modificações; se houver alterações, volte para a Etapa 2 ou 3 até que o usuário confirme.
Etapa 4: Escrever brief.md
Após a confirmação do usuário, escreva <topic>/brief.md de acordo com references/brief-template.md. Ele tem sete blocos: <role> <inputs> <direction> <structure> <build> <gotchas> <start>. Preencha tudo que foi confirmado; para valores padrão usados, indique que são valores padrão. Após escrever, informe ao usuário a localização do arquivo.
A produção subsequente seguirá rigorosamente o brief. Se precisar alterar algo no meio do caminho, primeiro altere o brief, depois o código. Se o usuário mudar de tópico ou quiser usar em outra ferramenta, pode reutilizar este brief diretamente.
Etapa 5: Produzir Cena por Cena
-
Primeiro, escreva
src/scenes.json:- O campo
styledeve ser"flash"ou"pixel"; o Root usará isso para selecionar o conjunto de cenas. - A tabela de cenas usa fórmulas de compasso; as transições devem ficar nos limites das seções.
- O campo
-
Para cada cena, escreva:
- Estilo FLASH: escreva componentes em
src/scenes/*.tsxe registre emsrc/scenes/index.ts. - Estilo Pixel: escreva funções de desenho
(c, f) => voidnoPIXEL_SCENESemsrc/pixel/scenes.ts. - Estilo C: estenda o código de pré-visualização da Etapa 3, conecte a
Film.tsxou escreva um componente de filme completo seguindoPixelFilm.tsx. - Todo o texto deve ser escrito em
src/captions.jsone todos os efeitos sonoros emsrc/sfx.json, usando as mesmas fórmulas de compasso.
- Estilo FLASH: escreva componentes em
-
Após concluir cada cena, execute sequencialmente:
npm run typechecknpm run check(verificação de legendas, deve ter 0 problemas)node tools/stills.mjs --out ../qa <entrada_em_segundos> <acao_principal_em_segundos> <saida_em_segundos>
Em seguida, examine cada quadro em busca de oclusão, elementos saindo da tela, texto sobreposto ao rosto dos personagens, texto sobreposto entre si. Corrija antes de fazer a próxima cena.
-
Para vídeos com mais de 30 segundos, após todas as cenas estarem prontas, renderize uma versão de baixa resolução:
node tools/render.mjs --scale 0.5 --out out/draft.mp4. Confirme se o ritmo e as transições estão bons, depois refine os detalhes. -
Para regras de estilo, consulte
references/style-flash.mdereferences/style-pixel.md; para regras gerais, consultereferences/craft.md.
Etapa 6: Áudio
As regras estão em references/audio.md:
- Efeitos sonoros e ações visuais são escritos na mesma fórmula de compasso.
- No estilo pixel, use timbres
chip_*. - Para efeito de máquina de escrever, use o campo
reppara repetir o efeito sonoro. - O nível de volume padrão é o valor final.
- Se o usuário disser que está muito alto, muito baixo ou estridente, use
--music-dbe--sfx-dbpara gerar algumas opções de comparação para o usuário escolher. Apenas troque a faixa de áudio, não re-renderize as cenas.
Etapa 7: Renderização e Aceitação
- Renderize:
npm run sfx, depoisnpm run render. O tempo depende da estimativa da Etapa 3; para um vídeo de 3200 quadros, o estilo FLASH leva cerca de 1,8 minutos, e o pixel, cerca de 6 minutos. - Verifique a resolução, taxa de quadros, número de quadros e duração com
ffprobe; meça o volume comebur128. - Gere quadros extraídos do vídeo:
python tools/qa_sheet.py out/film.mp4 ../qa/final(no Windows, também pode usartools/qa_sheet.ps1). Serão geradas duas imagens: um quadro de contato completo e uma versão para celular com largura de 360 pixels por quadro. - Avalie de acordo com a lista de verificação em
references/craft.md. Cada um dos 7 itens deve ter pontuação ≥ 8:- Liste os 3 problemas mais graves e seus momentos.
- Re-renderize apenas o trecho com problemas (
node tools/render.mjs --frames inicio-fim), depois recomponha o vídeo completo. - Registre as pontuações e problemas de cada rodada em
qa/review_log.md.
- Copie o vídeo final para
<topic>/<video_name>.mp4.
Pontos-chave para Vídeos Verticais (style = vflash)
- O componente do filme completo está em
src/vfilm/: VFilm, VOverlay, cartões e tags genéricos, capa minimalista. As cenas são registradas emVSCENE_MAPemvfilm/scenes.tsx. - Zona segura de legendas: x 40–1040, y 240–1640; o texto permanece por padrão ≥ 3,5 segundos, e cartões de texto curto ≥ 3 segundos.
- Não sobreponha a origem na tela; a origem só deve estar em
source/sources.md. No máximo, marque a tela como "ilustrativa". - Final sugerido: revisão/votação numerada + botão de seguir. Regras de texto em
references/publish-copy.md(título ≤ 30 caracteres, descrição ≤ 100 caracteres incluindo hashtags). - Volume final: -16 LUFS, pico verdadeiro ≤ -2 dBTP:
python tools/loudnorm.py out/film.mp4. A música de fundo deve ser claramente audível. - Pontos de corte: no primeiro tempo do compasso:
python tools/sync_check.py. A curva de velocidade é escrita porbeat_grid.pyemgrid.jsoncomosegments. - Capa vertical:
npm run vcover34/npm run vcover43.
Etapa 8: Capas
Cada estilo tem duas capas: 3:4 e 4:3; os vídeos verticais também têm um conjunto de capas minimalistas:
- Estilo FLASH (composição horizontal):
npm run cover34,npm run cover43 - Estilo Pixel:
npm run pixelcover34,npm run pixelcover43 - Vertical minimalista:
npm run vcover34,npm run vcover43
Todas são exportadas em resolução 2x. Regras de layout estão nos documentos de estilo correspondentes e em references/publish-copy.md. Para capas de vídeos curtos, evite o canto inferior esquerdo (área de visualizações) e não use faixas de cor no rodapé com listas.
Entrega
Informe ao usuário:
- Caminho do vídeo final, caminho do
brief.md, diretório do projeto. - As principais decisões criativas tomadas.
- Deficiências conhecidas.
- Tempo de renderização.
- Fatos incertos que precisam de verificação pelo usuário, listados separadamente.
Modificar Estilo, Adicionar Novo Estilo
- Alterar apenas este vídeo: altere apenas os arquivos dentro de
video/deste vídeo, não mexa no modelo do Skill. Para saber quais partes estão em quais arquivos, consulte a seção "Onde cada estilo está em quais arquivos" emreferences/craft.md. Primeiro, gere 4 a 6 quadros-chave representativos para o usuário confirmar o estilo, depois produza o vídeo completo. - Usar o estilo C para sempre:
- Reúna seu código em
assets/template/src/<nome_do_estilo>/. - Escreva
references/style-<nome_do_estilo>.md. - Na tabela de candidatos em
plans.md, marque como "incorporado". - Adicione uma linha na tabela de propostas deste arquivo.
- Reúna seu código em
- Estilos impossíveis: Este fluxo de trabalho só desenha gráficos vetoriais e pixelados com código. Filmagens reais, 3D realista, personagens realistas não são possíveis; avise o usuário com antecedência. Se precisar de personagens realistas, o usuário pode gerar um clipe de personagem em fundo verde com um modelo de vídeo, e o código cuidará apenas do cenário e do texto.
Arquivos de Referência (Leia Quando Necessário)
| Arquivo | Conteúdo |
|---|---|
references/plans.md | Formato das três propostas, tabela de candidatos C, regras de pré-visualização, escrita para apresentação ao usuário |
references/brief-template.md | Modelo dos sete blocos do brief.md |
references/style-flash.md | Estilo animação FLASH: especificações de estilo, componentes, capas |
references/style-pixel.md | Estilo pixel retrô: pontos-chave da cena, paleta de cores, duas resoluções, fonte matricial, sprites, CRT, capas |
references/craft.md | Regras de storyboard, regras de legendas, autoinspeção por cena, avaliação do vídeo completo, lista de aceitação, onde cada estilo está nos arquivos |
references/remotion-kit.md | Estrutura do modelo, sistema de fórmulas de compasso, APIs dos componentes, comandos comuns |
references/audio.md | Ritmo, tabela de timbres (incluindo timbres de chip), nível de volume final, fluxo de mixagem |
references/research.md | Método de pesquisa e verificação de fontes |
references/pitfalls.md | Armadilhas encontradas (leia antes de começar) |
references/credits.md | Fontes de inspiração e licenças de fontes |
references/publish-copy.md | Texto de publicação para vídeos verticais, final com votação, zona segura, volume |
scripts/new_project.py, new_project.ps1, check_env.py, beat_grid.py, music_rms.py, qa_sheet.py | Criar projeto, verificar ambiente, medir ritmo, medir volume, extrair quadros |
assets/template/ | Modelo do projeto Remotion (contém todos os componentes genéricos e exemplos de espaço reservado para ambos os estilos) |
assets/fonts/ | Fonte matricial Fusion Pixel 12px (OFL) |
examples/bait-color/ | Exemplo completo de várias cenas (opcional para consulta, não é o modelo padrão) |