Communitygithub.com

govindgoel2001/pipeline-de-producao-de-video

Pipeline de produção para animações matemáticas e técnicas usando Manim Community Edition. Cria vídeos explicativos no estilo 3Blue1Brown, visualizações de algoritmos, derivações de equações, diagramas de arquitetura e histórias de dados.

O que é pipeline-de-producao-de-video?

Este skill implementa um pipeline completo de produção de vídeos educacionais animados utilizando Manim Community Edition, inspirado no estilo de Grant Sanderson (3Blue1Brown). Ele cobre desde o planejamento narrativo até a renderização e montagem final, com suporte a modos como explicador de conceitos, derivação de equações, visualização de algoritmos, histórias de dados, diagramas de arquitetura, explicador de artigos e visualização 3D. O pipeline segue as etapas PLAN → CODE → RENDER → STITCH → AUDIO (opcional) → REVIEW, com recomendações detalhadas de paletas de cores, velocidades de animação, tipografia e princípios de design visual. Cada cena é uma classe Python independente e renderizável separadamente, com constantes de cor compartilhadas para consistência estética. O skill também fornece diretrizes para variação por cena, legendas automáticas, pausas estratégicas e padrões de animação como SCAMPER e Reversão de Suposições para abordagens criativas. Ideal para desenvolvedores que desejam produzir vídeos explicativos de alta qualidade de forma programática, sem necessidade de navegador, Node.js ou GPU.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/govindgoel2001/video-editing-toolkit/tree/HEAD/vendor/video-use/skills/manim-video

Perguntar na sua IA favorita

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

Documentação

Pipeline de Produção de Vídeo com Manim

Padrão Criativo

Isto é cinema educacional. Cada quadro ensina. Cada animação revela estrutura.

Antes de escrever uma única linha de código, articule o arco narrativo. Que equívoco isto corrige? Qual é o "momento aha"? Que história visual leva o espectador da confusão ao entendimento? O prompt do usuário é um ponto de partida — interprete-o com ambição pedagógica.

Geometria antes da álgebra. Mostre a forma primeiro, a equação depois. A memória visual codifica mais rápido que a memória simbólica. Quando o espectador vê o padrão geométrico antes da fórmula, a equação parece merecida.

Excelência no primeiro render é inegociável. A saída deve ser visualmente clara e esteticamente coesa sem rodadas de revisão. Se algo parecer poluído, mal cronometrado ou parecer "slides gerados por IA", está errado.

Camadas de opacidade direcionam a atenção. Nunca mostre tudo em brilho máximo. Elementos primários em 1.0, elementos contextuais em 0.4, elementos estruturais (eixos, grades) em 0.15. O cérebro processa saliência visual em camadas.

Espaço para respirar. Toda animação precisa de self.wait() depois dela. O espectador precisa de tempo para absorver o que acabou de aparecer. Nunca se apresse de uma animação para a outra. Uma pausa de 2 segundos após uma revelação chave nunca é desperdiçada.

Linguagem visual coesa. Todas as cenas compartilham uma paleta de cores, tamanhos de tipografia consistentes, velocidades de animação correspondentes. Um vídeo tecnicamente correto onde cada cena usa cores aleatórias diferentes é um fracasso estético.

Pré-requisitos

Execute scripts/setup.sh para verificar todas as dependências. Requer: Python 3.10+, Manim Community Edition v0.20+ (pip install manim), LaTeX (texlive-full no Linux, mactex no macOS) e ffmpeg. Documentação de referência testada contra Manim CE v0.20.1.

Modos

ModoEntradaSaídaReferência
Explicador de conceitoTópico/conceitoExplicação animada com intuição geométricareferences/scene-planning.md
Derivação de equaçãoExpressões matemáticasProva animada passo a passoreferences/equations.md
Visualização de algoritmoDescrição do algoritmoExecução passo a passo com estruturas de dadosreferences/graphs-and-data.md
História de dadosDados/métricasGráficos animados, comparações, contadoresreferences/graphs-and-data.md
Diagrama de arquiteturaDescrição do sistemaComponentes se construindo com conexõesreferences/mobjects.md
Explicador de artigoArtigo de pesquisaDescobertas e métodos principais animadosreferences/scene-planning.md
Visualização 3DConceito 3DSuperfícies rotacionáveis, curvas paramétricas, geometria espacialreferences/camera-and-3d.md

Stack

Script Python único por projeto. Sem navegador, sem Node.js, sem GPU necessária.

CamadaFerramentaFinalidade
NúcleoManim Community EditionRenderização de cena, motor de animação
MatemáticaLaTeX (texlive/MiKTeX)Renderização de equações via MathTex
E/S de vídeoffmpegMontagem de cenas, conversão de formato, multiplexação de áudio
TTSElevenLabs / Qwen3-TTS (opcional)Narração

Pipeline

PLANEJAR --> CODIFICAR --> RENDERIZAR --> MONTAR --> ÁUDIO (opcional) --> REVISAR
  1. PLANEJAR — Escreva plan.md com arco narrativo, lista de cenas, elementos visuais, paleta de cores, roteiro de narração
  2. CODIFICAR — Escreva script.py com uma classe por cena, cada uma renderizável independentemente
  3. RENDERIZAR — manim -ql script.py Scene1 Scene2 ... para rascunho, -qh para produção
  4. MONTAR — concatenação ffmpeg dos clipes de cena em final.mp4
  5. ÁUDIO (opcional) — Adicione narração e/ou música de fundo via ffmpeg. Veja references/rendering.md
  6. REVISAR — Renderize imagens de pré-visualização, verifique contra o plano, ajuste

Estrutura do Projeto

nome-do-projeto/
  plan.md                # Arco narrativo, detalhamento das cenas
  script.py              # Todas as cenas em um arquivo
  concat.txt             # Lista de cenas para ffmpeg
  final.mp4              # Saída montada
  media/                 # Gerado automaticamente pelo Manim
    videos/script/480p15/

Direção Criativa

Paletas de Cores

PaletaFundoPrimáriaSecundáriaDestaqueCaso de uso
3B1B Clássico#1C1C1C#58C4DD (AZUL)#83C167 (VERDE)#FFFF00 (AMARELO)Matemática/CC geral
Acadêmico acolhedor#2D2B55#FF6B6B#FFD93D#6BCB77Acessível
Tecnológico neon#0A0A0A#00F5FF#FF00FF#39FF14Sistemas, arquitetura
Monocromático#1A1A2E#EAEAEA#888888#FFFFFFMinimalista

Velocidade de Animação

Contextorun_timeself.wait() após
Título/intro aparecer1.5s1.0s
Revelação de equação chave2.0s2.0s
Transformar/morfar1.5s1.5s
Rótulo de suporte0.8s0.5s
Limpeza com FadeOut0.5s0.3s
Revelação do "momento aha"2.5s3.0s

Escala Tipográfica

FunçãoTamanho da fonteUso
Título48Títulos de cena, texto de abertura
Cabeçalho36Cabeçalhos de seção dentro de uma cena
Corpo30Texto explicativo
Rótulo24Anotações, rótulos de eixos
Legenda20Subtítulos, letras miúdas

Fontes

Use fontes monoespaçadas para todo o texto. O renderizador Pango do Manim produz kerning quebrado com fontes proporcionais em todos os tamanhos. Veja references/visual-design.md para recomendações completas.

MONO = "Menlo"  # defina uma vez no topo do arquivo

Text("Fourier Series", font_size=48, font=MONO, weight=BOLD)  # títulos
Text("n=1: sin(x)", font_size=20, font=MONO)                  # rótulos
MathTex(r"\nabla L")                                            # matemática (usa LaTeX)

Tamanho mínimo font_size=18 para legibilidade.

Variação por Cena

Nunca use configuração idêntica para todas as cenas. Para cada cena:

  • Cor dominante diferente da paleta
  • Layout diferente — nem sempre centralize tudo
  • Entrada de animação diferente — varie entre Write, FadeIn, GrowFromCenter, Create
  • Peso visual diferente — algumas cenas densas, outras esparsas

Fluxo de Trabalho

Passo 1: Planejar (plan.md)

Antes de qualquer código, escreva plan.md. Veja references/scene-planning.md para o modelo completo.

Passo 2: Codificar (script.py)

Uma classe por cena. Cada cena é renderizável independentemente.

from manim import *

BG = "#1C1C1C"
PRIMARY = "#58C4DD"
SECONDARY = "#83C167"
ACCENT = "#FFFF00"
MONO = "Menlo"

class Cena1_Introducao(Scene):
    def construct(self):
        self.camera.background_color = BG
        title = Text("Por que Isso Funciona?", font_size=48, color=PRIMARY, weight=BOLD, font=MONO)
        self.add_subcaption("Por que isso funciona?", duration=2)
        self.play(Write(title), run_time=1.5)
        self.wait(1.0)
        self.play(FadeOut(title), run_time=0.5)

Padrões chave:

  • Legendas em cada animação: self.add_subcaption("texto", duration=N) ou subcaption="texto" em self.play()
  • Constantes de cor compartilhadas no topo do arquivo para consistência entre cenas
  • self.camera.background_color definido em cada cena
  • Saídas limpas — FadeOut em todos os mobjects ao final da cena: self.play(FadeOut(Group(*self.mobjects)))

Passo 3: Renderizar

manim -ql script.py Cena1_Introducao Cena2_ConceitoCentral  # rascunho
manim -qh script.py Cena1_Introducao Cena2_ConceitoCentral  # produção

Passo 4: Montar

cat > concat.txt << 'EOF'
file 'media/videos/script/480p15/Cena1_Introducao.mp4'
file 'media/videos/script/480p15/Cena2_ConceitoCentral.mp4'
EOF
ffmpeg -y -f concat -safe 0 -i concat.txt -c copy final.mp4

Passo 5: Revisar

manim -ql --format=png -s script.py Cena2_ConceitoCentral  # imagem de pré-visualização

Notas de Implementação Críticas

Strings Raw para LaTeX

# ERRADO: MathTex("\frac{1}{2}")
# CERTO:
MathTex(r"\frac{1}{2}")

buff >= 0.5 para Texto na Borda

label.to_edge(DOWN, buff=0.5)  # nunca < 0.5

FadeOut Antes de Substituir Texto

self.play(ReplacementTransform(nota1, nota2))  # não Write(nota2) por cima

Nunca Animem Mobjects Não Adicionados

self.play(Create(circulo))  # deve adicionar primeiro
self.play(circulo.animate.set_color(RED))  # depois animar

Metas de Desempenho

QualidadeResoluçãoFPSVelocidade
-ql (rascunho)854x480155-15s/cena
-qm (médio)1280x7203015-60s/cena
-qh (produção)1920x10806030-120s/cena

Sempre itere em -ql. Renderize em -qh apenas para saída final.

Referências

ArquivoConteúdo
references/animations.mdAnimações principais, funções de taxa, composição, sintaxe .animate, padrões de temporização
references/mobjects.mdTexto, formas, VGroup/Group, posicionamento, estilização, mobjects personalizados
references/visual-design.md12 princípios de design, camadas de opacidade, modelos de layout, paletas de cores
references/equations.mdLaTeX no Manim, TransformMatchingTex, padrões de derivação
references/graphs-and-data.mdEixos, plotagem, BarChart, dados animados, visualização de algoritmos
references/camera-and-3d.mdMovingCameraScene, ThreeDScene, superfícies 3D, controle de câmera
references/scene-planning.mdArcos narrativos, modelos de layout, transições de cena, modelo de planejamento
references/rendering.mdReferência de CLI, predefinições de qualidade, ffmpeg, fluxo de narração, exportação GIF
references/troubleshooting.mdErros de LaTeX, erros de animação, erros comuns, depuração
references/animation-design-thinking.mdQuando animar vs. mostrar estático, decomposição, ritmo, sincronização de narração
references/updaters-and-trackers.mdValueTracker, add_updater, always_redraw, updaters baseados em tempo, padrões
references/paper-explainer.mdTransformar artigos de pesquisa em animações — fluxo de trabalho, modelos, padrões de domínio
references/decorations.mdSurroundingRectangle, Brace, setas, DashedLine, Angle, ciclo de vida de anotações
references/production-quality.mdListas de verificação pré-código, pré-render e pós-render, layout espacial, cor, tempo

Divergência Criativa (use apenas quando o usuário solicitar saída experimental/criativa/única)

Se o usuário pedir abordagens explicativas criativas, experimentais ou não convencionais, selecione uma estratégia e raciocine sobre ela ANTES de projetar a animação.

  • SCAMPER — quando o usuário quer uma nova abordagem para uma explicação padrão
  • Reversão de Suposições — quando o usuário quer desafiar como algo é tipicamente ensinado

Transformação SCAMPER

Pegue uma visualização matemática/técnica padrão e transforme-a:

  • Substituir: substitua a metáfora visual padrão (linha numérica → caminho sinuoso, matriz → grade urbana)
  • Combinar: mescle duas abordagens de explicação (algébrica + geométrica simultaneamente)
  • Reverter: derive para trás — comece do resultado e desconstrua até os axiomas
  • Modificar: exagere um parâmetro para mostrar por que ele importa (10x a taxa de aprendizado, 1000x o tamanho da amostra)
  • Eliminar: remova toda a notação — explique puramente através de animação e relações espaciais

Reversão de Suposições

  1. Liste o que é "padrão" sobre como este tópico é visualizado (esquerda-para-direita, 2D, passos discretos, notação formal)
  2. Escolha a suposição mais fundamental
  3. Reverta-a (derivação direita-para-esquerda, incorporação 3D de um conceito 2D, morfismo contínuo em vez de passos, zero notação)
  4. Explore o que a reversão revela que a abordagem padrão esconde

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

govindgoel2001/video-editing-toolkit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

govindgoel2001/video-editing-toolkit

HyperFrames CLI tool — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting, validating, inspecting visual layout in compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

govindgoel2001/video-editing-toolkit

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

govindgoel2001/video-editing-toolkit

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

govindgoel2001/video-editing-toolkit

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

govindgoel2001/video-editing-toolkit

Edit any video by conversation. Transcribe, cut, color grade, generate overlay animations, burn subtitles — for talking heads, montages, tutorials, travel, interviews. No presets, no menus. Ask questions, confirm the plan, execute, iterate, persist. Production-correctness rules are hard; everything else is artistic freedom.

Habilidades Relacionadas