Communitygithub.com

stitch-remotion

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

O que é stitch-remotion?

A habilidade stitch-remotion capacita agentes de IA a criar vídeos de demonstração interativos a partir de designs de tela do Stitch, utilizando o Remotion para geração programática de vídeos. Ela automatiza todo o fluxo de trabalho: desde a descoberta de projetos Stitch, listagem e download de capturas de tela, até a orquestração desses ativos em uma composição de vídeo Remotion com transições suaves (fade, slide, zoom), sobreposições de texto e indicadores de progresso. A habilidade oferece templates de componentes React (`ScreenSlide`, `WalkthroughComposition`), suporte a hotspots interativos, extração dinâmica de texto de HTML do Stitch para anotações automáticas, e integração com narração. Os desenvolvedores podem visualizar e refinar o vídeo no Remotion Studio antes de renderizar o arquivo final (MP4/WebM). A habilidade inclui adaptações para o runtime Codot, como mapeamento de ferramentas, download de ativos via MCP do Stitch e uso de ferramentas de navegador integradas para pré-visualização com alta fidelidade.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/XideaDev/codot-skill/tree/HEAD/skills/stitch/stitch-remotion

Perguntar na sua IA favorita

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

Documentação

Adaptação para o Runtime Codot

  • MCP do Stitch: Fornecido centralmente via Configurações Codot → MCP (procure por ferramentas prefixadas com stitch: ou mcp__stitch__). Não reconfigurar arquivos MCP por agente.
  • Verificação Visual e Navegador: Prefira as ferramentas browser_* nativas do Codot (browser_navigate, browser_snapshot, browser_screenshot, browser_console) em vez do MCP externo do Chrome DevTools ao inspecionar servidores de desenvolvimento local ou páginas renderizadas.
  • Entrega Visual: show_preview está offline e não pode acessar a rede; HTML exportado do Stitch depende de CDN Tailwind/fontes e renderiza em branco se passado diretamente. Use a habilidade stitch-preview (servidor estático local + browser_* para alta fidelidade/interação, ou stitch-offline.mjs + show_preview para pré-visualização HTML no chat, ou show_preview diretamente em capturas de tela .png).
  • Download de Ativos: Sempre use o MCP do Stitch download_file (com htmlCode.name / screenshot.name), nunca use curl contra downloadUrl (que requer credenciais e retorna um wrapper JSON). Se a saída de download_file for truncada para um arquivo temporário, decodifique-a com stitch-preview/scripts/save-stitch-file.mjs.
  • Parâmetros de Objeto: Se uma ferramenta MCP falhar com expected object, got string (alguns runtimes de agente serializam argumentos de objeto como strings), mude para o fluxo de trabalho alternativo apenas com strings em stitch-manage-design-system em vez de repetir a mesma chamada falha.
  • Chamadas de Longa Duração: Se generate_screen_from_text ou edit_screens exceder o tempo limite, consulte list_screens a cada 60 segundos por até ~5 minutos (5 consultas); se nenhuma nova tela aparecer, reenvie a chamada uma vez em vez de esperar indefinidamente.
  • Mapeamento de Ferramentas: Mapeie nomes genéricos de ferramentas (Read, Write, Edit, Bash) para as ferramentas ativas do Codot (read, write, edit, bash).

Stitch para Vídeos de Demonstração no Remotion

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

Visão Geral

Esta habilidade permite criar vídeos de demonstração 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 do Stitch
  • Acesso ao Servidor MCP do Remotion (ou CLI do 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:

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

Passo 2: Recuperar Informações do Projeto Stitch

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

    • Chame [stitch_prefix]: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 [stitch_prefix]:list_screens com o ID do projeto (apenas numérico)
    • Revise os títulos das telas para identificar todas para a demonstração
    • Extraia os IDs das telas do campo name de cada tela
  3. Busca de metadados das telas: Para cada tela:

    • Chame [stitch_prefix]:get_screen com o name do recurso da tela (projects/{project}/screens/{screen})
    • Recupere:
      • screenshot.name (projects/{project}/files/{file}) — Ativo visual para o vídeo
      • htmlCode.name (projects/{project}/files/{file}) — Opcional: para extrair texto/conteúdo
      • width, height — Dimensões da tela para dimensionamento adequado
      • Título e descrição da tela para sobreposições de texto
  4. Download de ativos:

    • Chame o MCP do Stitch [stitch_prefix]:download_file com screenshot.name (não use curl ou web_fetch em downloadUrl, que requer credenciais e retorna um wrapper JSON)
    • Se a saída de download_file for truncada para um arquivo temporário, decodifique-a com: node skills/stitch/stitch-preview/scripts/save-stitch-file.mjs <tool-output> assets/screens/{screen-name}.png
    • Organize os ativos na ordem do fluxo de demonstração pretendido

Passo 3: Configurar Projeto Remotion

  1. Verificar projeto Remotion existente:

    • Procure por remotion.config.ts ou package.json com dependências do Remotion
    • Se existir, use a estrutura de 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 de vídeo principal

    • 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 do Stitch ou dimensionar adequadamente)
    • Cálculo da duração total

Efeitos de Transição

Use @remotion/transitions para efeitos profissionais:

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

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

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

    • Use animação spring() para zoom suave
    • Aplique a elementos importantes da interface do usuário

Sobreposições de Texto

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

  1. Títulos das telas: Exibir na parte superior ou inferior de cada quadro
  2. Destaques de recursos: Destacar elementos específicos da interface com ponteiros animados
  3. Descrições: Texto descritivo que aparece gradualmente para cada tela
  4. Indicador de progresso: Mostrar posição atual da tela na demonstração

Passos de Execução

Passo 1: Coletar Ativos das Telas

  1. Identificar projeto Stitch alvo
  2. Listar todas as telas no projeto
  3. Baixar capturas de tela para cada tela
  4. Organizar na ordem do fluxo de demonstração
  5. Criar 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 de Histórico",
      "description": "Visualização de cálculos anteriores",
      "imagePath": "assets/screens/history.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. Criar 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. Criar WalkthroughComposition.tsx:

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

    • Defina o ID da composição
    • Configure as dimensões do vídeo
    • Defina 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/

Passo 3: Visualizar e Refinar

  1. Iniciar o Remotion Studio:

    npm run dev
    
    • Abre pré-visualização baseada em navegador
    • Permite edição e refinamento em tempo real
  2. Ajustar temporização:

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

    • Configure springs para efeitos de zoom
    • Modifique funções de easing para transições
    • Garanta que o texto seja legível o tempo todo

Passo 4: Renderizar Vídeo

  1. Renderizar usando a CLI do Remotion:

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

    • Chame [remotion_prefix]: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)

Recursos Avançados

Pontos de Interatividade (Hotspots)

Destaque elementos clicáveis ou recursos 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 à demonstração:

  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 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. Chame [stitch_prefix]:download_file com htmlCode.name para cada tela (decodifique a saída truncada com save-stitch-file.mjs)
  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 interface
  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 do Stitch baixadas
│   │           ├── home.png
│   │           └── history.png
│   ├── remotion.config.ts
│   └── package.json
├── screens.json                # Manifesto das telas
└── output.mp4                  # Vídeo renderizado

Integração com Habilidades do Remotion

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

Habilidades chave do Remotion a serem aproveitadas:

  • Temporização e easing de animações
  • 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

Demonstração básica com transições de fade:

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

Padrão 2: Destaque de Recurso

Foco em elementos específicos da interface:

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

Padrão 3: Fluxo do Usuário

Mostre a jornada do usuário passo a passo:

  • Fluxo de tela sequencial 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 borradasGaranta que as imagens baixadas estejam em resolução total via download_file (screenshot.name) em vez de miniaturas comprimidas
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 inconsistentesAumente a taxa de quadros para 60fps; use configurações de spring adequadas com damping apropriado
Falha na construção do RemotionVerifique a compatibilidade da versão do Node; garanta que todas as dependências estejam instaladas; revise a documentação do Remotion
Temporização inadequadaAjuste 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 do Stitch ou dimensione proporcionalmente
  2. Temporização consistente: Mantenha a duração de exibição das telas consistente, a menos que enfatize 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 ativos: Comprima imagens adequadamente; use formatos eficientes (PNG para interface, JPG para fotos)

Exemplo de Uso

Prompt do usuário:

Consulte as telas no meu projeto Stitch "Calculator App" e construa um vídeo remotion 
que mostre uma demonstração das telas.

Fluxo de trabalho do agente:

  1. Liste projetos Stitch → Encontre "Calculator App" → Extraia ID do projeto
  2. Liste telas no projeto → Identifique todas as telas (Início, Histórico, Configurações)
  3. Baixe capturas de tela para 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 temporização e transições
  7. Renderize vídeo final → calculator-walkthrough.mp4
  8. Reporte conclusão com link de pré-visualização do vídeo

Dicas para o Sucesso

  • Comece simples: Comece com...

Habilidades Relacionadas