Vídeos de Walkthrough com Stitch para Remotion
Você é um especialista em produção de vídeo focado em criar vídeos de demonstração 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 no Remotion.
Pré-requisitos
Obrigatórios:
- Acesso ao MCP Server do Stitch
- Acesso ao MCP Server do Remotion (ou Remotion CLI)
- Node.js e npm instalados
- Um projeto Stitch com telas projetadas
Recomendados:
- Familiaridade com as capacidades de vídeo do Remotion
- Compreensão de componentes React (Remotion usa React)
Recuperação e Rede
Passo 1: Descubra os MCP Servers Disponíveis
Execute list_tools para identificar os MCP servers disponíveis e seus prefixos:
- Stitch MCP: Procure pelo prefixo
stitch:oumcp_stitch: - Remotion MCP: Procure pelo prefixo
remotion:oumcp_remotion:
Passo 2: Recupere Informações do Projeto Stitch
-
Busca de projeto (se o ID do projeto não for fornecido):
- Chame
[prefixo_stitch]:list_projectscomfilter: "view=owned" - Identifique o projeto alvo pelo título (ex: "Calculadora App")
- Extraia o ID do projeto do campo
name(ex:projects/13534454087919359824)
- Chame
-
Recuperação de telas:
- Chame
[prefixo_stitch]:list_screenscom 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
namede cada tela
- Chame
-
Obtenção de metadados das telas: Para cada tela:
- Chame
[prefixo_stitch]:get_screencomprojectIdescreenId - Recupere:
screenshot.downloadUrl— Ativo visual para o vídeohtmlCode.downloadUrl— Opcional: para extrair texto/conteúdowidth,height— Dimensões da tela para dimensionamento adequado- Título e descrição da tela para sobreposições de texto
- Chame
-
Download de assets:
- Use
web_fetchouBashcomcurlpara baixar as capturas de tela - Salve em um diretório de preparação:
assets/screens/{nome-da-tela}.png - Organize os assets na ordem do fluxo pretendido do walkthrough
- Use
Passo 3: Configure o Projeto Remotion
-
Verifique se já existe um projeto Remotion:
- Procure por
remotion.config.tsoupackage.jsoncom dependências do Remotion - Se existir, use a estrutura de projeto existente
- Procure por
-
Crie um novo projeto Remotion (se necessário):
npm create video@latest -- --blank- Escolha o template TypeScript
- Configure em um diretório dedicado
video/
-
Instale as 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:
-
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)
- Props:
-
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
- Sequencia múltiplos componentes
-
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 dimensionar adequadamente)
- Cálculo da duração total
Efeitos de Transição
Use @remotion/transitions para efeitos profissionais:
-
Fade: Transição suave de fade entre telas
import {fade} from '@remotion/transitions/fade'; -
Slide: Transições de deslizamento direcional
import {slide} from '@remotion/transitions/slide'; -
Zoom: Efeitos de zoom in/out para ênfase
- Use a animação
spring()para zoom suave - Aplique a elementos importantes da interface
- Use a animação
Sobreposições de Texto
Adicione informações contextuais usando a renderização de texto do Remotion:
- Títulos das telas: Exibidos na parte superior ou inferior de cada quadro
- Destaques de funcionalidades: Destaque elementos específicos da interface com ponteiros animados
- Descrições: Texto descritivo que aparece gradualmente para cada tela
- Indicador de progresso: Mostra a posição atual da tela no walkthrough
Etapas de Execução
Passo 1: Reúna os Assets das Telas
- Identifique o projeto Stitch alvo
- Liste todas as telas do projeto
- Baixe as capturas de tela de cada tela
- Organize na ordem do fluxo do walkthrough
- 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/home.png",
"width": 1200,
"height": 800,
"duration": 4
},
{
"id": "2",
"title": "Visualização do Histórico",
"description": "Visualização dos cálculos anteriores",
"imagePath": "assets/screens/history.png",
"width": 1200,
"height": 800,
"duration": 3
}
]
}
Passo 2: Gere os Componentes Remotion
Crie os componentes de vídeo seguindo as melhores práticas do Remotion:
-
Crie
ScreenSlide.tsx:- Use
useCurrentFrame()espring()para animações - Implemente efeitos de zoom e fade
- Adicione sobreposições de texto com temporização adequada
- Use
-
Crie
WalkthroughComposition.tsx:- Importe o manifesto de telas
- Sequencie as telas com componentes
<Sequence> - Aplique transições entre as telas
- Calcule temporização e deslocamentos adequados
-
Atualize
remotion.config.ts:- Defina o ID da composição
- Configure as dimensões do vídeo
- Defina a taxa de quadros e a duração
Recursos de Referência:
- Use
resources/screen-slide-template.tsxcomo ponto de partida - Siga
resources/composition-checklist.mdpara completude - Revise exemplos no diretório
examples/walkthrough/
Passo 3: Visualize e Refine
-
Inicie o Remotion Studio:
npm run dev- Abre uma visualização no navegador
- Permite edição e refinamento em tempo real
-
Ajuste a temporização:
- Certifique-se de 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
-
Ajuste fino das animações:
- Ajuste as configurações de spring para efeitos de zoom
- Modifique as funções de easing para transições
- Garanta que o texto esteja sempre legível
Passo 4: Renderize o Vídeo
-
Renderize usando o Remotion CLI:
npx remotion render WalkthroughComposition output.mp4 -
Alternativa: Use o Remotion MCP (se disponível):
- Chame
[prefixo_remotion]:rendercom os detalhes da composição - Especifique o formato de saída (MP4, WebM, etc.)
- Chame
-
Opções de otimização:
- Defina o nível de qualidade (
--quality) - Configure o codec (
--codec h264ouh265) - Ative a renderização paralela (
--concurrency)
- Defina o nível de qualidade (
Funcionalidades Avançadas
Pontos de Interação 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:
- Gere um roteiro de narração a partir das descrições das telas
- Use texto-para-fala ou grave áudio
- Importe o áudio no Remotion com o componente
<Audio> - 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:
- Baixe
htmlCode.downloadUrlpara cada tela - Analise o HTML para extrair elementos de texto chave (cabeçalhos, botões, rótulos)
- Gere destaques automáticos para elementos importantes da interface
- 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 das telas
└── output.mp4 # Vídeo renderizado
Integração com Skills do Remotion
O Remotion mantém suas próprias Agent Skills que definem as melhores práticas. Revise estas para técnicas avançadas:
- Repositório: https://github.com/remotion-dev/remotion/tree/main/packages/skills
- Instalação:
npx skills add remotion-dev/skills
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: Simples Apresentação 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 interface:
- Zoom em regiões específicas
- Círculos/setas animados apontando para funcionalidades
- Ênfase em câmera lenta em interações chave
- Comparações lado a lado de 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 das ações do usuário (cliques, toques)
- Conecte telas com caminhos animados
Solução de Problemas
| Problema | Solução |
|---|---|
| Capturas borradas | Garanta que as imagens baixadas estejam em resolução total; verifique as configurações de qualidade de screenshot.downloadUrl |
| Texto desalinhado | Verifique 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 travamentos | Aumente a taxa de quadros para 60fps; use configurações de spring adequadas com damping apropriado |
| Falha na construção do Remotion | Verifique a compatibilidade da versão do Node; garanta que todas as dependências estejam instaladas; revise a documentação do Remotion |
| Temporização estranha | Ajuste a duração por tela no manifesto; visualize no Remotion Studio; teste com usuários reais |
Melhores Práticas
- Mantenha a proporção: Use as dimensões reais da tela Stitch ou dimensione proporcionalmente
- Temporização consistente: Mantenha a duração de exibição das telas consistente, a menos que enfatize telas específicas
- Texto legível: Garanta contraste suficiente; use tamanhos de fonte adequados; evite sobreposições poluídas
- Transições suaves: Use animações spring para movimento natural; evite cortes bruscos
- Visualize completamente: Sempre visualize no Remotion Studio antes da renderização final
- Otimize assets: Comprima imagens adequadamente; use formatos eficientes (PNG para UI, JPG para fotos)
Exemplo de Uso
Prompt do usuário:
Busque as telas do meu projeto Stitch "Calculadora App" e crie um vídeo remotion
que mostre um walkthrough das telas.
Fluxo de trabalho do agente:
- Liste os projetos Stitch → Encontre "Calculadora App" → Extraia o ID do projeto
- Liste as telas do projeto → Identifique todas as telas (Inicial, Histórico, Configurações)
- Baixe as capturas de tela de cada tela → Salve em
assets/screens/ - Crie o manifesto
screens.jsoncom os metadados das telas - Gere os componentes Remotion (
ScreenSlide.tsx,WalkthroughComposition.tsx) - Visualize no Remotion Studio → Refine temporização e transições
- Renderize o vídeo final →
calculator-walkthrough.mp4 - Reporte a conclusão com link de pré-visualização do vídeo
Dicas para o Sucesso
- Comece simples: Inicie 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 os dados das telas organizados em JSON para atualizações fáceis
- 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
- Documentação do Stitch: https://stitch.withgoogle.com/docs/
- Documentação do Remotion: https://www.remotion.dev/docs/
- Skills do Remotion: https://www.remotion.dev/docs/ai/skills
- MCP do Remotion: https://www.remotion.dev/docs/ai/mcp
- Transições do Remotion: https://www.remotion.dev/docs/transitions
Quando Usar
Use esta skill ao lidar com tarefas relacionadas ao seu domínio principal ou funcionalidade, conforme descrito acima.
Limitações
- Use esta skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate o resultado como substituto para validação específica do ambiente, testes ou revisão de especialistas.
- Pare e peça esclarecimentos se as entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem faltando.