Communitygithub.com

science-video

Crie vídeos de animação educacional e explicativa com código (ciência, aprendizado de idiomas, vida cotidiana, demonstração de produtos, etc.). Primeiro, pergunte o que fazer (ideia, artigo, URL do produto, repositório de código, vídeo de referência), pesquise fontes reais e forneça citações; depois, ofereça três propostas estilisticamente distintas (A: animação FLASH, B: pixel art retrô, C: escolha baseada no tema), cada uma com um quadro-chave ou amostra de 2–4 segundos; após a escolha do usuário, escreva um brief.md, produza cena por cena com autoinspeção de quadros congelados, sincronize com o ritmo da música de fundo, sintetize efeitos sonoros, misture o áudio, renderize em MP4 e crie capas nos formatos 3:4 e 4:3. Use quando o usuário disser: "faça um vídeo educativo", "faça uma animação explicativa", "faça um vídeo vertical/ TikTok/ curta", "faça um vídeo no estilo pixel art, jogo retrô, CRT", "me dê três propostas", "faça no estilo demo", "1920x1080 ou 1080x1920", "faça a capa".

O que é science-video?

O skill **science-video** é uma ferramenta avançada para criar vídeos de animação educacional e explicativa inteiramente com código, usando **Remotion** para toda a parte visual e **Python** para sintetizar efeitos sonoros. Ele foi projetado para agentes de IA como Claude Code, Cursor ou Codex, que atuam como um diretor de animação técnico: primeiro, o agente pergunta ao usuário sobre o tema (ideia, artigo, URL de produto, repositório de código, vídeo de referência), coleta e verifica fontes reais com citações, e em seguida gera três propostas estilisticamente distintas — A (animação FLASH com ilustrações vetoriais planas), B (pixel art retrô com canvas 2D e shader CRT) e C (uma sugestão criativa baseada no tema, como um plano-sequência ou metáfora visual). Cada proposta inclui um quadro-chave ou clipe de 2 a 4 segundos para visualização. Após a escolha do usuário, o agente escreve um `brief.md` detalhado e produz o vídeo cena por cena, com autoinspeção de quadros congelados, sincronização com o ritmo da música de fundo, síntese de efeitos sonoros, mixagem de áudio e renderização final em MP4. O skill suporta formatos horizontal (1920×1080) e vertical (1080×1920), gera capas nos formatos 3:4 e 4:3, e segue regras rigorosas de qualidade, como legibilidade de texto, riqueza visual e verificação de fatos. É ideal para conteúdos de ciência, aprendizado de idiomas, vida cotidiana, demonstrações de produtos e qualquer tópico que possa ser explicado visualmente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dominoeffect/science-video-skill/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

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 style como "vflash" no scenes.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:

  1. Verificar o ambiente (scripts/check_env.py). Ele imprime o que falta; peça permissão ao usuário antes de instalar.
  2. Criar o diretório de trabalho.
  3. Copiar o modelo.
  4. Copiar fontes.
  5. Executar npm install.
  6. Medir o ritmo e escrever em src/grid.json.
  7. 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 em source/sources.md e 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:

PropostaEstiloTécnicaAbordagem
AAnimação FLASH (ilustração plana)Remotion + componentes de ilustração SVGSeguro: pergunta → experimento/dados → conclusão → lembre-se de três coisas
BPixel Art Retrô (console de videogame antigo + TV CRT)Canvas 2D pixelado → Shader CRT WebGLGamificado: selecionar o cartucho é selecionar o nível, HUD mostra dados, diálogo dá conclusões, tela de resultados
CSugestã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 RemotionDiferente de A e BUma 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

  1. 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 de PixelStage.
    • C escreva do zero, seguindo a abordagem de PlanC.tsx: a cena é determinada apenas por t, monte uma cena.
  2. 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:clip para 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.
  3. 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.
  4. 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

  1. Primeiro, escreva src/scenes.json:

    • O campo style deve 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.
  2. Para cada cena, escreva:

    • Estilo FLASH: escreva componentes em src/scenes/*.tsx e registre em src/scenes/index.ts.
    • Estilo Pixel: escreva funções de desenho (c, f) => void no PIXEL_SCENES em src/pixel/scenes.ts.
    • Estilo C: estenda o código de pré-visualização da Etapa 3, conecte a Film.tsx ou escreva um componente de filme completo seguindo PixelFilm.tsx.
    • Todo o texto deve ser escrito em src/captions.json e todos os efeitos sonoros em src/sfx.json, usando as mesmas fórmulas de compasso.
  3. Após concluir cada cena, execute sequencialmente:

    • npm run typecheck
    • npm 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.

  4. 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.

  5. Para regras de estilo, consulte references/style-flash.md e references/style-pixel.md; para regras gerais, consulte references/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 rep para 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-db e --sfx-db para 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

  1. Renderize: npm run sfx, depois npm 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.
  2. Verifique a resolução, taxa de quadros, número de quadros e duração com ffprobe; meça o volume com ebur128.
  3. Gere quadros extraídos do vídeo: python tools/qa_sheet.py out/film.mp4 ../qa/final (no Windows, também pode usar tools/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.
  4. 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.
  5. 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 em VSCENE_MAP em vfilm/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 por beat_grid.py em grid.json como segments.
  • 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" em references/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:
    1. Reúna seu código em assets/template/src/<nome_do_estilo>/.
    2. Escreva references/style-<nome_do_estilo>.md.
    3. Na tabela de candidatos em plans.md, marque como "incorporado".
    4. Adicione uma linha na tabela de propostas deste arquivo.
  • 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)

ArquivoConteúdo
references/plans.mdFormato das três propostas, tabela de candidatos C, regras de pré-visualização, escrita para apresentação ao usuário
references/brief-template.mdModelo dos sete blocos do brief.md
references/style-flash.mdEstilo animação FLASH: especificações de estilo, componentes, capas
references/style-pixel.mdEstilo pixel retrô: pontos-chave da cena, paleta de cores, duas resoluções, fonte matricial, sprites, CRT, capas
references/craft.mdRegras 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.mdEstrutura do modelo, sistema de fórmulas de compasso, APIs dos componentes, comandos comuns
references/audio.mdRitmo, tabela de timbres (incluindo timbres de chip), nível de volume final, fluxo de mixagem
references/research.mdMétodo de pesquisa e verificação de fontes
references/pitfalls.mdArmadilhas encontradas (leia antes de começar)
references/credits.mdFontes de inspiração e licenças de fontes
references/publish-copy.mdTexto 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.pyCriar 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)

Habilidades Relacionadas