Communitygithub.com

ASoudy/AGS

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

O que é AGS?

Esta skill capacita agentes de IA a criar vídeos de demonstração profissional a partir de designs de aplicativos gerenciados no Stitch. Ela automatiza todo o fluxo: descobrir servidores MCP disponíveis, listar e baixar capturas de tela de um projeto Stitch, organizar os assets em uma ordem narrativa e gerar uma composição de vídeo no Remotion com transições suaves, animações de zoom e sobreposições de texto. É especialmente útil para desenvolvedores, designers de produto e criadores de conteúdo que precisam produzir vídeos de apresentação de aplicativos sem edição manual, suportando tanto o Remotion CLI quanto o Remotion MCP. O agente cria componentes React modulares (como ScreenSlide e WalkthroughComposition), configura transições como fade, slide e zoom, e permite personalizar durações, legendas e destaques interativos, resultando em um arquivo de vídeo final pronto para compartilhamento.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/skills/remotion

Perguntar na sua IA favorita

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

Documentação

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: ou mcp_stitch:
  • Remotion MCP: Procure pelo prefixo remotion: ou mcp_remotion:

Passo 2: Recupere 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. Obtenção de metadados das telas: 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 dimensionamento 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 preparação: assets/screens/{nome-da-tela}.png
    • Organize os assets na ordem do fluxo pretendido do walkthrough

Passo 3: Configure o Projeto Remotion

  1. Verifique se já existe um projeto Remotion:

    • Procure por remotion.config.ts ou package.json com dependências do 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 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:

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

Sobreposições de Texto

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

  1. Títulos das telas: Exibidos na parte superior ou inferior de cada quadro
  2. Destaques de funcionalidades: Destaque elementos específicos da interface com ponteiros animados
  3. Descrições: Texto descritivo que aparece gradualmente para cada tela
  4. Indicador de progresso: Mostra a posição atual da tela no walkthrough

Etapas 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 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/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:

  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 as telas com componentes <Sequence>
    • Aplique transições entre as 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 a 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 uma visualização no navegador
    • Permite edição e refinamento em tempo real
  2. 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
  3. 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

  1. Renderize usando o Remotion CLI:

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

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

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

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:

  1. Gere um roteiro de narração a partir das descrições das telas
  2. Use texto-para-fala ou grave áudio
  3. Importe o á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 (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 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:

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

ProblemaSolução
Capturas borradasGaranta que as imagens baixadas estejam 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 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 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 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 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:

  1. Liste os projetos Stitch → Encontre "Calculadora App" → Extraia o ID do projeto
  2. Liste as telas do projeto → Identifique todas as telas (Inicial, Histórico, Configurações)
  3. Baixe as capturas de tela de cada tela → Salve em assets/screens/
  4. Crie o manifesto screens.json com os metadados das telas
  5. Gere os 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 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

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.

Individual skills in this repo

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

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Habilidades Relacionadas