Communitygithub.com

mertz1999/assistente-demo-saas

Crie páginas de demonstração de vídeo SaaS cinematográficas e apresentações de produtos graváveis em tela. Use quando o Codex for solicitado a construir uma rota /demo, um tour animado do produto, uma apresentação promocional SaaS, uma página de gravação de tela, uma demonstração narrada do produto, uma história da UI guiada pelo cursor ou um sistema de vídeo de demonstração reutilizável para um aplicativo ou site.

O que é assistente-demo-saas?

Esta skill permite que um assistente de IA (como o Codex) crie páginas de demonstração de vídeo SaaS em tela cheia com movimento automático, projetadas para serem gravadas como vídeos de produto polidos. Ela prioriza uma curta história do cliente sobre um tour de funcionalidades, usando uma estrutura de storyboard de 30 a 50 segundos: gancho do problema, ação do administrador, momento do cliente, revelação do resultado, resultado de negócios e call-to-action final. A skill fornece um padrão de implementação detalhado para stacks modernas como Next.js, utilizando Framer Motion para transições de cena, animações de cursor e efeitos cinematográficos. Ela suporta controle de tempo preciso com base em áudio gerado, atributos `data-demo-cursor-target` para posicionamento preciso do cursor e validação de build e layout. O resultado é uma página de demonstração pronta para gravação ou apresentação ao vivo, com controles de reprodução e visualização de cena via parâmetros de consulta.

Funciona com~Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/mertz1999/luma-assistant/tree/HEAD/skills/saas-demo-video

Perguntar na sua IA favorita

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

Documentação

Página de Demonstração SaaS em Vídeo

Resultado

Construa uma página de demonstração em tela cheia, com movimento automático, que possa ser gravada como um vídeo de produto SaaS polido. Prefira uma curta história do cliente a um tour de funcionalidades: gancho do problema, ação do produto, momento do cliente, revelação do resultado, resultado de negócios, CTA final.

Use esta skill para criar ou melhorar rotas como /demo, /presentation, /video-demo ou páginas HTML/React independentes equivalentes.

Entradas Necessárias

Colete ou deduza estas informações antes da implementação. Pergunte apenas sobre bloqueios.

  • Nome do produto, domínio, público e promessa principal.
  • Duração alvo e proporção de aspecto, geralmente 30-60 segundos e 16:9.
  • Rotas do aplicativo existentes para mostrar: cadastro, painel, criação de produto, criação de link, página do cliente, análises.
  • Ativos da marca: logotipo, cores, fontes, imagens do produto, imagens de clientes, capturas de tela, ícones, molduras de telefone.
  • Restrições reais do fluxo de trabalho: o que o aplicativo realmente faz, o que é manual, o que é automático, quais dados estão disponíveis.
  • Roteiro de narração ou linha do tempo. Se o usuário gerou áudio, use os timestamps exatos.
  • CTA final e URL de gravação.

Nunca invente comportamentos que o produto não suporte. Se uma loja copia manualmente um link, diga isso em vez de dizer que o aplicativo o envia automaticamente.

Storyboard

Estrutura padrão de 30-50 segundos:

  1. Gancho do problema: mostre uma pergunta ou dor realista do cliente.
  2. Ação do administrador: adicione produto, crie link privado, copie mensagem.
  3. Momento do cliente: o cliente recebe o link, abre-o, carrega imagem, inicia a geração.
  4. Revelação do resultado: antes/produto/resultado lado a lado com uma animação de revelação limpa.
  5. Resultado de negócios: métricas do painel que importam.
  6. CTA final: promessa curta do produto e domínio.

Use o domínio real do aplicativo e a linguagem real do produto. Para comércio social, mostre a interface DM estilo Instagram apenas como um dispositivo visual de história, a menos que o produto realmente se integre com APIs do Instagram.

Padrão de Implementação

Use a pilha existente do aplicativo. Para aplicativos Next.js, prefira:

  • Uma rota como src/app/demo/page.tsx.
  • Um componente cliente para a apresentação temporizada.
  • Framer Motion para transições de cena, movimento do cursor, efeitos de revelação, brilho e zoom.
  • Componentes de UI existentes, logotipo, paleta e ativos.
  • Visualização de cena por parâmetro de consulta, por exemplo /demo?scene=resultReveal.

Comportamento principal do componente de demonstração:

  • Defina cenas como dados: id, title, caption, durationMs, cursor e metadados opcionais de foco visual/câmera.
  • Calcule os tempos de início das cenas a partir de durationMs.
  • Use uma linha do tempo baseada em relógio de parede para que recarregamentos a quente ou re-renderizações do desenvolvedor não redefinam a reprodução inesperadamente.
  • Adicione controles de reprodução, pausa, reinício, anterior e próximo, a menos que o usuário queira uma página de gravação pura.
  • Se sincronizar com áudio gerado, faça com que as durações das cenas correspondam exatamente aos intervalos de timestamp do áudio.
  • Adicione atributos data-demo-cursor-target a controles de UI importantes e calcule as posições do cursor a partir de getBoundingClientRect(). Evite coordenadas de cursor codificadas quando existir um alvo real.
  • Use ResizeObserver e requestAnimationFrame para manter os alvos do cursor precisos em diferentes tamanhos de viewport.
  • Respeite as configurações de movimento reduzido.

Direção Visual

Faça com que pareça um vídeo moderno de lançamento/demo SaaS:

  • Palco em tela cheia, não uma página de documentação normal.
  • Zooms cinematográficos em cliques importantes.
  • Movimento suave do cursor que continua da posição anterior do cursor.
  • Legendas curtas sobrepostas: "1. Adicionar produto", "2. Enviar link", "3. Cliente experimenta".
  • Capturas de tela reais do aplicativo ou maquetes de UI realistas dentro de molduras de navegador/telefone.
  • Um momento de revelação do resultado com flash, transição, desfoque-para-nítido ou comparação lado a lado.
  • Resultado limpo do painel com 2 a 4 métricas de alto sinal.
  • Sem parágrafos densos, sem logs de desenvolvedor, sem jargão técnico falso.

Para fluxos de cliente móvel, use uma moldura de telefone. Certifique-se de que o conteúdo dentro dela permaneça legível em viewports de gravação para desktop e celular.

Narração e Tempo

Se o usuário precisar de narração, forneça um prompt para um modelo de voz:

  • Tom: confiante, caloroso, premium, claro, não robótico.
  • Ritmo: corresponder à duração alvo.
  • Notas de pronúncia para o nome do produto.
  • Roteiro com timestamps por cena.

Se o usuário fornecer timestamps de áudio gerados, atualize as durações das cenas para esses intervalos exatos e verifique a duração total.

Veja references/storyboard-and-voiceover.md para modelos reutilizáveis de tempo e narração.

Validação

Antes de finalizar:

  • Execute o aplicativo localmente ou confirme o servidor dev/prod existente.
  • Execute verificações relevantes: typecheck, lint, build ou equivalente do framework.
  • Use verificações do Playwright/navegador nos tamanhos desktop e celular.
  • Verifique se não há overflow horizontal.
  • Verifique se o conteúdo da moldura do telefone está visível.
  • Verifique se o cursor pousa nos botões pretendidos usando medições de alvo do DOM.
  • Verifique se cada cena de visualização funciona através de parâmetros de consulta, se implementado.
  • Verifique se a URL pública final ou URL local retorna 200 OK.
  • Se um iframe de vídeo estiver incorporado, verifique se o iframe está presente no HTML renderizado.

Relate quaisquer avisos conhecidos apenas de desenvolvimento separadamente, como falhas de WebSocket do Next HMR em servidores dev de IP público.

Entrega

Retorne:

  • URL da página de demonstração.
  • Que rota/arquivos foram adicionados ou alterados.
  • Tabela de duração das cenas.
  • Prompt de narração, se solicitado.
  • Comandos/resultados de validação.
  • Quaisquer notas de gravação, como tamanho de viewport recomendado e se deve ocultar os controles.

Habilidades Relacionadas