Communitygithub.com

Video Director

Dirija e produza vídeos completos usando arte gerada por IA com planos de fundo editáveis em SVG, interface de produto real ou 3D procedural. Ideal para vídeos explicativos, demonstrações de produto, filmes de lançamento, Shorts e estudos de antes/depois que exigem visuais legíveis, anotações temporizadas, captura suave e um MP4 de revisão local. Não é para uma imagem isolada ou animação de site comum sem um entregável de vídeo.

O que é Video Director?

Video Director é uma habilidade especializada para agentes de IA, projetada para criar vídeos completos e polidos a partir de arte gerada por IA, combinando elementos editáveis como SVG, interface de usuário real ou cenas 3D procedural. O objetivo principal é tornar o assunto compreensível, não apenas animado, escolhendo o meio mais simples que represente fielmente a ação importante. A habilidade é entregue com scripts auxiliares em Node.js que gerenciam captura de tela cronometrada, mixagem de áudio com narração, verificação de integridade dos arquivos e comparação lado a lado, tudo rodando localmente no projeto do usuário. Diferente de um aplicativo separado, o Video Director opera dentro do fluxo de trabalho do agente, mantendo o controle sobre texto, setas, destaques e geometria factual em formatos vetoriais, enquanto usa a IA apenas para arte de fundo. A habilidade enfatiza a separação entre geração e montagem, preservação de ativos aprovados, anotações claras sem poluição visual, e a entrega final de um MP4 jogável localmente com todas as verificações de qualidade e metadados necessários para revisão.

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

Perguntar na sua IA favorita

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

Documentação

O que Video Director faz?

Faça o assunto ser compreensível, não meramente animado. Escolha o meio menos complexo que mostre a ação importante com veracidade. Esta é uma habilidade com auxiliares integrados, não um aplicativo separado ou biblioteca Python.

Briefing e receita

Estabeleça assunto, público, duração, proporção, ação principal e limite de entrega a partir da solicitação. Preserve vozes aprovadas, filmagens e posicionamento atual do produto. Faça escolhas secundárias reversíveis; pergunte sobre escolhas, direitos ou custos importantes que estejam faltando. A criação não autoriza publicação.

Mostre o resultado interessante desde o início. Escreva frases curtas e específicas: “Veja qual página recebe cliques,” não “Integre seu fluxo de trabalho.” Segure a interface real o tempo suficiente para ser lida. Estabeleça o mecanismo completo antes de explicar suas partes.

Leia apenas a receita relevante:

Escolha uma composição/paleta nova e pesquisada quando solicitado. Não imponha o estilo de um canal a todos os filmes. Cores complementares podem separar assuntos, mas rótulos e contraste também devem funcionar sem dicas de cor.

Decisões de produção

  1. Mantenha o controlável sob controle. Texto, setas, destaques, enquadramento de UI e geometria factual pertencem a SVG/HTML/canvas ou 3D. Pixels gerados são arte útil, não verdade exata de UI ou mecânica.
  2. Mostre a ação. Cliques reais precisam de um ponteiro visível e um lead-in; operações reais precisam de seu estado/filmagem real. Não anime uma captura de tela como se uma operação de backend tivesse ocorrido. Nomeie uma parte à medida que seu destaque aparece; rastreie sua âncora móvel.
  3. Direcione a atenção. Uma ação de ensino por vez. Suavize movimentos de câmera, estabilize, então segure. Derive posições a partir do tempo absoluto, não de deltas de quadro acumulados. Movimento secundário deve apoiar a explicação. Rotação linear é correta para um eixo de velocidade constante.
  4. Componha para a saída. Uma versão vertical precisa de enquadramento/posicionamento de rótulo legíveis próprios, não um recorte automático de paisagem. Mantenha anotações longe de partes, outros rótulos e sobreposições da plataforma.
  5. Separe geração de montagem. Salve arte aprovada e fala bruta. Registre prompts, fontes, direitos, configurações e hashes. Uma geração que expirou pode ainda ter criado um trabalho faturado; verifique antes de tentar novamente. Resolva escopo/custo faturados separadamente antes de gastar.
  6. Preserve limites de revisão. Use uma nova pasta de saída, preserve arquivos mestres/de recuperação e recuse sobrescrições acidentais. Pare antes de fazer upload/publicação a menos que autorizado separadamente.

Auxiliares de trabalho

Estes adaptam a captura com tempo explícito, serviço local seguro, montagem de clipes e verificações de saída codificada usados nas produções Pip. Resolva <skill> a partir da localização deste arquivo. Execute a partir do projeto de vídeo, não da pasta da habilidade. Leia production.md primeiro.

AuxiliarPropósito
scripts/create-example.mjsCopiar um primeiro projeto autocontido em uma nova pasta; nunca sobrescrever.
scripts/doctor.mjsVerificar dependências e realmente iniciar Chromium; sem instalações automáticas.
scripts/capture.mjsPágina local → H.264 silencioso de quadro exato; repetições no mesmo horário; hashes de origem/recibo de erro.
scripts/serve.mjsServidor estático somente loopback com intervalos e contenção de caminho.
scripts/compare.mjsLado a lado rotulado; rejeitar incompatibilidade de duração/fps.
scripts/audio.mjsClipes de fala existentes + pausas explícitas → WAV e manifesto de temporização medido.
scripts/verify.mjsProbe/decodificação completa/hash, todas as estatísticas de quadros adjacentes e folha de contato codificada.
scripts/self-test.mjsTestes de regressão para auxiliares e proteção contra sobrescrita.
scripts/boundary-test.mjsRegressões de navegador-rede local e áudio danificado.

Requer Node, FFmpeg/FFprobe e Playwright/Chromium acessível ao projeto; Three.js apenas para 3D. Auxiliares não instalam pacotes/modelos, chamam provedores, leem credenciais ou publicam. assets/first-video/ é apenas código e não precisa de mídia externa. O iniciador de comparação em assets/comparison-study/ contém código e um manifesto de ativos, não capturas de tela particulares, mídia gerada, fontes ou Three.js vendido.

Entrega

Faça uma passagem de temporização em baixo fps antes da captura final. Verifique a duração codificada, dimensões, fps, decodificação completa, cor, keyframes legíveis e limites de transição. As métricas suportam inspeção; uma grande diferença de quadro pode ser uma edição intencional, enquanto diferenças baixas podem esconder animação congelada. Olhe para o filme e ouça a fala. ASR e WAVs limpos não provam uma voz natural.

Entregue um MP4 local reproduzível e o caminho de origem, com verificações e omissões. Não reivindique 60 fps em tempo real de captura offline, um resultado histórico de uma linha de base construída ou um teste de agente independente da execução do próprio autor.

Veja lineage.md para inspirações e limites de licença. Habilidades instaladas especializadas podem complementar esta; o fluxo de trabalho não requer carregar todas as habilidades ou copiar repositórios upstream.

Habilidades Relacionadas