Communitygithub.com

editar-video

Edita vídeo real em nível profissional com ffmpeg local — correção de cor medida por escopos, saturação, contraste, níveis BT.709, tom de pele, HLG para SDR, cortes, J/L cut, camadas, texto, legenda, LUT .cube, zoom/estabilização, loudness e entrega para Reels/TikTok.

editar-video 是什么?

Esta skill capacita um agente de IA a realizar edição de vídeo profissional usando ffmpeg localmente, com foco em correção de cor baseada em medições objetivas (escopos, histogramas, vectorscope) em vez de julgamento visual subjetivo. Ela suporta fluxos de trabalho completos: diagnóstico por cena com scripts Python (escopos, comparação antes/depois), aplicação de planos de correção em RGB de 16 bits, geração de LUTs .cube para exportação para Premiere/Resolve/CapCut, e montagem com cortes secos, J cut e L cut. Também cobre conversão de HLG do iPhone para SDR, normalização de níveis, equilíbrio de cores, matching de cenas, aplicação de LUTs criativas, estabilização (libvidstab), e ajuste de loudness. A skill impõe portões de aprovação em cada etapa (diagnóstico, prévia, render final) e exige que o usuário confirme o ritmo e a sensação do corte. É compatível com qualquer sistema que tenha ffmpeg 8.1.2+, Python 3.10+ com numpy e Pillow, e funciona em macOS, Linux e Windows (WSL). O agente sempre apresenta fatos medidos (números por cena) e explica cada correção com sua fonte, evitando suposições não fundamentadas.

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/arthurmkt/arthur-portfolio-mkt/tree/main/design/editar-video

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Edição de vídeo medida

Princípio: cor se julga por medição. Toda mudança de cor que eu proponho vem com o número que a motivou (escopo, percentil, ângulo de pele) e com o número depois. Toda regra desta skill tem fonte ao lado; o que não tem fonte aparece como [sem fonte] e nunca como regra.

Limite declarado: eu vejo quadros e números, não assisto o vídeo rodando. Ritmo, sensação do corte e gosto do look são julgamento de quem pediu. Na entrega, peço explicitamente que a pessoa assista no celular.

Requisitos: ffmpeg e ffprobe (testado no 8.1.2, com libvidstab para a R61), Python 3.10+ com numpy e Pillow (pip install numpy pillow).

Arquivos

ArquivoPara quê
scripts/escopos.pydiagnóstico por cena: folha de escopos (waveform, parade RGB, vectorscope com linha de pele, histograma) + diagnostico.md/json com alertas e fonte
scripts/comparar.pyantes × depois por cena: folha, split_cenaN.png em 1080, tabela de números e alertas resolvidos/novos
scripts/graduar.pyaplica o plano de correção (JSON) na ordem de sinal, em RGB 16 bits; --previa gera quadros parados antes/depois
scripts/gerar_lut.pytransforma a correção aprovada num .cube (33/65) para Premiere/Resolve/CapCut e prova por PSNR
scripts/montar.pymonta trechos com corte seco, J cut e L cut a partir de uma lista (JSON)
scripts/receitas.py38 receitas ffmpeg com fonte; testar clipe.mp4 roda todas; md gera referencias/receitas-ffmpeg.md
referencias/cor-fluxo.mdordem de sinal, contraste, curvas, saturação, precisão 16 bits
referencias/niveis-e-escopos.mdBT.709, EBU R103 v3.0, como ler cada escopo, como o script mede
referencias/pele.mdlinha de pele, faixa de croma, sintoma → causa → correção
referencias/hdr-hlg.mdHLG do iPhone → SDR, níveis BT.2408, cadeia medida
referencias/corte.mdMurch (regra de seis, piscar), corte na ação, J/L cut, emendas de áudio, sincronia
referencias/plataformas.mdMeta e TikTok: formato, área segura, duração, o que é oficial e o que não é
referencias/receitas-ffmpeg.mdas 38 receitas por grupo (entrada, diagnóstico, cor, look, corte, camadas, movimento, acabamento, áudio, entrega)

Pasta de trabalho: uma pasta por peça (ex.: editar-video/<projeto>/<peça>/): bruto, plano, prévias, folhas e final juntos.

Nos comandos abaixo, ~/.claude/skills/editar-video é o lugar onde a skill foi instalada. Ajuste se instalou em outro lugar.


Passo 0 — Entrada (sem portão)

python ~/.claude/skills/editar-video/scripts/receitas.py mostrar R01   # e rodar com o arquivo

Decidir antes de tudo, pelos números do ffprobe:

  • color_transfer=arib-std-b67 (HLG) ou smpte2084 (PQ) → converter para SDR primeiro (referencias/hdr-hlg.md, R03). Nunca só trocar a etiqueta.
  • r_frame_rate ≠ avg_frame_rate → taxa variável: R02 antes de cortar (a Meta exige taxa fixa, Ads Guide).
  • color_range=pc → conferir se o conteúdo é mesmo 0–255 antes de converter (R04). O signalstats ignora a etiqueta de faixa.
  • Arquivo de IA, gravação de tela: costumam vir sem tag ou em faixa cheia. Medir antes de supor.

Passo 1 — Diagnóstico medido (portão 1)

python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 -o diag            # SDR
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 -o diag --sdr      # HLG: mede depois do tonemap
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 --pele 0.35,0.15,0.3,0.25   # região do rosto

Ler a folha pelo método VER → AMPLIAR → CONFIRMAR: o quadro, depois cada escopo, depois o número. Mostrar:

  1. a folha (folha_escopos.png) e a tabela por cena;
  2. fatos medidos, um por linha, com a regra e a fonte: "Cena 2: altas R 98,6 / G 90,0 / B 80,2 → dominante quente nas altas, se a parede for branca (Adobe, parade RGB)";
  3. o que não sei pela medição (ex.: se o tom quente é intencional).

A máscara de pele automática (Chai & Ngan) pega madeira, bege e laranja. Se o rosto estiver pequeno ou houver objeto da mesma cor, passar --pele com a região do rosto.

Portão 1: quem pediu confirma o que é problema e o que é intenção. Não corrijo dominante que a pessoa quer.

Passo 2 — Plano de correção e prévia (portão 2)

Escrever plano.json (formato no topo do graduar.py). Cada operação leva o motivo medido num campo "porque". Ordem fixa: conformar → global → cenas (igualar) → look → acabamento → legalizar (referencias/cor-fluxo.md, seção 1).

  • Normalizar: pontos de preto/branco por canal (niveis) a partir de baixas_RGB / altas_RGB.
  • Equilibrar: temperatura primeiro, depois verde/magenta (temperatura, balanco).
  • Igualar cenas: escolher a cena de referência (a mais aberta ou a mais próxima do look desejado, Colorist Guide 20, lição 2) e aproximar Y médio, altas RGB e pele das outras.
  • Look: só depois de igualar. Saturação de estilo, LUT criativa. Look é gosto: proponho, a pessoa decide.
python ~/.claude/skills/editar-video/scripts/graduar.py plano.json --mostrar   # cadeia de filtros
python ~/.claude/skills/editar-video/scripts/graduar.py plano.json --previa    # antes|depois do meio de cada cena

Portão 2: aprovação da prévia. Ajuste vem com cena e quanto ("cena 3 menos quente, metade"). Mudo só o que foi pedido.

Passo 3 — Render e comparação medida (portão 3)

python ~/.claude/skills/editar-video/scripts/graduar.py plano.json
python ~/.claude/skills/editar-video/scripts/comparar.py bruto.mp4 corrigido.mp4 -o comparacao --zoom-vs 2

Entregar folha_antes_depois.png + comparacao.md (números antes → depois, alertas resolvidos e novos, amplitude entre cenas). Se surgiu alerta novo, corrijo antes de mostrar.

Portão 3: aprovação do vídeo corrigido, assistido por quem pediu.

Passo 4 — Corte, camadas, texto, movimento (quando pedido)

  • Corte: lista de trechos em JSON → montar.py (seco, J, L). Regras e fontes em referencias/corte.md. Eu meço duração de plano e cortes por minuto; o ritmo é a pessoa quem julga.
  • Texto, legenda, logo: R50–R52, sempre dentro da área segura da plataforma (referencias/plataformas.md). Texto literal de uma lista fechada. Legenda segue a fala, com tempo de leitura de 1 s para cada 3 palavras + 1 s.
  • Movimento sobre o vídeo: zoom/pan com easing (R60), estabilização (R61), velocidade (R62).
  • Motion graphics do zero (tipografia cinética, números animados): skill /motion, com o vídeo entrando como sequência de quadros.
  • Ordem: gráficos e legenda entram depois da cor e da conversão HDR→SDR (ITU-R BT.2408-9 §9).

Passo 5 — Revisão e entrega

Checklist antes de mostrar:

  1. comparar.py sem alerta de nível/gamut no final; tags BT.709 conferidas com ffprobe.
  2. Resolução, fps fixo, duração, nº de quadros, sem quadro preto no início/fim.
  3. Texto dentro da área segura; legenda batendo com a fala.
  4. Loudness medido (R80) e informado. O alvo de -14 LUFS é [sem fonte oficial]; uso se a pessoa concordar.
  5. Encode R90 (H.264, yuv420p, BT.709, +faststart).
  6. Sem flash forte nem branco liso nos 3 primeiros segundos se for TopView do TikTok (plataformas.md).
  7. Pedir a passada de quem pediu, no celular: ritmo, sensação, pele.

Look aprovado que vai ser reaproveitado → gerar_lut.py --plano plano.json -o <projeto>_look.cube e --conferir para provar.

Regras de código (medidas com ffmpeg 8.1.2, 05/11/2026)

  1. Filtro de cor em RGB vem depois de format=gbrp16le. Em 8 bits a ida e volta perde 1,1 código de Y médio; em 16 bits sai exata.
  2. Não usar eq em fluxo 10 bits/HLG: ele força 8 bits.
  3. Caminho em filtro: file='/pasta/arquivo.cube' (aspas simples; caminho com : ou espaço precisa de escape com \).
  4. Tags na saída: -colorspace bt709 -color_primaries bt709 -color_trc bt709 -color_range tv (+ setparams no fim da cadeia do graduar.py).
  5. Legalizar só no fim (EBU R103 v3.0). O limiter não corrige gamut RGB; a etapa RGB16 já recorta.
  6. -ss antes do -i com reencode = corte preciso; com -c copy o corte cai no keyframe.

Individual skills in this repo

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

相关技能