Communitygithub.com

BEKO2210/Firstbrain

Genera videos de walkthrough a partir de proyectos de Stitch usando Remotion con transiciones suaves, zooms y superposiciones de texto.

¿Qué es Firstbrain?

Esta habilidad permite a los agentes de IA crear videos de walkthrough profesionales que muestran pantallas de aplicaciones con transiciones suaves, efectos de zoom y texto contextual. Combina la capacidad de recuperación de pantallas de Stitch con la generación de video programática de Remotion. Es especialmente útil para desarrolladores, diseñadores o equipos de producto que necesitan demostraciones visuales de flujos de usuario a partir de diseños de pantallas. Soporta las plataformas Stitch (MCP Server) y Remotion (MCP Server o CLI). El flujo de trabajo comienza recuperando metadatos y capturas de pantalla de un proyecto de Stitch, luego orquesta estos activos en una composición de Remotion. Utiliza componentes de React y animaciones basadas en frames para crear presentaciones suaves y personalizables. El agente puede configurar el proyecto, definir transiciones (fade, slide, zoom), añadir superposiciones de texto, generar indicadores de progreso e incluso extraer texto dinámicamente del código HTML de las pantallas. El resultado final es un video renderizado (MP4, WebM, etc.) listo para compartir.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/Skills/remotion

Preguntar en tu IA favorita

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

Documentación

Videos de Walkthrough de Stitch a Remotion

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

Descripción General

Esta habilidad te permite crear videos 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 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 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., "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 para el walkthrough
    • Extrae los ID de pantalla del campo name de cada pantalla
  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 un 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 preparación: assets/screens/{nombre-pantalla}.png
    • Organiza los activos en el orden del flujo de walkthrough previsto

Paso 3: Configurar el Proyecto de Remotion

  1. Verificar si existe un proyecto de 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 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
    • Funcionalidades: 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 las 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 de Stitch o escalar apropiadamente)
    • 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 de deslizamiento direccional

    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 de usuario

Superposiciones de Texto

Añade información contextual usando la representación de texto de Remotion:

  1. Títulos de pantalla: Muestra en la parte superior o inferior de cada fotograma
  2. Destacados de funciones: Resalta elementos específicos de la interfaz 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 walkthrough

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 las capturas de pantalla para cada pantalla
  4. Organiza en el orden del flujo de walkthrough
  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": "Vista 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 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 las 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 los ejemplos en el directorio examples/walkthrough/

Paso 3: Previsualizar y Refinar

  1. Iniciar Remotion Studio:

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

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

Paso 4: Renderizar Video

  1. Renderizar usando CLI de Remotion:

    npx remotion render WalkthroughComposition output.mp4
    
  2. Alternativa: Usar 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

Puntos de Interacción

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

Añade narración al walkthrough:

  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. 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 de 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 Skills de Remotion

Remotion mantiene sus propios Agent Skills que definen las mejores prácticas. Revísalos para técnicas avanzadas:

Skills 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

Walkthrough 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 en regiones específicas
  • Círculos/flechas animados apuntando a funciones
  • Énfasis en cámara lenta en interacciones clave
  • Comparaciones lado a lado 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; 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 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 el damping apropiado
Fallo de 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
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. Mantén la relación de aspecto: Usa las dimensiones reales de la pantalla de Stitch o escala proporcionalmente
  2. Temporización consistente: Mantén una duración de visualización de pantalla consistente a menos que quieras enfatizar pantallas específicas
  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. Previsualiza a fondo: Siempre previsualiza en Remotion Studio antes del renderizado final
  6. Optimiza 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 "Aplicación Calculadora" y construye un video de Remotion
que muestre un walkthrough de las pantallas.

Flujo de trabajo del agente:

  1. Lista proyectos de Stitch → Encuentra "Aplicación Calculadora" → 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 los metadatos de las pantallas
  5. Genera componentes de Remotion (ScreenSlide.tsx, WalkthroughComposition.tsx)
  6. Previsualiza en Remotion Studio → Refina la temporización y las transiciones
  7. Renderiza el video final → calculadora-walkthrough.mp4
  8. Reporta la finalización con un enlace de vista previa del video

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 oficiales y la documentación 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; asegúrate de 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 como se describe arriba.

Conexiones

  • Dominio: [[Diseño y Creatividad]]
  • Categoría: [[Diseño de UI y UX]]
  • Navegación: [[Resumen de Skills]], [[Inicio]]

Individual skills in this repo

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Expert in building portfolios that actually land jobs and clients -

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Best practices for Remotion - Video creation in React

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

BEKO2210/Firstbrain

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

BEKO2210/Firstbrain

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

BEKO2210/Firstbrain

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

Skills relacionados