Communitygithub.com

editar-video

Édition vidéo professionnelle avec ffmpeg local — correction des couleurs (normaliser → équilibrer → égaliser les scènes → look), saturation, contraste, niveaux légaux BT.709, teint, HLG iPhone vers SDR, coupes, J/L cut, calques, texte, sous-titres, LUT .cube, zoom/stabilisation, loudness et livraison pour Reels/TikTok. Le jugement des couleurs se fait par mesure (scopes et chiffres par scène), pas par « ça semble », et on fournit une fiche avant/après avec les chiffres.

Qu'est-ce que editar-video ?

Cette compétence (skill) d'agent IA permet une édition vidéo professionnelle et mesurée, en s'appuyant sur ffmpeg en local et des scripts Python. Elle est conçue pour les correcteurs, monteurs et créateurs de contenu qui utilisent des agents comme Claude Code, Cursor ou Codex. Le principe fondamental est que toute correction de couleur est justifiée par des mesures objectives (waveform, parade RGB, vectorscope, histogramme) et non par une impression visuelle. La skill couvre l'ensemble du flux de travail : diagnostic par scène (scripts/escopos.py), plan de correction avec prévisualisation (plano.json, scripts/graduar.py), comparaison avant/après (scripts/comparar.py), génération de LUT .cube (scripts/gerar_lut.py), montage avec coupes sèches, J cut et L cut (scripts/montar.py), et livraison optimisée pour Reels et TikTok. Elle gère également la conversion HLG (iPhone) vers SDR, l'égalisation des scènes, le teint, le contraste, la saturation, les niveaux légaux BT.709, le zoom, la stabilisation, le loudness (-14 LUFS suggéré) et l'incrustation de texte et sous-titres dans la zone de sécurité de la plateforme. L'agent indique toujours la règle et la source de chaque mesure, et demande une validation humaine à chaque étape (diagnostic, prévisualisation, rendu final).

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Édition vidéo mesurée

Principe : la couleur se juge par mesure. Toute modification de couleur que je propose s'accompagne du nombre qui l'a motivée (scope, percentile, angle de teint) et du nombre après. Chaque règle de cette compétence a une source à côté ; ce qui n'a pas de source apparaît comme [sans source] et jamais comme règle.

Limite déclarée : je vois des images et des chiffres, je ne regarde pas la vidéo en cours. Le rythme, la sensation de la coupe et le goût du look sont le jugement de la personne qui a demandé. À la livraison, je demande explicitement que la personne regarde sur son téléphone.

Prérequis : ffmpeg et ffprobe (testé avec la version 8.1.2, avec libvidstab pour la R61), Python 3.10+ avec numpy et Pillow (pip install numpy pillow).

Fichiers

FichierUtilité
scripts/escopos.pydiagnostic par scène : fiche de scopes (waveform, parade RGB, vectorscope avec ligne de teint, histogramme) + diagnostico.md/json avec alertes et source
scripts/comparar.pyavant × après par scène : fiche, split_cenaN.png en 1080, tableau de chiffres et alertes résolues/nouvelles
scripts/graduar.pyapplique le plan de correction (JSON) dans l'ordre du signal, en RGB 16 bits ; --previa génère des images fixes avant/après
scripts/gerar_lut.pytransforme la correction approuvée en un .cube (33/65) pour Premiere/Resolve/CapCut et vérifie par PSNR
scripts/montar.pyassemble les segments avec coupe sèche, J cut et L cut à partir d'une liste (JSON)
scripts/receitas.py38 recettes ffmpeg avec source ; testar clipe.mp4 les exécute toutes ; md génère referencias/receitas-ffmpeg.md
referencias/cor-fluxo.mdordre du signal, contraste, courbes, saturation, précision 16 bits
referencias/niveis-e-escopos.mdBT.709, EBU R103 v3.0, comment lire chaque scope, comment le script mesure
referencias/pele.mdligne de teint, plage de chroma, symptôme → cause → correction
referencias/hdr-hlg.mdHLG iPhone → SDR, niveaux BT.2408, chaîne mesurée
referencias/corte.mdMurch (règle des six, clignement), coupe dans l'action, J/L cut, raccords audio, synchronie
referencias/plataformas.mdMeta et TikTok : format, zone de sécurité, durée, ce qui est officiel et ce qui ne l'est pas
referencias/receitas-ffmpeg.mdles 38 recettes par groupe (entrée, diagnostic, couleur, look, coupe, calques, mouvement, finition, audio, livraison)

Dossier de travail : un dossier par pièce (ex. : editar-video/<projet>/<pièce>) : brut, plan, prévisualisations, fiches et final ensemble.

Dans les commandes ci-dessous, ~/.claude/skills/editar-video est l'endroit où la compétence a été installée. Ajustez si installée ailleurs.


Étape 0 — Entrée (sans validation)

python ~/.claude/skills/editar-video/scripts/receitas.py mostrar R01   # et exécuter avec le fichier

Décider avant tout, à partir des chiffres de ffprobe :

  • color_transfer=arib-std-b67 (HLG) ou smpte2084 (PQ) → convertir d'abord en SDR (referencias/hdr-hlg.md, R03). Ne jamais simplement changer l'étiquette.
  • r_frame_rate ≠ avg_frame_rate → débit variable : R02 avant de couper (Meta exige un débit fixe, Ads Guide).
  • color_range=pc → vérifier si le contenu est vraiment 0–255 avant de convertir (R04). signalstats ignore l'étiquette de plage.
  • Fichier IA, enregistrement d'écran : viennent souvent sans balise ou en pleine plage. Mesurer avant de supposer.

Étape 1 — Diagnostic mesuré (validation 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 : mesure après le tonemap
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 --pele 0.35,0.15,0.3,0.25   # région du visage

Lire la fiche par la méthode VOIR → AGRANDIR → CONFIRMER : l'image, puis chaque scope, puis le chiffre. Montrer :

  1. la fiche (folha_escopos.png) et le tableau par scène ;
  2. faits mesurés, un par ligne, avec la règle et la source : « Scène 2 : hauts R 98,6 / G 90,0 / B 80,2 → dominante chaude dans les hauts, si le mur est blanc (Adobe, parade RGB) » ;
  3. ce que je ne sais pas grâce à la mesure (ex. : si le ton chaud est intentionnel).

Le masque de peau automatique (Chai & Ngan) capture le bois, le beige et l'orange. Si le visage est petit ou s'il y a un objet de la même couleur, passer --pele avec la région du visage.

Validation 1 : la personne qui a demandé confirme ce qui est un problème et ce qui est une intention. Je ne corrige pas une dominante que la personne veut.

Étape 2 — Plan de correction et prévisualisation (validation 2)

Écrire plano.json (format en haut de graduar.py). Chaque opération porte le motif mesuré dans un champ "porque". Ordre fixe : conformer → global → scènes (égaliser) → look → finition → légaliser (referencias/cor-fluxo.md, section 1).

  • Normaliser : points de noir/blanc par canal (niveis) à partir de baixas_RGB / altas_RGB.
  • Équilibrer : température d'abord, puis vert/magenta (temperatura, balanco).
  • Égaliser les scènes : choisir la scène de référence (la plus ouverte ou la plus proche du look souhaité, Colorist Guide 20, leçon 2) et approximer Y moyen, hauts RGB et teint des autres.
  • Look : seulement après l'égalisation. Saturation de style, LUT créative. Le look est une question de goût : je propose, la personne décide.
python ~/.claude/skills/editar-video/scripts/graduar.py plano.json --mostrar   # chaîne de filtres
python ~/.claude/skills/editar-video/scripts/graduar.py plano.json --previa    # avant|après du milieu de chaque scène

Validation 2 : approbation de la prévisualisation. L'ajustement vient avec la scène et la mesure (« scène 3 moins chaude, moitié »). Je modifie uniquement ce qui a été demandé.

Étape 3 — Rendu et comparaison mesurée (validation 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

Livrer folha_antes_depois.png + comparacao.md (chiffres avant → après, alertes résolues et nouvelles, amplitude entre scènes). Si une nouvelle alerte apparaît, je corrige avant de montrer.

Validation 3 : approbation de la vidéo corrigée, visionnée par la personne qui a demandé.

Étape 4 — Coupe, calques, texte, mouvement (sur demande)

  • Coupe : liste de segments en JSON → montar.py (sec, J, L). Règles et sources dans referencias/corte.md. Je mesure la durée des plans et les coupes par minute ; le rythme est jugé par la personne.
  • Texte, sous-titre, logo : R50–R52, toujours dans la zone de sécurité de la plateforme (referencias/plataformas.md). Texte littéral d'une liste fermée. Les sous-titres suivent la parole, avec un temps de lecture de 1 s pour 3 mots + 1 s.
  • Mouvement sur la vidéo : zoom/pan avec easing (R60), stabilisation (R61), vitesse (R62).
  • Motion graphics à partir de zéro (typographie cinétique, chiffres animés) : compétence /motion, avec la vidéo entrant comme une séquence d'images.
  • Ordre : les graphiques et les sous-titres arrivent après la couleur et la conversion HDR→SDR (ITU-R BT.2408-9 §9).

Étape 5 — Révision et livraison

Checklist avant de montrer :

  1. comparar.py sans alerte de niveau/gamut à la fin ; balises BT.709 vérifiées avec ffprobe.
  2. Résolution, fps fixe, durée, nombre d'images, pas d'image noire au début/fin.
  3. Texte dans la zone de sécurité ; sous-titres correspondant à la parole.
  4. Loudness mesuré (R80) et signalé. La cible de -14 LUFS est [sans source officielle] ; je l'utilise si la personne est d'accord.
  5. Encodage R90 (H.264, yuv420p, BT.709, +faststart).
  6. Pas de flash fort ni de blanc uni dans les 3 premières secondes si c'est pour TopView de TikTok (plataformas.md).
  7. Demander le visionnage de la personne qui a demandé, sur son téléphone : rythme, sensation, teint.

Look approuvé qui sera réutilisé → gerar_lut.py --plano plano.json -o <projet>_look.cube et --conferir pour prouver.

Règles de code (mesurées avec ffmpeg 8.1.2, 05/11/2026)

  1. Le filtre de couleur en RGB vient après format=gbrp16le. En 8 bits l'aller-retour perd 1,1 code de Y moyen ; en 16 bits il est exact.
  2. Ne pas utiliser eq en flux 10 bits/HLG : il force 8 bits.
  3. Chemin dans le filtre : file='/dossier/fichier.cube' (guillemets simples ; un chemin avec : ou un espace nécessite un échappement avec \).
  4. Balises en sortie : -colorspace bt709 -color_primaries bt709 -color_trc bt709 -color_range tv (+ setparams à la fin de la chaîne de graduar.py).
  5. Légaliser seulement à la fin (EBU R103 v3.0). Le limiter ne corrige pas le gamut RGB ; l'étape RGB16 recadre déjà.
  6. -ss avant -i avec réencodage = coupe précise ; avec -c copy la coupe tombe sur le keyframe.

Individual skills in this repo

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

Skills associés