Communitygithub.com

visalnaqvi/video-generator-skill

Orquestra todo o pipeline de vídeo deste estúdio, de uma ideia ou briefing até o MP4 final — passando por identidade visual (novos clientes), roteiro (gancho, história, script), storyboard (conceitos, frames de estilo, shots, apresentação PDF), narração e renderização (música, som, legendas, final, QC) — parando para aprovação do usuário em cada etapa, permitindo retomar qualquer vídeo de onde parou e reportando o status. Use quando o usuário quiser um novo vídeo do início ao fim ('fazer um vídeo sobre…', 'novo promo/explainer/reel para…'), quiser continuar ou verificar um vídeo ('continuar o vídeo Stargate', 'onde estamos?', 'qual o próximo passo?') ou perguntar o status de todos os vídeos. Coordena as habilidades de cada etapa; nunca executa o trabalho delas diretamente.

O que é video-generator-skill?

Esta skill atua como o maestro de um pipeline completo de produção de vídeo. Ela gerencia e orquestra as habilidades especializadas (brand-kit, write, storyboard, voiceover, render) que executam o trabalho real de cada etapa — desde a criação de uma identidade visual para novos clientes, passando pela escrita de gancho, história e script, até a geração de storyboard, narração e renderização final. A skill garante que cada etapa só avance mediante aprovação explícita do usuário no chat, oferecendo controle total sobre o processo criativo. Ela é especialmente útil para desenvolvedores e criadores de conteúdo que desejam automatizar a produção de vídeos promocionais, explicativos ou reels, mantendo a supervisão humana em cada gate. A skill é compatível com ambientes que utilizam ferramentas de IA como Claude, Cursor ou Codex, pois depende de scripts Node.js e de arquivos de status para coordenar o fluxo de trabalho. Ao ser invocada, ela utiliza o comando `status.mjs` para verificar o estado atual do vídeo e, em seguida, chama a skill apropriada para a próxima ação, seguindo rigorosamente as instruções de cada etapa e garantindo que nenhum arquivo ou processo fique desatualizado.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/visalnaqvi/video-generator-skill/tree/HEAD/.claude/skills/produce

Perguntar na sua IA favorita

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

Documentação

Produzir — do briefing ao vídeo final

O maestro do estúdio. Cada etapa tem sua própria skill e faz seu próprio trabalho; esta skill decide qual etapa executar em seguida, garante que cada portão seja aprovado antes de avançar e mantém o usuário orientado. As etapas trocam informações por meio de arquivos em videos/<video>/, nunca chamando scripts umas das outras diretamente.

brand-kit (somente novos clientes) → write → storyboard → voiceover → render

Como estão as coisas

node studio/scripts/status.mjs videos/<video> — lê os arquivos do vídeo e imprime cada etapa (concluída / aguardando aprovação / desatualizada / não iniciada), a próxima ação e escreve videos/<video>/status.md. Sem argumentos, lista todos os vídeos e seus próximos passos. Execute no início de cada sessão de produção e após cada etapa.

Iniciando um novo vídeo

  1. Obtenha a solicitação: cliente/marca (site?), para que serve e quaisquer detalhes do briefing que o usuário já forneceu. Não interrogue — a skill de escrita coleta o briefing.
  2. Marca: se o cliente não tiver um kit aprovado em studio/brands/, execute a skill brand-kit (ela inclui a biblioteca de ativos). Kit aprovado existente → reutilize-o. Universo: apenas se o usuário nomear um universo ou um de seus personagens (ex.: "com Nox", "no Noxverse"), o vídeo usa esse universo (skill universe): sua paleta substitui o kit da marca, a menos que o usuário peça explicitamente também por uma marca do cliente. Nunca sugira ou pergunte sobre universos caso contrário — o fluxo normal é executado.
  3. Execute a skill write. Ela cria videos/<YYYY-MM-DD>-<slug>/ e o briefing, depois gancho → história → script com aprovações.

Continuando um vídeo

Execute status.mjs, depois invoque a skill para a próxima ação:

Próxima ação do statusSkill
kit da marca ausente / não aprovado / sem biblioteca de ativosbrand-kit
universo nomeado no briefing mas ausenteuniverse
briefing, gancho, história ou script não aprovadoswrite
storyboard não iniciado, aguardando aprovação ou desatualizadostoryboard
narração não iniciada, não ajustada, aguardando aprovação ou desatualizadavoiceover
final não renderizado, aguardando aprovação ou desatualizadorender
concluídoinforme ao usuário que está final; ofereça variações ou um novo vídeo

Invoque as skills de etapa com a ferramenta Skill e siga suas instruções completamente — incluindo suas próprias etapas de aprovação. Não atalhe o processo de uma etapa a partir daqui.

Portões (sempre parar para o usuário)

  1. Kit da marca (novos clientes) · 2. Gancho · 3. História · 4. Script · 5. Conceito · 6. Frames de estilo ·
  2. Storyboard + apresentação · 8. Voz (audição + prévia) · 9. Vídeo final.

Vídeos de universo: o storyboard é mostrado para aprovação (portão 7) apenas quando studio/scripts/board-check.mjs passa — status.mjs mostra check ✓ / check ✗ na linha do storyboard aponta para a verificação enquanto falha.

A aprovação deve vir do usuário no chat para este vídeo e portão. "Parece bom", "aprovado", "pode ir" contam; silêncio ou uma pergunta não contam. Uma aprovação nunca cobre o próximo portão. Após cada portão, forneça uma linha de status e o próximo passo.

Alterações após a aprovação

  • Nomeie a etapa responsável pela alteração: palavras → write; aparência, animação, transições, dicas sonoras → storyboard; voz, ritmo, tempo → voiceover; música, legendas, mix, exportação → render.
  • A skill responsável incrementa a version; as etapas posteriores tornam-se desatualizadas (status mostra ⚠️). Execute novamente apenas o que está desatualizado, em ordem. Nunca deixe arquivos desatualizados para trás — remova saídas que não correspondam mais (ex.: uma prévia antiga) depois que forem substituídas.

Regras do estúdio (aplicam-se a cada etapa)

  • Grátis primeiro. Ferramentas pagas (voz ElevenLabs, imagens de IA, música de IA) apenas quando o usuário pedir ou aprovar uma estimativa de custo no chat.
  • Som contido. Apenas momentos marcantes; sem "whoosh" em cada transição.
  • Palavras vêm do script. Apenas a skill write altera palavras.
  • Economize tokens sem perder qualidade: scripts medem e reportam JSON; veja folhas de contato, não frames individuais; não assista MP4s — envie-os para o usuário.
  • Mantenha o usuário orientado: após cada etapa, um breve resumo + qual o próximo passo.

Reportando

Quando perguntado "onde estamos?" ou no final de uma sessão: execute status.mjs (todos os vídeos ou um) e resuma em uma tabela curta: vídeo · etapa · próximo passo · qualquer coisa aguardando o usuário.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Habilidades Relacionadas