Communitygithub.com

motion-preflight-qa

Assurance qualité automatisée avant et après rendu pour le motion design, les vidéos générées par IA (HyperFrames, Remotion, HTML/GSAP) et les publicités sociales courtes (Instagram Reels, TikTok, YouTube Shorts, LinkedIn). Audite les codecs, le format pixel (yuv420p), les flags faststart, la sonie EBU R128 (-14 LUFS / -1 dBTP), les blocs noirs, génère une planche contact de zone de sécurité à 6 images et produit des MP4 prêts à livrer.

Qu'est-ce que motion-preflight-qa ?

Ce skill, Motion Preflight QA, est une passerelle de qualité déterministe pour les animations graphiques et publicités vidéo courtes rendues par code. Il s'intègre dans les workflows de déploiement pour éliminer les re-rendus aveugles, les légendes coupées, l'audio muet ou écrasé, et les bugs de lecture sur iOS/QuickTime. Il est conçu pour les plateformes d'IA comme Claude Code, Cursor, Codex, ainsi que les environnements de développement Python/FFmpeg. Le skill effectue un audit technique en 8 étapes (codec, format pixel yuv420p, faststart, ratio d'aspect, FPS, intégrité des noirs, sonie EBU R128, taille/fichier), génère une planche contact visuelle avec zones de danger UI, et propose une correction automatique des problèmes (format pixel, faststart, normalisation sonie). L'utilisateur exécute ces scripts en Python via des commandes CLI, sans dépendances Python tierces, uniquement FFmpeg et FFprobe sur le PATH. Il est essentiel pour tout développeur ou créateur qui livre des vidéos produites par code sur les réseaux sociaux, garantissant une conformité technique avant livraison.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Shk2005/motion-preflight-qa/tree/HEAD

Demander à votre IA préférée

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

Documentation

Motion Preflight QA

Passerelle de qualité déterministe broadcast et plateforme sociale pour les animations graphiques et publicités vidéo courtes rendues par code. Conçue pour éliminer les re-rendus aveugles, les légendes coupées, l'audio muet/écrasé et les bugs de lecture iOS/QuickTime.

Prérequis

  • Python 3.9+ (bibliothèque standard uniquement — aucun paquet Python tiers requis)
  • FFmpeg & FFprobe dans le PATH

Workflow QA Standard (À Exécuter Avant Chaque Livraison)

Étape 1 : Auditer la vidéo rendue

Exécute l'audit technique en 8 points contre la plateforme cible (reels, tiktok, shorts, youtube, linkedin, square ou auto) :

python3 scripts/audit_video.py chemin/vers/video.mp4 --platform reels

Utilisez --json pour une sortie lisible par machine lors de l'enchaînement dans des pipelines automatisés.

Ce qu'il vérifie :

  1. Conteneur & Codec : Compatibilité H.264 (libx264) ou HEVC MP4.
  2. Format Pixel (yuv420p) : Détecte les exports yuv444p / 10 bits qui s'affichent en écran noir dans QuickTime, Safari et Instagram iOS.
  3. Web Faststart (moov avant mdat) : Vérifie la lecture mobile progressive instantanée sans délais de mise en mémoire tampon.
  4. Ratio d'aspect & Résolution : Vérifie la conformité aux dimensions de la plateforme cible (ex. 1080x1920 pour vertical 9:16).
  5. Consistance du Taux d'Images : Vérifie les FPS standards propres (24, 30, 60 ou 120) et signale les fréquences variables non standard.
  6. Intégrité du Hook (Analyse des Images Noires) : Signale toute intro noire morte (> 0,25 s au début) ou trous noirs inattendus en milieu de vidéo.
  7. Sonie Audio (EBU R128) : Mesure la sonie intégrée (I en LUFS) et le pic vrai (TP en dBTP) par rapport à la norme sociale -14 LUFS / -1,0 dBTP.
  8. Taille du Fichier & Budget de Débit : Signale les exports de grain de film gonflés qui déclenchent une recompression agressive de la plateforme.

Étape 2 : Générer la Planche Contact de Zone de Sécurité

Génère une planche de preuve visuelle à 6 images avec les zones de danger HUD de la plateforme masquées en rouge translucide et le périmètre titre-sécurisé souligné en vert :

python3 scripts/safe_zone_overlay.py chemin/vers/video.mp4 --platform reels --out qa_contact_sheet.png

Inspectez qa_contact_sheet.png (visuellement ou avec un outil de lecture d'images) :

  • Zones rouges = zones de danger UI (en-tête supérieur, rail like/commentaire/partage droit, tiroir de légende/audio inférieur).
  • Boîte verte = Zone titre-sécurisée. Tout titre, statistique, appel produit ou CTA touchant le rouge DOIT être repositionné avant livraison.
  • Pour inspecter un seul timestamp problématique en pleine résolution, ajoutez --at <secondes> --out proof_frame.png.

Étape 3 : Auto-Master pour Livraison (si un contrôle technique échoue ou donne un avertissement)

Corrige le format pixel, injecte +faststart, applique une normalisation de sonie EBU R128 en deux passes (-14 LUFS, -1,0 dBTP) et optimise proprement le débit binaire :

python3 scripts/fix_delivery.py chemin/vers/video.mp4 --out chemin/vers/video_master.mp4 --crf 20

Utilisez --crf 23 pour les arrière-plans à grain de film lourd ou bruyants afin de réduire la taille du fichier sans typographie baveuse. Relancez ensuite l'Étape 1 sur le fichier master pour confirmer un 100/100 PASS.

Documentation de Référence

  • references/platform-safe-zones.md — Coordonnées exactes des zones de sécurité 2026 et marges de pixels pour Instagram Reels, TikTok, YouTube Shorts, LinkedIn et grand écran 16:9.
  • references/delivery-specs.md — Codec, espace colorimétrique, sonie, débit binaire et corrections courantes des pannes code-vers-vidéo.

Skills associés