Communitygithub.com

Video Factory

Verwandeln Sie Ihre eigenen Videoclips in ein bearbeitetes Video mit Untertiteln und Musik. Analysiert das Material (Aufnahmen, Sprache, Lautstärke), plant den Schnitt, rendert einen Entwurf, prüft ihn und überarbeitet ihn. Verwenden Sie dies, wenn der Benutzer Clips zu einem Video, Kurzvideo, Reel, Rückblick, Zusammenschnitt oder Höhepunkte-Zusammenstellung bearbeiten, schneiden, trimmen oder zusammenstellen möchte.

Was ist Video Factory?

Video Factory ist eine KI-gestützte Fähigkeit für KI-Agenten wie Claude Code, Cursor oder Codex, die den gesamten Videobearbeitungs-Workflow automatisiert: von der Analyse des Rohmaterials über die kreative Planung bis hin zum finalen Rendering mit Untertiteln und Musik. Sie unterstützt verschiedene Plattformen wie TikTok, YouTube und Instagram und wählt automatisch das passende Seitenverhältnis (9:16, 16:9, 4:5) basierend auf dem Zielort. Die Fähigkeit analysiert Aufnahmen, Sprach- und Lautstärkeinformationen, erstellt einen Bearbeitungsplan (EDL) in JSON, rendert einen Entwurf, prüft ihn auf Probleme (wie Untertitel, die Gesichter verdecken) und erlaubt bis zu zwei Überarbeitungsdurchläufe, bevor das finale Video ausgegeben wird. Entwickler profitieren von der starken modularen Struktur mit Python-Skripten, der Wiederverwendbarkeit durch Caching, der Unterstützung für benutzerdefinierte Musik (unter Achtung der Rechte) und der Fähigkeit, auch ohne Transkription (faster-whisper) zu arbeiten, falls nötig. Die Fähigkeit betont kreative Entscheidungen durch den Agenten (was bleibt, in welcher Reihenfolge und warum) und hält sich an strenge Regeln, wie dem Verzicht auf Raten von Zeitpunkten ohne visuelle Überprüfung und dem ausschließlichen Verwenden von benutzergestellter Musik.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Mickabooo/video/tree/HEAD/video-factory/skills/video-factory

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Video Factory?

Du bist der Editor. Die Skripte erledigen die mechanische Arbeit: Analyse, Schnitt, Untertitel, Mischen und Rendern. Du triffst die kreativen Entscheidungen: was behalten wird, in welcher Reihenfolge und warum.

In den folgenden Befehlen bedeutet SKILL_DIR den Ordner, der diese Datei enthält. Schreibe den tatsächlichen Pfad aus, wenn du sie ausführst.

1. Überprüfe die Werkzeuge

python3 "SKILL_DIR/scripts/doctor.py"

Falls etwas Erforderliches fehlt, stoppe und gib dem Benutzer den Installationsbefehl, den doctor ausgegeben hat. Ein fehlendes faster-whisper ist kein Hindernis: Alles funktioniert ohne Transkripte und Untertitel, außer diesen.

2. Hol dir die Vorgaben

Kläre vier Dinge ab. Frage nur nach dem, was der Benutzer dir noch nicht gesagt hat, in einer einzigen Nachricht mit nicht mehr als drei Fragen:

  • Wo es veröffentlicht wird. Dies legt das Seitenverhältnis und eine sinnvolle Länge fest.
  • Wie lang es sein soll.
  • Worum es geht, und welche Momente unbedingt drin sein müssen oder draußen bleiben müssen.
  • Musik. Der Pfad zu einem Track, für den sie die Rechte haben, oder keiner.

Falls der Benutzer sagt, mach einfach irgendwas, verwende diese Standardwerte und sage, welche du verwendet hast:

ZielaspectLänge
TikTok, Reels, Shorts9:1620–45 s
YouTube16:9was das Material hergibt
Instagram-Feed4:515–30 s
Nicht angegeben9:16 wenn die meisten Clips hochkant sind, sonst 16:930–60 s

3. Analysiere das Material

python3 "SKILL_DIR/scripts/analyze.py" CLIPS --out RUN_DIR

CLIPS sind eine oder mehrere Clip-Dateien oder Ordner. Füge --recursive hinzu, um Unterordner einzuschließen. Wähle RUN_DIR als factory-output/<kurzer-name> im Arbeitsordner des Benutzers. Das Skript gibt RUN_DIR=... aus, wenn es fertig ist. Die Analyse wird zwischengespeichert, daher ist erneutes Ausführen auf denselben Clips schnell.

4. Sieh dir das Material an

  1. Lies RUN_DIR/index.md vollständig.
  2. Öffne jedes Kontaktblatt in RUN_DIR/sheets/. Jeder Frame ist mit seiner Nummer und seiner Zeit in Sekunden beschriftet.
  3. Für einen genaueren Blick auf einen Moment (um einen Bildausschnitt, ein Gesicht oder Text auf dem Bildschirm zu beurteilen), speichere ein Standbild in voller Größe: python3 "SKILL_DIR/scripts/frame.py" RUN_DIR c03 12.5

Halte für jeden Clip fest, was er zeigt, seine besten Momente und alles Unbrauchbare: verwackelt, unscharf, zu dunkel, versehentlich oder eine schwächere Aufnahme von etwas, das du woanders hast.

5. Plane den Schnitt

Lies references/editing-principles.md. Schreibe dann RUN_DIR/plan.md mit:

  • Winkel: Ein Satz, worum es in dem Video geht.
  • Hook: Was in den ersten zwei Sekunden passiert.
  • Struktur: Die Abschnitte in der Reihenfolge, mit den Clips und Zeiten für jeden.
  • Weggelassen: Was du weggeschnitten hast und warum, damit der Benutzer es zurückfordern kann.

6. Schreibe die EDL

Lies references/edl-format.md, schreibe dann RUN_DIR/edl.json und validiere es:

python3 "SKILL_DIR/scripts/validate_edl.py" RUN_DIR/edl.json

Behebe jeden Fehler. Behebe jede Warnung "schneidet in das Wort hinein" mit den vorgeschlagenen Zeiten. Behandle andere Warnungen als Anregungen zum Überdenken, nicht als Anweisungen.

7. Rendere einen Entwurf und überprüfe ihn

python3 "SKILL_DIR/scripts/render.py" RUN_DIR/edl.json
python3 "SKILL_DIR/scripts/review.py" RUN_DIR/draft.mp4 --edl RUN_DIR/edl.json

Überprüfe dann selbst das Ergebnis:

  • Behebe alles, was unter "Gefundene Probleme" aufgeführt ist.
  • Öffne das Kontaktblatt aus RUN_DIR/review/. Überprüfe den Bildausschnitt, stelle sicher, dass Untertitel und Text keine Gesichter verdecken, und überprüfe, ob der Eröffnungsframe als Hook funktioniert.
  • Wenn Untertitel aktiviert sind, lies RUN_DIR/draft.srt von Anfang bis Ende. Es sollte als vollständige Gedanken lesbar sein, kein Satz sollte mitten durchgeschnitten sein.

Überarbeite edl.json und rendere erneut, höchstens zwei weitere Male. Höre auf, wenn die Überprüfung sauber ist und alle verbleibenden Änderungen Geschmackssache wären.

8. Zeige es dem Benutzer

Gib ihnen den Pfad zu draft.mp4, seine Länge, zwei oder drei Sätze zu deinem Schnitt und die Optionen, die sie vielleicht ändern möchten (Hook, Reihenfolge, Länge, Musiklautstärke). Frage, bevor du die finale Version renderst, es sei denn, sie haben gesagt, du sollst direkt durchgehen.

Wenn sie Änderungen wünschen, bearbeite edl.json und rendere den Entwurf erneut. Fange nicht von vorne an, es sei denn, sie bitten darum.

9. Rendere die finale Version

python3 "SKILL_DIR/scripts/render.py" RUN_DIR/edl.json --quality final
python3 "SKILL_DIR/scripts/review.py" RUN_DIR/final.mp4 --edl RUN_DIR/edl.json

Melde die Pfade zu final.mp4 und, falls es Untertitel gibt, final.srt. Die meisten Plattformen akzeptieren die .srt als hochgeladene Untertitelspur.

Regeln

  • Ändere, verschiebe, benenne niemals die Clips des Benutzers um oder lösche sie. Alles, was du erstellst, kommt in RUN_DIR.
  • Basieren jeden Schnittpunkt auf dem Index (Sprache, Aufnahmen oder leise Abschnitte) oder auf einem Frame, den du angesehen hast. Rate niemals eine Zeit.
  • Verwende keinen Clip, dessen Kontaktblatt du dir nicht angesehen hast, und beschreibe kein Material, das du nicht gesehen hast.
  • Verwende nur Musik, die der Benutzer bereitgestellt oder auf die er dich hingewiesen hat. Lade niemals Musik herunter.
  • Wenn das Material die angeforderte Länge oder Geschichte nicht unterstützt, sage das. Polstere das Video nicht mit schwachen Aufnahmen auf, um ein Ziel zu erreichen.
  • Wenn ein Skript fehlschlägt, lies die Fehlermeldung: Sie sagt, was zu beheben ist. Führe doctor.py aus, wenn ein Tool zu fehlen scheint.

Ohne Transkript

Wenn die Clips nicht transkribiert wurden (faster-whisper ist nicht installiert oder das Modell konnte nicht heruntergeladen werden), sagt index.md dies. Du kannst trotzdem mit den Aufnahmen, leisen Abschnitten und Kontaktblättern arbeiten, aber es wird keine Untertitel geben, und du kannst nicht sicher sein, dass ein Schnitt nicht mitten im Satz landet. Sag es dem Benutzer und erwähne, dass das Ausführen von python3 -m pip install faster-whisper gefolgt von einem erneuten Ausführen von analyze.py Transkripte hinzufügt.

Dateien in einem Ausführungsordner

DateiGeschrieben vonWas es ist
clip-index.jsonanalyze.pyVollständige Analyse, einschließlich Wortzeiten
index.mdanalyze.pyDie Zusammenfassung, die bei der Planung gelesen wird
sheets/<id>.jpganalyze.pyEin Kontaktblatt pro Clip
plan.mdduDer redaktionelle Plan
edl.jsonduDer Schnitt selbst
draft.mp4, final.mp4render.pyGerenderte Videos
draft.srt, final.srtrender.pyUntertitel als separate Datei
review/review.pyKontaktblätter und Überprüfungen für jeden Renderdurchlauf
stills/frame.pyStandbilder in voller Größe

Verwandte Skills