Communitygithub.com

assafkip/claude-video-editor

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. Use quando o usuário solicitar: explicações animadas, animações matemáticas, visualizações de conceitos, demonstrações de algoritmos, explicadores técnicos, vídeos estilo 3Blue1Brown ou qualquer animação programática com conteúdo geométrico/matemático.

O que é claude-video-editor?

Este skill implementa um pipeline completo de produção de vídeos educacionais animados usando Manim Community Edition, inspirado no estilo visual do canal 3Blue1Brown. Ele é projetado para desenvolvedores e criadores de conteúdo que desejam transformar conceitos matemáticos, algoritmos, equações e dados em animações de alta qualidade, com foco em clareza pedagógica e estética coerente. O pipeline segue seis etapas: Planejar (escrever o arco narrativo), Codificar (criar cenas em Python), Renderizar (usar `manim` com qualidade de rascunho ou produção), Costurar (com ffmpeg), Adicionar Áudio (opcional, com narração via TTS) e Revisar. O skill enfatiza a criação de um `plan.md` antes de qualquer código, definindo paletas de cores fixas, escalas de tipografia monoespaçada, tempos de animação e variação entre cenas para evitar repetição visual. Suporta diversos modos de uso: explicador de conceitos, derivação de equações, visualização de algoritmos, histórias de dados, diagramas de arquitetura, explicador de artigos e visualizações 3D. O stack é enxuto: apenas Python, Manim, LaTeX e ffmpeg, sem necessidade de navegador ou GPU. Referências detalhadas em markdown cobrem desde design visual até sincronização de narração. Para saídas criativas, o skill oferece estratégias de divergência como SCAMPER e inversão de suposições, permitindo abordagens inovadoras para explicações técnicas.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/assafkip/claude-video-editor/tree/HEAD/skills/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ídeos 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 conceito equivocado este vídeo 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 desordenado, mal cronometrado ou com "aparência de slides gerados por IA", está errado.

Camadas de opacidade direcionam a atenção. Nunca mostre tudo com 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 próxima. 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 e velocidades de animação combinadas. Um vídeo tecnicamente correto onde cada cena usa cores aleatórias diferentes é uma falha estética.

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 com 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 pesquisaPrincipais descobertas e métodos animadosreferences/scene-planning.md
Visualização 3DConceito 3DSuperfícies giratórias, curvas paramétricas, geometria espacialreferences/camera-and-3d.md

Stack

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

CamadaFerramentaPropósito
NúcleoManim Community EditionRenderização de cenas, motor de animação
MatemáticaLaTeX (texlive/MiKTeX)Renderização de equações via MathTex
I/O de vídeoffmpegCostura de cenas, conversão de formato, multiplexação de áudio
TTSElevenLabs / Qwen3-TTS (opcional)Narração por voz

Pipeline

PLANEJAR --> CODIFICAR --> RENDERIZAR --> COSTURAR --> Á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 Cena1 Cena2 ... para rascunho, -qh para produção
  4. COSTURAR — Concatenação com ffmpeg dos clipes das cenas 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 em relação ao 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 costurada
  media/                 # Gerado automaticamente pelo Manim
    videos/script/480p15/

Direção Criativa

Paletas de Cores

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

Velocidade de Animação

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

Escala de Tipografia

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("Série de Fourier", 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

Etapa 1: Planejar (plan.md)

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

Etapa 2: Codificar (script.py)

Uma classe por cena. Toda 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:

  • Subtítulos em toda 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 toda cena
  • Saídas limpas — FadeOut de todos os mobjects ao final da cena: self.play(FadeOut(Group(*self.mobjects)))

Etapa 3: Renderizar

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

Etapa 4: Costurar

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

Etapa 5: Revisar

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

Notas Críticas de Implementação

Strings Raw para LaTeX

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

buff >= 0.5 para Texto nas Bordas

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 Anime Mobjects Não Adicionados

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

Metas de Performance

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

Sempre itere em -ql. Só renderize em -qh para a 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 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.mdTransformando 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é-renderização e pós-renderização, 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
  • Inversã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: troque a metáfora visual padrão (reta numérica → caminho sinuoso, matriz → grade urbana)
  • Combinar: mescle duas abordagens explicativas (algébrica + geométrica simultaneamente)
  • Reverter: derive ao contrário — comece pelo 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 notação — explique puramente através de animação e relações espaciais

Inversã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. Inverta-a (derivação da direita para a esquerda, incorporação 3D de um conceito 2D, transformação contínua em vez de passos, notação zero)
  4. Explore o que a inversão revela que a abordagem padrão esconde

Individual skills in this repo

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

assafkip/claude-video-editor

Build videos from stills when there is nothing to cut — narration first (ElevenLabs v3 with audio tags), then still keyframes from ANY source (AI image tools, screenshots, photos, HyperFrames-rendered HTML), animated deterministically with the animate-stills recipe (HyperFrames camera moves + GSAP atmosphere). Use when the user wants an explainer, documentary-style video, or any video built from generated or collected visuals instead of recorded footage.

assafkip/claude-video-editor

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.

assafkip/claude-video-editor

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

assafkip/claude-video-editor

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.

assafkip/claude-video-editor

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.

assafkip/claude-video-editor

Beginner-friendly end-to-end video creator for HyperFrames. Use when the user says "make a video", "create a video", "new video", "build a video", "video from scratch", "I want to make a video", "help me create a video", or when someone who's never used HyperFrames before arrives with a concept, script, or rough idea and wants a finished MP4. Interviews the user in one pass, then builds the full video with mandatory preview and visual-verification gates.

assafkip/claude-video-editor

Build and iterate short-form vertical (9:16) videos in Hyperframes — TikTok/Reels/Shorts style. Use when Nate says "short-form video", "vertical video", "TikTok/Reels/Shorts", "make a short", "talking-head + motion graphics", or when the target is a 1080x1920 composition with face video + synced scene overlays + karaoke captions. Encodes the full May Shorts 19 playbook: face-mode choreography, audio-synced scene timing, karaoke captions, and the 10-rule quality checklist.

assafkip/claude-video-editor

Edit any video by conversation — the orchestrator for the bundled video pipeline. Use when the user wants to edit, cut, caption, grade, or add motion graphics to footage; drops a folder of clips and says "edit this"; or asks to make a promo/teaser/tutorial/short. Routes to video-use (the cut engine) and HyperFrames (motion-graphics overlays), with a motion-craft library for taste.

assafkip/claude-video-editor

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.

Habilidades Relacionadas