Communitygithub.com

ASoudy/AGS

Genera videos de recorrido a partir de proyectos de Stitch usando Remotion con transiciones suaves, efectos de zoom y superposiciones de texto.

¿Qué es AGS?

Esta habilidad permite crear videos de recorrido profesional que muestran pantallas de aplicaciones con transiciones fluidas, efectos de zoom y superposiciones de texto contextual. El flujo de trabajo recupera capturas de pantalla desde el servidor MCP de Stitch y las organiza en una composición de video programática con Remotion. Es útil para desarrolladores, diseñadores y creadores de contenido que desean generar presentaciones visuales atractivas a partir de diseños de aplicaciones sin edición manual. Soporta plataformas como Claude Code, Cursor y Codex (con servidores MCP compatibles). El proceso incluye la descarga de activos visuales de Stitch, la creación de componentes React en Remotion (ScreenSlide, WalkthroughComposition), la aplicación de transiciones (fade, slide, zoom) y la renderización final del video en formatos MP4 o WebM. Además, ofrece funciones avanzadas como hotspots interactivos, integración de locuciones y extracción dinámica de texto desde el HTML de Stitch.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/skills/remotion

Preguntar en tu IA favorita

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

Documentación

Videos de Recorrido con Stitch y Remotion

Eres un especialista en producción de video enfocado en crear videos de recorrido 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 suaves y profesionales.

Resumen

Esta habilidad te permite crear videos de recorrido 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 video de Remotion.

Prerrequisitos

Requeridos:

  • Acceso al Servidor MCP de Stitch
  • Acceso al Servidor MCP de Remotion (o a la 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)

Descubrimiento y Conexión

Paso 1: Descubrir los 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: Obtener Información del Proyecto Stitch

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

    • Llama a [prefijo_stitch]:list_projects con filter: "view=owned"
    • Identifica el proyecto objetivo por su título (ej., "Aplicación Calculadora")
    • 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 pantallas del recorrido
    • 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 — Activo visual para el video
      • 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 activos:

    • Usa web_fetch o Bash con curl para descargar las capturas de pantalla
    • Guarda en un directorio de staging: assets/screens/{nombre-pantalla}.png
    • Organiza los activos en el orden del flujo de recorrido previsto

Paso 3: Configurar el Proyecto Remotion

  1. Verificar si existe un proyecto Remotion:

    • Busca remotion.config.ts o package.json con dependencias de Remotion
    • Si existe, usa la estructura del proyecto existente
  2. Crear un nuevo proyecto 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 Remotion modular 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 desvanecimiento
    • 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 del video (coincidir con las dimensiones de la pantalla Stitch o escalar adecuadamente)
    • Cálculo de duración total

Efectos de Transición

Usa @remotion/transitions para efectos profesionales:

  • Desvanecimiento (Fade): Transición suave entre pantallas

    import {fade} from '@remotion/transitions/fade';
    
  • Deslizamiento (Slide): 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. Llamadas a características: Resalta elementos específicos de la interfaz con punteros animados
  3. Descripciones: Texto descriptivo que aparece gradualmente para cada pantalla
  4. Indicador de progreso: Muestra la posición actual de la pantalla en el recorrido

Pasos de Ejecución

Paso 1: Reunir Activos de Pantalla

  1. Identifica el proyecto Stitch objetivo
  2. Lista todas las pantallas del proyecto
  3. Descarga las capturas de pantalla de cada una
  4. Organízalas en el orden del flujo de recorrido
  5. Crea un archivo de manifiesto (screens.json):
{
  "projectName": "Aplicación Calculadora",
  "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 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 desvanecimiento
    • Añade superposiciones de texto con temporización adecuada
  2. Crear WalkthroughComposition.tsx:

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

    • Establece el ID de composición
    • Configura las dimensiones del video
    • Define 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/walkthrough/

Paso 3: Previsualizar y Refinar

  1. Iniciar Remotion Studio:

    npm run dev
    
    • Abre una vista previa en el navegador
    • Permite edición y refinamiento en tiempo real
  2. 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
  3. Afinar animaciones:

    • Ajusta las configuraciones de spring para los efectos de zoom
    • Modifica las funciones de easing para las transiciones
    • Asegura 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 el MCP de Remotion (si está disponible):

    • Llama a [prefijo_remotion]:render con los detalles de 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)

Funcionalidades Avanzadas

Zonas Interactivas (Hotspots)

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

Añade narración al recorrido:

  1. Genera un guion de locución a partir de las descripciones de pantalla
  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 locución

Extracción Dinámica de Texto

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

  1. Descarga htmlCode.downloadUrl de 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

proyecto/
├── 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                  # Video renderizado

Integración con Habilidades de Remotion

Remotion mantiene sus propias habilidades de agente que definen mejores prácticas. Revísalas 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 de Diapositivas Simple

Recorrido básico con transiciones de desvanecimiento:

  • 3-5 segundos por pantalla
  • Transiciones de desvanecimiento cruzado
  • Superposición de texto inferior con título de pantalla
  • Barra de progreso en la parte superior

Patrón 2: Destacado de Características

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

  • Zoom a regiones específicas
  • Círculos/flechas animados que apuntan 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 paso a paso del usuario:

  • Flujo secuencial de pantallas con diapositivas 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 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 fps a 60; usa configuraciones de spring adecuadas con damping apropiado
Error de compilación de RemotionComprueba 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 correctaAjusta 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 Stitch o escala proporcionalmente
  2. Temporización 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 movimiento natural; evita cortes bruscos
  5. Previsualiza a fondo: Siempre previsualiza en Remotion Studio antes del renderizado final
  6. Optimiza activos: Comprime imágenes adecuadamente; usa formatos eficientes (PNG para interfaz, JPG para fotos)

Ejemplo de Uso

Mensaje del usuario:

Busca las pantallas de mi proyecto Stitch "Aplicación Calculadora" y crea un video de Remotion 
que muestre un recorrido por las pantallas.

Flujo de trabajo del agente:

  1. Listar proyectos de Stitch → Encontrar "Aplicación Calculadora" → Extraer ID del proyecto
  2. Listar pantallas del proyecto → Identificar todas las pantallas (Inicio, Historial, Configuración)
  3. Descargar capturas de pantalla de cada una → Guardar en assets/screens/
  4. Crear manifiesto screens.json con metadatos de pantalla
  5. Generar componentes Remotion (ScreenSlide.tsx, WalkthroughComposition.tsx)
  6. Previsualizar en Remotion Studio → Refinar temporización y transiciones
  7. Renderizar video final → calculadora-recorrido.mp4
  8. Reportar finalización con enlace de vista previa del video

Consejos para el Éxito

  • Empieza simple: Comienza con transiciones básicas de desvanecimiento 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 pantalla organizados en JSON para facilitar las actualizaciones
  • 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

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

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Skills relacionados