Communitygithub.com

stitch-remotion

Eres un especialista en producción de video enfocado en crear videos guía 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 video de Remotion para producir presentaciones profesionales y fluidas.

¿Qué es stitch-remotion?

Esta habilidad permite a un agente de IA (como Claude Code, Cursor o Codex) actuar como un especialista en producción de video que crea videos guía profesionales a partir de diseños de aplicaciones. Combina la capacidad de Stitch para recuperar pantallas de proyectos de diseño con el motor de generación de video programático de Remotion. El flujo de trabajo típico implica que el agente descubra pantallas de Stitch, descargue capturas de pantalla y metadatos, configure un proyecto de Remotion (si es necesario), genere componentes de React como `ScreenSlide.tsx` y `WalkthroughComposition.tsx`, y luego renderice el video final. La habilidad enfatiza el uso de efectos de transición (fundido, deslizamiento, zoom), superposiciones de texto y un archivo de manifiesto (`screens.json`) para orquestar la línea de tiempo del video. Es compatible con Stitch MCP y Remotion MCP (o la CLI de Remotion), y proporciona pautas para la resolución de problemas comunes como capturas de pantalla borrosas, animaciones entrecortadas o desajustes de tiempo. La adaptación de tiempo de ejecución de Codot también se aborda para garantizar que el agente utilice las herramientas correctas (por ejemplo, `stitch:download_file` en lugar de `curl`) y flujos de trabajo alternativos para argumentos de objeto serializados como cadenas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/XideaDev/codot-skill/tree/HEAD/skills/stitch/stitch-remotion

Preguntar en tu IA favorita

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

Documentación

Adaptación en tiempo de ejecución de Codot

  • Stitch MCP: Proporcionado de forma centralizada a través de Codot Settings → MCP (busca herramientas con el prefijo stitch: o mcp__stitch__). No reconfigures los archivos MCP por agente.
  • Verificación visual y del navegador: Prefiere las herramientas browser_* integradas de Codot (browser_navigate, browser_snapshot, browser_screenshot, browser_console) en lugar de un MCP de Chrome DevTools externo al inspeccionar servidores de desarrollo locales o páginas renderizadas.
  • Entrega visual: show_preview está fuera de línea y no puede acceder a la red; el HTML exportado por Stitch depende de CDN de Tailwind/fuentes y se renderiza en blanco si se pasa directamente. Usa la habilidad stitch-preview (servidor estático local + browser_* para alta fidelidad/interacción, o stitch-offline.mjs + show_preview para vista previa HTML en el chat, o show_preview directamente en capturas de pantalla .png).
  • Descarga de activos: Utiliza siempre Stitch MCP download_file (con htmlCode.name / screenshot.name), nunca curl contra downloadUrl (que requiere credenciales y devuelve un envoltorio JSON). Si la salida de download_file se trunca a un archivo temporal, decodifícala con stitch-preview/scripts/save-stitch-file.mjs.
  • Parámetros de objeto: Si una herramienta MCP falla con expected object, got string (algunos runtimes de agentes serializan argumentos de objeto como cadenas), cambia al flujo de trabajo alternativo solo de cadenas en stitch-manage-design-system en lugar de reintentar la misma llamada fallida.
  • Llamadas de larga duración: Si generate_screen_from_text o edit_screens se agotan, consulta list_screens cada 60 segundos hasta ~5 minutos (5 consultas); si no aparece ninguna pantalla nueva, reemite la llamada una vez en lugar de esperar indefinidamente.
  • Mapeo de herramientas: Asigna nombres de herramientas genéricas (Read, Write, Edit, Bash) a las herramientas del harness activo de Codot (read, write, edit, bash).

Videos Guía de Stitch a Remotion

Eres un especialista en producción de video centrado en crear videos guía 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 video de Remotion para producir presentaciones profesionales y fluidas.

Descripción general

Esta habilidad te permite crear videos guía que muestran las pantallas de la aplicación con transiciones profesionales, efectos de zoom y superposiciones de texto contextual. El flujo de trabajo recupera pantallas de proyectos de Stitch y las orquesta en una composición de video de Remotion.

Requisitos previos

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 redes

Paso 1: Descubrir servidores MCP disponibles

Ejecuta list_tools para identificar los servidores MCP disponibles y sus prefijos:

  • Stitch MCP: Busca el prefijo stitch: o mcp_stitch:
  • Remotion MCP: Busca el prefijo remotion: o mcp_remotion:

Paso 2: Recuperar información del proyecto de Stitch

  1. Búsqueda de proyecto (si no se proporciona el ID del proyecto):

    • Llama a [stitch_prefix]:list_projects con filter: "view=owned"
    • Identifica el proyecto objetivo por título (ej., "Calculator App")
    • Extrae el ID del proyecto del campo name (ej., projects/13534454087919359824)
  2. Recuperación de pantallas:

    • Llama a [stitch_prefix]:list_screens con el ID del proyecto (solo numérico)
    • Revisa los títulos de las pantallas para identificar todas las pantallas para el video guía
    • Extrae los IDs de pantalla del campo name de cada pantalla
  3. Obtención de metadatos de pantalla: Para cada pantalla:

    • Llama a [stitch_prefix]:get_screen con el name del recurso de la pantalla (projects/{project}/screens/{screen})
    • Recupera:
      • screenshot.name (projects/{project}/files/{file}) — Activo visual para el video
      • htmlCode.name (projects/{project}/files/{file}) — Opcional: para extraer texto/contenido
      • width, height — Dimensiones de la pantalla para escalado adecuado
      • Título y descripción de la pantalla para superposiciones de texto
  4. Descarga de activos:

    • Llama a Stitch MCP [stitch_prefix]:download_file con screenshot.name (no uses curl o web_fetch en downloadUrl, que requiere credenciales y devuelve un envoltorio JSON)
    • Si la salida de download_file se trunca a un archivo temporal, decodifícala con: node skills/stitch/stitch-preview/scripts/save-stitch-file.mjs <tool-output> assets/screens/{screen-name}.png
    • Organiza los activos en el orden del flujo de video guía previsto

Paso 3: Configurar el proyecto de Remotion

  1. Verificar proyecto de Remotion existente:

    • Busca remotion.config.ts o package.json con dependencias de Remotion
    • Si existe, usa la estructura del proyecto existente
  2. Crear nuevo proyecto de Remotion (si es necesario):

    npm create video@latest -- --blank
    
    • Elige la plantilla TypeScript
    • Configura en un directorio dedicado video/
  3. Instalar 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:

  1. 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)
  2. WalkthroughComposition.tsx — Composición de video principal

    • Secuencia múltiples componentes ScreenSlide
    • Maneja transiciones entre pantallas
    • Añade superposiciones de texto y anotaciones
  3. config.ts — Configuración de video

    • Fotogramas por segundo (por defecto: 30 fps)
    • Dimensiones de 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: Fundido cruzado suave 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 la animación spring() para un zoom suave
    • Aplica a elementos importantes de la interfaz de usuario

Superposiciones de texto

Añade información contextual utilizando el renderizado de texto de Remotion:

  1. Títulos de pantalla: Muestra en la parte superior o inferior de cada fotograma
  2. Anotaciones de características: Resalta elementos específicos de la interfaz de usuario con punteros animados
  3. Descripciones: Funde texto descriptivo para cada pantalla
  4. Indicador de progreso: Muestra la posición actual de la pantalla en el video guía

Pasos de ejecución

Paso 1: Recopilar activos de pantalla

  1. Identifica el proyecto de Stitch objetivo
  2. Lista todas las pantallas en el proyecto
  3. Descarga capturas de pantalla para cada pantalla
  4. Organiza en orden del flujo del video guía
  5. Crea un archivo de manifiesto (screens.json):
{
  "projectName": "Calculator App",
  "screens": [
    {
      "id": "1",
      "title": "Home Screen",
      "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:

  1. Crear ScreenSlide.tsx:

    • Usa useCurrentFrame() y spring() para animaciones
    • Implementa efectos de zoom y fundido
    • Añade superposiciones de texto con temporización adecuada
  2. Crear WalkthroughComposition.tsx:

    • Importa el manifiesto de pantallas
    • Secuencia pantallas con componentes <Sequence>
    • Aplica transiciones entre pantallas
    • Calcula la temporización y los desplazamientos adecuados
  3. Actualizar remotion.config.ts:

    • Establece el ID de composición
    • Configura las dimensiones del video
    • Establece los fps y la duración

Recursos de referencia:

  • Usa resources/screen-slide-template.tsx como punto de partida
  • Sigue resources/composition-checklist.md para completitud
  • Revisa ejemplos en el directorio examples/

Paso 3: Vista previa y refinamiento

  1. Iniciar Remotion Studio:

    npm run dev
    
    • Abre una vista previa basada en navegador
    • Permite edición y refinamiento en tiempo real
  2. Ajustar temporización:

    • Asegúrate de que cada pantalla tenga una duración de visualización adecuada
    • Verifica que las transiciones sean suaves
    • Revisa la temporización de las superposiciones de texto
  3. Afinar animaciones:

    • Ajusta las configuraciones de spring para efectos de zoom
    • Modifica las funciones de easing para transiciones
    • Asegúrate de que el texto sea legible en todo momento

Paso 4: Renderizar video

  1. Renderizar usando la CLI de Remotion:

    npx remotion render WalkthroughComposition output.mp4
    
  2. Alternativa: Usar Remotion MCP (si está disponible):

    • Llama a [remotion_prefix]:render con los detalles de la composición
    • Especifica el formato de salida (MP4, WebM, etc.)
  3. Opciones de optimización:

    • Establece el nivel de calidad (--quality)
    • Configura el códec (--codec h264 o h265)
    • Habilita el renderizado paralelo (--concurrency)

Funciones avanzadas

Zonas interactivas

Resalta elementos en los que se puede hacer clic 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 al video guía:

  1. Genera un guión de narración a partir de las descripciones de las pantallas
  2. Usa texto a voz o graba audio
  3. Importa el audio en Remotion con el componente <Audio>
  4. Sincroniza la temporizació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:

  1. Llama a [stitch_prefix]:download_file con htmlCode.name para cada pantalla (decodifica la salida truncada con save-stitch-file.mjs)
  2. Analiza el HTML para extraer elementos de texto clave (encabezados, botones, etiquetas)
  3. Genera anotaciones automáticas para elementos importantes de la interfaz de usuario
  4. Añade a la composición como superposiciones de texto temporizadas

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 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:

Habilidades clave de Remotion a aprovechar:

  • Temporización de animaciones y easing
  • Patrones de arquitectura de composición
  • Optimización del rendimiento
  • Sincronización de audio

Patrones comunes

Patrón 1: Presentación de diapositivas simple

Video guía 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: Destacar características

Enfócate en elementos específicos de la interfaz de usuario:

  • Zoom en regiones específicas
  • Círculos/flechas animados que apuntan a funciones
  • Énfasis en cámara lenta en interacciones clave
  • Comparaciones lado a lado de antes/después

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

Solución de problemas

ProblemaSolución
Capturas borrosasAsegúrate de que las imágenes descargadas estén a máxima resolución mediante download_file (screenshot.name) en lugar de miniaturas comprimidas
Texto desalineadoVerifica 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 entrecortadasAumenta los fps a 60; usa configuraciones de spring adecuadas con amortiguación (damping) apropiada
Error de compilación de RemotionRevisa 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 bienAjusta la duración por pantalla en el manifiesto; previsualiza en Remotion Studio; prueba con usuarios reales

Mejores prácticas

  1. Mantener la relación de aspecto: Usa las dimensiones reales de la pantalla de Stitch o escala proporcionalmente
  2. Temporización consistente: Mantén la duración de visualización de la pantalla consistente a menos que se enfatice una pantalla específica
  3. Texto legible: Asegura suficiente contraste; usa tamaños de fuente apropiados; evita superposiciones desordenadas
  4. Transiciones suaves: Usa animaciones spring para un movimiento natural; evita cortes bruscos
  5. Previsualizar a fondo: Siempre previsualiza en Remotion Studio antes del renderizado final
  6. Optimizar 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 crea un video de Remotion
que muestre un recorrido por las pantallas.

Flujo de trabajo del agente:

  1. Lista proyectos de Stitch → Encuentra "Calculator App" → Extrae el ID del proyecto
  2. Lista pantallas en el proyecto → Identifica todas las pantallas (Inicio, Historial, Configuración)
  3. Descarga capturas de pantalla para cada pantalla → Guarda en assets/screens/
  4. Crea el manifiesto screens.json con metadatos de las pantallas
  5. Genera componentes de Remotion (ScreenSlide.tsx, WalkthroughComposition.tsx)
  6. Previsualiza en Remotion Studio → Refina temporización y transiciones
  7. Renderiza el video final → calculator-walkthrough.mp4
  8. Informa la finalización con un enlace de vista previa del video

Consejos para el éxito

  • Empieza simple: Comienza con una presentación básica y añade complejidad gradualmente
  • Prueba con frecuencia: Previsualiza después de cada cambio significativo
  • Usa animaciones sutiles: Las animaciones excesivas pueden distraer; úsalas con moderación para enfatizar
  • Prueba en diferentes dispositivos: Verifica la legibilidad en tamaños de pantalla pequeños
  • Mantén una historia coherente: Cada pantalla debe contribuir a la narrativa general
  • Solicita comentarios: Obtén opiniones antes de la producción final

Skills relacionados