Communitygithub.com

Verificação de Pré-envio

Use quando o usuário renderizou ou exportou um vídeo vertical e quer saber se o TikTok, YouTube Shorts, Instagram Reels ou Facebook Reels o aceitarão, ou por que um upload ou postagem agendada falhou. Executa um verificador publicado com ffprobe e fornece a correção FFmpeg para cada falha.

O que é Verificação de Pré-envio?

Esta skill verifica se um vídeo vertical atende aos requisitos técnicos das principais plataformas de vídeo curto (TikTok, YouTube Shorts, Instagram Reels e Facebook Reels) antes do upload. Ela utiliza o pacote `shortform-preflight` do GitHub, que emprega o `ffprobe` para extrair metadados do arquivo e os compara com as regras publicadas por cada aplicativo (upload, web, API). Cada falha é acompanhada de um comando FFmpeg correspondente para corrigir o problema — por exemplo, ajustando taxa de quadros, codec de áudio, comprimento ou posição do moov atom. A skill suporta diferentes rotas (upload via aplicativo, web ou API de publicação) e parâmetros específicos como limite de duração do TikTok Direct Post. Ela foi testada em ambientes de desenvolvimento com Node.js 18+ e FFmpeg instalados, e fornece saída em JSON para facilitar a leitura linha a linha. É ideal para fluxos de publicação automatizados, ajudando a evitar rejeições ou reprocessamentos inesperados.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/viewgum/skills/tree/HEAD/skills/upload-preflight

Perguntar na sua IA favorita

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

Documentação

O que Verificação de Pré-envio faz?

Uma renderização que parece boa ainda pode ser recusada ou reprocessada: a taxa de quadros errada para uma API, um codec de áudio que uma ferramenta de postagem rejeita, um arquivo acima do limite de tamanho, um clipe mais longo do que o aplicativo aceita. Esta skill executa https://github.com/viewgum/shortform-preflight no arquivo, que o lê com ffprobe e o verifica em relação aos números que cada aplicativo publica, então transforma cada falha em um comando FFmpeg.

Não é para: onde o texto se posiciona no quadro (use short-form-specs), ou o que o vídeo diz.

Fluxo de Trabalho

  1. Esclareça o escopo apenas se necessário. Padrões: todos os quatro aplicativos e as regras para upload em cada aplicativo (--route app). Para o upload web do TikTok use --route web. Se o usuário publica por meio de um agendador ou código próprio, use as regras da API de publicação (--api), que são mais restritivas para Facebook Reels e Instagram. Para o Direct Post do TikTok, informe o limite da conta (max_video_post_duration_sec das informações do criador do TikTok) como --tiktok-endpoint direct --tiktok-max-seconds <n>; sem isso, informe que a duração não foi verificada.
  2. Verifique as ferramentas: ffprobe -version (FFmpeg), node -v (18 ou mais recente) e npx --version. A primeira execução baixa o verificador do GitHub, então também precisa de acesso à rede. Se algo estiver faltando, informe o que, como instalar e pare.
  3. Execute-o, em JSON para que você possa ler cada linha: npx -y github:viewgum/shortform-preflight <arquivo> --json (adicione --api, ou --platform tiktok,youtube-shorts, conforme necessário). Código de saída 0 significa que nenhuma verificação falhou; 1 significa que uma verificação falhou ou um valor necessário não pôde ser lido (o aplicativo aparece como incompleto; informe qual medida está faltando); 2 significa entrada inválida.
  4. Para cada falha e cada aviso que o usuário provavelmente encontrará, informe a causa em uma linha, a fonte que a linha cita e uma correção. Correções comuns (ajuste os caminhos e mantenha o restante do arquivo como está):
    • Taxa de quadros fora do intervalo: ffmpeg -i in.mp4 -r 30 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a copy -movflags +faststart -use_editlist 0 out.mp4
    • Codec, croma ou perfil recusado: ffmpeg -i in.mp4 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a aac -b:a 192k -movflags +faststart -use_editlist 0 out.mp4
    • Átomo moov no final ou lista de edição (a API do Instagram recusa ambos): ffmpeg -i in.mp4 -c copy -movflags +faststart -use_editlist 0 out.mp4
    • Taxa de amostragem, canais ou bitrate de áudio (a API do Facebook Reels lista 48 kHz estéreo, 128 kbps ou mais; um codificador configurado exatamente para 128k geralmente fica um pouco abaixo): ffmpeg -i in.mp4 -c:v copy -c:a aac -b:a 192k -ar 48000 -ac 2 -movflags +faststart -use_editlist 0 out.mp4
    • Muito longo: corte-o, ffmpeg -i in.mp4 -t 89.9 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a aac -b:a 192k -movflags +faststart -use_editlist 0 out.mp4 (defina -t um pouco abaixo do limite: o corte pode ficar um quadro mais longo).
    • Várias linhas de uma vez: combine as opções em uma única recodificação em vez de encadear passagens, como no exemplo de execução.
    • Toda recodificação: adicione -g 90 a 30 fps (-g 72 a 24) para que os keyframes ocorram a cada 3 segundos; a API do Facebook pede grupos fechados de imagens com 2 a 5 segundos de duração, que o verificador não pode testar. Verifique com ffprobe -v error -select_streams v -skip_frame nokey -show_entries frame=pts_time -of csv=p=0 out.mp4.
    • Muito grande: reduza a configuração de qualidade (um -crf mais alto) em vez da resolução.
    • Não é 9:16: adicione padding ou corte para 1080 x 1920 apenas se o usuário quiser; informe o que será perdido.
  5. Após uma correção, execute o verificador novamente no novo arquivo e mostre que a linha agora passa.

Formato de Saída

**Arquivo:** demo.mp4 · 1080 x 1920 · 95 s · 23.976 fps · H.264 · AAC
**Regras:** APIs de publicação

| Aplicativo | Resultado | Linhas com falha ou aviso |
|---|---|---|
| Facebook Reels | falha | duração 95 s (API aceita 3 a 90 s); taxa de quadros 23.976 (precisa de 24 a 60); 44.1 kHz e mono (48 kHz estéreo listado, aviso) |
| Instagram Reels | falha | lista de edição presente (nenhuma permitida); átomo moov após a mídia (deve estar no início) |

### Correção
Uma recodificação para todas as linhas: `ffmpeg -i demo.mp4 -t 89.9 -r 30 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a aac -b:a 192k -ar 48000 -ac 2 -g 90 -movflags +faststart -use_editlist 0 fixed.mp4`
(fontes: Meta para Desenvolvedores, Reels Publishing API e IG User Media)

**Após a correção:** nenhuma falha.
  • Cite as próprias linhas do verificador; não reformule limites de memória.
  • Informe quais regras foram usadas: upload do aplicativo, upload web ou a API de publicação.
  • Linhas informativas (bitrates recomendados, loudness medido) não são falhas; mencione-as apenas se o usuário perguntar.

Armadilhas Comuns

  • Não recodifique quando um remux resolver. -c copy com +faststart mantém a qualidade.
  • Não altere a resolução ou proporção a menos que o usuário peça; pergunte primeiro, pois cortar perde imagem.
  • Não trate um aviso como uma recusa. Informe o que o aplicativo pode fazer (reprocessar, rejeitar através da API) apenas conforme a fonte afirma.
  • Não execute FFmpeg sobre o arquivo original. Sempre escreva um novo arquivo.
  • Não adivinhe um limite que o verificador informa como não publicado. Informe que o aplicativo não o publica.

Individual skills in this repo

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

Habilidades Relacionadas