Communitygithub.com

editar-entrega-qa

Verificar edições finais de vídeo antes da entrega. Use quando um agente precisar inspecionar um MP4/MOV/WebM renderizado, confirmar duração/resolução/quadros por segundo/áudio, gerar ou revisar folhas de contato, analisar CSVs de linha do tempo, verificar densidade de cortes/mistura de fontes, verificar integração e coesão de FX, sincronizar texto com batida, detectar quadros fracos ou placeholders acidentais e decidir se uma edição social sincronizada com batida está pronta para ser exibida.

O que é editar-entrega-qa?

Editar Entrega QA é uma habilidade especializada para agentes de IA que trabalham com edição de vídeo, garantindo que as peças finais estejam prontas para entrega ou publicação. Ela verifica sistematicamente os aspectos técnicos do vídeo (duração, resolução, taxa de quadros, codec, áudio), gera e revisa folhas de contato para identificar problemas visuais, inspeciona CSVs de linha do tempo para métricas de segmentos e mistura de fontes, e executa verificações avançadas como coesão de efeitos, sincronia texto-batida e detecção de loops. A habilidade suporta plataformas como Claude Code, Cursor e Codex, e se baseia em um script Python (`scripts/qa_video_edit.py`) que produz relatórios em JSON e Markdown, mas enfatiza que a revisão humana (assistir ao vídeo e inspecionar quadros) continua essencial. Seu objetivo principal é evitar retrabalho caro, identificando problemas como quadros em branco, marcas d'água, cortes inadequados ou falta de sincronia antes que o vídeo seja finalizado, seguindo padrões como o 'Conteto Machino'.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BusyBee3333/viral-video-edit-skills/tree/main/skills/edit-delivery-qa

Perguntar na sua IA favorita

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

Documentação

Editar Entrega QA

Visão Geral

Use esta habilidade antes de apresentar uma edição de vídeo como finalizada. A saída esperada é um relatório de QA conciso: especificações técnicas, saúde da linha do tempo, anotações de revisão visual e quaisquer correções necessárias antes da entrega.

Verificações Obrigatórias

  1. Sondar a renderização final:
    • duração
    • resolução
    • taxa de quadros
    • codec de vídeo
    • presença de fluxo de áudio
    • contêiner de entrega
  2. Gerar uma folha de contato se ainda não existir.
  3. Revisar a folha de contato em busca de:
    • quadros ativos e intencionais
    • sem cartões de título/entrevistas/quadros em branco, a menos que sejam deliberados
    • sem marcas d'água ou sobreposições de pré-visualização de estoque
    • assunto/ação legível após o corte
    • acentos que pareçam intencionais, não preenchimento aleatório
  4. Inspecionar o CSV da linha do tempo, se disponível:
    • contagem de segmentos
    • duração média/mínima/máxima dos segmentos
    • mistura de fontes
    • mistura de tipo/categoria
    • uso de acertos prioritários
  5. Comparar o resultado com o formato alvo e o briefing criativo.
  6. Declarar se a edição está pronta, precisa de uma pequena revisão ou precisa de uma re-renderização.

Alvos de Montagem Sincronizada com Batida

Para cortes de montagem social densa:

  • Duração: geralmente 30-40s.
  • Vertical: 1080x1920; paisagem: 1920x1080.
  • Taxa de quadros: mínimo 30fps.
  • Para uma montagem de alta energia de 35s, 70-90 segmentos é saudável se o material de arquivo suportar.
  • Comprimento médio do segmento: cerca de 0.35-0.50s.
  • O áudio deve estar presente e limpo.
  • A folha de contato deve mostrar principalmente material ativo/intencional.

Verificações de FX Integrados & Artesanato (adições de julho de 2026)

Para edições com efeitos ou camadas de texto, adicione estas às verificações obrigatórias:

  • Verificação de coesão / adesivo: algum elemento composto parece um adesivo não rastreado, em vez de um objeto na cena? Algum segmento parece um corte para um vídeo diferente? Algum plano quebra a gradação compartilhada (um visual único entre os naturais)? Qualquer sim = revisão — estas são as causas de rejeição de maior frequência.
  • Verificação de sincronia de texto: se uma linha de gancho deve cair em uma batida, meça o deslocamento real entre o quadro de aparecimento do texto e o acento de áudio; | deslocamento | > 100ms = re-renderização.
  • Verificação de loop: reproduza o final no início; edições de emenda de loop devem ser invisíveis.
  • Verificação em escala de telefone: inspecione em tamanho real E em escala de telefone; salve quadros de revisão em timestamps obrigatórios (por exemplo, 1/4/8/12/14s de uma peça de 15s) mais uma verificação pontual de quadro tardio junto com o relatório de QA.
  • Estágio de prova barato (antes das construções completas, não depois): renderize um esqueleto de baixa resolução dos primeiros 3-5 segundos e assista-o na velocidade de rolagem antes de se comprometer com a renderização completa/VFX — os critérios de eliminação são baratos neste portão e caros após VFX.
  • Entregável QuickTime: quando a revisão acontece em players da Apple, também produza e faça QA separadamente de um .mov compatível com QuickTime.
  • Para qualquer coisa que vá para o público, execute cinco portões independentes: técnico, visual, narrativo, originalidade/direitos, pacote de plataforma. O QA automatizado suporta, mas nunca substitui assistir à renderização em velocidade normal. Granulação é aceitável (os espectadores preferem); bloqueio, bandeamento, borrão de upscale, marcas d'água e bordas são as verdadeiras penalidades.

Padrões de Falha

Envie a edição de volta para revisão quando você vir:

  • sem fluxo de áudio ou trecho de áudio errado
  • proporção de aspecto errada ou corte não intencional
  • quadros vazios, cartões de título, entrevistas, marcas d'água de estoque ou sobreposições de preço
  • ação oculta pelo corte vertical
  • muitas inserções fracas de multidão/laser/natureza substituindo a premissa principal
  • acertos musicais prioritários servidos por filmagens de baixo movimento
  • CSV da linha do tempo e renderização final discordam materialmente

Script

Execute scripts/qa_video_edit.py contra o vídeo final. Adicione --timeline e --contact-sheet quando disponíveis:

python3 scripts/qa_video_edit.py final.mp4 --timeline final_timeline.csv --contact-sheet final_contact_sheet.jpg --out final_qa

O script escreve JSON e Markdown. Ele também pode criar uma folha de contato com FFmpeg quando --make-contact-sheet é definido.

Revisão Humana

O script detecta problemas de especificações e linha do tempo; ele não substitui assistir ou inspecionar quadros. Sempre combine o QA automatizado com pelo menos uma revisão da folha de contato, e assista à renderização final quando a edição é de alto risco ou visualmente densa.

Para o padrão Conteto Machino, leia references/edit-qa-standard.md.

Referências opcionais:

  • references/qa-thresholds.md: limites adaptáveis por tipo de edição.
  • references/example-prompts.md: prompts reutilizáveis de QA final.
  • references/gui-vision.md: visão de produto para um painel de QA visual e entrega.

Individual skills in this repo

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

beat-synced-montage-builder

Build beat-synced social video montages from song-analysis outputs and source footage. Use when an agent needs to assemble, plan, or revise a music-timed edit; map footage to beats/onsets/cut markers; create vertical or landscape montage timelines; integrate audio-reactive FX into shots; mix gameplay, crowd, concert, nature, menu, or other accent footage; generate timeline CSVs, contact sheets, and edit briefs; or adapt the Conteto Machino / Smash Mash workflow for another song or footage library.

generated-media-sourcing

Generate or plan media assets for beat-synced edits when real footage is missing or the user asks for generated visuals - AI video (Gemini/Veo/Flow), AI images, or procedural audio-reactive GPU renders (tunnels, portals, kaleidoscopes, starbursts, mandalas, title pieces via Python+moderngl GLSL). Use with beat-synced-montage-builder when a montage needs generated clips, stills, or procedural audio-reactive elements instead of, or alongside, sourced footage.

song-edit-analysis

Analyze songs and audio files for beat-synced video editing, clip timing, energy mapping, viral window selection, onset-locked cut grids, footage selection, and agent-readable edit briefs. Use when an agent needs to inspect an MP3/WAV/M4A/audio track, estimate tempo and beat grids, identify sections, produce cut markers, pick the best 15-30s window of a song for short-form video, or guide a human or another agent in choosing footage that matches musical energy.

viral-video-edits

End-to-end system for making S-tier beat-synced short-form music video edits — song analysis, viral window selection, footage sourcing with shot-level QA, hook writing, onset-locked cutting, integrated audio-reactive FX (person mattes, procedural GLSL renderers, cinematic grade), and delivery QA. Use this whenever the user asks to make a video edit, music video, reel, TikTok/Shorts/vertical video, beat-synced montage, lyric/hook video, audio-reactive visual, tunnel/portal/kaleidoscope render, or to promote a song with video content — even if they don

Habilidades Relacionadas