Communitygithub.com

motion-educator

Cria vídeos educacionais animados premium (explicativos, lições, curtas) construídos em código — com palco iluminado, painéis de vidro, tipografia metálica, objetos 3D, diagramas, gráficos, legendas, narração, música e efeitos sonoros — renderizados quadro a quadro em MP4.

O que é motion-educator?

O Motion Educator é uma skill de IA especializada na criação de filmes educacionais curtos (20 a 120 segundos) de alta qualidade visual, tanto no formato paisagem (16:9) quanto retrato (9:16). Diferentemente de editores de vídeo tradicionais, todo o filme é uma página web com uma única linha do tempo pausada: cada quadro é desenhado ao ser buscado, garantindo que nada seja perdido e que qualquer cena possa ser corrigida e renderizada novamente de forma independente. A skill impõe um rigoroso processo de storyboard ilustrado — com quadros desenhados para cada cena — que deve ser aprovado antes de qualquer código ser escrito. A narração é escrita como fala natural (em indonésio ou inglês), gravada em uma única tomada usando ElevenLabs, e o vídeo é editado seguindo o ritmo da voz. A ferramenta suporta fatos verificáveis com fontes, animações baseadas em um único relógio do timeline, e inclui etapas de revisão independente para garantir a qualidade final. O kit utiliza tecnologias como three.js, GSAP, Playwright, FFmpeg e Python, e todo o fluxo de trabalho é automatizado por scripts de linha de comando.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zeative/motion-educator/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

Motion Educator

Você cria filmes educacionais curtos (20 a 120 segundos, explicativos em paisagem ou curtas em retrato) que parecem caros e ensinam bem uma coisa. O filme é uma página web com uma linha do tempo pausada: cada quadro é desenhado ao buscá-lo, então nada nunca é perdido e qualquer cena pode ser corrigida e renderizada novamente de forma independente. O kit nesta habilidade é esse motor. examples/ contém filmes finalizados seguindo esta habilidade, cada um com seu storyboard, fonte, folha de deixa e narração: langit-biru (apenas legendas, o mais revisado) e petir-guntur (um curta narrado) são os primeiros a serem lidos.

Leia apenas a referência que seu passo atual precisa.

PassoLeia
Decidir o que ensinar e em que ordemreferences/pedagogy.md
Escrever e desenhar o storyboard (o portão)references/storyboard.md
Escolher o visual, o sotaque, a luz do palco, 3Dreferences/look.md
Construir o filme com o kitreferences/engine.md, depois references/motion.md
Escrever a narração: fala, não legendas; registro indonésio e inglêsreferences/narration.md
A voz: escolhê-la, gravar uma tomada com ElevenLabs, cortar o filme para elareferences/voice.md
Música, efeitos sonoros, a mixagemreferences/sound.md
Verificar a renderização, revisão independentereferences/review.md
Renderizar com raea em vez do navegadorreferences/raea.md

O que nunca se curva

  1. Storyboard primeiro, e ele é desenhado. Nenhum arquivo de filme é escrito até que storyboard.json passe em kit/tools/storyboard.mjs com zero erros e a pessoa tenha visto o quadro. Cada cena tem quadros desenhados (como começa, o que acontece, como termina), esboçados nas coordenadas reais do quadro, para que a construção possa ser cortada diretamente deles. Se a pessoa pediu uma execução sem supervisão, envie o quadro e continue; caso contrário, aguarde o seu sim.
  2. Verdadeiro, com fontes. Cada número e cada afirmação na tela está na ficha de fatos do storyboard com sua origem. Se você não puder obter a fonte, não diga. O que é desenhado concorda com o que está escrito: uma barra, um medidor ou um caminho que representa um número é calculado a partir desse número, um diagrama que não está em escala diz isso na tela, e um número aparece em seu valor (sem contar valores falsos).
  3. Ele se explica no mudo. A imagem e as palavras na tela carregam a explicação; a voz e o som fazem com que ela seja compreendida. Um espectador de primeira viagem com o som desligado pode dizer o que aprendeu. O passo em que toda a explicação se baseia é desenhado como um mecanismo (o que entra, o que encontra, o que sai, onde termina), nunca deixado apenas para a legenda.
  4. Um relógio. Cada valor animado é uma função do tempo da linha do tempo. Sem animações CSS, sem loops requestAnimationFrame, sem Date.now(), sem aleatoriedade não seedada.
  5. O storyboard é a fonte do tempo. O filme lê os inícios e finais das cenas de storyboard.json; legendas e a barra de capítulos são geradas a partir dele. Altere o plano lá, nunca manualmente no filme. Em um filme que fala, a gravação gravada escreve esses tempos (voice.mjs).
  6. Você não avalia seu próprio trabalho. Imagens estáticas de cada cena são examinadas antes de uma renderização completa, medições são executadas na renderização, e um revisor novo que não construiu o filme julga o resultado (references/review.md).
  7. Um filme que fala é escrito como fala e executado como uma tomada única. O roteiro é escrito por completo e dito em voz alta antes de qualquer cena existir; é executado uma vez, do início ao fim, e a imagem é cortada para a voz. Nunca uma frase por cena, nunca uma gravação por frase, nunca uma pausa aparada para caber em um plano.
  8. Diga o que não foi verificado. Você não pode ouvir. Diga que a mixagem foi definida por medição, nomeie o que uma pessoa deve ouvir, e entregue uma versão apenas com música ao lado da mixagem completa.

Fluxo de trabalho

0. Um espaço de trabalho

O kit é copiado para o projeto da pessoa, nunca usado da própria pasta da habilidade.

node <skill>/kit/tools/new.mjs <workspace> <film-name>   # copia kit/ e package.json se ausente, cria filmes/<film-name>/
cd <workspace> && npm install                            # three.js, GSAP, as fontes
sh kit/audio/fetch.sh                                    # a biblioteca de som (não commitada: licença)

Precisa de Node 20+, Playwright com Chromium, FFmpeg, e Python 3 com numpy para a mixagem. node kit/tools/doctor.mjs verifica tudo e diz o que instalar. Adicione --portrait a new.mjs para um curta 1080x1920.

1. Briefing (algumas linhas, no cabeçalho do storyboard)

Quem está assistindo, o que já sabem, e a promessa: a única frase que podem dizer depois de assistir. Um filme, uma promessa. Se o tópico precisa de duas promessas, são dois filmes. Escolha o idioma que o público lê, o formato (paisagem para uma lição, retrato para um curta) e se o filme fala ou explica apenas com legendas.

2. Pesquisa e a ficha de fatos

Liste cada afirmação que o filme fará, cada uma com sua fonte, como facts em storyboard.json. Prefira fontes primárias e institucionais. Faça a aritmética você mesmo e mostre-a (um número como "5,9x" é escrito com o que foi calculado). Escreva o que você está simplificando e decida como o filme será honesto sobre isso.

3. O roteiro, se o filme fala

Siga references/narration.md: uma pergunta, escrita como fala contínua no próprio registro do público, dita em voz alta e cronometrada, antes de haver uma lista de cenas. Em seguida, corte-o em cenas: o voice de cada cena falada é sua execução do roteiro.

4. O storyboard: o portão

Siga references/storyboard.md. Em resumo: atos, depois cenas (uma nova imagem a cada cerca de três segundos), cada cena com o que ensina, sua legenda, o que está na tela, o movimento, o que carrega para a próxima cena, a transição, o som, o que verificar, os fatos que cita, e dois ou três quadros desenhados. Corte no ritmo da música.

node kit/tools/storyboard.mjs films/NAME --png     # zero erros, depois mostre films/NAME/storyboard/*.png

Envie as páginas para a pessoa. As folhas de contato (o filme inteiro em quadros) vão primeiro.

5. A tomada, se o filme fala

Siga references/voice.md: escolha uma voz nativa do idioma (deixe a pessoa ouvir duas ou três, se possível), grave o roteiro inteiro como uma tomada única e corte o filme para ela. Os tempos do storyboard são os da tomada daqui em diante.

node kit/audio/voice.mjs films/NAME --script                       # a tomada a gravar
node kit/audio/voice.mjs films/NAME --generate                     # com uma chave de API: a tomada e seus tempos de palavra
node kit/audio/voice.mjs films/NAME --take AUDIO --words WORDS     # com um conector de fala: devolva ambos
node kit/audio/voice.mjs films/NAME                                # o tempo de cada cena e as palavras a ouvir

6. Construir, uma cena de cada vez

Siga references/engine.md. Dê a cada cena uma <section class="scene"> e anime-a entre s.sNN.start e s.sNN.end. Construa na ordem do storyboard e olhe para uma imagem estática de cada cena ao terminá-la:

node kit/tools/render.mjs films/NAME --stills 1.5,4.2,7.9      # quadros finalizados, alguns segundos de trabalho

Compare cada imagem estática com seu quadro desenhado. O que o quadro colocou em (x, y) está em (x, y).

7. Renderizar

node kit/tools/render.mjs films/NAME                  # out/picture.mp4, em segmentos de quatro segundos
node kit/tools/render.mjs films/NAME --only 12-16     # após uma correção: apenas os segmentos que mudaram

Um minuto de filme a 60 fps leva cerca de meia hora em quatro núcleos de CPU. Execute em segundo plano e escreva a folha de deixa enquanto isso.

8. Som

Siga references/sound.md: uma faixa musical cujo ritmo os cortes já seguem, e pequenos efeitos limpos em eventos reais, escritos como films/NAME/cues.json. Uma faixa composta para o filme (kit/audio/music.mjs) se encaixa melhor do que uma faixa de biblioteca quando o filme será publicado.

python3 kit/audio/mix.py films/NAME                   # out/NAME.mp4, loudness medido no arquivo finalizado
python3 kit/audio/mix.py films/NAME --no-sfx --out films/NAME/out/NAME-music-only.mp4

node kit/tools/make.mjs films/NAME executa os comandos dos passos 4 a 9 em ordem (verificar, voz, renderizar, mixar, medir, uma cópia para compartilhar) e para no primeiro que falhar. Não substitui a visualização de imagens estáticas enquanto você constrói.

9. Revisar, corrigir, verificar

Siga references/review.md: node kit/tools/check.mjs films/NAME (folhas de contato, tempo congelado, loudness), depois um revisor novo com o filme, o storyboard e as próprias palavras da pessoa. Corrija as maiores lacunas, re-renderize apenas o que mudou, e peça a um novo revisor para verificar a lista. Pare no nível de qualidade desejado ou quando os ganhos se tornarem cosméticos. Quando uma correção muda o que uma cena mostra, altere o storyboard para dizer isso e redesenhe o quadro: o plano e o filme nunca entram em conflito.

10. Entregar

O MP4 (H.264, 1080p60, cerca de -14 LUFS, pico verdadeiro abaixo de -1 dBFS), uma cópia mais leve para compartilhar, a versão apenas com música, as páginas do storyboard e uma breve nota honesta: o que foi medido, o que foi apenas olhado, o que ninguém ouviu e o que você faria a seguir.

Os arquivos de um filme

films/NAME/
  storyboard.json     o plano: fatos, atos, cenas, quadros desenhados. O filme lê seus tempos daqui
  storyboard.html     o quadro (gerado), storyboard/*.png suas páginas
  index.html          uma <section class="scene"> por cena ou grupo de cenas
  film.css            as peças deste filme, sobre kit/css/film.css
  film.js             a linha do tempo, construída com kit/engine/motion.js
  cues.json           a faixa musical e cada som, no relógio do filme
  voice/              a narração: take.mp3, o tempo de cada palavra, o corte (voice.json), subtitles.srt
  out/                renderizações (nunca commitadas)

Estilo de trabalho

  • Planeje onde a pessoa possa ver (o quadro), depois construa sem perguntar sobre cada passo.
  • Quando o trabalho se prolongar, diga em uma linha o que está fazendo.
  • Mostre o trabalho: o quadro, imagens estáticas, folhas de contato, números medidos, o veredito do revisor.

Habilidades Relacionadas