Communitygithub.com

Produção de Vídeos Curtos Virais Animados

Pipeline completo de produção para vídeos curtos animados 2D (stickman em 3D) e 3D estilizados (9:16, 30-55s) usando Gemini Omni 1.2 Flash, folhas de referência de personagem com três painéis, QA forense com VLM multi-frame e montagem determinística com FFmpeg. Use quando o usuário quiser planejar, storyboard, gerar folhas de personagem, renderizar, fazer QA, atualizar de 2D para 3D ou montar vídeos curtos animados para YouTube Shorts, Reels ou TikToks.

O que é Produção de Vídeos Curtos Virais Animados?

Esta skill implementa um pipeline profissional de seis etapas para criar vídeos curtos animados virais no formato 9:16 (Shorts, Reels, TikToks), operando inteiramente sobre a stack de mídia do Gemini e FFmpeg, sem depender de wrappers pagos de terceiros ou do Blender. Ela suporta tanto o estilo 'stickman em 3D' (personagens 2D em cenários 3D) quanto animação 3D estilizada. O fluxo começa com a criação de script e bíblia de estilo, seguido pela geração de folhas de referência imutáveis de três painéis (frente, 3/4, costas) para cada personagem, garantindo consistência visual. A renderização é feita primeiro em baixa resolução (360p) para iteração rápida, depois submetida a uma rigorosa etapa de QA com VLM (Modelo de Linguagem e Visão) forense, que analisa múltiplos quadros-chave e compara com o plano original, aplicando correções específicas de um playbook de falhas. Após aprovação, os takes são renderizados em 1080p e montados com FFmpeg, incluindo áudio ducking, legendas karaokê e normalização de loudness (-14 LUFS). A pipeline também oferece uma etapa opcional de upgrade 2D para 3D, convertendo as folhas de referência bidimensionais em modelos tridimensionais estilizados. O objetivo é maximizar o potencial viral: o script é otimizado para engajar nos primeiros 3 segundos (Hook Gate), e a montagem final é preparada para as zonas seguras da interface do usuário das plataformas de Shorts.

Funciona com~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/nikeshthapa255/Video-creator-skills/tree/HEAD/viral-animated-shorts

Perguntar na sua IA favorita

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

Documentação

Pipeline de Vídeos Curtos Animados Virais

Produza vídeos curtos animados 9:16 (2D stickman em 3D ou 3D estilizado) nativamente na stack de mídia Gemini e FFmpeg, sem wrappers pagos de terceiros ou Blender.

Verificação de Pré-requisitos

Antes de executar a geração ou montagem de vídeo ao vivo, verifique as dependências locais (teste --version, não apenas which, porque macOS /usr/bin/python3 pode ser um stub não instalado do Xcode CLT):

  • API de Vídeo/Áudio: gemini-api whoami (preferido) ou SDK Python google-genai com GEMINI_API_KEY definida (consulte as skills gemini-omni-flash-api e gemini-api-cli).
  • Folhas de Personagem: gemini-api image (gemini-nano-banana-2.1) ou o subagente image-generator integrado.
  • Montagem e Amostragem de Quadros: ffmpeg -version, ffprobe -version, e python3 --version (para conversão de legendas).

Se gemini-api ou ffmpeg estiver faltando, complete os Estágios 1-2 ao vivo (usando image-generator para as folhas), gere jobs.json e legendas .ass, e relate os comandos exatos de instalação para as etapas restantes de renderização/montagem ao vivo.

Fluxo de Trabalho em Seis Estágios

Armazene todos os artefatos do projeto dentro de um diretório dedicado <project_dir>/ (ex.: shorts/<slug>/): shot_plan.json, sheets/, drafts_360p/, qa/, finals_1080p/, audio/, final_short.mp4.

Estágio 1: Roteiro, Bíblia de Estilo e Portão do Gancho

  1. Escreva um roteiro enxuto: 30-45s (2-4 cenas) para esquetes cômicos, ou 130-150 palavras (45-55s) para explicadores. Sem introdução ou saudação.
  2. Compile <project_dir>/shot_plan.json correspondendo a references/shot_plan_schema.json:
    • Fixe uma string style_bible idêntica reutilizada em todos os prompts de cena.
    • Defina cada personagem sem props segurados em seu design base.
    • Divida as cenas em clipes Omni de 3-15s com timecodes de batida [0-3s] e Duração Média do Take de 1,5-2,5s.
    • Defina audio_mode como native_omni (diálogo cômico/SFX) ou tts_plus_bgm (explicadores com narração).
    • Escreva a linha final para fazer loop sintaticamente na Batida 1.
  3. Portão do Gancho (obrigatório antes de renderizar): Verifique a Batida 1 (0-3s) em relação a references/qa_rubric.md (seção Portão do Gancho). Não gere vídeo até que a Batida 1 tenha contraste visual no quadro 0, movimento imediato e uma premissa verbal de loop aberto.

Estágio 2: Folhas de Referência de Três Painéis Imutáveis

  1. Construa uma folha de referência de três painéis 16:9 para cada personagem (Frente | 3/4 Lateral | Costas) usando os templates em references/sheet_prompt_templates.md.
    • Use fundo cinza claro neutro, iluminação plana e uniforme, expressão neutra, e sem props segurados (props causam morfismo de mãos entre takes).
  2. Gere via gemini-api image "<prompt>" --aspect-ratio 16:9 --image-size 2K --out <project_dir>/sheets/<char>_2d.png (ou delegue ao image-generator e copie/converta a saída .jpg/.png para <project_dir>/sheets/).
  3. Inspecione visualmente cada folha com read_file. Refaça se os painéis discordarem em proporções, vestuário ou espessura de linha.
  4. Ao usar gemini-api, faça upload das folhas aprovadas uma vez (gemini-api files upload <sheet> --wait) para reutilizar os URIs files/<id> em todas as cenas.

Estágio 3: Passada Rascunho 360p

  1. Gere rascunhos 9:16 em 360p com gemini-omni-1.2-flash (--aspect-ratio 9:16 --resolution 360p) via gemini-api video ou generate_video.py --batch jobs_360p.json. Cada item em jobs_360p.json usa:
    {"prompt": "...", "image": ["sheets/char_2d.png"], "duration": 7, "aspect_ratio": "9:16", "resolution": "360p", "output": "drafts_360p/shot_01.mp4"}
    
  2. Passe a(s) folha(s) de referência imutável(is) (-i / --image, até 6 imagens) em cada take e vincule cada personagem em linguagem natural por ordem de upload (nunca use tags <IMAGE_REF_N>).
  3. Inclua a style_bible literal, restrição negativa explícita (sem texto na tela, sem marcas d'água, sinais em branco), e batidas de take único ou timecode.
  4. Para takes com 2 personagens, separe os personagens espacialmente (esquerda/direita) ou use plano/contraplano para evitar sangramento de atributos.
  5. Para cortes contínuos diretos, extraia o último quadro limpo da Cena N como âncora secundária, mantendo a folha de referência canônica como âncora primária.

Estágio 4: QA Forense com VLM Consciente do Contexto (Máx. 2-3 Tentativas)

  1. Amostre quadros de cada clipe rascunho (início, meio, pico de ação, fim) mais o quadro final do take anterior:
    bash scripts/extract_qa_frames.sh <clip.mp4> <project_dir>/qa/<shot_id> [prev_clip.mp4]
    
  2. Execute gemini-api analyze (ou inspeção visual via read_file) com references/qa_rubric.md, passando a folha de referência, quadro final anterior e quadros amostrados.
  3. Diagnostique falhas pelo índice exato do quadro e código de falha (HOOK_WEAK, EXTRA_LIMB, STYLE_DRIFT, TEXT_WARP, AUDIO_DESYNC).
  4. Aplique a correção correspondente de references/failure_fix_playbook.md:
    • Pequena falha localizada: edite no local via --previous-interaction-id <id> ("<correção>. Mantenha todo o resto igual.").
    • Erro grave de anatomia/composição: simplifique ação/câmera e refaça.
    • Limite as tentativas a 3 por take. Registre qualquer nova correção descoberta em references/failure_fix_playbook.md.

Estágio 5: Renderização Final 1080p e Upgrade Opcional 2D para 3D

  1. Re-renderize os takes aprovados em 1080p (--resolution 1080p).
  2. Upgrade Opcional 2D para 3D: Converta cada folha 2D aprovada em uma folha de referência 3D estilizada usando o template de conversão 3D em references/sheet_prompt_templates.md com -i <char>_2d.png. Inspecione via read_file, atualize style_bible para 3D estilizado e reexecute o shot_plan.json comprovado.

Estágio 6: Montagem Determinística com FFmpeg

  1. Gere legendas .srt com temporização por palavra (gemini-api transcribe -i <audio_or_clip> --format srt) ou exporte a partir da temporização do roteiro.
  2. Converta .srt para legendas karaokê .ass em zona segura (posicionadas acima da zona de perigo de 35% inferior da interface de Shorts):
    python3 scripts/srt_to_ass.py <input.srt> <project_dir>/audio/captions.ass
    
  3. Execute o script de montagem probe -> conform -> concat -> duck -> queimar legendas -> 2-pass -14 LUFS:
    bash scripts/assemble_short.sh <project_dir>/finals_1080p <project_dir>/audio/captions.ass <project_dir>/final_short.mp4 [voiceover.wav] [bgm.wav]
    
  4. Verifique as dimensões (1080x1920), duração, volume de áudio (-14 LUFS) e verificações visuais de quadro do final_short.mp4 antes de entregar.

Habilidades Relacionadas