Communitygithub.com

screen-demo

Cria um vídeo de demonstração polido (e um GIF) de qualquer site ou aplicativo web, por código. O Claude examina a página, planeja um tour e um script o executa no Chromium com cursor suave, cliques reais, digitação e rolagem suave, renderizando um vídeo 1920x1080 (ou vertical, ou quadrado) com zoom nos pontos importantes, anéis de destaque, legendas e um cartão de título.

O que é screen-demo?

O screen-demo é uma skill para agentes de IA (como Claude Code, Cursor, Codex) que transforma uma URL em um vídeo de demonstração profissional. Primeiro, o agente inspeciona a página usando Playwright para identificar elementos clicáveis e capturar capturas de tela numeradas. Depois, ele escreve um tour em JSON com cartão de título, rolagens, zooms, cliques e digitação. Finalmente, o script executa o tour em um Chromium real, capturando cada quadro a 30fps, e usa ffmpeg para renderizar o vídeo final em formato paisagem (16:9), vertical (9:16) ou quadrado. A skill também gera um GIF opcional para READMEs. É ideal para criar vídeos de demonstração de sites próprios, gravações de aplicativos ou walkthroughs rápidos, mantendo a interação suave e editando legendas e zooms sem regravar toda a cena.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/gabrielebolognese/screen-demo/tree/HEAD/skills/screen-demo

Perguntar na sua IA favorita

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

Documentação

O que screen-demo faz?

Transforma uma URL em um vídeo de demonstração. Você é o diretor: examina a página, escreve o tour como JSON, e o script reproduz, captura os quadros da própria página (nunca a área de trabalho) e edita o vídeo. Rolações, o deslizar do cursor e a digitação são capturados quadro a quadro a 30 qps, portanto são suaves mesmo em páginas pesadas; o que a página faz por si mesma após um clique ou carregamento vem da transmissão ao vivo.

Configuração (uma vez)

  1. Python 3.10+ com Pillow e um Playwright recente: python -m pip install -U playwright pillow, depois python -m playwright install chromium.
  2. ffmpeg no PATH (winget install ffmpeg, brew install ffmpeg).

Verifique com python tests/selftest.py (uma página local, sem rede, cerca de um minuto).

Fluxo de trabalho

  1. Pergunte para que é o vídeo: a URL, as 2 a 4 coisas a mostrar (o herói, um recurso, o preço, um fluxo de cadastro), o formato (landscape 16:9 para YouTube e READMEs, vertical 9:16 para Shorts e Reels, square), e se querem um GIF. Apenas o próprio site ou aplicativo do usuário, ou uma página pública que ele tenha permissão de exibir.
  2. Examine a página: python scripts/demo.py inspect URL WORK [--format vertical]. Leia cada WORK/page-N.jpg (a página em fatias do tamanho da viewport, cada elemento clicável numerado em vermelho) e WORK/elements.txt. Um banner de cookies ou pop-up aparece aqui: o primeiro passo do tour fecha ele (o botão "Rejeitar" ou "Fechar").
  3. Escreva WORK/tour.json (formato em references/tour-format.md): um cartão de título, depois passos curtos. Um bom tour: uma legenda que diz o que o produto faz, uma rolagem até a primeira coisa que vale a pena ver, um zoom nela, um clique ou alguma digitação que mostre o produto funcionando, um destaque no resultado, uma legenda por ideia. 15 a 40 segundos. Os alvos são os números da inspeção (#12), ou css=... ou text=....
  4. Grave: python scripts/demo.py record WORK/tour.json OUT [--gif]. Reproduz o tour, imprime cada passo que falhou, e renderiza OUT/demo.mp4 (e OUT/demo.gif).
  5. Veja OUT/keys.jpg (um quadro de cada passo) antes de considerar pronto: um zoom no lugar errado, uma legenda sobre o ponto do quadro, um passo que falhou (o elemento moveu-se ou estava oculto), um banner ainda no caminho. Para alterar apenas legendas, zooms ou o cartão de título, edite OUT/tour.json e execute python scripts/demo.py render OUT [--gif] (sem nova gravação); qualquer outra coisa, grave novamente.
  6. Entregue: o caminho de demo.mp4 (e o GIF), sua duração, e uma linha por ideia que ele mostra.

Regras

  • Nunca faça login com senha, nunca digite senha ou número de cartão (o script recusa campos de senha e pagamento), nunca compre, envie, publique ou exclua nada, nunca envie um formulário com dados pessoais de alguém. Uma demonstração de uma área logada precisa que o usuário forneça a página de uma conta de teste.
  • Recuse banners de cookies (o mínimo de dados) a menos que o usuário diga o contrário.
  • Mantenha legendas curtas (3 a 8 palavras); uma ideia por legenda; o próprio movimento do vídeo faz o resto.
  • Respeite o site: nenhum tour de uma página que o usuário não possa exibir.

Exemplo

Usuário: "faça uma demonstração de 20 segundos da minha landing page https://exemplo.com para o README, mostre o cadastro"

Você executa o inspect, lê as 3 fatias, vê um banner de cookies (#2 "Rejeitar todos"), o herói, um campo "Experimente" (#9) e um cartão de preço (#21); você escreve um tour: um cartão de título, clique em #2, legenda "Notas que se escrevem sozinhas", digite em #9, clique em #10, destaque o resultado, legenda "Gratuito para sempre", role até #21, zoom; grave com --gif, abra keys.jpg, veja que o zoom enquadrou bem o preço, e responda com demo.mp4 (21 s), demo.gif (3 MB) e as quatro ideias.

Habilidades Relacionadas