Communitygithub.com

mertz1999/luma-assistant

Crea páginas de video demo cinemáticas para SaaS y presentaciones de productos grabables. Se utiliza cuando se le pide a Codex que construya una ruta /demo, un recorrido animado por el producto, una presentación promocional de SaaS, una página de grabación de pantalla, una demo narrada del producto, una historia de UI impulsada por cursor o un sistema de video demo reutilizable para una aplicación o sitio web.

¿Qué es luma-assistant?

Este skill permite a un agente de IA (como Codex) construir páginas de demostración de producto de alto nivel, similares a un video promocional de SaaS, pero renderizadas como una página web interactiva y de pantalla completa. En lugar de recorrer todas las funciones, el skill prioriza una historia corta centrada en el cliente: problema, acción del producto, momento del cliente, revelación del resultado y llamada a la acción final. El agente usaría este skill cuando se le pida explícitamente que cree o mejore rutas como `/demo`, `/presentation` o `/video-demo` en una aplicación web existente (por ejemplo, Next.js). El skill es útil porque automatiza la creación de una experiencia de demostración altamente pulida que puede grabarse directamente para su uso en marketing, sin necesidad de edición de video externa. Soporta plataformas como Next.js (usando Framer Motion para animaciones) y puede adaptarse a cualquier stack. El agente recopila información esencial (nombre del producto, marca, flujos de trabajo reales) y construye una serie de escenas con temporizadores, movimientos de cursor suaves, subtítulos en pantalla y transiciones cinemáticas. Para lograr precisión, el skill indica que se utilicen atributos `data-demo-cursor-target` y `getBoundingClientRect()` para calcular las posiciones del cursor, evitando coordenadas fijas y asegurando que la demo sea responsiva. Además, incluye pautas para sincronizar con audio de voz en off y validar la página final con pruebas de Playwright, verificando que no haya desbordamientos horizontales y que los elementos del teléfono sean visibles.

Compatible con~Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/mertz1999/luma-assistant/tree/HEAD/skills/saas-demo-video

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Video Demo SaaS

Resultado

Construye una página de demostración a pantalla completa con movimiento automático que pueda grabarse como un video pulido de producto SaaS. Prefiere una historia corta de cliente sobre un recorrido de funciones: gancho del problema, acción del producto, momento del cliente, revelación del resultado, resultado empresarial y CTA final.

Usa este skill para crear o mejorar rutas como /demo, /presentation, /video-demo o páginas HTML/React independientes equivalentes.

Entradas Requeridas

Recopila o deduce estas antes de la implementación. Pregunta solo por bloqueos.

  • Nombre del producto, dominio, audiencia y promesa principal.
  • Duración objetivo y relación de aspecto, normalmente 30-60 segundos y 16:9.
  • Rutas existentes de la aplicación a mostrar: registro, panel de control, creación de producto, creación de enlace, página de cliente, análisis.
  • Activos de marca: logotipo, colores, fuentes, imágenes del producto, imágenes de clientes, capturas de pantalla, iconos, marcos de teléfono.
  • Restricciones reales del flujo de trabajo: qué hace realmente la aplicación, qué es manual, qué es automático, qué datos están disponibles.
  • Guion de voz en off o línea de tiempo. Si el usuario ha generado audio, usa las marcas de tiempo exactas.
  • CTA final y URL de grabación.

Nunca inventes un comportamiento que el producto no soporte. Si una tienda copia manualmente un enlace, dilo en lugar de decir que la aplicación lo envía automáticamente.

Guion Gráfico

Estructura predeterminada de 30-50 segundos:

  1. Gancho del problema: muestra una pregunta o dolor realista del cliente.
  2. Acción del administrador: agregar producto, crear enlace privado, copiar mensaje.
  3. Momento del cliente: el cliente recibe el enlace, lo abre, sube una imagen, inicia la generación.
  4. Revelación del resultado: comparación lado a lado antes/producto/resultado con una animación de revelación limpia.
  5. Resultado empresarial: métricas del panel de control que importan.
  6. CTA final: promesa corta del producto y dominio.

Usa el dominio real de la aplicación y el lenguaje real del producto. Para comercio social, muestra la UI de DM estilo Instagram solo como un dispositivo visual narrativo a menos que el producto se integre realmente con las APIs de Instagram.

Patrón de Implementación

Usa el stack existente de la aplicación. Para aplicaciones Next.js, prefiere:

  • Una ruta como src/app/demo/page.tsx.
  • Un componente de cliente para la presentación temporizada.
  • Framer Motion para transiciones de escena, movimiento del cursor, efectos de revelación, brillo y zoom.
  • Componentes de UI existentes, logotipo, paleta y activos.
  • Vista previa de escena por parámetro de consulta, por ejemplo /demo?scene=resultReveal.

Comportamiento del componente demo principal:

  • Define escenas como datos: id, title, caption, durationMs, cursor y metadatos opcionales de enfoque visual/cámara.
  • Calcula los tiempos de inicio de las escenas a partir de durationMs.
  • Usa una línea de tiempo de reloj de pared para que las recargas en caliente o los rerenderizados del desarrollador no restablezcan la reproducción inesperadamente.
  • Agrega controles de reproducción, pausa, reinicio, anterior y siguiente a menos que el usuario quiera una página de grabación pura.
  • Si se sincroniza con audio generado, haz que las duraciones de las escenas coincidan exactamente con los rangos de marca de tiempo del audio.
  • Agrega atributos data-demo-cursor-target a controles de UI importantes y calcula las posiciones del cursor a partir de getBoundingClientRect(). Evita coordenadas de cursor fijas cuando exista un objetivo real.
  • Usa ResizeObserver y requestAnimationFrame para mantener los objetivos del cursor precisos en todos los tamaños de ventana.
  • Respeta la configuración de movimiento reducido.

Dirección Visual

Haz que se sienta como un video de lanzamiento/demo de SaaS moderno:

  • Escenario a pantalla completa, no una página de documentación normal.
  • Acercamientos cinemáticos en los clics importantes.
  • Movimiento suave del cursor que continúa desde la posición anterior del cursor.
  • Subtítulos cortos en pantalla: "1. Agregar producto", "2. Enviar enlace", "3. El cliente lo prueba".
  • Capturas de pantalla reales de la aplicación o maquetas de UI realistas dentro de marcos de navegador/teléfono.
  • Un momento de revelación del resultado con destello, barrido, desenfoque a nitidez o comparación lado a lado.
  • Toma limpia del resultado del panel de control con 2-4 métricas de alta señal.
  • Sin párrafos densos, sin registros de desarrollador, sin jerga técnica falsa.

Para flujos de cliente móvil, usa un marco de teléfono. Asegúrate de que el contenido dentro de él siga siendo legible en ventanas de grabación de escritorio y móvil.

Narración y Temporización

Si el usuario necesita voz en off, proporciona un prompt para un modelo de voz:

  • Tono: seguro, cálido, premium, claro, no robótico.
  • Ritmo: que coincida con la duración objetivo.
  • Notas de pronunciación para el nombre del producto.
  • Guion con marcas de tiempo por escena.

Si el usuario proporciona marcas de tiempo de audio generado, actualiza las duraciones de las escenas a esos rangos exactos y verifica la duración total.

Consulta references/storyboard-and-voiceover.md para plantillas reutilizables de temporización y narración.

Validación

Antes de finalizar:

  • Ejecuta la aplicación localmente o confirma el servidor de desarrollo/producción existente.
  • Ejecuta las comprobaciones relevantes: verificación de tipos, lint, compilación o equivalente del framework.
  • Usa comprobaciones de Playwright/navegador en tamaños de escritorio y móvil.
  • Verifica que no haya desbordamiento horizontal.
  • Verifica que el contenido del marco del teléfono sea visible.
  • Verifica que el cursor aterrice en los botones previstos usando mediciones del objetivo DOM.
  • Verifica que cada escena de vista previa funcione a través de los parámetros de consulta si se implementó.
  • Verifica que la URL pública final o la URL local devuelvan 200 OK.
  • Si se incrusta un iframe de video, verifica que el iframe esté presente en el HTML renderizado.

Informa cualquier advertencia conocida de solo desarrollo por separado, como fallos de WebSocket de HMR de Next en servidores de desarrollo con IP pública.

Entrega

Devuelve:

  • URL de la página demo.
  • Qué rutas/archivos se agregaron o modificaron.
  • Tabla de duración de escenas.
  • Prompt de voz en off si se solicitó.
  • Comandos/resultados de validación.
  • Cualquier nota de grabación, como el tamaño de ventana recomendado y si ocultar los controles.

Skills relacionados