Communitygithub.com

shorts-pipeline

Criar, renderizar, verificar, mixar e empacotar um vídeo vertical 1080×1920 (YouTube Shorts, Reels, TikTok) a partir de material de origem mais narração, usando o pipeline baseado em clipes (edl.json, build.py, check.py, sound/mix.py). Use sempre que a tarefa for produzir, corrigir ou revisar tal vídeo, instruir um subagente editor ou explicar por que o check.py falha.

O que é shorts-pipeline?

O shorts-pipeline é um fluxo de trabalho completo para produção de vídeos verticais curtos (YouTube Shorts, Reels, TikTok) a partir de uma lista de edição (EDL) e narração. Ele automatiza desde a preparação do projeto (com scripts de inicialização e verificação de dependências) até a renderização do vídeo, verificação de conformidade, mixagem de som e empacotamento final. O pipeline é modular, com etapas claras: roteiro, voz, captura de material, edição, renderização, capa, verificação (check.py), mixagem de som (sound/mix.py) e empacotamento. Cada etapa possui seu próprio comando e verificação, e o sistema é altamente personalizável via CHANNEL.md, que define tópico, idioma, público, regras de conteúdo, aparência, voz, créditos e cronograma. O pipeline suporta temas visuais (case-file, panel-heist, vice-dusk, classic) e inclui validações rigorosas, como zonas seguras de texto (check.py), limites de zoom, e a exigência de que o EDL seja mais recente que o render para evitar resultados desatualizados. É usado principalmente com agentes de IA como Claude Code, Cursor ou Codex, e pode delegar a edição a subagentes com um BRIEF.md, sempre exigindo revisão manual dos quadros.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ilyamelnichenkov/youtube-shorts/tree/HEAD/skills/shorts-pipeline

Perguntar na sua IA favorita

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

Documentação

Pipeline de Shorts (neutro em relação ao tópico)

Uma lista de edição (<short>/edl.json) mais uma narração resulta em um vídeo finalizado: clipes em movimento em uma "janela" de foto temática, legendas de palavras, uma placa de gancho, um círculo de herói, uma capa, uma lista de cues de efeitos sonoros e, em seguida, uma mixagem de som a -14 LUFS. Tudo que é específico para um canal (tópico, idiomas, público, regras de conteúdo, aparência, voz, créditos, cronograma) fica no CHANNEL.md do projeto. Leia-o primeiro e siga-o em vez dos padrões abaixo. Se estiver faltando ou tiver seções vazias, pergunte ao proprietário (ou copie engine/templates/CHANNEL.md e preencha-o com ele) antes de produzir qualquer coisa. Habilidades relacionadas: shorts-script-voice (tópico, roteiro, voz) e shorts-packaging (arquivos finais, textos de upload).

Antes de tudo

  1. Scripts do kit (setup.sh, shorts-init.sh, doctor.sh, install-codex.sh) ficam na pasta scripts/ do kit: a pasta do plugin, ou $SHORTS_HOME/kit/scripts/ (setup.sh e install-codex.sh mantêm uma cópia lá).
  2. Trabalhe a partir de uma pasta de projeto que contenha _pipeline/, _tools/, _fonts/, CHANNEL.md (crie uma com scripts/shorts-init.sh <dir>). Todos os comandos abaixo são executados a partir da raiz dessa pasta.
  3. Execute scripts/doctor.sh <dir-do-projeto> uma vez por máquina. Ele verifica todas as dependências (programas do sistema, pacotes Python, modelos, espaço em disco) e deve terminar com "All good." Caso contrário: scripts/install-system-deps.sh para ffmpeg/Python/curl, scripts/setup.sh para o resto. A lista completa está em DEPENDENCIES.md do kit.
  4. SHORTS_HOME (padrão ~/.shorts-studio) contém o ambiente virtual Python e os modelos de voz. Exporte-o se colocá-lo em outro lugar.
  5. Leia _pipeline/README.md (referência do mecanismo) e references/edl-notes.md antes de escrever uma lista de edição.

O fluxo de trabalho (cada etapa tem sua própria verificação)

#EtapaComando / saídaVerificar
1Tópico + roteirohabilidade shorts-script-voiceuma alegação, fontes atribuídas, proprietário OK quando o perfil solicitar
2Voz$SHORTS_HOME/venv/bin/python _tools/build_vo.py <short>/vo/beats.json, depois _tools/words.py <short>/voleia vo/words.json: cada palavra correta
3Material_tools/grab.py <topic> '<url>' <start> <end> --tag NAME (registra _footage/SOURCES.md), ou suas próprias gravaçõesfolha de contato de cada clipe; política do CHANNEL.md
4Lista de ediçãocopie references/edl-template.json, altere o conteúdobuild.py <edl> --words mostra tokens de legenda
5Renderizarpython3 _pipeline/build.py <short>/edl.json --theme <theme> (3-10 min; 4K60 é lento)sem erro; o arquivo é mais recente que o edl
6Capa... build.py <edl> --cover"violações de zona segura: nenhuma", legível com 180 px de largura
7Verificarpython3 _pipeline/check.py <short>/<name>-<theme>-silent.mp4 <short>/edl.jsonimprime ALL CHECKS PASS; você olhou cada folha de contato
8Som$SHORTS_HOME/venv/bin/python _pipeline/sound/mix.py <short> --theme <theme> --music <name> --strict-14,0 +/-0,5 LUFS, pico verdadeiro <= -1,0 dBTP, erros de palavras próximos de 0
9Empacotarhabilidade shorts-packagingarquivo + capa + bloco de upload em ready/

Folhas de contato de um clipe de origem: ffmpeg -ss <t> -i <file> -t <d> -vf "fps=2,scale=320:-1,tile=7x4" -frames:v 1 out.png (escreva PNG: a saída JPEG de algumas fontes falha com "non full-range YUV"). Limites de cena: ffmpeg -i <file> -vf "scale=320:180,select='gt(scene,0.25)',showinfo" -an -f null - 2>&1 | grep -o "pts_time:[0-9.]*". Temas: case-file (papel de dossiê), panel-heist (página de quadrinhos), vice-dusk (dusk neon), classic; o perfil escolhe um.

Como um bom short se parece (padrões; o perfil substitui)

  • 18-45 s, um argumento do gancho ao desfecho, um corte a cada 1,5-3 s, cada tomada se move, a placa de gancho está ligada desde o quadro 0 (hook.y 1170 mantém-a longe da etiqueta de exposição), um momento de herói com um círculo vermelho em algo que o quadro realmente mostra.
  • A imagem segue as palavras. As legendas são frases de 2-3 palavras (break_before); nomes permanecem em um grupo.
  • A última tomada corta de volta para o primeiro quadro (o vídeo faz loop).
  • Todo texto legível permanece na zona segura do telefone: y 300-1580, x 130-950 (x <= 860 para y 1000-1600). check.py aplica isso.
  • Janela de foto alta "aspect": "3:4" (900x1200) em clipes de 1080p ou mais; fontes em 720p ou letterbox não conseguem preenchê-la.

Lições aprendidas a duras penas (detalhes em references/lessons.md)

  • O EDL é mais recente que o render? O render está desatualizado. Reconstrua antes de julgar o check.py.
  • Stills congelados (quadros consecutivos mal diferem por > 0,3 s) falham no check.py. Telas estáticas, cores planas e assuntos parados precisam de movimento em velocidade constante: "move_ease": "linear", um intervalo de zoom de 0,15-0,4 e um pan de 150+ px de origem. float sozinho não é suficiente (a senoide desacelera até zero em suas curvas).
  • Limites de zoom: fontes 4K <= 1,00, 1080p <= 1,25, 720p <= 1,0 (check.py imprime o limite por clipe).
  • Sobreposições do criador (marca d'água, facecam, terço inferior, legendas, banners estilizados) nunca atingem a imagem: corte com a substituição de imagem sources de nível superior, mova o corte ou escolha outros quadros. Olhe cada quadro de corte.
  • Honestidade: rótulos, círculos e legendas dizem apenas o que o quadro mostra; atribua fatos à sua fonte na narração.
  • Capa: um corte full-bleed de um quadro de origem; a placa fica em tab_y (330) e esconde o topo da imagem. Para um assunto próximo ao topo, defina tab_y em cerca de 1090 e stamp_y em cerca de 410.
  • Um render por vez (um render 4K60 usa todos os núcleos); nunca inicie um segundo render da mesma pasta.

Delegando uma edição a um subagente

Dê ao agente o BRIEF.md (criado por shorts-init a partir de references/editor-brief.md) mais o roteiro, os arquivos de voz e a lista de clipes. A sessão principal escreve o roteiro e a voz, revisa cada quadro ela mesma e faz a mixagem de som: o relatório de um agente é uma alegação, não uma prova. Verifique os horários dos arquivos (mp4 silencioso mais recente que o edl, log de verificação mais recente que o mp4) antes de aceitar.

Individual skills in this repo

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

Habilidades Relacionadas