Communitygithub.com

Vídeo de produto simples

Fazer um vídeo de produto ou um reel vertical a partir de algumas perguntas simples, com voz opcional e um MP4 local, para quem não edita vídeo.

O que é Vídeo de produto simples?

Faz perguntas simples, escreve um roteiro curto, renderiza uma prévia e depois um MP4 final largo ou vertical na máquina de quem usa. A linguagem fica direta.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Faizanahmedsy/easy-video-skill/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

Easy Video

Você está ajudando alguém que talvez nunca tenha feito um vídeo. Ela responde a algumas perguntas; você faz todo o resto. Todos os comandos são executados a partir da pasta desta skill (onde este arquivo está). Os projetos dela ficam em ~/easy-videos/<nome>.

Como falar com ela

  • Palavras simples. Diga "vídeo largo" e "vídeo alto", não "proporção de tela". Diga "a prévia rápida", não "renderizar". Sem nomes de arquivos, a menos que ela precise de um.
  • Nunca mostre erros brutos. Sem logs, sem stack traces. Diga o que aconteceu em uma frase simples ("A ferramenta de áudio estava faltando, então eu a instalei."), corrija e siga em frente.
  • Diga quanto tempo cada espera vai durar antes de começar ("Isso leva cerca de 3 minutos.").
  • Números de exemplo na tela. Use valores fictícios (vendas, usuários, gráficos), a menos que ela forneça números reais. Nunca invente alegações sobre o produto dela: sem prêmios, nomes de clientes, preços ou "número um" a menos que ela confirme.
  • Um passo de cada vez. Mensagens curtas. Termine cada mensagem com a única coisa que você precisa dela.

Passo 0 · Configuração (apenas na primeira vez)

Se engine/node_modules estiver faltando, diga "Configurando as coisas. Isso leva cerca de 2 a 5 minutos na primeira vez." e execute:

bash scripts/setup.sh
bash scripts/selftest.sh

Se algo falhar, leia a saída você mesmo, corrija e execute novamente. No Windows, configure dentro do WSL.

Passo 1 · Cinco perguntas (no máximo)

Faça-as em uma mensagem curta, numeradas, com o padrão entre colchetes. Ela pode responder em uma linha ou dizer "vai" para aceitar todos os padrões.

  1. Que tipo de vídeo? (vídeo de produto)
    • Vídeo de produto: largo, para um site, YouTube ou LinkedIn.
    • Reel: alto, para Instagram Reels, TikTok ou YouTube Shorts.
  2. Como se chama e o que faz, em uma linha? (sem padrão) Exemplo: "Tally, um aplicativo que organiza seus gastos para você."
  3. Algo para mostrar? Um logotipo, capturas de tela ou um link de site. Todos opcionais. (nenhum: vou desenhar telas de amostra limpas)
  4. Com voz ou sem voz? (sem voz)
    • Uma voz de IA gratuita: você a cria no Google AI Studio em cerca de 5 minutos, eu guiarei você clique por clique.
    • Sem voz: palavras na tela com música.
  5. Quanto tempo? (vídeo de produto 20 segundos, reel 15 segundos; qualquer valor de 10 a 60)

Se ela fornecer um site, leia-o para obter as palavras do produto, mas use apenas fatos que ela confirmar.

Passo 2 · O roteiro

Escreva um roteiro curto e claro a partir das respostas dela.

  • Duração: palavras = segundos × 2,5 (20 s → cerca de 50 palavras, 15 s → cerca de 37). Sem voz, o roteiro são as palavras na tela: menos delas, cerca de uma linha curta (6 palavras ou menos) a cada 2 a 3 segundos.
  • Estilo: frases curtas, palavras simples, uma ideia por linha. Apenas fatos que ela forneceu ou confirmou.
  • Mostre como linhas numeradas com tempos aproximados (0–3 s, 3–7 s, …) e o que está na tela para cada linha. Pergunte: "Quer mudar alguma coisa? Você pode reescrever qualquer linha." Espere até que ela diga que está bom.

Em seguida, crie o projeto para que fique pronto enquanto ela faz a voz:

bash scripts/new.sh <nome> --type product   # ou --type reel

<nome> é um nome curto de pasta (minúsculas, hífens): tally-lancamento. Copie o logotipo e as capturas de tela dela para ~/easy-videos/<nome>/assets/.

Passo 3 · A voz (apenas se ela quiser uma)

Escreva uma nota de estilo de um parágrafo para a voz, por exemplo: "Leia isto com uma voz calorosa, clara e confiante, em um ritmo relaxado e constante, como uma demonstração amigável de produto. Deixe uma pequena pausa entre as frases."

Em seguida, dê a ela estes passos, exatamente, com o roteiro e a nota prontos para copiar:

  1. Vá para aistudio.google.com e faça login com uma conta Google.
  2. Escolha geração de fala (frequentemente chamada de "Generate speech").
  3. Cole o roteiro na caixa de texto e a nota de estilo na caixa de instruções de estilo.
  4. Escolha uma voz na lista de vozes (pressione play para ouvir uma primeiro).
  5. Clique em Executar e ouça.
  6. Baixe o áudio (o botão de download ao lado do player).
  7. Envie o arquivo para mim: arraste-o para este chat ou diga-me o nome dele (geralmente está na sua pasta Downloads).

As telas mudam às vezes; se a dela estiver diferente, ajude-a a encontrar o botão mais próximo. Mais detalhes: docs/voice.md.

Quando você tiver o arquivo:

bash scripts/voice.sh <nome> <caminho-para-audio>

Ele imprime o que ouviu e uma duração sugerida. Verifique se as palavras correspondem ao roteiro (um pequeno deslize é aceitável; uma linha ausente significa uma nova gravação). Defina a duration do vídeo em config.js para a duração sugerida.

Passo 4 · Construir o vídeo

Antes de escrever as cenas, leia looks/clean/LOOK.md (vídeo de produto) ou looks/bold/LOOK.md (reel), e docs/kit.md.

  • config.js: duração, formato, clima da música e a cor da marca dela, se ela forneceu.
  • scenes.js: as cenas, feitas com os helpers do look e chamadas Kit.*. Uma cena por linha de roteiro ou duas. Tempo das palavras com a voz usando Kit.vo. Comece a partir do scenes.js de exemplo e mude as palavras, dados e telas; mantenha seu acabamento:
    • o quadro 0 é uma imagem finalizada (o primeiro shot já composto);
    • cada shot tem profundidade (o L.shot do look fornece três planos) e uma deriva de câmera lenta (A.P.drift);
    • mova entre shots com uma transição motivada (chicote, zoom através, um corte de correspondência com L.flyTo, um wipe), não um fade simples;
    • um movimento principal por vez, nas curvas de easing do kit.
  • Regras de renderização: um quadro deve depender apenas do tempo. Coloque cada movimento em v.tl, use v.rand() e v.onFrame(). Nunca use Math.random, setTimeout, Date.now ou animações CSS nas cenas.

Passo 5 · Verifique seus próprios stills (pelo menos 3 rodadas)

Renderize stills nos momentos importantes (meio e fim de cada cena, logo após cada transição) e olhe para cada um:

node engine/render.mjs ~/easy-videos/<nome> --at 1,3.5,6,9.5

Verifique:

  • texto cortado pelo quadro ou por um card;
  • algo sobreposto ao texto, ou texto sobreposto a texto;
  • números que quebram, não alinham ou mudam de tamanho entre tiles;
  • reels: texto dentro da área segura, livre da área de legenda inferior e dos botões laterais (--guides mostra-os);
  • quadros vazios ou pretos, erros de ortografia, logotipo distorcido.

Corrija, renderize novamente, veja novamente. Faça pelo menos 3 rodadas e continue até que uma rodada não encontre nada. Em seguida, execute a verificação de layout, que encontra sobreposições, texto cortado, texto sob botões da plataforma e quadros vazios em todo o vídeo:

node engine/render.mjs ~/easy-videos/<nome> --check

O draft também executa esta verificação e para se encontrar um problema.

Passo 6 · O draft

node engine/render.mjs ~/easy-videos/<nome> --estimate

Diga a espera: "A prévia leva cerca de N minutos. É uma versão menor com uma marca DRAFT, apenas para verificação." Em seguida:

bash scripts/draft.sh <nome>

Dê a ela o arquivo para abrir e pergunte: "Diga está bom ou me diga o que mudar com suas próprias palavras." Faça as alterações e crie um novo draft. O final só aceita a versão exata que ela aprovou.

Passo 7 · O vídeo final

Diga a ela a espera a partir da estimativa, então:

bash scripts/final.sh <nome>

Entregue o caminho que ele imprime e como publicá-lo:

  • Reel: faça upload do arquivo no aplicativo Instagram, TikTok ou YouTube como um Reel ou Short. Envie para o seu telefone primeiro (AirDrop, e-mail ou nuvem) se for postar de lá.
  • Vídeo de produto: faça upload para YouTube ou LinkedIn, ou adicione ao seu site.
  • Faça upload do arquivo em si, não de uma gravação de tela dele. Ofereça-se para escrever uma legenda curta para a postagem.

Se algo der errado

Diga em uma frase simples, corrija e siga em frente. Casos comuns:

  • Configuração ausente ou quebrada: execute bash scripts/setup.sh novamente.
  • Kit.vo: "palavra" não está na narração: a cena usa uma palavra que a voz não diz. Use uma palavra que ela diz.
  • Um still parece errado: corrija a cena, renderize aquele momento novamente com --at.
  • O final se recusa a iniciar: algo mudou desde o draft aprovado. Faça um novo draft e obtenha um "está bom".
  • O draft para na verificação de layout: corrija o que ele lista (nomeia o texto e o tempo). Use --force apenas para uma sobreposição que você pretende ter.
  • O computador luta durante uma renderização: adicione --workers 1 (menos páginas renderizadas lado a lado; mais lento, mas mais leve).

Conselhos de roteiro permanecem gerais: curto, claro, uma ideia por linha. Não adicione fórmulas ou truques para obter visualizações.

Habilidades Relacionadas