Communitygithub.com

Bewegungsgrafik-Qualitätssicherung

Automatisierte Vorab- und Nachbearbeitungs-Qualitätssicherung für Bewegungsgrafiken, KI-generierte Videos (HyperFrames, Remotion, HTML/GSAP) und Kurzform-Social-Anzeigen (Instagram Reels, TikTok, YouTube Shorts, LinkedIn). Prüft Codecs, Pixelformat (yuv420p), Faststart-Streaming-Flags, EBU R128-Lautstärke (-14 LUFS / -1 dBTP), tote schwarze Einblendungen, erstellt ein 6-Frame-Safe-Zone-QA-Kontaktblatt und liefert auslieferungsfertige MP4s.

Was ist Bewegungsgrafik-Qualitätssicherung?

Diese Fähigkeit bietet eine deterministische Quality-Gate für bewegte Grafiken und Kurzform-Videoanzeigen, die mit Code rendern. Sie ist für Plattformen wie Claude Code, Cursor, Codex und andere KI-gestützte Entwicklungsumgebungen konzipiert. Die Fähigkeit führt eine 8-stufige technische Prüfung durch, die Container und Codec, Pixelformat (yuv420p), Web-Faststart, Seitenverhältnis und Auflösung, Bildratenkonsistenz, schwarze Einblendungen, EBU R128-Lautstärke und Dateigröße/Bitratenbudget abdeckt. Sie generiert ein visuelles Kontaktblatt mit Safe-Zone-Überlagerungen, um UI-Hindernisse zu erkennen, und bietet ein automatisches Korrekturmodul, das Pixelformat-Probleme behebt, Faststart hinzufügt und die Lautstärke normalisiert. Die Fähigkeit eliminiert blinde Neurenders, abgeschnittene Untertitel, stummgeschaltete/verzerrte Audioausgaben und iOS/QuickTime-Wiedergabefehler und stellt sicher, dass jede Videodatei für die Kundenauslieferung oder Social-Uploads bereit ist.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Bewegungsgrafik-Qualitätssicherung (Preflight QA)

Deterministische Broadcast- und Social-Plattform-Qualitätsprüfung für code-renderte Bewegungsgrafiken und Kurzform-Videoanzeigen. Entwickelt, um blinde Neurenders, abgeschnittene Untertitel, stummgeschaltete/verzerrte Audioausgaben und iOS/QuickTime-Wiedergabefehler zu eliminieren.

Voraussetzungen

  • Python 3.9+ (nur Standardbibliothek — keine Drittanbieter-Python-Pakete erforderlich)
  • FFmpeg & FFprobe im PATH

Standard-QA-Workflow (Vor jeder Auslieferung ausführen)

Schritt 1: Das gerenderte Video prüfen

Führen Sie die 8-stufige technische Prüfung gegen die Zielplattform (reels, tiktok, shorts, youtube, linkedin, square oder auto) durch:

python3 scripts/audit_video.py pfad/zu/video.mp4 --platform reels

Verwenden Sie --json für maschinenlesbare Ausgabe, wenn Sie es in automatisierte Pipelines einbinden.

Was geprüft wird:

  1. Container & Codec: H.264 (libx264) oder HEVC MP4-Kompatibilität.
  2. Pixelformat (yuv420p): Erkennt yuv444p / 10-Bit-Exporte, die in QuickTime, Safari und Instagram iOS als schwarze Bildschirme erscheinen.
  3. Web Faststart (moov vor mdat): Überprüft sofortige progressive mobile Wiedergabe ohne Pufferungsverzögerungen.
  4. Seitenverhältnis & Auflösung: Überprüft Übereinstimmung mit den Zielplattform-Maßen (z. B. 1080x1920 für 9:16 vertikal).
  5. Bildratenkonsistenz: Überprüft saubere Standard-FPS (24, 30, 60 oder 120) und markiert nicht-standardmäßige variable Bildraten.
  6. Einblendungsintegrität (Schwarz-Frame-Scan): Markiert tote schwarze Intro-Phasen (> 0,25 s am Anfang) oder unerwartete schwarze Lücken mitten im Video.
  7. Audiolautstärke (EBU R128): Misst integrierte Lautstärke (I in LUFS) und True Peak (TP in dBTP) gegen den -14 LUFS / -1,0 dBTP Social-Standard.
  8. Dateigröße & Bitratenbudget: Markiert übermäßig große Filmkorn-Exporte, die aggressive plattformspezifische Neukomprimierung auslösen.

Schritt 2: Das Safe-Zone-Kontaktblatt generieren

Erstellen Sie ein 6-Frame-visuelles Nachweisblatt mit pixelgenauen Plattform-HUD-Gefahrenzonen, die in durchscheinendem Rot maskiert sind, und dem Titel-Safe-Bereich, der in Grün umrandet ist:

python3 scripts/safe_zone_overlay.py pfad/zu/video.mp4 --platform reels --out qa_kontaktblatt.png

Überprüfen Sie qa_kontaktblatt.png (visuell oder mit einem Bildlesewerkzeug):

  • Rote Zonen = UI-Gefahrenbereiche (obere Kopfzeile, rechte Like/Kommentar/Teilen-Leiste, untere Untertitel/Audio-Schublade).
  • Grünes Kästchen = Titel-Safe-Zone. Jegliche Überschrift, Statistik, Produkt-Hervorhebung oder CTA, die Rot berührt, MUSS vor der Auslieferung neu positioniert werden.
  • Um eine einzelne Problemzeitmarke in voller Auflösung zu inspizieren, fügen Sie --at <Sekunden> --out proof_frame.png hinzu.

Schritt 3: Automatische Auslieferungsversion (wenn eine technische Prüfung warnt oder fehlschlägt)

Pixelformat beheben, +faststart einfügen, Zwei-Durchgang-EBU-R128-Lautstärkenormalisierung (-14 LUFS, -1,0 dBTP) anwenden und Bitrate sauber optimieren:

python3 scripts/fix_delivery.py pfad/zu/video.mp4 --out pfad/zu/video_master.mp4 --crf 20

Verwenden Sie --crf 23 für starkes Filmkorn oder verrauschte Hintergründe, um die Dateigröße zu reduzieren, ohne die Typografie zu verwaschen. Führen Sie dann Schritt 1 für die masterisierte Datei erneut aus, um ein 100/100 BESTANDEN zu bestätigen.

Referenzdokumentation

  • references/platform-safe-zones.md — Exakte 2026 Safe-Zone-Koordinaten und Pixelabstände für Instagram Reels, TikTok, YouTube Shorts, LinkedIn und 16:9 Breitbild.
  • references/delivery-specs.md — Codec, Farbraum, Lautstärke, Bitrate und häufige Code-zu-Video-Fehlerbehebungen.

Verwandte Skills