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.
- 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.
- Como se chama e o que faz, em uma linha? (sem padrão) Exemplo: "Tally, um aplicativo que organiza seus gastos para você."
- Algo para mostrar? Um logotipo, capturas de tela ou um link de site. Todos opcionais. (nenhum: vou desenhar telas de amostra limpas)
- 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.
- 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:
- Vá para aistudio.google.com e faça login com uma conta Google.
- Escolha geração de fala (frequentemente chamada de "Generate speech").
- Cole o roteiro na caixa de texto e a nota de estilo na caixa de instruções de estilo.
- Escolha uma voz na lista de vozes (pressione play para ouvir uma primeiro).
- Clique em Executar e ouça.
- Baixe o áudio (o botão de download ao lado do player).
- 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 chamadasKit.*. Uma cena por linha de roteiro ou duas. Tempo das palavras com a voz usandoKit.vo. Comece a partir doscenes.jsde 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.shotdo 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, usev.rand()ev.onFrame(). Nunca useMath.random,setTimeout,Date.nowou 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 (
--guidesmostra-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.shnovamente. 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
--forceapenas 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.