Vídeos de Walkthrough do 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ídeos do Remotion para produzir apresentações suaves e profissionais.
Visão Geral
Esta habilidade permite criar 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 organiza em uma composição de vídeo Remotion.
Pré-requisitos
Obrigatórios:
- Acesso ao Servidor MCP Stitch
- Acesso ao Servidor MCP Remotion (ou CLI Remotion)
- 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: Descobrir Servidores MCP Disponíveis
Execute list_tools para identificar servidores MCP disponíveis e seus prefixos:
- Stitch MCP: Procure pelo prefixo
stitch:oumcp_stitch: - Remotion MCP: Procure pelo prefixo
remotion:oumcp_remotion:
Passo 2: Recuperar Informações do Projeto Stitch
-
Consulta 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 do walkthrough
- Extraia os IDs das telas do campo
namede cada tela
- Chame
-
Busca de metadados das telas: Para cada tela:
- Chame
[prefixo_stitch]:get_screencomprojectIdescreenId - Recupere:
screenshot.downloadUrl— Recurso visual para o vídeohtmlCode.downloadUrl— Opcional: para extrair texto/conteúdowidth,height— Dimensões da tela para escala adequada- Título e descrição da tela para sobreposições de texto
- Chame
-
Download de recursos:
- Use
web_fetchouBashcomcurlpara baixar screenshots - Salve em um diretório de preparação:
assets/screens/{nome-da-tela}.png - Organize os recursos na ordem do fluxo de walkthrough pretendido
- Use
Passo 3: Configurar Projeto Remotion
-
Verificar projeto Remotion existente:
- Procure por
remotion.config.tsoupackage.jsoncom dependências do Remotion - Se existir, use a estrutura de projeto existente
- Procure por
-
Criar novo projeto Remotion (se necessário):
npm create video@latest -- --blank- Escolha o template TypeScript
- Configure em um diretório dedicado
video/
-
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 modular Remotion 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 de vídeo principal- 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 escalar adequadamente)
- Cálculo da duração total
Efeitos de Transição
Use @remotion/transitions para efeitos profissionais:
-
Fade: Transição suave de cruzamento 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 ê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: Exiba na parte superior ou inferior de cada quadro
- Destaques de funcionalidades: Destaque elementos específicos da interface com indicadores animados
- Descrições: Faça o fade-in do texto descritivo para cada tela
- Indicador de progresso: Mostre a posição atual da tela no walkthrough
Passos de Execução
Passo 1: Coletar Recursos da Tela
- Identifique o projeto Stitch alvo
- Liste todas as telas no projeto
- Baixe screenshots para cada tela
- Organize na ordem do fluxo de 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/inicio.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:
-
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 tela
- Sequencie telas com componentes
<Sequence> - Aplique transições entre 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 taxa de quadros e 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: Pré-visualizar e Refinar
-
Inicie o Remotion Studio:
npm run dev- Abre uma pré-visualização baseada em navegador
- Permite edição e refinamento em tempo real
-
Ajuste a 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
-
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 esteja legível em todos os momentos
Passo 4: Renderizar Vídeo
-
Renderize usando a CLI Remotion:
npx remotion render WalkthroughComposition output.mp4 -
Alternativa: Use o Remotion MCP (se disponível):
- Chame
[prefixo_remotion]:rendercom 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 renderização paralela (
--concurrency)
- Defina o nível de qualidade (
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:
- 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 (títulos, botões, rótulos)
- Gere chamadas automáticas para elementos importantes da interface
- Adicione à composição como sobreposições de texto temporizadas
Estrutura de Arquivos
projeto/
├── video/ # Diretório do projeto Remotion
│ ├── src/
│ │ ├── WalkthroughComposition.tsx
│ │ ├── ScreenSlide.tsx
│ │ ├── components/
│ │ │ ├── Hotspot.tsx
│ │ │ └── TextOverlay.tsx
│ │ └── Root.tsx
│ ├── public/
│ │ └── assets/
│ │ └── screens/ # Screenshots baixados do Stitch
│ │ ├── inicio.png
│ │ └── historico.png
│ ├── remotion.config.ts
│ └── package.json
├── screens.json # Manifesto de tela
└── 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. Consulte-as 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 Remotion chave para aproveitar:
- 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 cross-fade
- Sobreposição de texto na parte inferior com título da tela
- Barra de progresso na parte superior
Padrão 2: Destaque de Funcionalidade
Foco em elementos específicos da interface:
- 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
| Problema | Solução |
|---|---|
| Screenshots embaçadas | Garanta que as imagens baixadas estejam na resolução máxima; verifique as configurações de qualidade do 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 instáveis | Aumente a taxa de quadros para 60fps; use configurações de spring adequadas com damping apropriado |
| Falha na compilaçã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; pré-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 escale 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 apropriados; evite sobreposições poluídas
- Transições suaves: Use animações spring para movimento natural; evite cortes bruscos
- Pré-visualize completamente: Sempre pré-visualize no Remotion Studio antes da renderização final
- Otimize recursos: Comprima imagens adequadamente; use formatos eficientes (PNG para UI, JPG para fotos)
Exemplo de Uso
Comando do usuário:
Consulte as telas do meu projeto Stitch "Calculadora App" e construa um vídeo remotion
que mostre um walkthrough das telas.
Fluxo de trabalho do agente:
- Liste projetos Stitch → Encontre "Calculadora App" → Extraia o ID do projeto
- Liste telas no projeto → Identifique todas as telas (Início, Histórico, Configurações)
- Baixe screenshots para cada tela → Salve em
assets/screens/ - Crie o manifesto
screens.jsoncom metadados das telas - Gere componentes Remotion (
ScreenSlide.tsx,WalkthroughComposition.tsx) - Pré-visualize no Remotion Studio → Refine temporização e transições
- Renderize o vídeo final →
calculadora-walkthrough.mp4 - Relate 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 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 fácil atualização
- Pré-visualize com frequência: Use o Remotion Studio para detectar problemas cedo
- Considere acessibilidade: Adicione legendas; garanta texto legível; use visuais claros
- Otimize para a plataforma: Corresponda as dimensões do vídeo à plataforma alvo (YouTube, redes 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
- Remotion MCP: 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, teste ou revisão específica do ambiente do projeto.
- Pare e peça esclarecimentos se entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem faltando.