Communitygithub.com

aliabbaschadhar/copilot-superpowers

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

O que é copilot-superpowers?

Esta skill capacita um agente de IA a criar vídeos de walkthrough profissionais a partir de designs de aplicativos, combinando a capacidade de captura de tela do Stitch com a geração programática de vídeo do Remotion. O agente primeiro descobre os servidores MCP disponíveis (Stitch e Remotion), depois recupera informações do projeto Stitch, lista todas as telas, baixa as imagens de cada tela e os metadados. Em seguida, ele monta um projeto Remotion organizado com componentes modulares como ScreenSlide, WalkthroughComposition e transições suaves (fade, slide, zoom). O resultado é um vídeo renderizado (MP4) com cronometragem ajustável, sobreposições de texto e recursos avançados como hotspots interativos e integração de narração. A skill suporta os MCPs Stitch e Remotion, além do ambiente de linha de comando do Remotion, e inclui dicas de boas práticas, soluções de problemas e padrões comuns de produção.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aliabbaschadhar/copilot-superpowers/tree/HEAD/assets/skills/remotion

Perguntar na sua IA favorita

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

Documentação

Vídeos Walkthrough de Stitch para Remotion

Você é um especialista em produção de vídeo 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 mostram 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 Servidor MCP Stitch
  • Acesso ao Servidor MCP Remotion (ou CLI Remotion)
  • 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 Rede

Passo 1: Descobrir 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: Recuperar Informações do Projeto Stitch

  1. Busca 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.: "Calculadora 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 da tela: Para cada tela:

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

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

Passo 3: Configurar Projeto Remotion

  1. Verificar projeto Remotion existente:

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

    npm create video@latest -- --blank
    
    • Escolha o template TypeScript
    • Configure em um diretório dedicado video/
  3. Instalar 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
    • Recursos: 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 múltiplos 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 de slide direcionais

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

    • Use animação spring() para zoom suave
    • Aplique a 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 rodapé de cada quadro
  2. Destaques de funcionalidades: Marque 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: Reunir Ativos das Telas

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

Passo 2: Gerar 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 cronometragem adequada
  2. Crie WalkthroughComposition.tsx:

    • Importe o manifesto de telas
    • Sequencie telas com componentes <Sequence>
    • Aplique transições entre telas
    • Calcule cronometragem 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: Visualizar e Refinar

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

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

    • Configure 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: Renderizar Vídeo

  1. Renderize usando CLI Remotion:

    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)
    • Habilite renderização paralela (--concurrency)

Recursos Avançados

Hotspots Interativos

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

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 texto-para-fala ou grave áudio
  3. Importe áudio no Remotion com o componente <Audio>
  4. Sincronize a cronometragem 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 (cabeçalhos, 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
│   │           ├── inicial.png
│   │           └── historico.png
│   ├── remotion.config.ts
│   └── package.json
├── screens.json                # Manifesto de telas
└── output.mp4                  # Vídeo renderizado

Integração com Skills Remotion

O Remotion mantém suas próprias Skills de Agente que definem boas práticas. Consulte estas para técnicas avançadas:

Principais skills Remotion a aproveitar:

  • Cronometragem 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 Simples de Slides

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

  • 3-5 segundos por tela
  • Transições de fade cruzado
  • 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 60fps; use configurações spring adequadas com damping apropriado
Falha na construção do RemotionVerifique a compatibilidade da versão do Node; garanta que todas as dependências estão instaladas; consulte a documentação do Remotion
Cronometragem parece erradaAjuste a duração por tela no manifesto; visualize no Remotion Studio; teste com usuários reais

Boas Práticas

  1. Mantenha a proporção: Use as dimensões reais da tela Stitch ou escale proporcionalmente
  2. Cronometragem consistente: Mantenha a duração de exibição das telas consistente, a menos que esteja destacando telas específicas
  3. Texto legível: Garanta contraste suficiente; use tamanhos de fonte adequados; evite sobreposições confusas
  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 ativos: 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 "Calculadora App" e monte um vídeo remotion
que mostre um walkthrough das telas.

Fluxo de trabalho do agente:

  1. Liste projetos Stitch → Encontre "Calculadora App" → Extraia ID do projeto
  2. Liste telas no projeto → Identifique todas as telas (Inicial, Histórico, Configurações)
  3. Baixe capturas de tela de cada tela → Salve em assets/screens/
  4. Crie manifesto screens.json com metadados das telas
  5. Gere componentes Remotion (ScreenSlide.tsx, WalkthroughComposition.tsx)
  6. Visualize no Remotion Studio → Refine cronometragem e transições
  7. Renderize o vídeo final → calculadora-walkthrough.mp4
  8. Relate conclusão com link de pré-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 oficiais e a documentação do Remotion
  • Use arquivos de manifesto: Mantenha os dados das telas organizados em JSON para facilitar atualizações
  • 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, redes sociais, etc.)

Referências

Quando Usar

Use esta skill ao lidar com tarefas relacionadas ao seu domínio principal ou funcionalidade, conforme descrito acima.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas