Cómo usar

Esta página recorre el flujo completo, desde una carpeta vacía hasta un deck animado listo.

1. Instala y vincula

cd mi-carpeta-de-slides
npx mira-animator install
npx mira-animator link ../mi-proyecto --name=miproyecto

Mira Instalación y Fuentes vinculadas para más detalles.

2. Crea un deck

Crear un deck es conversacional — solo habla con /mira-new dentro de Claude:

/mira-new crea una nueva presentación llamada 'mi-clase'

Pregunta solo el nombre del tema y en seguida crea la carpeta decks/<tema>/ con la references/ lista, mostrándote su ruta completa. Ahí se detiene y pregunta cómo quieres empezar: contarle por texto en el chat de qué trata la presentación, o poner tus archivos (PDF, documento, capturas, enlaces) en la carpeta de referencias y avisarle. Solo después pregunta el resto (plantilla del deck, tema base, color principal), monta el deck y ofrece accionar el pipeline.

La carpeta va primero por una razón práctica: si ya tienes el material a mano, necesitas un lugar donde ponerlo antes de decidir plantilla y color. Si vuelves más tarde, en la misma sesión o en otra, /mira-new reconoce la carpeta como un deck en curso, lista lo que encontró en references/ y continúa donde lo dejaste.

También puedes indicar la plantilla y el tema en la misma frase:

/mira-new crea una presentación llamada 'mi-clase' con la plantilla aula-capitulo y el tema mira-dark

Plantillas de deck

Plantilla	Para
mira-default	Por defecto. Titulo arriba, animacion ocupando el resto del slide
aula-capitulo	Una clase o conferencia a partir de un capítulo / módulo
pitch-projeto	Un pitch de proyecto
demo-tecnica	Una demo técnica / walkthrough
sandeco-just-animation-template	Un escenario negro, sin texto, solo para la animacion de Mira

Temas: mira-dark, light-minimal, corporate-blue, neon-emerald.

Atajo: el deck completo de una vez

Si prefieres no pasar por los pasos 2 y 3 por separado, /mira-fast hace todo en una sola llamada, generando los slides en paralelo:

/mira-fast spec driven development
/mira-fast /mira-vertical el libro en references/mi-libro.pdf

No pregunta nada, del tema al HTML final, y por eso no apruebas el plan de slides a mitad de camino. También crea la carpeta del deck con la references/ antes de planificar, y falla avisando si señalas una fuente que no existe. Necesita Dynamic workflows habilitado en /config.

3. Rellena el deck

De vuelta en Claude, apunta un deck a una fuente en lenguaje natural:

"rellena el deck mi-clase con el contenido de la fuente miproyecto"

Esto dispara el pipeline de agentes:

flowchart LR
    E[mira-extract] --> P[mira-planner]
    P --> C[mira-copywriter]
    C --> B[mira-builder]
    B --> A[mira-animator]
    A --> V[mira-validator]

Cada orquestador pausa entre los agentes y te mantiene en control. El planner, en particular, te muestra el plan de slides y espera aprobación antes de montar nada.

4. Ajusta las animaciones

Con el deck montado, puedes moldear el movimiento:

• Tamaño — "pon las animaciones en 6/10" o "este slide está pequeño, déjalo en 7/10". El agente mira-size-animator escala la percepción de tamaño de cada animación en una escala de 1 a 10 (el valor por defecto que genera mira-animator es 3/10).
• Metáfora — "convierte este concepto en una metáfora animada". El propio mira-animator reemplaza la animación de un slide por otra analogía concreta de la vida diaria, en el lugar, manteniendo el título y las píldoras.
• Visuales — pide a mira-visuals paneles estáticos, diagramas o infografías, o a mira-chart gráficos de datos a partir de un CSV/JSON, una imagen, o incluso un boceto a mano, o a mira-chart-race para datos temporales que corren en el tiempo (barras que se reordenan o líneas que se dibujan).
• 3D, QR, quizzes e imágenes: coloca un elemento 3D real y auto-rotante con /mira-3d, un código QR escaneable (a partir de un enlace o texto) con /mira-qrcode, un quiz en vivo con revelación de respuesta correcta controlada por el presentador usando /mira-quiz, o una imagen que ya tienes con /mira-image. Un slide 3D que carga un .glb necesita un servidor local (el agente arranca uno y escribe un lanzador de doble clic); todo lo demás se abre desde file://.
• Morph de formas: haz que una forma SVG se transforme en otra en bucle con /mira-svg-morph (pasas los archivos), o /mira-icon-morph para hacerlo a partir de conceptos en palabras, con íconos buscados y licenciados en Iconify.
• Animar un SVG: haz que un SVG que provees se mueva (batir, girar, deslizar, pulsar, dibujar) con /mira-svg-animator; si es un path único fusionado, separa la parte a animar.

4.5 El deck aprende tu gusto

Mira guarda una memoria local de tus correcciones. En cada Guardar del modo edición (tecla E), la diferencia entre lo que generó el builder y lo que corregiste se añade a ~/.mira-memory/evidencia.jsonl. Nada sale de tu máquina.

• Dictar una regla ahora: npx mira-animator memoria nota "menos texto por slide" --eixo densidade. Se convierte en nota activa al instante y el builder la sigue en el próximo deck.
• Dejar que aprenda solo: npx mira-animator memoria consolidar convierte lo que se repitió (3 episodios, 3 decks distintos, 2 sesiones) en nota candidata. Una candidata nunca se aplica hasta que la actives con memoria estado <archivo> ativo.
• Las notas son tuyas: markdown plano en ~/.mira-memory/notas/. Ábrelas, edítalas o revócalas. Revocar es un estado, nunca un borrado.
• La marca siempre manda: #FF904D, equilibrio de la portada y área segura están por encima de lo aprendido.

5. Abre y presenta

El deck es un decks/mi-clase/index.html autocontenido. Doble clic — corre desde file://, sin servidor. Navega card por card. Para hacer un video, graba la pantalla con el viewport ajustado a la resolución del formato objetivo.

6. Exporta a otros formatos (opcional)

A partir del mismo deck 16:9, sin tocar el original, puedes generar versiones cuadrada, vertical, en regla de los tercios y con transición disolvencia. Mira Formatos de vídeo.

Una nota sobre el idioma

Mira genera el contenido del deck en el idioma en que trabajas. La regla de idioma compartida vive en agents/_shared/idioma.md y la respetan todos los agentes, así que los slides salen en tu idioma, no en el predeterminado del agente.