Communitygithub.com

QA de livraison de montage

Vérifier les montages finaux avant livraison. Utilisez cette compétence lorsqu'un agent doit inspecter un rendu MP4/MOV/WebM, confirmer la durée/résolution/images par seconde/audio, générer ou examiner des planches contact, analyser des CSV de timeline, vérifier la densité de coupe/le mix des sources, vérifier l'intégration et la cohésion des effets, valider la synchronisation texte-temps, détecter les images faibles ou les placeholders accidentels, et décider si un montage social synchronisé au beat est prêt à être présenté.

Qu'est-ce que QA de livraison de montage ?

Cette compétence permet à un agent IA d'effectuer un contrôle qualité (QA) complet avant la livraison d'un montage vidéo, en particulier pour les montages sociaux synchronisés au beat. L'agent inspecte le rendu final pour vérifier les spécifications techniques (durée, résolution, codec, audio), génère et examine une planche contact, analyse le fichier CSV de la timeline pour la densité et la diversité des segments, et compare le résultat au format cible et au brief créatif. Elle intègre également des contrôles avancés comme la cohésion des effets composites (vérification des stickers, des boucles, de la synchronisation texte-temps) et les validations sur écran téléphone. En cas de défaillance, l'agent émet un rapport structuré indiquant si le montage est prêt, nécessite une révision, ou doit être ré-encodé. La compétence s'appuie sur un script Python automatisé (`scripts/qa_video_edit.py`) complété par une revue humaine obligatoire des images.

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

Demander à votre IA préférée

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

Documentation

Que fait QA de livraison de montage ?

Présentation

Utilisez cette compétence avant de présenter un montage vidéo comme terminé. Le résultat attendu est un rapport de QA concis : spécifications techniques, santé de la timeline, notes de révision visuelle et éventuelles corrections nécessaires avant livraison.

Vérifications obligatoires

  1. Sonder le rendu final :
    • durée
    • résolution
    • images par seconde
    • codec vidéo
    • présence d'une piste audio
    • conteneur de livraison
  2. Générer une planche contact si elle n'existe pas déjà.
  3. Examiner la planche contact pour :
    • des images actives et intentionnelles
    • aucun carton-titre/interview/plan vide sauf intention délibérée
    • aucun filigrane ou incrustation de prévisualisation
    • sujet/action lisible après recadrage
    • accents qui semblent intentionnels, pas de remplissage aléatoire
  4. Inspecter le CSV de la timeline si disponible :
    • nombre de segments
    • durée moyenne/minimale/maximale des segments
    • mix des sources
    • mix des types/catégories
    • utilisation des hits prioritaires
  5. Comparer le résultat au format cible et au brief créatif.
  6. Indiquer si le montage est prêt, nécessite une petite révision, ou doit être ré-encodé.

Cibles pour un montage synchronisé au beat

Pour les montages denses sur les réseaux sociaux :

  • Durée : généralement 30-40s.
  • Vertical : 1080x1920 ; paysage : 1920x1080.
  • Images par seconde : 30fps minimum.
  • Pour un montage 35s à haute énergie, 70-90 segments est sain si les rushes le permettent.
  • Longueur moyenne des segments : environ 0.35-0.50s.
  • L'audio doit être présent et propre.
  • La planche contact doit montrer principalement des plans actifs/intentionnés.

Contrôles d'effets intégrés et de qualité artisanale (ajouts de 2026-07)

Pour les montages avec effets ou calques de texte, ajoutez ceci aux vérifications obligatoires :

  • Contrôle de cohésion / sticker : un élément composite donne-t-il l'impression d'un sticker non suivi plutôt que d'un objet dans la scène ? Un segment donne-t-il l'impression d'un cutaway vers une autre vidéo ? Un plan casse-t-il l'étalonnage commun (un look isolé parmi des naturels) ? Oui = révision — ce sont les causes de rejet les plus fréquentes.
  • Contrôle de synchronisation texte : si une accroche textuelle doit tomber sur un temps, mesurer le décalage réel entre l'image d'apparition du texte et l'accent audio ; |décalage| > 100ms = ré-encodage.
  • Contrôle de boucle : rejouer la fin au début ; les raccords de boucle doivent être invisibles.
  • Contrôle à l'échelle téléphone : inspecter en taille réelle ET à l'échelle téléphone ; sauvegarder les images de révision à des timestamps imposés (par exemple 1/4/8/12/14s d'un plan de 15s) ainsi qu'un contrôle tardif aléatoire à côté du rapport QA.
  • Étape de validation économique (avant les constructions complètes, pas après) : rendre un squelette basse résolution des 3-5 premières secondes et le regarder à la vitesse de défilement avant de s'engager dans le rendu complet/VFX — les critères d'abandon sont peu coûteux à cette barrière et coûteux après VFX.
  • Livrable QuickTime : lorsque la révision a lieu dans des lecteurs Apple, produire et qualifier séparément un .mov compatible QuickTime.
  • Pour tout ce qui est public, exécuter cinq barrières indépendantes : technique, visuelle, narrative, originalité/droits, plateforme. Le QA automatisé soutient mais ne remplace jamais le visionnage du rendu à vitesse normale. Le grain est acceptable (les spectateurs le préfèrent) ; les blocages, bandes, flou d'upscale, filigranes et bordures sont les véritables pénalités.

Schémas d'échec

Renvoyez le montage en révision lorsque vous voyez :

  • absence de piste audio ou mauvais extrait audio
  • mauvais rapport hauteur/largeur ou recadrage non intentionnel
  • plans vides, cartons-titres, interviews, filigranes de stock, ou incrustations de prix
  • action cachée par le recadrage vertical
  • trop d'inserts faibles (foule/laser/nature) remplaçant le sujet principal
  • hits musicaux prioritaires servis par des plans à faible mouvement
  • désaccord significatif entre le CSV de timeline et le rendu final

Script

Exécutez scripts/qa_video_edit.py sur la vidéo finale. Ajoutez --timeline et --contact-sheet si disponibles :

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

Le script écrit du JSON et du Markdown. Il peut également créer une planche contact avec FFmpeg lorsque --make-contact-sheet est défini.

Révision humaine

Le script détecte les problèmes de spécifications et de timeline ; il ne remplace pas le visionnage ou l'inspection des images. Associez toujours le QA automatisé à au moins une révision de la planche contact, et regardez le rendu final lorsque le montage est à fort enjeu ou visuellement dense.

Pour le standard Conteto Machino, lisez references/edit-qa-standard.md.

Références optionnelles :

  • references/qa-thresholds.md : seuils adaptables par type de montage.
  • references/example-prompts.md : invites de QA finale réutilisables.
  • references/gui-vision.md : vision produit pour un panneau de QA visuelle et de livraison.

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

Skills associés