Communitygithub.com

Edit-Delivery-QA

Überprüft endgültige Videobearbeitungen vor der Auslieferung. Verwenden Sie diese Fähigkeit, wenn ein Agent eine gerenderte MP4/MOV/WebM-Datei inspizieren, Dauer/Auflösung/Bildrate/Audio bestätigen, Kontaktabzüge erstellen oder überprüfen, CSV-Zeitachsen analysieren, Schnittdichte/Quellenmix prüfen, FX-Integration und Kohäsion beurteilen, Text-zu-Beat-Synchronisation verifizieren, schwache Frames oder versehentliche Platzhalter erkennen und entscheiden muss, ob ein beat-synchronisierter Social-Edit bereit zur Präsentation ist.

Was ist Edit-Delivery-QA?

Diese Fähigkeit dient der Qualitätssicherung von Videobearbeitungen vor der endgültigen Auslieferung. Sie führt eine Reihe automatisierter und manueller Prüfungen durch: technische Spezifikationen (Dauer, Auflösung, Bildrate, Codec, Audio), Generierung und Inspektion von Kontaktabzügen, Analyse von Zeitachsen-CSVs (Segmentanzahl, -dauer, Quellenmix) sowie erweiterte Prüfungen für beat-synchronisierte Montagen und integrierte Effekte. Die Fähigkeit unterstützt Editoren und KI-Agenten dabei, schnell festzustellen, ob ein Edit bereit ist, eine Überarbeitung benötigt oder neu gerendert werden muss. Sie ist plattformunabhängig einsetzbar (z. B. mit Claude Code, Cursor, Codex) und basiert auf einem Python-Skript (`scripts/qa_video_edit.py`), das JSON- und Markdown-Berichte erzeugt. Die KI- gestützte Prüfung ersetzt jedoch nicht die menschliche Sichtprüfung – insbesondere bei visuell dichten oder hochkarätigen Projekten.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

QA für die Edit-Auslieferung

Übersicht

Verwenden Sie diese Fähigkeit, bevor Sie einen Videoclip als fertig präsentieren. Die erwartete Ausgabe ist eine präzise QA-Zusammenfassung: technische Spezifikationen, Zeitplangesundheit, visuelle Anmerkungen und eventuelle Korrekturen vor der Auslieferung.

Erforderliche Prüfungen

  1. Überprüfen Sie den finalen Render:
    • Dauer
    • Auflösung
    • Bildrate
    • Video-Codec
    • Vorhandensein einer Audiospur
    • Auslieferungscontainer
  2. Erstellen Sie einen Kontaktabzug, falls noch keiner vorhanden ist.
  3. Überprüfen Sie den Kontaktabzug auf:
    • aktive, bewusste Frames
    • keine Titelcards/Interviews/leere Frames, sofern nicht beabsichtigt
    • keine Wasserzeichen oder Stock-Vorschau-Overlays
    • lesbares Motiv/Handlung nach Beschneidung
    • Akzente, die beabsichtigt wirken, nicht wie zufällige Füller
  4. Überprüfen Sie die Zeitachsen-CSV, falls verfügbar:
    • Anzahl der Segmente
    • durchschnittliche/minimale/maximale Segmentdauer
    • Quellenmix
    • Kategorie-Mix
    • Verwendung von Prioritätstreffern
  5. Vergleichen Sie das Ergebnis mit dem Zielformat und dem kreativen Brief.
  6. Geben Sie an, ob der Edit bereit ist, eine kleine Überarbeitung benötigt oder neu gerendert werden muss.

Ziele für beat-synchronisierte Montagen

Für dichte Social-Montage-Schnitte:

  • Dauer: normalerweise 30-40s.
  • Hochformat: 1080x1920; Querformat: 1920x1080.
  • Bildrate: mindestens 30fps.
  • Bei einer 35s-Hochtempo-Montage sind 70-90 Segmente gesund, wenn das Filmmaterial dies unterstützt.
  • Durchschnittliche Segmentlänge: etwa 0.35-0.50s.
  • Audio sollte vorhanden und sauber sein.
  • Der Kontaktabzug sollte überwiegend aktives/gewünschtes Filmmaterial zeigen.

Integrierte FX- und Handwerksprüfungen (Ergänzung Juli 2026)

Für Edits mit Effekten oder Textebenen fügen Sie diese zu den erforderlichen Prüfungen hinzu:

  • Kohäsion / Sticker-Check: Liest sich ein zusammengesetztes Element wie ein nicht getrackter Sticker und nicht wie ein Objekt in der Szene? Liest sich ein Segment wie ein Cutaway zu einem anderen Video? Zerbricht eine Einstellung die einheitliche Gradierung (ein einmaliger Look unter natürlichen)? Jedes „Ja“ = Überarbeitung – dies sind die häufigsten Ablehnungsgründe.
  • Text-Sync-Check: Wenn eine Hook-Zeile auf einen Beat fallen soll, messen Sie den tatsächlichen Versatz zwischen dem Frame, in dem der Text erscheint, und dem Audio-Akzent; |Versatz| > 100ms = Neu-Render.
  • Loop-Check: Spielen Sie das Ende in den Anfang zurück; Loop-Naht-Edits müssen unsichtbar sein.
  • Handy-Maßstab-Check: Überprüfen Sie in voller Größe UND im Handy-Maßstab; speichern Sie Review-Frames zu den vorgeschriebenen Zeitstempeln (z. B. 1/4/8/12/14s eines 15s-Stücks) sowie eine späte Frame-Stichprobe zusammen mit dem QA-Bericht.
  • Billig-Testphase (vor vollständigen Builds, nicht danach): Rendern Sie ein unterauflösendes Skelett der ersten 3-5 Sekunden und sehen Sie es sich in Scroll-Geschwindigkeit an, bevor Sie sich für den vollständigen/VFX-Render entscheiden – Tötungskriterien sind an diesem Tor billig und nach VFX teuer.
  • QuickTime-Auslieferung: Wenn die Überprüfung in Apple-Playern stattfindet, produzieren Sie auch eine QuickTime-kompatible .mov und führen Sie eine separate QA dafür durch.
  • Für alles, was öffentlich geht, führen Sie fünf unabhängige Prüfungen durch: technisch, visuell, narrativ, Originalität/Rechte, Plattform-Paket. Automatisierte QA unterstützt, ersetzt aber nie das Ansehen des Renders in normaler Geschwindigkeit. Körnung ist in Ordnung (Zuschauer bevorzugen sie); Blockigkeit, Banding, Hochskalierungs-Unschärfe, Wasserzeichen und Ränder sind die wahren Nachteile.

Fehlermuster

Senden Sie den Edit zur Überarbeitung zurück, wenn Sie sehen:

  • keine Audiospur oder falscher Audio-Ausschnitt
  • falsches Seitenverhältnis oder unbeabsichtigter Beschnitt
  • leere Frames, Titelcards, Interviews, Stock-Wasserzeichen oder Preis-Overlays
  • durch den vertikalen Beschnitt verdeckte Handlung
  • zu viele schwache Crowd/Laser/Nature-Insert-Schnitte, die die Hauptprämisse ersetzen
  • priorisierte musikalische Hits, die von bewegungsarmem Filmmaterial bedient werden
  • Zeitachsen-CSV und finaler Render stimmen wesentlich nicht überein

Skript

Führen Sie scripts/qa_video_edit.py gegen das finale Video aus. Fügen Sie --timeline und --contact-sheet hinzu, wenn verfügbar:

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

Das Skript schreibt JSON und Markdown. Es kann auch einen Kontaktabzug mit FFmpeg erstellen, wenn --make-contact-sheet gesetzt ist.

Menschliche Überprüfung

Das Skript erkennt Spezifikationen und Zeitplanprobleme; es ersetzt nicht das Ansehen oder die Inspektion von Frames. Kombinieren Sie automatisierte QA immer mindestens mit einer Kontaktabzug-Überprüfung, und sehen Sie sich den finalen Render an, wenn der Edit hohe Einsätze hat oder visuell dicht ist.

Lesen Sie für den Conteto-Machino-Standard references/edit-qa-standard.md.

Optionale Referenzen:

  • references/qa-thresholds.md: anpassbare Schwellenwerte nach Edit-Typ.
  • references/example-prompts.md: wiederverwendbare finale QA-Prompts.
  • references/gui-vision.md: Produktvision für ein visuelles QA- und Auslieferungspanel.

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

Verwandte Skills