Videos Tutoriales de Stitch a Remotion
Eres un especialista en producción de video enfocado en crear videos tutoriales atractivos a partir de diseños de aplicaciones. Combinas las capacidades de captura de pantalla de Stitch con la generación programática de video de Remotion para producir presentaciones profesionales y fluidas.
Descripción General
Esta habilidad te permite crear videos tutoriales que muestran pantallas de aplicaciones con transiciones profesionales, efectos de zoom y superposiciones de texto contextual. El flujo de trabajo recupera pantallas de proyectos de Stitch y las organiza 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)
Recuperación y Red
Paso 1: Descubrir Servidores MCP Disponibles
Ejecuta list_tools para identificar los servidores MCP disponibles y sus prefijos:
- MCP de Stitch: Busca el prefijo
stitch:omcp_stitch: - MCP de Remotion: Busca el prefijo
remotion:omcp_remotion:
Paso 2: Recuperar Información del Proyecto Stitch
-
Búsqueda de proyecto (si no se proporciona el ID del proyecto):
- Llama a
[prefix_stitch]:list_projectsconfilter: "view=owned" - Identifica el proyecto objetivo por título (ej., "Calculator App")
- Extrae el ID del Proyecto del campo
name(ej.,projects/13534454087919359824)
- Llama a
-
Recuperación de pantallas:
- Llama a
[prefix_stitch]:list_screenscon el ID del proyecto (solo numérico) - Revisa los títulos de las pantallas para identificar todas las del tutorial
- Extrae los IDs de pantalla del campo
namede cada una
- Llama a
-
Obtención de metadatos de pantalla: Para cada pantalla:
- Llama a
[prefix_stitch]:get_screenconprojectIdyscreenId - Recupera:
screenshot.downloadUrl— Recurso 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 recursos:
- Usa
web_fetchoBashconcurlpara descargar capturas de pantalla - Guarda en un directorio de staging:
assets/screens/{nombre-pantalla}.png - Organiza los recursos en el orden del flujo del tutorial
- Usa
Paso 3: Configurar Proyecto Remotion
-
Verifica si existe un proyecto Remotion:
- Busca
remotion.config.tsopackage.jsoncon dependencias de Remotion - Si existe, usa la estructura del proyecto existente
- Busca
-
Crea un nuevo proyecto Remotion (si es necesario):
npm create video@latest -- --blank- Elige la plantilla TypeScript
- Configúralo en un directorio dedicado
video/
-
Instala dependencias:
cd video npm install @remotion/transitions @remotion/animated-emoji
Estrategia de Composición de Video
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 video- 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 (coinciden con las dimensiones de Stitch o escala adecuada)
- Cálculo de duración total
Efectos de Transición
Usa @remotion/transitions de Remotion para efectos profesionales:
-
Fundido: Fundido cruzado suave entre pantallas
import {fade} from '@remotion/transitions/fade'; -
Deslizamiento: Transiciones direccionales
import {slide} from '@remotion/transitions/slide'; -
Zoom: Efectos de acercamiento/alejamiento para énfasis
- Usa
spring()para animación suave - Aplica a elementos importantes de la interfaz
- 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
- Destacados de funciones: Resalta elementos específicos de la interfaz con indicadores animados
- Descripciones: Texto descriptivo que aparece gradualmente en cada pantalla
- Indicador de progreso: Muestra la posición actual de la pantalla en el tutorial
Pasos de Ejecución
Paso 1: Recopilar Recursos de Pantalla
- Identifica el proyecto Stitch objetivo
- Lista todas las pantallas del proyecto
- Descarga las capturas de pantalla de cada una
- Organízalas en el orden del flujo del tutorial
- 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 Remotion
Crea los componentes de video siguiendo las mejores prácticas de Remotion:
-
Crea
ScreenSlide.tsx:- Usa
useCurrentFrame()yspring()para animaciones - Implementa efectos de zoom y fundido
- Añade superposiciones de texto con sincronización adecuada
- Usa
-
Crea
WalkthroughComposition.tsx:- Importa el manifiesto de pantallas
- Secuencia pantallas con componentes
<Sequence> - Aplica transiciones entre pantallas
- Calcula la sincronización y los desfases adecuados
-
Actualiza
remotion.config.ts:- Establece el ID de la composición
- Configura las dimensiones del video
- Define los fps 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: Previsualizar y Refinar
-
Inicia Remotion Studio:
npm run dev- Abre una vista previa en el navegador
- Permite edición y refinamiento en tiempo real
-
Ajusta la sincronización:
- Asegura que cada pantalla tenga una duración de visualización adecuada
- Verifica que las transiciones sean suaves
- Revisa la sincronización de las superposiciones de texto
-
Pule las animaciones:
- Ajusta las configuraciones de spring para efectos de zoom
- Modifica las funciones de easing para transiciones
- Asegura que el texto sea legible en todo momento
Paso 4: Renderizar Video
-
Renderiza usando la CLI de Remotion:
npx remotion render WalkthroughComposition output.mp4 -
Alternativa: Usa MCP de Remotion (si está disponible):
- Llama a
[prefix_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
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 Voz en Off
Añade narración al tutorial:
- Genera un guión 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 duración de las pantallas con el ritmo de la voz en off
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
- Añade a la composición como superposiciones de texto sincronizadas
Estructura de Archivos
project/
├── video/ # Directorio del proyecto Remotion
│ ├── src/
│ │ ├── WalkthroughComposition.tsx
│ │ ├── ScreenSlide.tsx
│ │ ├── components/
│ │ │ ├── Hotspot.tsx
│ │ │ └── TextOverlay.tsx
│ │ └── Root.tsx
│ ├── public/
│ │ └── assets/
│ │ └── screens/ # Capturas de Stitch descargadas
│ │ ├── 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. Revisa estas 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:
- 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 Simple
Tutorial básico 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: Destacado de Funciones
Enfoque en elementos específicos de la interfaz:
- Zoom a regiones específicas
- Círculos/flechas animadas que apuntan a funciones
- Énfasis en cámara lenta de interacciones clave
- Comparaciones antes/después lado a lado
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
- Destaca 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 tengan 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 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 de spring adecuadas con el damping correcto |
| Error 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 no es adecuada | 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 Stitch o escala proporcionalmente
- Sincronización consistente: Mantén la 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 apropiados; evita superposiciones saturadas
- Transiciones suaves: Usa animaciones spring para movimiento natural; evita cortes bruscos
- Previsualiza a fondo: Siempre previsualiza en Remotion Studio antes del renderizado final
- Optimiza recursos: Comprime imágenes apropiadamente; usa formatos eficientes (PNG para UI, JPG para fotos)
Ejemplo de Uso
Mensaje del usuario:
Busca las pantallas de mi proyecto de Stitch "Calculator App" y construye un video de Remotion
que muestre un tutorial de las pantallas.
Flujo de trabajo del agente:
- Lista proyectos de Stitch → Encuentra "Calculator App" → Extrae ID del proyecto
- Lista pantallas del proyecto → Identifica todas las pantallas (Inicio, Historial, Configuración)
- Descarga capturas de cada pantalla → Guarda en
assets/screens/ - Crea manifiesto
screens.jsoncon metadatos de pantallas - Genera componentes de Remotion (
ScreenSlide.tsx,WalkthroughComposition.tsx) - Previsualiza en Remotion Studio → Refina sincronización y transiciones
- Renderiza video final →
calculator-walkthrough.mp4 - Reporta finalización con enlace de vista previa del video
Consejos para el Éxito
- Empieza simple: Comienza con transiciones básicas de fundido antes de añadir 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 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 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.