Communitygithub.com

demo-video

Planeje e crie vídeos curtos baseados em evidências sobre trabalho de software: vídeos de conclusão para uma única alteração, demonstrações de sprint, resumos 'Anteriormente em', resultados de pesquisa, lançamentos, filmes conceituais, tutoriais e reproduções de bugs. Um blueprint: resumo, tabela de reivindicações, storyboard, ritmo, branding e revisão, para qualquer renderizador HTML-para-vídeo.

O que é demo-video?

Esta habilidade 'demo-video' fornece um blueprint metodológico para criar vídeos curtos e baseados em evidências sobre trabalho de software, priorizando a demonstração de fatos reais sobre a estética cinematográfica. Ela é projetada para diversos cenários, como vídeos de conclusão de tarefas, demonstrações de sprint, resumos de projetos contínuos, resultados de pesquisas e reproduções de bugs, oferecendo modos específicos com durações e estruturas recomendadas. O processo começa com a definição do modo e a escrita de um resumo (BRIEF.md), seguido por regras não negociáveis que garantem que cada quadro mostre algo real, identificado e legível em dispositivos móveis, com o resultado principal apresentado primeiro. A habilidade descreve um ciclo de trabalho detalhado, desde a criação de storyboards textuais até a captura, composição, renderização e entrega, suportando ferramentas como HyperFrames, Remotion, Motion Canvas e FFmpeg. Importante: ela autoriza apenas a captura e composição locais, não a publicação ou ações em sistemas externos sem autorização explícita.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jernejk/jkstack/tree/HEAD/blueprints/demo-video

Perguntar na sua IA favorita

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

Documentação

Demo video

Um vídeo aqui é evidência em primeiro lugar e filme em segundo. Cada quadro mostra algo real, rotulado pelo que é, legível em um celular e cronometrado para que o resultado chegue antes do detalhe.

Este é um blueprint, não uma habilidade instalada. Ele descreve um método que produziu filmes reais, mas não inclui nenhum renderizador, gravador ou verificador. Use as ferramentas que você tem; extensões descreve aquelas que valem a pena construir. Resolva caminhos de referência relativos a esta pasta de habilidade.

1. Escolha o modo, depois escreva o resumo

ModoUsoDuraçãoForma
doneuma alteração ou correção de bug mesclada15–30 scartão de introdução → a alteração na UI real → cartão final com o problema ou PR
sprint-demouma revisão de sprint para stakeholders2–4 minmeta do sprint → 3–5 etapas concluídas, mais valiosas primeiro → não concluído → próximo
previously-onum episódio de um projeto em andamento1–3 minúltimo tópico aberto → partes: pergunta → resultado → o que mudou → próximo tópico
researchum experimento, spike ou noite de pesquisa1–2.5 minpergunta → método em uma imagem → resultado com seu denominador → surpresas → decisão
releaseo que foi lançado e o que vem a seguir1–2.5 minforma de recapitulação com estados mesclado → lançado → staging → produção
conceptum filme conceitual, mockup ou proposta45–95 sgancho de resultado → um exemplo funcional → prova → limite honesto → recompensa
walkthroughcomo fazer uma tarefa30–90 sresultado finalizado → etapas na UI real → resultado finalizado novamente
reproum relatório de bug10–30 sambiente → etapas → a falha, mantida → resultado esperado em texto

Detalhes por modo: modes. Retrospectivas, aniversários e despedidas são a extensão de jornada em extensões.

Antes de qualquer captura, escreva BRIEF.md na pasta do filme: modo, público, um único takeaways, largura de visualização (padrão: um celular, 844 px paisagem e 390 px retrato player), perfil de marca, a classe de evidência de cada cena, prazo e resultados. Peça apenas o que você não pode inferir da solicitação ou fontes.

2. Inegociáveis

  • Evidência antes da arte. Mostre UI real, saída salva real e páginas de origem reais. Nunca pinte um estado que não aconteceu, invente um número ou implique velocidade, lançamento ou uso em produção. Cada fato na tela tem uma linha na tabela de reivindicações antes de sua cena ser construída (evidência).
  • Rotule o que é, na tela, o tempo todo. Uma faixa fora da câmera declara a classe de evidência: Local build, Concept demo · sample data, Recorded answer · replayed, Staging, Production. Conceitos e mockups nunca passam por funcionalidades lançadas.
  • Resultado primeiro. O takeaways e um número principal ou resultado visível chegam em cerca de 1,5 s após o início de uma cena e permanecem até o corte. Duração da cena ≥ 1 s + palavras ÷ 3 + 1,5 s de espera (ritmo).
  • Legível em um celular. Texto principal ≥ 80 px em 1080p; qualquer coisa que um espectador precise ler ≥ 36 px. Muitas palavras: corte palavras ou recomponha, nunca reduza.
  • UI nítida. Capture prova com densidade 2× e mostre-a em escala ≥ 1,0 ou aumente o zoom. Nunca amplie uma tela densa de 1080p e chame-a de close-up.
  • Apenas marca aprovada. Branding pessoal ou empresarial vem de um perfil de marca e dos ativos aprovados dessa marca (branding). Nunca redesenhe, recolorir ou aproxime um logotipo.
  • Som licenciado. Música e efeitos precisam de uma licença verificada e o crédito que ela exige.
  • Concluído significa verificado. Relate verificações técnicas, quadros inspecionados, reprodução em velocidade e audição separadamente. A aceitação do solicitante é seu próprio estado (revisão).

3. Ciclo de trabalho

  1. Resumo e reivindicações. BRIEF.md e a tabela de reivindicações. Para filmes com números, tenha um revisor independente, idealmente uma família de modelos diferente ou uma pessoa, verifique o texto final na tela, incluindo texto dentro de capturas de tela, antes da renderização completa.
  2. Storyboard em palavras. Uma linha por cena: janela de tempo, linha principal, imagem, rótulo de evidência, dica de som, como faz a transição. Escolha os 3–5 tipos de transição que o filme usa e o que causa cada um.
  3. Captura (capture). Fluxos de navegador com script para filmagens interativas, captura de quadro com relógio falso para animação própria de uma página, capturas de tela de elementos 2× para imagens estáticas.
  4. Composição (composer). Modos curtos adequam-se a um compositor orientado por especificações; modos mais longos adequam-se a uma composição construída manualmente em uma linha do tempo pausada com cenas em uma grade de barras.
  5. Verifique antes de renderizar. Capture o primeiro momento legível de cada cena, ponto médio, espera tardia e ambos os lados de cada corte. Corrija colisões, texto cortado, quadros vazios e qualquer coisa que um estranho não pudesse ler.
  6. Renderize, misture, verifique. Renderize, codifique, misture música e efeitos, execute as verificações técnicas e, em seguida, leia você mesmo a folha de contato, tiras de corte e folhas de celular (movimento e som).
  7. Entregue. Cópias silenciosas, com música e para web, além de um pôster, o crédito da música ao lado do player e um REVIEW.md: o que foi medido, o que foi apenas observado e o pior quadro.

4. Toolchain

Qualquer renderizador que produza quadros deterministicamente serve. HyperFrames (Apache-2.0) e um script de captura de quadro canalizado para FFmpeg renderizam composições HTML diretamente. Remotion (React; verifique primeiro os termos de licença da empresa) e Motion Canvas (cenas TypeScript) têm seus próprios modelos de cena; o contrato de composição em composer traduz para eles. Automação de navegador como Playwright conduz a captura. FFmpeg codifica, mistura e mede. Fixe as versões do renderizador e desative a telemetria onde oferecido.

5. Autoridade

Fazer um filme autoriza captura local, composição e verificação. Não autoriza uploads, mensagens, comentários em PR ou issues, alterações de produto ou publicação. Use dados fictícios de amostra ou aprovados; nunca mostre nomes de clientes, clientes ou funcionários sem aprovação, e nunca dê zoom em uma identidade logada.

Referências

NecessidadeLeia
Perfis de modo e formas de históriamodes
Reivindicações, rótulos, estados de status, verificação de fatosevidência
Tempo de leitura, tamanhos de texto, larguras de celularritmo e celular
Movimento, transições, música e efeitosmovimento e som
Perfis de marca pessoal e empresarialbranding
Técnicas e armadilhas de capturacapture
Especificação de vídeo concluído e contrato de composiçãocomposer
Estágios de revisão e sugestões de entregarevisão e entrega
Gravador, verificadores, recapitulações de uma linha do tempo, filmes de jornadaextensões

Habilidades Relacionadas