Communitygithub.com

rnijhara/claude-skills

Produza um vídeo MP4 demo ou walkthrough narrado, com capítulos e resolução 1080p, de qualquer produto baseado em navegador (web app, dashboard, ferramenta interna, artefato incorporado). Ele dirige a interface real no Chrome com cursor na tela, anéis de destaque, notas e cartões de título, narra um roteiro de cena com TTS (Amazon Polly ou macOS say), sincroniza cada ação com a narração, corta esperas de carregamento e mixa, normaliza e adiciona capítulos ao resultado. Use quando for solicitado a "criar um vídeo demo", "gravar um walkthrough", "fazer uma screencast com narração", "vídeo de tour do produto" ou para regravar ou alterar a narração de um existente.

O que é claude-skills?

Esta skill permite a criação automatizada de vídeos de demonstração ou walkthrough narrados em 1080p com capítulos, controlando o navegador Chrome real via CDP (Chrome DevTools Protocol). Útil para desenvolvedores, gerentes de produto e equipes de suporte que precisam produzir vídeos de alta qualidade de produtos baseados em navegador de forma repetível e eficiente. A skill suporta plataformas como Claude Code, Cursor, Codex e outros agentes de IA que executam scripts Node.js e Python. O fluxo de trabalho é composto por etapas: (1) definição do script da cena em código (script.cjs), (2) geração de voz via TTS (Amazon Polly ou macOS say), (3) gravação da tela com sobreposição de cursor, anéis de destaque e notas, (4) pós-produção que corta esperas, normaliza áudio (LUFS) e adiciona capítulos, e (5) revisão visual. O pipeline é idempotente: alterações no roteiro ou voz geram regravação automática sem necessidade de regravar manualmente. A skill prioriza a estabilidade e a repetibilidade, usando gravação em tela cheia (1920×1080) e garantindo que a narração dite o tempo das ações.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/rnijhara/claude-skills/tree/HEAD/plugins/browser-demo-video/skills/browser-demo-video

Perguntar na sua IA favorita

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

Documentação

Vídeo demo de navegador

Você escreve o script do vídeo como código, então as tomadas são repetíveis: uma mudança de voz ou um rótulo corrigido significa uma regravação automática, não uma regravação manual. O pipeline:

script.cjs ──tts.cjs──▶ audio/*.wav + durations.json
     │                                │
     └──────────record.cjs◀───────────┘   Chrome + overlay, CDP screencast → takes/<target>/frames + timeline.json
                    │
               post.py  ──▶ MP4 (cortes removidos, narração + sons de clique, −16 LUFS, capítulos)
                    │
               review.py ──▶ folhas de contato + verificação de volume/capítulos → você inspeciona, então entrega

Engine: scripts/ nesta skill. Projeto por vídeo: ~/Movies/Demos/<slug>/ (nunca /tmp, que é limpo), contendo video.config.cjs, script.cjs, audio/ e takes/. Exemplo executável: examples/hello-orders/ (uma pequena página incorporada em um shell hospedeiro; use para verificar sua configuração). Leia references/lessons.md antes da primeira tomada.

Requisitos: Chrome, Node com Playwright (record.cjs o encontra, ou defina playwright na configuração), ffmpeg/ffprobe, Python 3 e a CLI da AWS para Polly.

1. Acorde o vídeo (antes de qualquer código)

Confirme e proponha um esboço ao qual o usuário possa reagir:

  • Público-alvo. Vídeos internos cobrem papéis, permissões, controles e limites conhecidos, e terminam com um capítulo "Coisas a saber". Vídeos para liderança e clientes cobrem resultados e apenas o caminho feliz.
  • O fluxo completo, como capítulos, e a duração alvo. Cerca de 10 a 12 minutos funcionaram para um mergulho interno.
  • Onde gravar (decisão). O walkthrough clica em botões reais e escreve estado real, então nunca executa em dados reais e compartilhados. Recomende uma cópia, um workspace de teste ou um ambiente de desenvolvimento com dados realistas, além de uma maneira de redefini-lo entre tomadas. Se criar essa cópia escreve em produção, precisa de um sim explícito.
  • Identidades (decisão). Se o fluxo precisa de duas pessoas (criador e revisor), um colega de equipe real faz login em uma segunda janela, ou uma pessoa faz ambos os papéis e o vídeo diz isso na tela. Nunca crie usuários ou lide com senhas; se uma conta de teste for necessária, o usuário a cria.
  • Voz (decisão). O padrão é Polly generativa "Amy" (en-GB), que se saiu bem com espectadores reais. Ofereça uma amostra de ~30 s de cada voz candidata antes de gerar tudo: aws polly synthesize-speech --profile <dev profile> --region eu-west-2 --engine generative --voice-id Amy --output-format mp3 --text "<passagem com o jargão do produto>" sample-Amy.mp3 Use uma conta AWS não produtiva. O macOS say funciona offline, mas soa sintético. A própria voz do usuário é a opção mais natural.
  • Enquadramento. Apenas o produto está no quadro: sem painéis laterais do host, listas ou banners. Configure isso no hook setup da configuração.

2. Configure o projeto

P=~/Movies/Demos/<slug>; K=~/.claude/skills/browser-demo-video
mkdir -p "$P" && cp $K/templates/video.config.cjs $K/templates/script.cjs "$P"/

Em video.config.cjs, preencha: a url do ambiente descartável, frame se o produto roda em um iframe, ready, setup (enquadramento), theme (cor de destaque do produto e rodapé), voice e helpers.waitLoaded (o sinal de carregamento do produto).

Mapeie a interface antes de escrever os passos. Abra-a, liste seletores estáveis (ids, roles, data-*, texto visível) e anote carregamentos lentos. Prefira seletores baseados em texto exibido (tr:has-text("-1.250,00") [data-resolve]) em vez de chaves geradas.

3. Escreva o roteiro da cena

Cada passo tem { id, chapter?, pre?, say?, act?, gap? }. A API h está documentada no topo de templates/script.cjs.

  • Narração dita o tempo. act executa enquanto o clipe toca, e h.at(0.6) alinha uma segunda ação com as palavras. Mantenha cada say em uma ou duas frases faladas.
  • Escreva números como são falados ("noventa e sete por cento", "catorze de setembro").
  • Use decisões reais de usuários reais onde existirem, para que os números na tela correspondam ao que a equipe conhece.
  • Coloque um cartão de capítulo (h.card) antes de cada capítulo, e adicione anéis com rótulos de 3 a 6 palavras. Use note() apenas onde um ponto precisa ser destacado, como uma propriedade de segurança, uma ressalva ou "no uso real…".
  • Envolva cada carregamento lento em h.cut(() => h.waitLoaded(), 'Carregando …'). Esse intervalo é removido na pós-produção.
  • Diga cada simplificação na tela e na narração. Por exemplo, uma pessoa faz dois papéis: mostre o controle bloqueando, mostre a configuração sendo alterada "apenas para esta gravação", então explique o que acontece no uso real.
  • Aponte para downloads; não clique neles (veja lições).

4. Gere a narração

node $K/scripts/tts.cjs "$P". Apenas linhas alteradas são regeneradas. Claude não pode ouvir o resultado, então nomeie as palavras arriscadas (siglas, nomes) e peça ao usuário para verificá-las. Com macOS say, soletre siglas como letras ("S A P").

5. Teste, faça login e grave

  1. Teste. Aponte TARGET=preview com previewUrl para uma build local, se existir. Caso contrário, execute segmentos curtos no ambiente descartável: ONLY='^(c1|load0|where1)$' node $K/scripts/record.cjs "$P" record. Verifique alguns quadros com a ferramenta Read (takes/prod/frames/*.jpg, failure.png em erros) e verifique com ffprobe se os quadros são 1920×1080. Redefina o ambiente depois.
  2. Faça login. Execute node $K/scripts/record.cjs "$P" login com run_in_background. O usuário faz login na janela que abrir e a fecha. Se ele disser que terminou mas a janela ainda estiver aberta, pkill -INT -f "record.cjs.* login".
  3. Tomada completa. Redefina o ambiente, então execute node $K/scripts/record.cjs "$P" record com run_in_background. Antes de começar, informe ao usuário que leva aproximadamente a duração da narração mais um terço, em uma janela visível do Chrome que ele não deve clicar. Aguarde a notificação de conclusão; não faça polling com sleep. Verifique o log para cada passo ok e nenhuma linha FAILED ou CRASHED.

6. Monte e revise

python3 $K/scripts/post.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4"        # run_in_background; ~10 min para um vídeo de 10 min
python3 $K/scripts/review.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4" "$P/review"   # opcional: step_id:0.8 picks

Leia cada folha review/s*.jpg. Procure por rótulos cortados ou sobrepostos, anéis no elemento errado, estados de carregamento que não foram cortados e sobreposições restantes. O volume deve estar em torno de −16 LUFS, e a contagem de capítulos deve corresponder ao roteiro. Corrija problemas no roteiro, redefina o ambiente e faça uma nova tomada. Novas tomadas são baratas.

7. Entregue e limpe

  • Entregue. Copie o vídeo para $P/<slug>.mp4 e execute open. Se uma versão anterior existir, mantenha-a renomeada (por exemplo, antigo-<voz>-<slug>.mp4), não sobrescrita.
  • Relate. Forneça a duração, resolução, capítulos, a voz, onde foi gravado, cada simplificação mostrada, o que você não pôde verificar (o áudio) e quaisquer falhas visuais restantes.
  • Pergunte antes de limpar. Obtenha a autorização do usuário antes de remover a cópia descartável ou o ambiente, e antes de deletar takes/ (quadros consomem GBs). Mantenha script.cjs, a configuração e audio/ para que o vídeo possa ser regravado depois.
  • Registre. Se o trabalho pertence a um ticket ou arquivo de notas, anote a localização do vídeo lá e que a exclusão da cópia está pendente. Faça commit apenas desse arquivo.

Habilidades Relacionadas