Communitygithub.com

make-video

Gere vídeos curtos animados e com voz (1080×1920) para YouTube Shorts a partir de um guia ou tópico: divida o guia em partes, escreva a narração, construa cenas cinéticas sincronizadas com as palavras, dê voz com Kokoro TTS e renderize MP4s.

O que é make-video?

Este skill permite transformar qualquer guia ou tópico em uma série de Shorts animados com narração, no formato vertical 1080×1920. Ele automatiza a divisão do conteúdo em partes, a geração de roteiro, a criação de cenas visuais cinéticas (com caixas de texto grandes, animações sincronizadas palavra a palavra) e a renderização final com áudio via Kokoro TTS. É ideal para criadores de conteúdo educacional, resumos de estudo ou documentação que desejam produzir vídeos profissionais sem edição manual. Funciona como um pipeline local (Python + ffmpeg) e segue regras rígidas de estilo definidas em DESIGN.md — sem legendas incorporadas, sem layouts lado a lado, e com foco em legibilidade em dispositivos móveis. O usuário interage aprovando a divisão em episódios e a aparência visual antes da renderização em lote.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rana3128/claude-skills-plugins/tree/HEAD/plugins/video-gen/skills/make-video

Perguntar na sua IA favorita

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

Documentação

Crie Shorts cinéticos com voz

Tudo é renderizado com o pipeline incluído em pipeline/ ao lado deste arquivo (o "Diretório base para este skill" mostrado quando o skill carrega).

0. Configuração (uma vez por projeto)

Se o projeto não tem uma pasta video_gen/ com kinetic_build.py, crie-a:

mkdir -p video_gen && cp <diretório do skill>/pipeline/* video_gen/
cd video_gen
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt            # desenho (Python 3.11+)
python3.12 -m venv .venv-tts && .venv-tts/bin/pip install -r requirements-tts.txt  # voz Kokoro

ffmpeg deve estar no PATH. voice.py executa o worker TTS em .venv-tts ao lado dele. Execute todos os comandos a partir de video_gen/.

1. Leia as regras

  • DESIGN.md - o estilo visual cinético. Regras rígidas: caixas empilham em uma coluna de largura total, nunca lado a lado; sem barras de destaque nas bordas das caixas; texto grande; cada elemento aparece na palavra falada correspondente; cabeçalhos cabem em uma linha (cerca de 30 caracteres); sem legendas incorporadas.
  • PARTS.md - o formato do part.md, regras de narração e como dividir um guia. Não leia engine_short.py, templates.py ou skin.py a menos que esteja depurando-os.

2. Nova série: divida primeiro, obtenha aprovação

  1. Analise o guia de origem e proponha uma lista de partes (um conceito por parte, cerca de 90-125 s cada). Pare para aprovação do usuário. Nunca corte conteúdo para atingir um tamanho; adicione exemplos e o "porquê" em vez disso.
  2. Escreva cada <série>/pNN_<slug>/part.md, mais <série>/README.md com a análise e uma tabela de partes.
  3. Adicione a pasta da série a SERIES em build_part.py (kicker + footer). Opcionalmente adicione uma marca de logotipo a MARKS em kinetic.py.
  4. Lint da narração: .venv/bin/python build_part.py <dir da parte> --lint e corrija todo problema. Narração: sem recapitulação, sem boas-vindas, vá direto ao tópico; sem símbolos ou código; soletre siglas para a voz; frases com no máximo 45 palavras.

3. Cenas

Cada parte recebe um scenes.py definindo SCENES. Dois estilos (veja examples/):

  • Blocos de estágio declarativos (preferido, rápido): SCENES = K.part(palavra, tag, chips, [[blocos...], ...]) usando Track, Pipe, Rows, Code, Lanes, Bars, Ring, Fan, Chips, Big, Note. Uma dica (cue) é um prefixo de palavra (buscado após a dica anterior do bloco), (palavra, batida) ou um número de batida. Exemplo: examples/p03_*.
  • Classes Scene escritas à mão para uma metáfora que os blocos não conseguem mostrar. Exemplo: examples/p01_*. Liste as palavras-dica na ordem falada, ou as dicas retornarão como MISSING (ausentes).

4. Verifique, depois renderize

.venv/bin/python kinetic_build.py <dir da parte> --stills /tmp/pNN.png   # folha de contato + relatório de dicas
.venv/bin/python kinetic_build.py <dir da parte> --out <série>/output   # <slug>_voiced.mp4 final
.venv/bin/python cue_scan.py <série>/p*_*                               # verificação de sincronia somente texto

Corrija toda dica MISSING e overflow antes da renderização final. Para uma série completa, renderize as duas primeiras partes e obtenha o OK do usuário sobre a aparência, depois execute o restante 3 de cada vez em segundo plano (xargs -P 3).

5. Relatório

Uma tabela: link do MP4, tópico, duração, silêncio mais longo (alvo abaixo de 1 s). Marque as partes renderizadas no README da série. Diga claramente o que não foi verificado (quadros não visualizados, áudio não ouvido).

Nunca

  • Coloque caixas lado a lado, barras de destaque nas bordas, texto pequeno ou legendas incorporadas.
  • Proponha calibração de voz por vídeo; a sincronia é baseada em tempo de palavra e genérica.
  • Edite engine_short.py diretamente; build_part.py o modifica em memória.

Habilidades Relacionadas