Communitygithub.com

delorenj/skills

Animações Manim CE: vídeos matemáticos/algorítmicos estilo 3Blue1Brown.

O que é skills?

Esta skill capacita agentes de IA (como Claude Code, Cursor ou Codex) a produzir vídeos explicativos animados de alta qualidade usando Manim Community Edition, inspirados pelo estilo do canal 3Blue1Brown. Ela cobre desde o planejamento narrativo até a renderização final, incluindo visualizações de algoritmos, derivações de equações, diagramas de arquitetura e histórias baseadas em dados. A skill enfatiza padrões criativos rigorosos, como hierarquia visual com opacidade, ritmo com pausas, paletas de cores coerentes e variação entre cenas. O pipeline é baseado em um único script Python, sem dependências de navegador ou GPU, e inclui modos específicos para diferentes tipos de conteúdo, com referências detalhadas para animações, design visual, equações e resolução de problemas. Ideal para desenvolvedores e educadores que desejam criar conteúdo educacional cinematográfico programaticamente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/delorenj/skills/tree/HEAD/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

Quando usar

Use quando o usuário solicitar: explicações animadas, animações matemáticas, visualizações de conceitos, demonstrações de algoritmos, vídeos explicativos técnicos, vídeos estilo 3Blue1Brown, ou qualquer animação programática com conteúdo geométrico/matemático. Cria vídeos explicativos no estilo 3Blue1Brown, visualizações de algoritmos, derivações de equações, diagramas de arquitetura e histórias baseadas em dados usando Manim Community Edition.

Padrão Criativo

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

Antes de escrever uma única linha de código, articule o arco narrativo. Que equívoco isso corrige? Qual é o "momento de insight"? Que história visual leva o espectador da confusão à compreensão? 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 na primeira renderização não é negociável. A saída deve ser visualmente clara e esteticamente coesa sem rodadas de revisão. Se algo parecer poluído, mal cronometrado ou como "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 é desperdício.

Linguagem visual coesa. Todas as cenas compartilham uma paleta de cores, tamanhos de tipografia consistentes e velocidades de animação compatíveis. 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. A documentação de referência foi testada com Manim CE v0.20.1.

Modos

ModoEntradaSaídaReferência
Explicador de conceitosTópico/conceitoExplicação animada com intuição geométricareferences/scene-planning.md
Derivação de equaçõesExpressõ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 com 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

Script Python único 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
Video I/OffmpegJunção de cenas, conversão de formato, mixagem de áudio
TTSElevenLabs / Qwen3-TTS (opcional)Narração por voz

Pipeline

PLANEJAR → CODIFICAR → RENDERIZAR → JUNTAR → Á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. JUNTAR — Concatenação com 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 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 unida
  media/                 # Gerado automaticamente pelo Manim
    videos/script/480p15/

Direção Criativa

Paletas de Cores

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

Velocidade de Animação

Contextorun_timeself.wait() após
Título/intro aparecem1.5s1.0s
Revelação de equação chave2.0s2.0s
Transformar/transformar1.5s1.5s
Rótulo de suporte0.8s0.5s
Limpeza FadeOut0.5s0.3s
Revelação do "momento de insight"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
Legenda20Legendas, texto pequeno

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 — não centralize tudo sempre
  • 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 abrangente.

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
        titulo = 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(titulo), run_time=1.5)
        self.wait(1.0)
        self.play(FadeOut(titulo), run_time=0.5)

Padrões chave:

  • Legendas em toda animação: self.add_subcaption("texto", duration=N) ou subcaption="texto" em self.play()
  • Constantes de cores 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: Juntar

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 Críticas de Implementação

Strings Raw para LaTeX

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

buff >= 0.5 para Texto nas Bordas

rotulo.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 com -ql. Renderize com -qh apenas 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, sincronia com 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, Ângulo, 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 reflita sobre ela ANTES de projetar a animação.

  • SCAMPER — quando o usuário quiser uma nova abordagem para uma explicação padrão
  • Inversão de Suposição — quando o usuário quiser 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 tortuoso, 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 notação — explique apenas por animação e relações espaciais

Inversão de Suposição

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

Individual skills in this repo

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

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

delorenj/skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

delorenj/skills

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.

delorenj/skills

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 dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

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.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

Habilidades Relacionadas