Communitygithub.com

manim-animator

Projete, roteirize, crie, inspecione, renderize e corrija automaticamente animações matemáticas educacionais usando ManimGX (principal, Rust+GPU) e ManimCE (alternativa). Utiliza um fluxo de trabalho CLI local sem MCP, com enquadramento pedagógico, revisão de storyboard com objetos fantasmas, consulta de API com herança MRO e inspeção automatizada de layout.

O que é manim-animator?

Manim Animator é uma skill para agentes de IA que automatiza a criação de animações matemáticas educacionais de alta qualidade. O fluxo de trabalho é dividido em cinco estágios: enquadramento pedagógico e seleção de paradigma, storyboard detalhado com auditoria de objetos fantasmas, geração rigorosa de código com verificação de API, inspeção visual rápida e renderização, e correção automática de traçado e layout. A skill suporta tanto ManimGX (baseado em Rust com aceleração GPU) quanto ManimCE (versão clássica em Python) como alternativa, e oferece modos de operação dentro de um 'studio' workspace (com helpers de estilo e sincronia com voz) ou como scripts independentes. Um dos principais diferenciais é a abordagem 'zero-MCP': toda a lógica reside em scripts locais (search_api.py, inspect, etc.), sem depender de servidores MCP externos ou ferramentas de terceiros. A skill prioriza a inspeção visual rigorosa (storyboard PNG, verificação de colisão e margens seguras) e a correção autônoma de erros de renderização, layout e API, garantindo que o agente nunca adivinhe parâmetros ou ignore problemas visuais.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YZDame/manimcat-skills/tree/HEAD/skills/manim-animator

Perguntar na sua IA favorita

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

Documentação

Fluxo de Trabalho do Manim Animator (Sem MCP)

Você é um animador matemático especialista e designer de visualizações pedagógicas. Siga este fluxo de trabalho de 5 estágios para transformar um conceito ou script de ensino em animações matemáticas limpas e verificadas usando ManimGX (padrão) ou ManimCE (alternativa).


Estágio 1: Enquadramento Pedagógico e Seleção de Paradigma

Leia references/framing-and-storyboard.md para a metodologia de design completa. Antes de codificar, esclareça:

  1. Pergunta Central e Resposta: Indique a única pergunta que a animação responde (O que / Por que / Como) e sua resposta concisa em uma frase.
  2. Paradigma de Ensino (escolha a lente mais adequada):
    • Dualidade (对偶): Cada símbolo algébrico mapeia para uma entidade geométrica visível na tela.
    • Paradoxo (破解): Apresente um fenômeno contra-intuitivo primeiro, depois dissecque seu mecanismo.
    • Aproximação (逼近): Deslize de casos discretos/finitos em direção a um limite contínuo.
    • Projeção (降维): Construa intuição mecânica em 1D/2D antes de elevar para dimensões superiores.
  3. Arquétipo de Palco:
    • Divisão Esquerda-Direita: Derivação de fórmula/álgebra de um lado, movimento geométrico vinculado do outro.
    • Tela Cheia Central: Plano de coordenadas único ou plano complexo passando por transformação global.
    • Camadas Superior-Inferior: Fenômeno macro acima, detalhamento local/infinitesimal abaixo.
  4. Fundo Visível e Continuidade: Plante condições geométricas visíveis sem revelar a resposta; transforme objetos existentes de estágio para estágio em vez de apagar e redesenhar tudo.

Estágio 2: Storyboard de 5 Seções e Auditoria de Objetos Fantasmas

Planeje a linha do tempo exata e as coordenadas espaciais usando a lista de verificação de storyboard de 5 partes em references/framing-and-storyboard.md:

  1. 重点 (Pontos-chave): Momentos centrais de epifania e passos causais.
  2. 舞台 (Palco): Regiões da tela, coordenadas de âncora (x, y) exatas e zonas seguras para legendas (y > -2.6 quando composto com legendas).
  3. 物体动画 (Objetos e Ciclo de Vida): Declare explicitamente enter, keep, transform e exit para cada objeto nomeado em cada cena.
  4. 衔接变换 (Transições): Como cada cena se transforma ou transita para a próxima.
  5. 复检 (Revisão de Objetos Fantasmas): Audite cada cena em busca de objetos fantasmas—elementos que entram, param de mudar, nunca saem e colidem ou obscurecem cenas subsequentes.

Estágio 3: Geração Estrita de Código

Leia references/specification.md e references/visual-style.md antes de escrever código Python.

Detecção de Modo de Workspace

  • Dentro do Studio video (AGENTS.md / ./studio + studio_style.py):
    • Edite projects/<name>/script.md e projects/<name>/scenes.py.
    • Importe from studio_style import * (fornece m, np, constantes da paleta quente BG, CORAL, TEAL, INK, SAFE_BOTTOM = -2.6, helpers T(), M() e TimedScene).
    • Crie subclasses de TimedScene, sincronize animações com timestamps de narração (self.play_line(i, ...), self.wait_until(...), self.play_until(...)) , mantenha os elementos visuais principais acima de y > SAFE_BOTTOM e sempre termine com self.finish().
    • O mecanismo padrão é ManimGX (@manim SceneName). Se uma cena específica precisar de recursos do ManimCE não suportados no GX, marque @manim SceneName ce em script.md.
  • Cena Independente (Fora do Studio):
    • Use import manimgx as m (ou from manimgx import *) para ManimGX, ou from manim import * para ManimCE.
    • Aplique a paleta de luz quente (#F5F0E8 ou #FFF9F0) com cores de texto base escuras explícitas (#141413 ou #454545) para que texto e operadores nunca fiquem invisíveis (branco sobre creme).

Verificação de API (Sem Adivinhação)

Sempre que estiver em dúvida sobre uma classe, assinatura de método ou método herdado de Mobject, execute search_api.py (ou ./studio api dentro do workspace video):

python3 "<SKILL_DIR>/scripts/search_api.py" --engine gx --symbol Axes.c2p --query "tangent line"

Use --engine ce ao direcionar ManimCE. Nunca invente parâmetros ou adivinhe métodos não documentados.


Estágio 4: Inspeção Visual Rápida e Renderização

Nunca trate apenas um código de saída bem-sucedido como trabalho concluído—verifique visualmente o layout e colisões.

  • No Studio video:
    1. Execute ./studio voice <project> (se script.md tiver sido alterado) para gerar timeline.json.
    2. Execute inspeção rápida de layout e storyboard (~1s, sem codificação MP4):
      ./studio inspect <project>
      
      Isso invoca manimgx inspect, sinaliza legendas cortadas/sobrepostas/muito pequenas, sai com código diferente de zero em erros de layout e escreve projects/<project>/build/clips/<Scene>.storyboard*.png.
    3. Abra e inspecione visualmente *.storyboard*.png com read_file para verificar alinhamento, legibilidade e distância SAFE_BOTTOM.
    4. Renderize o rascunho/vídeo final:
      ./studio manim <project> --draft   # verificação rápida 720p
      ./studio manim <project>           # clipe de produção 1080p
      
  • Script ManimGX Independente:
    manimgx inspect scene.py MainScene -o storyboard.png
    manimgx render scene.py MainScene -o out.mp4
    
  • Script ManimCE Independente:
    manim -ql scene.py MainScene   # rascunho rápido
    manim -qh scene.py MainScene   # final 1080p60
    

Estágio 5: Correção de Traçado e Layout

Se a renderização ou inspect falhar:

  1. Consulte references/common-fixes.md para padrões de erro do ManimGX e ManimCE.
  2. Em caso de AttributeError ou TypeError, consulte <SKILL_DIR>/scripts/search_api.py para a classe/método com falha (suporta consulta de herança MRO).
  3. Se um storyboard manimgx inspect mostrar legendas sobrepostas, bordas cortadas ou objetos abaixo de SAFE_BOTTOM, ajuste coordenadas/âncoras ou use explicitamente FadeOut/exit em objetos remanescentes e execute inspect novamente até ficar limpo.
  4. Mantenha o design visual e matemático central intacto—nunca exclua um recurso educacional apenas para silenciar um erro.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas