Vídeos de Walkthrough de Stitch a Remotion
Eres un especialista en producción de vídeo centrado en crear vídeos de walkthrough atractivos a partir de diseños de aplicaciones. Combina las capacidades de recuperación de pantallas de Stitch con la generación programática de vídeo de Remotion para producir presentaciones profesionales y fluidas.
Resumen
Este skill te permite crear vídeos de walkthrough 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 organiza en una composición de vídeo 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 vídeo de Remotion
- Comprensión de componentes de React (Remotion usa React)
Recuperació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: Recuperar 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
-
Recuperació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 del walkthrough
- 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— Recurso visual para el vídeohtmlCode.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 recursos:
- Usa
web_fetchoBashconcurlpara descargar las capturas de pantalla - Guarda en un directorio de staging:
assets/screens/{nombre-pantalla}.png - Organiza los recursos en el orden del flujo del walkthrough 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 TypeScript
- Configura en un directorio dedicado
video/
-
Instalar dependencias:
cd video npm install @remotion/transitions @remotion/animated-emoji
Estrategia de Composición de Vídeo
Arquitectura
Crea una composición modular de Remotion 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 principal del vídeo- Secuencia múltiples componentes
ScreenSlide - Maneja las transiciones entre pantallas
- Añade superposiciones de texto y anotaciones
- Secuencia múltiples componentes
-
config.ts— Configuración del vídeo- Fotogramas por segundo (por defecto: 30 fps)
- Dimensiones del vídeo (coincidir con las dimensiones de las pantallas de Stitch o escalar apropiadamente)
- Cálculo de la duración total
Efectos de Transición
Usa @remotion/transitions de Remotion para efectos profesionales:
-
Fade: Fundido cruzado suave entre pantallas
import {fade} from '@remotion/transitions/fade'; -
Slide: Transiciones de deslizamiento direccional
import {slide} from '@remotion/transitions/slide'; -
Zoom: Efectos de zoom in/out para énfasis
- Usa la animación
spring()para un zoom suave - Aplica a elementos importantes de la interfaz de usuario
- Usa la animación
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 funciones: Resalta elementos específicos de la interfaz con punteros animados
- Descripciones: Funde texto descriptivo para cada pantalla
- Indicador de progreso: Muestra la posición actual de la pantalla en el walkthrough
Pasos de Ejecución
Paso 1: Recopilar Recursos de Pantalla
- Identifica el proyecto de Stitch objetivo
- Lista todas las pantallas del proyecto
- Descarga las capturas de pantalla de cada pantalla
- Organiza en el orden del flujo del walkthrough
- Crea 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 vídeo siguiendo las mejores prácticas de Remotion:
-
Crea
ScreenSlide.tsx:- Usa
useCurrentFrame()yspring()para las animaciones - Implementa efectos de zoom y fundido
- Añade superposiciones de texto con la sincronización adecuada
- Usa
-
Crea
WalkthroughComposition.tsx:- Importa el manifiesto de pantallas
- Secuencia las pantallas con componentes
<Sequence> - Aplica transiciones entre pantallas
- Calcula la sincronización y los desplazamientos adecuados
-
Actualiza
remotion.config.ts:- Establece el ID de la composición
- Configura las dimensiones del vídeo
- Establece la tasa de fotogramas y la duración
Recursos de Referencia:
- Usa
resources/screen-slide-template.tsxcomo punto de partida - Sigue
resources/composition-checklist.mdpara completitud - Revisa ejemplos en el directorio
examples/walkthrough/
Paso 3: Vista Previa y Refinamiento
-
Inicia Remotion Studio:
npm run dev- Abre una vista previa en el navegador
- Permite la edición y el refinamiento en tiempo real
-
Ajusta la sincronización:
- Asegúrate de que cada pantalla tenga la duración de visualización adecuada
- Verifica que las transiciones sean suaves
- Revisa la sincronización de las superposiciones de texto
-
Ajusta las animaciones:
- Modifica las configuraciones de spring para los efectos de zoom
- Ajusta las funciones de easing para las transiciones
- Asegúrate de que el texto sea legible en todo momento
Paso 4: Renderizar el Vídeo
-
Renderiza usando la CLI de Remotion:
npx remotion render WalkthroughComposition output.mp4 -
Alternativa: Usa el 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:
- Establece el nivel de calidad (
--quality) - Configura el códec (
--codec h264oh265) - Habilita el renderizado en paralelo (
--concurrency)
- Establece el nivel de calidad (
Funcionalidades Avanzadas
Zonas Interactivas (Hotspots)
Resalta elementos cliqueables o funciones 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 Voz en Off
Añade narración al walkthrough:
- Genera un guion de voz en off a partir de las descripciones de las pantallas
- Usa texto a voz o graba audio
- Importa el audio en Remotion con el componente
<Audio> - Sincroniza la sincronización de las pantallas 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 interfaz de usuario
- Añade a la composición como superposiciones de texto temporizadas
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 de Stitch descargadas
│ │ ├── home.png
│ │ └── history.png
│ ├── remotion.config.ts
│ └── package.json
├── screens.json # Manifiesto de pantallas
└── output.mp4 # Vídeo renderizado
Integración con Skills de Remotion
Remotion mantiene sus propios Skills de Agente que definen las mejores prácticas. Revisa estos para técnicas avanzadas:
- Repositorio: https://github.com/remotion-dev/remotion/tree/main/packages/skills
- Instalación:
npx skills add remotion-dev/skills
Skills clave de Remotion para aprovechar:
- Sincronización y easing de animaciones
- Patrones de arquitectura de composición
- Optimización de rendimiento
- Sincronización de audio
Patrones Comunes
Patrón 1: Presentación de Diapositivas Simple
Walkthrough básico con transiciones de fundido:
- 3-5 segundos por pantalla
- Transiciones de fundido cruzado
- Superposición de texto inferior con el título de la pantalla
- Barra de progreso en la parte superior
Patrón 2: Destacar Funciones
Enfócate en elementos específicos de la interfaz de usuario:
- Zoom en regiones específicas
- Círculos/flechas animados que señalan funciones
- Énfasis en cámara lenta en interacciones clave
- Comparaciones de antes/después lado a lado
Patrón 3: Flujo de Usuario
Muestra el recorrido del usuario paso a paso:
- Flujo de pantallas secuencial con deslizamientos direccionales
- Superposición de pasos numerados
- Resalta acciones del usuario (clics, toques)
- Conecta pantallas con rutas animadas
Resolución de Problemas
| Problema | Solución |
|---|---|
| Capturas de pantalla borrosas | Asegúrate de que las imágenes descargadas estén a máxima resolución; 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 la posición del texto según el tamaño real de la pantalla |
| Animaciones entrecortadas | Aumenta la tasa de fotogramas a 60fps; usa configuraciones 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 sincronización se siente incorrecta | 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 las pantallas de Stitch o escala proporcionalmente
- Sincronización consistente: Mantén la duración de visualización de las pantallas consistente a menos que se quiera enfatizar pantallas específicas
- Texto legible: Asegura suficiente contraste; usa tamaños de fuente apropiados; evita superposiciones abarrotadas
- Transiciones suaves: Usa animaciones spring para un movimiento natural; evita cortes bruscos
- Previsualiza a fondo: Siempre previsualiza en Remotion Studio antes del renderizado final
- Optimiza recursos: Comprime las imágenes adecuadamente; usa formatos eficientes (PNG para UI, JPG para fotos)
Ejemplo de Uso
Prompt del usuario:
Busca las pantallas de mi proyecto de Stitch "Calculator App" y construye un vídeo de Remotion
que muestre un walkthrough de las pantallas.
Flujo de trabajo del agente:
- Listar proyectos de Stitch → Encontrar "Calculator App" → Extraer ID del proyecto
- Listar pantallas del proyecto → Identificar todas las pantallas (Home, History, Settings)
- Descargar capturas de pantalla de cada pantalla → Guardar en
assets/screens/ - Crear manifiesto
screens.jsoncon metadatos de las pantallas - Generar componentes de Remotion (
ScreenSlide.tsx,WalkthroughComposition.tsx) - Previsualizar en Remotion Studio → Refinar sincronización y transiciones
- Renderizar vídeo final →
calculator-walkthrough.mp4 - Reportar finalización con enlace de vista previa del vídeo
Consejos para el Éxito
- Empieza simple: Comienza con transiciones de fundido básicas antes de añadir animaciones complejas
- Sigue los patrones de Remotion: Aprovecha los skills y la documentación oficial de Remotion
- Usa archivos de manifiesto: Mantén los datos de las pantallas 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 gráficos claros
- Optimiza para la plataforma: Ajusta las dimensiones del vídeo 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/
- Skills 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