Communitygithub.com

alexey1312/Skill-de-Revisão-de-Edição-Vibe

Use esta habilidade para verificar se um vídeo renderizado atende ao briefing, à edição aprovada e ao roteiro antes da publicação, detectando problemas técnicos, de legendas e de dados privados.

O que é Skill-de-Revisão-de-Edição-Vibe?

Esta habilidade (skill) para agentes de IA, como Claude Code, Cursor ou Codex, automatiza a revisão de vídeos renderizados antes da publicação. Ela verifica se o arquivo final corresponde ao briefing (tamanho, taxa de quadros, duração), à edição aprovada (EDL) e ao roteiro. A skill realiza varreduras apenas de leitura com FFmpeg para detectar problemas mensuráveis, como quadros pretos ou congelados, áudio perdido, silêncios longos, cliques, problemas de loudness ou pico verdadeiro, e também verifica legendas quanto a limites de linhas, velocidade de leitura e ortografia de nomes. Além disso, orienta uma exibição completa com som e gera um relatório detalhado com evidências (tempos de saída, quadros, intervalos de áudio), correções sugeridas e uma lista do que não pôde ser verificado automaticamente. A habilidade também é útil para diagnosticar renders quebrados, documentar o estado do projeto para transferência a outro agente e transformar um vídeo aprovado em template para séries. Importante: ela não realiza cortes (use 'vibe-editing-cut') nem valida/renderiza projetos HyperFrames ou Remotion (use 'hyperframes-cli' e 'remotion-render').

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alexey1312/Vibe-Editing-Agent-Skill/tree/HEAD/skills/vibe-editing-review

Perguntar na sua IA favorita

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

Documentação

Edição vibe: revisão

Verifique se um vídeo renderizado atende ao que foi prometido, com evidências, antes de alguém publicá-lo. Scripts encontram o que pode ser medido; uma pessoa assistindo uma vez, com som, encontra o resto. O relatório diz o que é o quê.

  • O que verificar e como: references/acceptance-checklist.md
  • Sintomas, causas, próximos passos: references/troubleshooting.md
  • Legendas e seus limites: references/captions.md
  • Formato do relatório: references/plan-format.md
  • Anotações que levam a uma correção: references/edit-requests.md
  • Pasta, briefing, project.md e a transferência: references/project-memory.md
  • De um vídeo a uma série: references/series.md
  • Dados, licenças e dinheiro: references/data-and-licences.md
  • O que este repositório mediu: references/measured-behavior.md
  • Versões e datas: references/versions.md
  • Citações: references/sources.md

Contrato

  • A revisão é somente leitura. As varreduras leem o arquivo; nada é re-renderizado, normalizado ou enviado. Quadros de evidência vão apenas para onde --evidence-dir aponta (renders/verify/ por convenção).
  • Cada descoberta tem um local, uma evidência e uma correção: tempo de saída (e tempo de origem quando o corte está envolvido), um quadro, um intervalo de áudio ou uma regra de script, e uma alteração específica (references/plan-format.md).
  • Correções aguardam aprovação e são feitas pela habilidade que as possui: o corte por vibe-editing-cut, uma composição pelas habilidades do mecanismo.
  • Diga o que não foi verificado. qa_scan.py imprime a lista de coisas que nenhum script verifica; o relatório a mantém, marcada como verificada por uma pessoa ou não verificada.
  • Cite ou rotule. Limites vêm de references/captions.md, references/audio.md alvos por meio do briefing, e references/versions.md com sua data; um julgamento de gosto é rotulado como tal.

1. Coletar

  • O arquivo a revisar, o briefing, a EDL aprovada (edit/edl.json), o arquivo de legendas, o glossário, o roteiro.
  • project.md: o estado, decisões que não devem mudar, a lista de ativos.
  • python3 scripts/toolchain_report.py --format markdown: o que esta máquina pode medir.
  • Quando algo está faltando (sem briefing, sem EDL), revise o que existe e liste a lacuna.

2. Escanear

python3 scripts/qa_scan.py exports/final.mp4 --width 1080 --height 1920 --fps 30 \
  --edl edit/edl.json --captions exports/final.srt --glossary transcripts/glossary.txt \
  --loudness-target -14 --true-peak-max -1 --evidence-dir renders/verify
python3 scripts/media_probe.py exports/final.mp4
  • Pegue o alvo de loudness do briefing; não há padrão (references/audio.md).
  • As descobertas QA001–QA013 e as regras de legenda CAP001–CAP011 estão listadas em CHECKS.md no repositório desta habilidade; cada uma é uma pista, leia o quadro ou ouça antes de relatá-la.
  • Um fade preto intencional, um quadro mantido ou uma pausa deliberada é mantido com um motivo, não relatado como defeito.

3. Comparar as palavras

  • Leia as palavras finais ao lado do roteiro aprovado ou da edl.py table.
  • Em cada junção que removeu palavras, compare com a origem: um "não" perdido, uma condição removida ou uma pergunta pela metade altera a afirmação.
  • Verifique cada nome e número na tela e nas legendas em relação ao glossário e às fontes dos fatos.

4. Olhar e ouvir

  • Quadros de cada lado de cada junção, o meio de cada transição, o primeiro e o último quadro de cada inserção.
  • Gráficos nunca cobrem o rosto, as legendas ou a ação; nada privado está na tela.
  • Uma exibição completa sem parar, com som, no dispositivo que os espectadores usam; depois uma sem som.
  • Peça ao autor para assistir quando nenhuma pessoa no ciclo o fez; a análise de quadros por um agente não é uma exibição.

5. Relatar

Escreva o relatório de revisão a partir de references/plan-format.md: um veredito em duas frases, descobertas com alta severidade primeiro, verificações que passaram e o que não foi verificado. Agrupe correções por responsável e por nível (história, ritmo, texto, imagem, som) para que possam ser aplicadas em uma passada cada.

6. Após o veredito

  • Render quebrado: siga references/troubleshooting.md; reproduza em uma cena antes de alterar qualquer coisa.
  • Transferência: escreva o estado em project.md — objetivo, EDL aprovada, última renderização boa, comandos, ativos, defeitos abertos com tempos de saída, decisões que precisam do autor, os próximos dois passos (references/project-memory.md).
  • Série: somente depois que dois ou três vídeos saíram da mesma forma; separe o design das entradas e teste casos extremos (references/series.md).

Proteções

  • Não corrija enquanto revisa; relate, depois deixe o responsável aplicar as correções aprovadas.
  • Não relate um valor medido como defeito sem o alvo do briefing por trás dele.
  • Não chame um vídeo de aceito sem uma exibição completa com som por uma pessoa, ou diga claramente que não houve nenhuma.
  • Não faça upload do vídeo para um serviço para verificá-lo sem aprovação (references/data-and-licences.md).
  • Não imprima uma chave ou dado pessoal da imagem no relatório.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas