mira-animator
v0.1.16
Published
Agentes e templates para criação de slides animados com D3.js em HTML
Maintainers
Readme
Mira
Slides animados com D3 — mire a atenção onde importa.
O Mira é um conjunto de agentes, skills e templates para criar apresentações HTML animadas (D3.js v7 + Tailwind + glassmorphism) a partir do conteúdo dos seus projetos, livros ou PDFs. Ele segue a filosofia do Reversa: instala-se numa pasta de trabalho isolada e lê conteúdo de fontes vinculadas, sem misturar nada com os projetos de origem.
Instalação
cd minha-pasta-de-slides
npx mira-animator installA instalação copia os agents para .claude/skills/, os templates para mira-templates/, cria a pasta decks/ e escreve mira.config.json + CLAUDE.md.
Conceito central: fontes vinculadas
O Mira nunca é instalado dentro do projeto sobre o qual você quer apresentar. Em vez disso, você vincula fontes:
# uma pasta de outro projeto
npx mira-animator link C:/projetos/reversa --name=reversa
# um PDF na própria pasta
npx mira-animator link ./inbox/artigo.pdf
# listar fontes
npx mira-animator sourcesOs agentes leem das fontes, mas escrevem somente em decks/.
Criando um deck
No Claude, use a skill /mira-new: ela conduz a criação de forma conversacional (nome do tema, template, tema base, cor principal e referências), monta a pasta decks/<tema>/ e, ao final, oferece acionar o pipeline.
Ou direto pelo CLI:
npx mira-animator new minha-aula --deck=aula-capitulo --theme=mira-darkTemplates de deck: aula-capitulo, pitch-projeto, demo-tecnica.
Temas: mira-dark, light-minimal, corporate-blue, neon-emerald.
Depois, no Claude: "preencha o deck minha-aula com o conteúdo da fonte reversa".
Pipeline de agentes
mira-extract lê a fonte vinculada e gera o briefing
mira-planner plano de slides + aprovação do usuário
mira-copywriter refinamento de texto e imagens
mira-builder montagem do HTML (glass-cards)
mira-animator animações D3 com loop interno (inclui diretrizes D3 em references/)
mira-size-animator ajusta a percepção de tamanho das animações numa escala de 1 a 10 (base 3/10)
mira-animated-metaphor transforma a animação de um slide na metáfora visual do conceito
mira-visuals imagens estáticas: painéis, diagramas, gráficos e infográficos
mira-validator relatório de conformidade finalApoio: mira-image-prompt (prompts JSON para foto realista), mira-img-animator (anima imagens existentes) e mira-chart (gráficos de dados a partir de CSV/JSON ou de imagens e rascunhos à mão, com recomendação do melhor tipo). Regra de idioma compartilhada em agents/_shared/idioma.md.
O mira-size-animator lê o marcador <!-- @MIRA:SIZE N/10 --> que o mira-animator estampa em cada animação (sempre 3/10 ao gerar) e escala a composição dentro do SVG para preencher mais ou menos o palco, sem alterar a altura do palco nem o loop interno. "Coloca as animações em 6/10" sobe o nível; "esse slide em 2/10" desce.
Outros formatos de vídeo
A partir do deck 16:9, sem tocar no original:
mira-squaredcriaindex-1x1.html, versão quadrada 1080x1080 (feed, LinkedIn).mira-verticalcriaindex-9x16.html, versão vertical 1080x1920 (Reels, Shorts, Stories, TikTok).
Cada um fixa os slides na proporção alvo (moldura fixa) e reduz os espaços laterais. Grave com a viewport ajustada à resolução do formato.
E uma variante de composição (não muda a proporção):
mira-thirdscriaindex-thirds.html, regra dos terços: empurra o conteúdo do slide para as colunas 1+2 (dois terços da esquerda) e deixa a coluna da direita livre, para você sobrepor texto, lower-third ou o vídeo do apresentador na edição. Combina por cima do 16:9, do 1:1 ou do 9:16.
E uma variante de transição:
mira-transition-dissolvecriaindex-dissolve.html: troca o scroll entre slides por um crossfade real (dissolve, estilo Canva), via View Transitions API. Funciona com clique duplo no arquivo (Chrome/Edge), sem servidor; navegadores sem a API navegam normal.
Templates
Três camadas em templates/:
themes/— identidade visual via CSS variables. O tema é injetado no deck na criação (/* @MIRA:THEME */).slides/— blueprints de tipos de slide: capa, conceito com animação D3, comparação, timeline, código, encerramento.decks/— apresentações completas e rodáveis que servem de esqueleto.
Comandos
| Comando | Descrição |
|---|---|
| npx mira-animator install | Instala na pasta atual |
| npx mira-animator link <caminho> | Vincula fonte de conteúdo |
| npx mira-animator sources | Lista
