Communitygithub.com

ComeOnOliver/skillshub

Gere vídeos de walkthrough a partir de projetos Stitch usando Remotion, com transições suaves, zoom e sobreposições de texto.

O que é skillshub?

Esta skill capacita agentes de IA a criar vídeos de demonstração interativos a partir de telas de aplicativos projetadas no Stitch, utilizando o Remotion para geração programática de vídeo. O fluxo de trabalho envolve recuperar capturas de tela de projetos Stitch, organizá-las em uma composição Remotion e aplicar transições profissionais (fade, slide, zoom) e sobreposições de texto. Suporta as plataformas Stitch e Remotion MCP, além do uso direto da CLI do Remotion para renderização. A skill fornece componentes modulares (ScreenSlide, WalkthroughComposition), manifestos JSON para organização de assets e padrões reutilizáveis como apresentação de slides simples, destaque de funcionalidades e fluxos de usuário. É ideal para desenvolvedores que desejam automatizar a criação de vídeos de showcase de apps, reduzindo o trabalho manual de edição e garantindo consistência visual.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/google-labs-code/remotion

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Vídeos de Walkthrough do Stitch para Remotion

Você é um especialista em produção de vídeos focado em criar vídeos de walkthrough envolventes a partir de designs de aplicativos. Você combina as capacidades de recuperação de tela do Stitch com a geração programática de vídeo do Remotion para produzir apresentações suaves e profissionais.

Visão Geral

Esta skill permite que você crie vídeos de walkthrough que exibem telas de aplicativos com transições profissionais, efeitos de zoom e sobreposições de texto contextuais. O fluxo de trabalho recupera telas de projetos Stitch e as orquestra em uma composição de vídeo Remotion.

Pré-requisitos

Obrigatório:

  • Acesso ao Stitch MCP Server
  • Acesso ao Remotion MCP Server (ou Remotion CLI)
  • Node.js e npm instalados
  • Um projeto Stitch com telas projetadas

Recomendado:

  • Familiaridade com as capacidades de vídeo do Remotion
  • Compreensão de componentes React (Remotion usa React)

Recuperação e Networking

Passo 1: Descubra servidores MCP disponíveis

Execute list_tools para identificar servidores MCP disponíveis e seus prefixos:

  • Stitch MCP: Procure pelo prefixo stitch: ou mcp_stitch:
  • Remotion MCP: Procure pelo prefixo remotion: ou mcp_remotion:

Passo 2: Recupere informações do projeto Stitch

  1. Pesquisa de projeto (se o ID do projeto não for fornecido):

    • Chame [prefixo_stitch]:list_projects com filter: "view=owned"
    • Identifique o projeto alvo pelo título (ex.: "Calculator App")
    • Extraia o ID do projeto do campo name (ex.: projects/13534454087919359824)
  2. Recuperação de telas:

    • Chame [prefixo_stitch]:list_screens com o ID do projeto (apenas numérico)
    • Revise os títulos das telas para identificar todas as telas para o walkthrough
    • Extraia os IDs das telas do campo name de cada tela
  3. Busca de metadados das telas: Para cada tela:

    • Chame [prefixo_stitch]:get_screen com projectId e screenId
    • Recupere:
      • screenshot.downloadUrl — Asset visual para o vídeo
      • htmlCode.downloadUrl — Opcional: para extrair texto/conteúdo
      • width, height — Dimensões da tela para escalonamento adequado
      • Título e descrição da tela para sobreposições de texto
  4. Download de assets:

    • Use web_fetch ou Bash com curl para baixar as capturas de tela
    • Salve em um diretório de staging: assets/screens/{nome-da-tela}.png
    • Organize os assets na ordem do fluxo de walkthrough pretendido

Passo 3: Configure o projeto Remotion

  1. Verifique se existe um projeto Remotion:

    • Procure por remotion.config.ts ou package.json com dependências Remotion
    • Se existir, use a estrutura de projeto existente
  2. Crie um novo projeto Remotion (se necessário):

    npm create video@latest -- --blank
    
    • Escolha o template TypeScript
    • Configure em um diretório dedicado video/
  3. Instale dependências:

    cd video
    npm install @remotion/transitions @remotion/animated-emoji
    

Estratégia de Composição de Vídeo

Arquitetura

Crie uma composição Remotion modular com estes componentes:

  1. ScreenSlide.tsx — Componente de exibição de tela individual

    • Props: imageSrc, title, description, width, height
    • Funcionalidades: Animação de zoom, transições de fade
    • Duração: Configurável (padrão 3-5 segundos por tela)
  2. WalkthroughComposition.tsx — Composição principal do vídeo

    • Sequencia vários componentes ScreenSlide
    • Gerencia transições entre telas
    • Adiciona sobreposições de texto e anotações
  3. config.ts — Configuração do vídeo

    • Taxa de quadros (padrão: 30 fps)
    • Dimensões do vídeo (corresponder às dimensões da tela Stitch ou escalar adequadamente)
    • Cálculo da duração total

Efeitos de Transição

Use @remotion/transitions do Remotion para efeitos profissionais:

  • Fade: Transição suave de fade entre telas

    import {fade} from '@remotion/transitions/fade';
    
  • Slide: Transições direcionais de deslizamento

    import {slide} from '@remotion/transitions/slide';
    
  • Zoom: Efeitos de zoom in/out para ênfase

    • Use animação spring() para zoom suave
    • Aplique em elementos importantes da UI

Sobreposições de Texto

Adicione informações contextuais usando a renderização de texto do Remotion:

  1. Títulos das telas: Exiba no topo ou no final de cada quadro
  2. Destaques de funcionalidades: Destaque elementos específicos da UI com ponteiros animados
  3. Descrições: Faça fade in de texto descritivo para cada tela
  4. Indicador de progresso: Mostre a posição atual da tela no walkthrough

Passos de Execução

Passo 1: Reúna os assets das telas

  1. Identifique o projeto Stitch alvo
  2. Liste todas as telas do projeto
  3. Baixe as capturas de tela para cada tela
  4. Organize na ordem do fluxo de walkthrough
  5. Crie um arquivo de manifesto (screens.json):
{
  "projectName": "Calculator App",
  "screens": [
    {
      "id": "1",
      "title": "Tela Inicial",
      "description": "Interface principal da calculadora com teclado numérico",
      "imagePath": "assets/screens/home.png",
      "width": 1200,
      "height": 800,
      "duration": 4
    },
    {
      "id": "2",
      "title": "Visualização do Histórico",
      "description": "Visualização de cálculos anteriores",
      "imagePath": "assets/screens/history.png",
      "width": 1200,
      "height": 800,
      "duration": 3
    }
  ]
}

Passo 2: Gere Componentes Remotion

Crie os componentes de vídeo seguindo as melhores práticas do Remotion:

  1. Crie ScreenSlide.tsx:

    • Use useCurrentFrame() e spring() para animações
    • Implemente efeitos de zoom e fade
    • Adicione sobreposições de texto com temporização adequada
  2. Crie WalkthroughComposition.tsx:

    • Importe o manifesto de telas
    • Sequencie telas com componentes <Sequence>
    • Aplique transições entre telas
    • Calcule temporização e deslocamentos adequados
  3. Atualize remotion.config.ts:

    • Defina o ID da composição
    • Configure as dimensões do vídeo
    • Defina a taxa de quadros e duração

Recursos de Referência:

  • Use resources/screen-slide-template.tsx como ponto de partida
  • Siga resources/composition-checklist.md para completude
  • Revise exemplos no diretório examples/walkthrough/

Passo 3: Visualize e Refine

  1. Inicie o Remotion Studio:

    npm run dev
    
    • Abre visualização baseada em navegador
    • Permite edição e refinamento em tempo real
  2. Ajuste a temporização:

    • Garanta que cada tela tenha duração de exibição adequada
    • Verifique se as transições são suaves
    • Cheque a temporização das sobreposições de texto
  3. Ajuste fino das animações:

    • Ajuste as configurações de spring para efeitos de zoom
    • Modifique funções de easing para transições
    • Garanta que o texto seja legível em todos os momentos

Passo 4: Renderize o Vídeo

  1. Renderize usando Remotion CLI:

    npx remotion render WalkthroughComposition output.mp4
    
  2. Alternativa: Use Remotion MCP (se disponível):

    • Chame [prefixo_remotion]:render com detalhes da composição
    • Especifique o formato de saída (MP4, WebM, etc.)
  3. Opções de otimização:

    • Defina nível de qualidade (--quality)
    • Configure codec (--codec h264 ou h265)
    • Ative renderização paralela (--concurrency)

Funcionalidades Avançadas

Hotspots Interativos

Destaque elementos clicáveis ou funcionalidades 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>
  );
};

Integração de Narração

Adicione narração ao walkthrough:

  1. Gere roteiro de narração a partir das descrições das telas
  2. Use text-to-speech ou grave áudio
  3. Importe áudio no Remotion com o componente <Audio>
  4. Sincronize a temporização das telas com o ritmo da narração

Extração Dinâmica de Texto

Extraia texto do código HTML do Stitch para anotações automáticas:

  1. Baixe htmlCode.downloadUrl para cada tela
  2. Analise o HTML para extrair elementos de texto chave (títulos, botões, rótulos)
  3. Gere destaques automáticos para elementos importantes da UI
  4. Adicione à composição como sobreposições de texto temporizadas

Estrutura de Arquivos

project/
├── video/                      # Diretório do projeto Remotion
│   ├── src/
│   │   ├── WalkthroughComposition.tsx
│   │   ├── ScreenSlide.tsx
│   │   ├── components/
│   │   │   ├── Hotspot.tsx
│   │   │   └── TextOverlay.tsx
│   │   └── Root.tsx
│   ├── public/
│   │   └── assets/
│   │       └── screens/        # Capturas de tela Stitch baixadas
│   │           ├── home.png
│   │           └── history.png
│   ├── remotion.config.ts
│   └── package.json
├── screens.json                # Manifesto de telas
└── output.mp4                  # Vídeo renderizado

Integração com Skills do Remotion

O Remotion mantém suas próprias Skills de Agente que definem melhores práticas. Revise-as para técnicas avançadas:

Skills chave do Remotion a serem aproveitadas:

  • Temporização e easing de animação
  • Padrões de arquitetura de composição
  • Otimização de desempenho
  • Sincronização de áudio

Padrões Comuns

Padrão 1: Apresentação de Slides Simples

Walkthrough básico com transições de fade:

  • 3-5 segundos por tela
  • Transições de fade
  • Sobreposição de texto inferior com título da tela
  • Barra de progresso no topo

Padrão 2: Destaque de Funcionalidade

Foco em elementos específicos da UI:

  • Zoom em regiões específicas
  • Círculos/setas animadas apontando para funcionalidades
  • Ênfase em câmera lenta em interações chave
  • Comparações lado a lado antes/depois

Padrão 3: Fluxo do Usuário

Mostre a jornada do usuário passo a passo:

  • Fluxo sequencial de telas com slides direcionais
  • Sobreposição de etapas numeradas
  • Destaque de ações do usuário (cliques, toques)
  • Conecte telas com caminhos animados

Solução de Problemas

ProblemaSolução
Capturas de tela borradasCertifique-se de que as imagens baixadas estão em resolução total; verifique as configurações de qualidade de screenshot.downloadUrl
Texto desalinhadoVerifique se as dimensões da tela correspondem ao tamanho da composição; ajuste o posicionamento do texto com base no tamanho real da tela
Animações com travamentosAumente a taxa de quadros para 60 fps; use configurações de spring adequadas com damping apropriado
Falha na compilação do RemotionVerifique a compatibilidade da versão do Node; garanta que todas as dependências estão instaladas; revise a documentação do Remotion
Temporização estranhaAjuste a duração por tela no manifesto; visualize no Remotion Studio; teste com usuários reais

Melhores Práticas

  1. Mantenha a proporção: Use as dimensões reais da tela Stitch ou escale proporcionalmente
  2. Temporização consistente: Mantenha a duração de exibição das telas consistente, a menos que esteja enfatizando telas específicas
  3. Texto legível: Garanta contraste suficiente; use tamanhos de fonte adequados; evite sobreposições poluídas
  4. Transições suaves: Use animações spring para movimento natural; evite cortes bruscos
  5. Visualize completamente: Sempre visualize no Remotion Studio antes da renderização final
  6. Otimize assets: Comprima imagens adequadamente; use formatos eficientes (PNG para UI, JPG para fotos)

Exemplo de Uso

Prompt do usuário:

Consulte as telas do meu projeto Stitch "Calculator App" e crie um vídeo Remotion
que mostre um walkthrough das telas.

Fluxo do agente:

  1. Liste projetos Stitch → Encontre "Calculator App" → Extraia ID do projeto
  2. Liste telas no projeto → Identifique todas as telas (Home, History, Settings)
  3. Baixe capturas de tela para cada tela → Salve em assets/screens/
  4. Crie o manifesto screens.json com metadados das telas
  5. Gere componentes Remotion (ScreenSlide.tsx, WalkthroughComposition.tsx)
  6. Visualize no Remotion Studio → Refine temporização e transições
  7. Renderize o vídeo final → calculator-walkthrough.mp4
  8. Reporte a conclusão com link de visualização do vídeo

Dicas para o Sucesso

  • Comece simples: Comece com transições de fade básicas antes de adicionar animações complexas
  • Siga os padrões Remotion: Aproveite as skills e documentação oficiais do Remotion
  • Use arquivos de manifesto: Mantenha dados das telas organizados em JSON para fácil atualização
  • Visualize com frequência: Use o Remotion Studio para detectar problemas cedo
  • Considere acessibilidade: Adicione legendas; garanta que o texto seja legível; use visuais claros
  • Otimize para a plataforma: Corresponda as dimensões do vídeo à plataforma alvo (YouTube, mídias sociais, etc.)

Referências

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Habilidades Relacionadas