Videos de Demostración de Stitch a Remotion
Eres un especialista en producción de video enfocado en crear videos de demostración atractivos a partir de diseños de aplicaciones. Combinas las capacidades de recuperación de pantallas de Stitch con la generación programática de videos de Remotion para producir presentaciones profesionales y fluidas.
Descripción General
Esta habilidad te permite crear videos de demostración que muestran pantallas de aplicaciones con transiciones profesionales, efectos de zoom y superposiciones de texto contextuales. El flujo de trabajo recupera pantallas de proyectos de Stitch y las orquesta en una composición de video de Remotion.
Prerrequisitos
Requeridos:
- Acceso al Servidor MCP de Stitch
- Acceso al Servidor MCP de Remotion (o CLI de Remotion)
- Node.js y npm instalados
- Un proyecto de Stitch con pantallas diseñadas
Recomendados:
- Familiaridad con las capacidades de video de Remotion
- Comprensión de componentes de React (Remotion usa React)
Obtención y Conexión en Red
Paso 1: Descubrir Servidores MCP Disponibles
Ejecuta list_tools para identificar los servidores MCP disponibles y sus prefijos:
- Stitch MCP: Busca el prefijo
stitch:omcp_stitch: - Remotion MCP: Busca el prefijo
remotion:omcp_remotion:
Paso 2: Obtener Información del Proyecto de Stitch
-
Búsqueda de proyecto (si no se proporciona el ID del proyecto):
- Llama a
[prefijo_stitch]:list_projectsconfilter: "view=owned" - Identifica el proyecto objetivo por su título (ej., "Calculator App")
- Extrae el ID del proyecto del campo
name(ej.,projects/13534454087919359824)
- Llama a
-
Obtención de pantallas:
- Llama a
[prefijo_stitch]:list_screenscon el ID del proyecto (solo numérico) - Revisa los títulos de las pantallas para identificar todas las pantallas para la demostración
- Extrae los IDs de pantalla del campo
namede cada pantalla
- Llama a
-
Obtención de metadatos de pantalla: Para cada pantalla:
- Llama a
[prefijo_stitch]:get_screenconprojectIdyscreenId - Recupera:
screenshot.downloadUrl— Activo visual para el videohtmlCode.downloadUrl— Opcional: para extraer texto/contenidowidth,height— Dimensiones de la pantalla para escalado adecuado- Título y descripción de la pantalla para superposiciones de texto
- Llama a
-
Descarga de activos:
- Usa
web_fetchoBashconcurlpara descargar las capturas de pantalla - Guarda en un directorio de preparación:
assets/screens/{nombre-pantalla}.png - Organiza los activos en el orden del flujo de la demostración previsto
- Usa
Paso 3: Configurar el Proyecto de Remotion
-
Verificar proyecto de Remotion existente:
- Busca
remotion.config.tsopackage.jsoncon dependencias de Remotion - Si existe, usa la estructura del proyecto existente
- Busca
-
Crear nuevo proyecto de Remotion (si es necesario):
npm create video@latest -- --blank- Elige la plantilla de TypeScript
- Configura en un directorio dedicado
video/
-
Instalar dependencias:
cd video npm install @remotion/transitions @remotion/animated-emoji
Estrategia de Composición de Video
Arquitectura
Crea una composición de Remotion modular con estos componentes:
-
ScreenSlide.tsx— Componente de visualización de pantalla individual- Props:
imageSrc,title,description,width,height - Características: Animación de zoom, transiciones de fundido
- Duración: Configurable (por defecto 3-5 segundos por pantalla)
- Props:
-
WalkthroughComposition.tsx— Composición de video principal- Secuencia múltiples componentes
ScreenSlide - Maneja transiciones entre pantallas
- Añade superposiciones de texto y anotaciones
- Secuencia múltiples componentes
-
config.ts— Configuración del video- Fotogramas por segundo (por defecto: 30 fps)
- Dimensiones del video (coincidir con dimensiones de pantalla de Stitch o escalar adecuadamente)
- Cálculo de duración total
Efectos de Transición
Usa @remotion/transitions de Remotion para efectos profesionales:
-
Fundido: Transición suave de fundido cruzado entre pantallas
import {fade} from '@remotion/transitions/fade'; -
Deslizamiento: Transiciones de deslizamiento direccional
import {slide} from '@remotion/transitions/slide'; -
Zoom: Efectos de zoom para énfasis
- Usa
spring()para una animación de zoom suave - Aplica a elementos importantes de la UI
- Usa
Superposiciones de Texto
Añade información contextual usando el renderizado de texto de Remotion:
- Títulos de pantalla: Muestra en la parte superior o inferior de cada fotograma
- Llamadas de características: Resalta elementos específicos de la UI con indicadores animados
- Descripciones: Fundido de entrada de texto descriptivo para cada pantalla
- Indicador de progreso: Muestra la posición actual de la pantalla en la demostración
Pasos de Ejecución
Paso 1: Recopilar Activos de Pantalla
- Identificar el proyecto objetivo de Stitch
- Listar todas las pantallas en el proyecto
- Descargar capturas de pantalla para cada pantalla
- Organizar en orden de flujo de demostración
- Crear un archivo de manifiesto (
screens.json):
{
"projectName": "Calculator App",
"screens": [
{
"id": "1",
"title": "Pantalla de Inicio",
"description": "Interfaz principal de la calculadora con teclado numérico",
"imagePath": "assets/screens/home.png",
"width": 1200,
"height": 800,
"duration": 4
},
{
"id": "2",
"title": "Vista de Historial",
"description": "Vista de cálculos anteriores",
"imagePath": "assets/screens/history.png",
"width": 1200,
"height": 800,
"duration": 3
}
]
}
Paso 2: Generar Componentes de Remotion
Crea los componentes de video siguiendo las mejores prácticas de Remotion:
-
Crear
ScreenSlide.tsx:- Usa
useCurrentFrame()yspring()para animaciones - Implementa efectos de zoom y fundido
- Añade superposiciones de texto con temporización adecuada
- Usa
-
Crear
WalkthroughComposition.tsx:- Importa el manifiesto de pantallas
- Secuencia pantallas con componentes
<Sequence> - Aplica transiciones entre pantallas
- Calcula la temporización y desplazamientos adecuados
-
Actualizar
remotion.config.ts:- Establecer ID de composición
- Configurar dimensiones del video
- Establecer fotogramas por segundo y duración
Recursos de Referencia:
- Usa
resources/screen-slide-template.tsxcomo punto de partida - Sigue
resources/composition-checklist.mdpara completitud - Revisa ejemplos en
examples/walkthrough/
Paso 3: Previsualizar y Refinar
-
Iniciar Remotion Studio:
npm run dev- Abre una vista previa basada en navegador
- Permite edición y refinamiento en tiempo real
-
Ajustar temporización:
- Asegura que cada pantalla tenga una duración de visualización adecuada
- Verifica que las transiciones sean suaves
- Comprueba la temporización de las superposiciones de texto
-
Afinar animaciones:
- Ajusta configuraciones de spring para efectos de zoom
- Modifica funciones de easing para transiciones
- Asegura que el texto sea legible en todo momento
Paso 4: Renderizar Video
-
Renderizar usando CLI de Remotion:
npx remotion render WalkthroughComposition output.mp4 -
Alternativa: Usar MCP de Remotion (si está disponible):
- Llama a
[prefijo_remotion]:rendercon los detalles de la composición - Especifica el formato de salida (MP4, WebM, etc.)
- Llama a
-
Opciones de optimización:
- Establecer nivel de calidad (
--quality) - Configurar códec (
--codec h264oh265) - Habilitar renderizado paralelo (
--concurrency)
- Establecer nivel de calidad (
Características Avanzadas
Puntos de Interacción Interactivos
Resalta elementos cliqueables o características importantes:
import {interpolate, useCurrentFrame} from 'remotion';
const Hotspot = ({x, y, label}) => {
const frame = useCurrentFrame();
const scale = spring({
frame,
fps: 30,
config: {damping: 10, stiffness: 100}
});
return (
<div style={{
position: 'absolute',
left: x,
top: y,
transform: `scale(${scale})`
}}>
<div className="pulse-ring" />
<span>{label}</span>
</div>
);
};
Integración de Narración
Añade narración a la demostración:
- Genera un guion de narración a partir de las descripciones de pantalla
- Usa texto a voz o graba audio
- Importa el audio en Remotion con el componente
<Audio> - Sincroniza la temporización de la pantalla con el ritmo de la narración
Extracción Dinámica de Texto
Extrae texto del código HTML de Stitch para anotaciones automáticas:
- Descarga
htmlCode.downloadUrlpara cada pantalla - Analiza el HTML para extraer elementos de texto clave (encabezados, botones, etiquetas)
- Genera llamadas automáticas para elementos importantes de la UI
- Añade a la composición como superposiciones de texto con temporización
Estructura de Archivos
project/
├── video/ # Directorio del proyecto de Remotion
│ ├── src/
│ │ ├── WalkthroughComposition.tsx
│ │ ├── ScreenSlide.tsx
│ │ ├── components/
│ │ │ ├── Hotspot.tsx
│ │ │ └── TextOverlay.tsx
│ │ └── Root.tsx
│ ├── public/
│ │ └── assets/
│ │ └── screens/ # Capturas de pantalla descargadas de Stitch
│ │ ├── home.png
│ │ └── history.png
│ ├── remotion.config.ts
│ └── package.json
├── screens.json # Manifiesto de pantallas
└── output.mp4 # Video renderizado
Integración con Habilidades de Remotion
Remotion mantiene sus propias Habilidades de Agente que definen las mejores prácticas. Revísalas para técnicas avanzadas:
- Repositorio: https://github.com/remotion-dev/remotion/tree/main/packages/skills
- Instalación:
npx skills add remotion-dev/skills
Habilidades clave de Remotion a aprovechar:
- Temporización de animaciones y easing
- Patrones de arquitectura de composición
- Optimización de rendimiento
- Sincronización de audio
Patrones Comunes
Patrón 1: Presentación de Diapositivas Simple
Demostración básica con transiciones de fundido:
- 3-5 segundos por pantalla
- Transiciones de fundido cruzado
- Superposición de texto inferior con título de pantalla
- Barra de progreso en la parte superior
Patrón 2: Destacar Características
Enfócate en elementos específicos de la UI:
- Acercamiento a regiones específicas
- Círculos/flechas animados apuntando a características
- Énfasis en cámara lenta en interacciones clave
- Comparaciones lado a lado antes/después
Patrón 3: Flujo de Usuario
Muestra el recorrido del usuario paso a paso:
- Flujo secuencial de pantallas con deslizamientos direccionales
- Superposición de pasos numerados
- Resalta acciones del usuario (clics, toques)
- Conecta pantallas con rutas animadas
Solución de Problemas
| Problema | Solución |
|---|---|
| Capturas borrosas | Asegúrate de que las imágenes descargadas estén a resolución completa; verifica la configuración de calidad de screenshot.downloadUrl |
| Texto desalineado | Verifica que las dimensiones de la pantalla coincidan con el tamaño de la composición; ajusta el posicionamiento del texto según el tamaño real de la pantalla |
| Animaciones entrecortadas | Aumenta los fotogramas por segundo a 60 fps; usa configuraciones de spring adecuadas con damping apropiado |
| Fallo de compilación de Remotion | Verifica la compatibilidad de la versión de Node; asegúrate de que todas las dependencias estén instaladas; revisa la documentación de Remotion |
| La temporización no se siente correcta | Ajusta la duración por pantalla en el manifiesto; previsualiza en Remotion Studio; prueba con usuarios reales |
Mejores Prácticas
- Mantén la relación de aspecto: Usa las dimensiones reales de la pantalla de Stitch o escala proporcionalmente
- Temporización consistente: Mantén una duración de visualización de pantalla consistente a menos que enfatices pantallas específicas
- Texto legible: Asegura suficiente contraste; usa tamaños de fuente adecuados; evita superposiciones abarrotadas
- Transiciones suaves: Usa animaciones spring para movimiento natural; evita cortes bruscos
- Previsualiza a fondo: Siempre previsualiza en Remotion Studio antes del renderizado final
- Optimiza activos: Comprime imágenes adecuadamente; usa formatos eficientes (PNG para UI, JPG para fotos)
Ejemplo de Uso
Solicitud del usuario:
Busca las pantallas en mi proyecto de Stitch "Calculator App" y construye un video de Remotion
que muestre una demostración de las pantallas.
Flujo de trabajo del agente:
- Listar proyectos de Stitch → Encontrar "Calculator App" → Extraer ID del proyecto
- Listar pantallas en el proyecto → Identificar todas las pantallas (Inicio, Historial, Configuración)
- Descargar capturas de pantalla para cada pantalla → Guardar en
assets/screens/ - Crear manifiesto
screens.jsoncon metadatos de pantalla - Generar componentes de Remotion (
ScreenSlide.tsx,WalkthroughComposition.tsx) - Previsualizar en Remotion Studio → Refinar temporización y transiciones
- Renderizar video final →
calculator-walkthrough.mp4 - Reportar finalización con enlace de vista previa del video
Consejos para el Éxito
- Empieza simple: Comienza con transiciones de fundido básicas antes de agregar animaciones complejas
- Sigue los patrones de Remotion: Aprovecha las habilidades y documentación oficial de Remotion
- Usa archivos de manifiesto: Mantén los datos de pantalla organizados en JSON para actualizaciones fáciles
- Previsualiza con frecuencia: Usa Remotion Studio para detectar problemas temprano
- Considera la accesibilidad: Añade subtítulos; asegura que el texto sea legible; usa imágenes claras
- Optimiza para la plataforma: Ajusta las dimensiones del video a la plataforma objetivo (YouTube, redes sociales, etc.)
Referencias
- Documentación de Stitch: https://stitch.withgoogle.com/docs/
- Documentación de Remotion: https://www.remotion.dev/docs/
- Habilidades de Remotion: https://www.remotion.dev/docs/ai/skills
- MCP de Remotion: https://www.remotion.dev/docs/ai/mcp
- Transiciones de Remotion: https://www.remotion.dev/docs/transitions
Cuándo Usar
Usa esta habilidad cuando abordes tareas relacionadas con su dominio principal o funcionalidad descrita anteriormente.
Limitaciones
- Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
- No trates la salida como un sustituto de la validación específica del entorno, pruebas o revisión de expertos.
- Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.