Communitygithub.com

syahdestiny/manim-composer

Transforma ideias vagas de vídeos educacionais em planos detalhados cena por cena (scenes.md) para animações Manim no estilo 3Blue1Brown.

O que é manim-composer?

O Manim Composer é uma habilidade especializada para agentes de IA (como Claude Code, Cursor, Codex) que auxilia na criação de roteiros e planos visuais para vídeos educacionais de matemática e ciências usando a biblioteca Manim (como 3Blue1Brown). Ele transforma conceitos vagos em arquivos `scenes.md` estruturados, com definições de cenas, elementos visuais, notas de narração e dicas técnicas. O processo segue três fases: (1) pesquisa profunda do tópico, identificando o 'aha moment' e conceitos-chave; (2) questionamento direcionado ao usuário sobre público, escopo e estilo; (3) geração do documento `scenes.md` completo, seguindo princípios de narrativa visual, ritmo e beleza matemática. Útil para educadores, criadores de conteúdo e qualquer pessoa que queira transformar uma ideia abstrata em um vídeo animado bem planejado, sem precisar dominar todos os detalhes técnicos do Manim.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/syahdestiny/skill-motion-manim-skill/tree/HEAD/skills/manim-composer

Perguntar na sua IA favorita

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

Documentação

Fluxo de Trabalho

Fase 1: Entender o Conceito

  1. Pesquise profundamente o tópico antes de fazer perguntas

    • Use pesquisa na web para entender os conceitos centrais
    • Identifique os insights-chave que tornam este tópico interessante
    • Encontre o "momento aha" - o que faz o aprendizado clicar
    • Observe equívocos comuns a serem abordados
  2. Identifique o gancho narrativo

    • Que pergunta este vídeo responde?
    • Por que o espectador deveria se importar?
    • Qual é o elemento surpreendente ou contraintuitivo?

Fase 2: Esclarecer com o Usuário

Faça perguntas direcionadas (não todas de uma vez - adapte conforme as respostas):

Público & Escopo

  • Qual formação em matemática/ciências devo assumir? (ex.: "sabe cálculo" ou "álgebra do ensino médio")
  • Duração desejada do vídeo? (curto: 5-10min, médio: 15-20min, longo: 30min+)
  • Deve ser autossuficiente ou parte de uma série?

Foco & Profundidade

  • Algum aspecto específico a enfatizar ou pular?
  • Foco em demonstrações formais ou intuição?
  • Incluir aplicações do mundo real?

Preferências de Estilo

  • Preferências de esquema de cores?
  • Estilo de narração? (casual, formal, lúdico)
  • Alguma metáfora visual específica em mente?

Fase 3: Criar scenes.md

Gere um arquivo scenes.md abrangente com esta estrutura:

# [Título do Vídeo]

## Visão Geral
- **Tópico**: [Conceito central]
- **Gancho**: [Pergunta/mistério de abertura]
- **Público-Alvo**: [Pré-requisitos]
- **Duração Estimada**: [X minutos]
- **Insight-Chave**: [O "momento aha"]

## Arco Narrativo
[2-3 frases descrevendo a jornada da confusão à compreensão]

---

## Cena 1: [Nome da Cena]
**Duração**: ~X segundos
**Propósito**: [O que esta cena realiza]

### Elementos Visuais
- [Lista de mobjects necessários]
- [Animações a serem usadas]
- [Movimentos de câmera]

### Conteúdo
[Descrição detalhada do que acontece, o que é mostrado, o que é explicado]

### Notas de Narração
[Pontos-chave a transmitir, tom, notas de ritmo]

### Notas Técnicas
- [Classes/métodos específicos do Manim a usar]
- [Quaisquer implementações complicadas a notar]

---

## Cena 2: [Nome da Cena]
...

---

## Transições & Fluxo
[Notas sobre como as cenas se conectam, motivos visuais recorrentes]

## Paleta de Cores
- Primária: [cor] - usada para [propósito]
- Secundária: [cor] - usada para [propósito]
- Destaque: [cor] - usada para [propósito]
- Fundo: [cor]

## Conteúdo Matemático
[Lista de equações, fórmulas ou objetos matemáticos que precisam ser renderizados]

## Ordem de Implementação
[Ordem sugerida para implementar as cenas, observando dependências]

Princípios de Estilo 3b1b

Aplique estes princípios ao compor as cenas:

Narrativa Visual

  • Mostre, não apenas conte - Cada conceito precisa de uma representação visual
  • Revelação progressiva - Construa complexidade gradualmente, não mostre tudo de uma vez
  • Continuidade visual - Transforme objetos em vez de substituí-los quando possível

Ritmo & Cadência

  • Pausa para insight - Dê tempo aos espectadores para absorver momentos-chave
  • Varie o ritmo - Misture sequências rápidas com explicações mais lentas
  • Termine cenas com resolução - Cada cena deve parecer completa

Beleza Matemática

  • Enfatize a elegância - Destaque quando a matemática é surpreendentemente simples ou bela
  • Conecte representações - Mostre o mesmo conceito de várias maneiras (algébrica, geométrica, intuitiva)
  • Abrace a abstração gradualmente - Comece concreto, depois generalize

Técnicas de Engajamento

  • Faça perguntas - Torne os espectadores curiosos antes de revelar as respostas
  • Reconheça a dificuldade - "Isso pode parecer confuso no início..."
  • Celebre o insight - Faça o "momento aha" parecer merecido

Referências

Modelos

Habilidades Relacionadas