Communitygithub.com

phoroth/AGENTIC

Genera vídeos de tutorial a partir de proyectos de Stitch usando Remotion con transiciones suaves, zoom y superposiciones de texto.

¿Qué es AGENTIC?

Esta habilidad permite a un agente de IA crear vídeos de tutorial atractivos a partir de diseños de aplicaciones obtenidos de Stitch, combinándolos con la generación programática de vídeos de Remotion. El flujo de trabajo incluye recuperar pantallas de proyectos de Stitch, descargar sus capturas y organizarlas en una composición de vídeo de Remotion con transiciones profesionales (fundidos, deslizamientos, zoom) y superposiciones de texto contextual. Soporta plataformas como Claude Code, Cursor y Codex mediante el uso de servidores MCP de Stitch y Remotion, y sigue las mejores prácticas de Remotion para animaciones y estructura de componentes. El resultado es un vídeo renderizado (MP4, WebM) que muestra un recorrido paso a paso por la interfaz de la aplicación, ideal para demostraciones de productos, tutoriales y presentaciones.

Compatible con~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/phoroth/AGENTIC/tree/HEAD/skills/remotion

Preguntar en tu IA favorita

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

Documentación

Vídeos de Tutorial de Stitch a Remotion

Eres un especialista en producción de vídeo enfocado en crear tutoriales 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 vídeos de Remotion para producir presentaciones fluidas y profesionales.

Descripción General

Esta habilidad te permite crear vídeos de tutorial 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 orquesta en una composición de vídeo 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 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: 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 [prefijo_stitch]: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 [prefijo_stitch]:list_screens con 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 name de cada una
  3. Obtención de metadatos de pantalla: Para cada pantalla:

    • Llama a [prefijo_stitch]:get_screen con projectId y screenId
    • Recupera:
      • screenshot.downloadUrl — Recurso visual para el vídeo
      • htmlCode.downloadUrl — 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 recursos:

    • Usa web_fetch o Bash con curl para descargar las capturas de pantalla
    • Guarda en un directorio de preparación: assets/screens/{nombre-pantalla}.png
    • Organiza los recursos en el orden del flujo del tutorial

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
    • Configurar en un directorio dedicado video/
  3. 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:

  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 vídeo principal

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

    • Fotogramas por segundo (por defecto: 30 fps)
    • Dimensiones del vídeo (coincidir con las dimensiones de Stitch o escalar adecuadamente)
    • Cálculo de la 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 la animación spring() para un zoom suave
    • Aplica a elementos importantes de la interfaz

Superposiciones de Texto

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

  1. Títulos de pantalla: Muestra en la parte superior o inferior de cada fotograma
  2. Destacados de funciones: Señala elementos específicos de la interfaz con punteros animados
  3. Descripciones: Funde el texto descriptivo para cada pantalla
  4. Indicador de progreso: Muestra la posición actual de la pantalla en el tutorial

Pasos de Ejecución

Paso 1: Reunir Recursos de Pantalla

  1. Identificar el proyecto de Stitch objetivo
  2. Listar todas las pantallas del proyecto
  3. Descargar capturas para cada pantalla
  4. Organizar en el orden del flujo del tutorial
  5. 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/inicio.png",
      "width": 1200,
      "height": 800,
      "duration": 4
    },
    {
      "id": "2",
      "title": "Vista de Historial",
      "description": "Visualización de cálculos anteriores",
      "imagePath": "assets/screens/historial.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:

  1. Crear ScreenSlide.tsx:

    • Usa useCurrentFrame() y spring() para animaciones
    • Implementa efectos de zoom y fundido
    • Añade superposiciones de texto con el tiempo adecuado
  2. Crear WalkthroughComposition.tsx:

    • Importa el manifiesto de pantallas
    • Secuencia las pantallas con componentes <Sequence>
    • Aplica transiciones entre pantallas
    • Calcula el tiempo y los desfases adecuados
  3. Actualizar remotion.config.ts:

    • Establece el ID de la composición
    • Configura las dimensiones del vídeo
    • Establece los fotogramas por segundo 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/walkthrough/

Paso 3: Vista Previa y Refinamiento

  1. Iniciar Remotion Studio:

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

    • Asegura que cada pantalla tenga una duración de visualización adecuada
    • Verifica que las transiciones sean suaves
    • Revisa el tiempo de las superposiciones de texto
  3. Afinar 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 el Vídeo

  1. Renderizar usando la CLI de Remotion:

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

    • Llama a [prefijo_remotion]: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 en paralelo (--concurrency)

Funcionalidades Avanzadas

Puntos de Interés Interactivos

Destaca 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 Locución

Añade narración al tutorial:

  1. Genera un guion de locució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 el tiempo de las pantallas con el ritmo de la locución

Extracción Dinámica de Texto

Extrae texto del código HTML de Stitch para anotaciones automáticas:

  1. Descarga htmlCode.downloadUrl para cada pantalla
  2. Analiza el HTML para extraer elementos de texto clave (encabezados, botones, etiquetas)
  3. Genera llamadas automáticas para elementos importantes de la interfaz
  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 Stitch descargadas
│   │           ├── inicio.png
│   │           └── historial.png
│   ├── remotion.config.ts
│   └── package.json
├── screens.json                # Manifiesto de pantallas
└── output.mp4                  # Vídeo 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:

Habilidades clave de Remotion a aprovechar:

  • Temporizació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 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:

  • Zoom en regiones específicas
  • Círculos/flechas animadas señalando características
  • É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
  • Destaca 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 tengan resolución completa; verifica la configuración de calidad de screenshot.downloadUrl
Texto desalineadoVerifica 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 entrecortadasAumenta los fotogramas por segundo a 60 fps; usa configuraciones spring adecuadas con el damping apropiado
Fallo en la compilación de RemotionVerifica la compatibilidad de la versión de Node; asegúrate de que todas las dependencias estén instaladas; revisa la documentación de Remotion
El tiempo se siente incorrectoAjusta la duración por pantalla en el manifiesto; previsualiza en Remotion Studio; prueba con usuarios reales

Mejores Prácticas

  1. Mantén la relación de aspecto: Usa las dimensiones reales de la pantalla de Stitch o escala proporcionalmente
  2. Tiempo consistente: Mantén una duración de visualización constante a menos que quieras enfatizar pantallas específicas
  3. Texto legible: Asegura suficiente contraste; usa tamaños de fuente adecuados; evita superposiciones abarrotadas
  4. Transiciones suaves: Usa animaciones spring para movimientos naturales; evita cortes bruscos
  5. Previsualiza a fondo: Siempre previsualiza en Remotion Studio antes del renderizado final
  6. Optimiza recursos: Comprime las imágenes adecuadamente; usa formatos eficientes (PNG para IU, JPG para fotos)

Ejemplo de Uso

Solicitud del usuario:

Busca las pantallas en mi proyecto de Stitch "Calculator App" y crea un vídeo de Remotion
que muestre un tutorial de las pantallas.

Flujo de trabajo del agente:

  1. Listar proyectos de Stitch → Encontrar "Calculator App" → Extraer ID del proyecto
  2. Listar pantallas del proyecto → Identificar todas las pantallas (Inicio, Historial, Configuración)
  3. Descargar capturas para cada pantalla → Guardar en assets/screens/
  4. Crear manifiesto screens.json con metadatos de las pantallas
  5. Generar componentes de Remotion (ScreenSlide.tsx, WalkthroughComposition.tsx)
  6. Previsualizar en Remotion Studio → Refinar tiempo y transiciones
  7. Renderizar vídeo final → calculator-walkthrough.mp4
  8. 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 las habilidades y documentación oficiales 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 vídeo a la plataforma destino (YouTube, redes sociales, etc.)

Referencias

Cuándo Usar

Usa esta habilidad cuando trabajes en 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, pruebas o revisión de expertos específica del entorno.
  • Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.

Skills relacionados