Markus Michalski FAQ

VidCraft Quality-System

Das VidCraft Quality-System: 14-Punkte-Script-Review, Pre-Generation-Gates, 20-Punkte-Video-Review sowie Voice-, Brand-, Accessibility- und Timing-Checks und die zugehörigen MCP-Tools.

VidCraft Quality-System

English Version

Zurück zur Übersicht


Überblick

Qualität wird an drei Stellen geprüft: am Script (script-reviewer), vor der Generierung (pre-generation-check) und am fertigen Video (video-reviewer). Dazu kommen vier Einzel-Checks. Die Skills nutzen MCP-Tools für Messbares und beurteilen den Rest selbst. Ergebnisse sind PASS, WARN oder FAIL.


Script-Review (script-reviewer)

14 Punkte, gruppiert:

Gruppe Punkte
Inhalt 1 Timing (Sprechtempo im Zielbereich des Typs), 2 Lesbarkeit (Flesch Reading Ease mindestens 60), 3 Struktur nach Typ-Vorlage, 4 Hook in den ersten 5 Sekunden, 5 Call-to-Action am Ende
Sprache 6 gleichbleibende Tonalität, 7 keine KI-typische Sprache, 8 höchstens 20 Wörter je Satz, 9 Aktiv und Imperativ bei Anleitungen
Visuell 10 keine Szene über 60 Sekunden, 11 definierte Übergänge, 12 Visual Direction je Szene, 13 höchstens 7 Wörter je Overlay ohne Wiederholung der Narration
Vollständigkeit 14 Zusammenfassung bei Tutorials und Installations-Guides

Zusätzlich gibt es einen Aussprache-Hinweis (check_pronunciation) für beide Plattformen und für Synthesia mit Expressive Avatars einen Ausdrucks-Punkt (kein Segment über 60 Sekunden ohne ! oder ?, Emoticons markieren). Bestehen alle Punkte, setzt der Skill den Episoden-Status Script Reviewed.


Pre-Generation-Check (pre-generation-check)

Der Skill ruft zuerst das Tool run_pre_generation_gates auf und ergänzt es um eigene Prüfungen.

Tool-Gates:

Gate Ergebnis bei Verstoß
Episoden-Status ist weder Not Started noch Script Draft FAIL (blockiert)
Mindestens eine Szene vorhanden FAIL (blockiert)
Jede Szene hat Narration FAIL (blockiert)
Jede Szene hat Visual Direction WARN
Geschätzte Dauer (Wörter geteilt durch defaults.wpm) nur Information

Gesamtergebnis: READY oder BLOCKED.

Ergänzungen im Skill: Zeichen-Limits der Plattform (blockierend), Dauer im Typ-Bereich, referenzierte Assets, und für HeyGen Warnungen bei mehreren Hintergründen je Szene, zeitgesteuerten Overlays, SSML-Prosody ohne eigene Stimme und nicht deklarierten Variablen.


Video-Review (video-reviewer)

20 Punkte nach der Generierung:

Gruppe Punkte
Inhalt (5) Hook, Botschaften, CTA, Ablauf, Vollständigkeit
Narration (4) natürliche Sprache, keine KI-Muster, Satzlänge, Aussprache
Bild (4) Abwechslung alle 15 bis 30 Sekunden, Avatar-Konsistenz, Bildschirmtext, Übergänge
Tempo (3) Gesamtdauer, Szenendauer, Atempausen
Marke und Barrierefreiheit (4) Tonalität, visuelle Marke, Untertitel geplant, inklusive Sprache

Sind alle Punkte bestanden, wird der Status QA Passed gesetzt. Bei einem FAIL bleibt Generated, bei reinen Warnungen entscheidest du.


Einzel-Checks

Skill Prüft
voice-checker KI-typische Sprache nach Stufen aus knowledge/ai-language-patterns.md: Stufe 1 immer markieren, Stufe 2 ab zwei Treffern je Episode, Stufe 3 wenn das Muster sich wiederholt. Nur Hinweise, kein Umschreiben. Ausnahmen etwa für wörtliche UI-Navigation.
timing-validator Gesamtdauer, Szenenanzahl, längste und kürzeste Szene, Hook-Dauer, Sprechtempo gegen die Werte des Video-Typs
brand-checker Tonalität, Terminologie, visuelle Identität, Stil-Vorgaben. Ohne Marken-Angaben wird die Prüfung übersprungen.
accessibility-checker 10 Punkte: Untertitel-Eignung, Informationen nicht nur im Ton, Lesetempo, Overlay-Länge, Kontrast, nicht nur Farbe, Überladung, Fachbegriffe, Lesbarkeit, Tempo

Messwerkzeuge im MCP-Server

Tool Liefert
analyze_timing Wortanzahl und geschätzte Dauer bei gegebenem Sprechtempo
check_readability Flesch-Wert (ab 60 PASS, ab 40 WARN, darunter FAIL), Satzstatistik, Sätze über 20 Wörter
validate_structure Szenen vorhanden, Narration und Visual Direction je Szene
validate_platform_limits Zeichen und Szenen gegen die Plattform-Limits
check_pronunciation Jahreszahlen, Akronyme, lateinische Abkürzungen mit Vorschlägen

Der Flesch-Wert ist eine vereinfachte, an englischer Silbenzählung orientierte Näherung. Bei deutschen Scripts dient er als grober Anhaltspunkt.