Communitygithub.com

Video Forge

Erstellen Sie professionelle Videos mit Code: Erzählung, Bewegungsuntertitel, Bildschirmaufnahme, Zoom, Schwärzung, 3D und wiederverwendbare Bibliotheken. Ideal für Werbung, Erklärvideos, Demos und Bearbeitung.

Was ist Video Forge?

Video Forge ist ein KI-Agenten-Skill zum Erstellen fertiger Videos durch Code-gesteuerte Autorenwerkzeuge. Es kombiniert HTML/GSAP, React, FFmpeg, Aufnahmen, SVG, Sprites, Filmmaterial, Audio und 3D in einem editierbaren Projekt. Der Skill folgt einem Golden Path: Projektumgebung einmalig einrichten, Storyboard-JSON bearbeiten, validieren und über das Skript `run.py` rendern – das Layout und Timing werden vollständig vom Code bestimmt. Er unterstützt Wiederverwendung durch einen Katalog von Komponenten (RenderComp, Curvable, Onda, FFmpeg, Blender) und bietet ausführliche Referenzen für verschiedene Aufgaben wie Motion-Design, Bildschirmaufnahme, Audio und 3D. Der Skill ist als eigenständiges Set von Skripten und Bibliotheken konzipiert, das keine privaten MCPs, Autoren-Verzeichnisse oder kostenpflichtigen Dienste benötigt. Zu den Prüfungen gehören das Überprüfen der Dauer, Abmessungen/FPS und Audio sowie die Erstellung eines Kontaktbogens zur visuellen Inspektion.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/jazzautomations/video-forge/tree/main

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Video Forge?

Erstellen Sie ein editierbares Projekt und ein fertiges Video. Nutzen Sie die Werkzeugkiste gemeinsam: HTML/GSAP, React, FFmpeg, Aufnahmen, SVG, Sprites, Filmmaterial, Audio und 3D. Wählen Sie Werkzeuge pro Szene; Bewahren Sie die Engine eines vorhandenen Projekts. Visuelle Inhalte werden in Code erstellt oder aus vorhandenen Medien bezogen. Ersetzen Sie keine generativen Video-/Bild- oder Talking-Head-Modelle. Die Synthese von Erzählungen und Sprachtranskription sind als Audio-Werkzeuge erlaubt.

Pfade sind relativ zu diesem Verzeichnis, wo immer es installiert ist. Kein privates MCP, bestimmtes Agent/Modell, Autoren-Home-Verzeichnis oder kostenpflichtiger Dienst wird von diesem Skill benötigt.

Goldener Pfad — für ein komplettes Video genau so vorgehen

Erkunden Sie NICHT den Code, erstellen Sie Assets nicht von Hand und passen Sie Pixel nicht manuell an. Der Code besitzt das gesamte Layout-, Schriftanpassungs- und Erzähl-Timing-Mathe. Sie bearbeiten nur Text und Parameter in einer kleinen JSON-Datei. Führen Sie diese vier Schritte in der Reihenfolge aus:

# 1. Lokale Umgebung EINMAL vorbereiten (projektlokales Python + Audio-Modelle)
python3 <skill-verz>/scripts/setup_environment.py --out .video-forge-tools --audio

# 2. Das mitgelieferte Storyboard kopieren; nur dessen Text/Sekunden/Farben/Komponenten bearbeiten.
#    Die gesamte Datei mit Write neu schreiben – niemals exakte/surgical Edits durchführen.
cp <skill-verz>/assets/storyboard-production.json ./storyboard.json

# 3. Validieren, dann in MP4 rendern. run.py ist DER Einstiegspunkt: es wählt den vorbereiteten
#    Interpreter und die Modellpfade aus und führt voice→captions→scenes→sound→render→checks aus.
python3 <skill-verz>/scripts/build_project.py ./storyboard.json --check
python3 <skill-verz>/scripts/run.py ./storyboard.json --out ./film
#    run.py BLOCKIERT, bis das MP4 fertig ist. Bei Unterbrechung denselben Befehl mit
#    --resume fortsetzen (nicht neu starten). Wenn Ihre Bash-Aufrufe ein Timeout haben, --background hinzufügen und
#    stattdessen mit production_job.py status abfragen.

# 4. Die tatsächliche Datei überprüfen
python3 <skill-verz>/scripts/verify_video.py ./film/out/final.mp4 --require-audio

Regeln für ein schwaches Modell: Das Storyboard-JSON ist das EINZIGE, was Sie bearbeiten. Rufen Sie produce.py/build_project.py niemals mit dem systemweiten python3 für das vollständige Video auf – gehen Sie immer über run.py. Bearbeiten Sie niemals eine .tsx/.py-Quelldatei, um Größe, Layout oder Text zu ändern; übergeben Sie es stattdessen als Storyboard-Parameter. Wenn ein Titel oder eine Karte falsch aussieht, ändern Sie seinen JSON-Wert, nicht seinen Code – der Layout-Mathematik ist deterministisch und passt bereits in den Rahmen.

Mit dem kleinsten sinnvollen Kontext beginnen

Lesen Sie Workflow. Leiten Sie die Standardwerte aus der Aufgabenstellung und den bereitgestellten Marken-/Referenzmaterialien ab. Fragen Sie nur nach Material, bei dem Entscheidungen fehlen. Speichern Sie für ein neues Projekt DESIGN.md und STORYBOARD.md: ein Zweck pro Szene, Dauer, Renderer, Asset, Kamerabewegung und Audio-Cue. Passen Sie Abmessungen/FPS an, bevor Sie Renderer mischen.

Für ein vollständiges Werbe-/Tutorialvideo ist das Production-Rezept oben der Standard, nicht der alte, stille Vier-Art-Smoketest. Lesen Sie Produktionsrichtung und beginnen Sie mit assets/storyboard-production.json. scripts/run.py führt den Plan durch Sprache, Wort-Untertitel, kohärente Szenen, Ton, Rendern und Exportprüfungen (es ruft produce.py für Sie mit dem vorbereiteten Interpreter auf). Wenn lokale Audio-Abhängigkeiten fehlen, bereitet scripts/setup_environment.py --out .video-forge-tools --audio ein projektlokales Python vor und meldet Modellpfade. Dieses Setup ist über Coding-Harnesses hinweg wiederverwendbar; es erfordert keine private Umgebung des Autors. Siehe production-direction.md.

Gehen Sie für diesen Pfad mit der Aufgabenstellung und dem Produktionsbeispiel vor; führen Sie den Validator und Produzenten aus, anstatt jede Implementierung zu durchforsten oder jede Abhängigkeit vorher zu prüfen. Der Produzent meldet fehlende Werkzeuge und konkrete Reparaturmaßnahmen. Lesen Sie seine Quelle nur, wenn ein beobachteter Fehler diagnostiziert werden muss. Das treibende Modell wählt die Nachricht und die Szenenparameter aus; bewährter Code liefert Handwerk und Korrektheit. Bezeichnen Sie "es hat ein JSON gefüllt" nicht als End-to-End-Produktionstest.

Wiederverwendungs-Modus ist der Standard: Durchsuchen Sie den Katalog, wählen Sie eine demonstrierte Komponente aus, füllen Sie ihre deklarierten Props, rendern Sie einen kurzen Proof, dann komponieren Sie. Lesen Sie Modell-Gerüst, wenn der Agent Schwierigkeiten hat oder wenn Sie eine Evaluierung erstellen. Eigener Code ist angemessen, wenn der Katalog wirklich nicht passt.

Tatsächlichen Code durchsuchen, bevor Bewegung erfunden wird

python3 <skill-verz>/scripts/catalog.py 'character'
python3 <skill-verz>/scripts/catalog.py 'caption'
python3 <skill-verz>/scripts/catalog.py 'terminal'

Für eine Aufgabenstellung, die zum Startwortschatz (Titel/Charakter/Bildschirm/3D) passt, lassen Sie das Modell assets/storyboard-example.json mit assets/storyboard.schema.json füllen:

python3 <skill-verz>/scripts/build_project.py ./storyboard.json --check
python3 <skill-verz>/scripts/build_project.py ./storyboard.json --out ./my-video

Der Compiler schreibt das Projekt und nur die Abhängigkeiten, die die gewählten Szenen benötigen. Verwenden Sie die tatsächlichen Standardwerte, anstatt ein Schema zu erfinden. Verwenden Sie für ein vollständiges Video den Goldenen Pfad (run.py), anstatt bei diesem nackten, stillen Gerüst stehenzubleiben. Es bereitet tatsächliche Sprache vor, richtet das Skript an gemessenen ASR-Spannen aus, überträgt Untertitel-Zeiten in den Render, mastert den Soundtrack und exportiert ein Kontaktblatt.

Siehe Bibliothekskatalog. Gebündelter Quellcode mit Upstream-Lizenzen:

  • library/vendor/rendercomp/: 50 codegezeichnete Szenen, Typografie, Übergänge, Diagramme und SVG-Charaktere. Jede Komponente exportiert Standardwerte, FPS und Dauer.
  • library/vendor/curvable/: 14 parametrisierte Launch-Video-Szenen; prüfen Sie optionale Shader-/Schriftart-/WASM-Abhängigkeiten, bevor Sie eine Komponente verwenden.
  • library/vendor/onda/: Komponenten, Zod-Schemas, Übergänge und Kompositionshilfen. Parsen Sie Standardwerte durch das Schema; bewahren Sie relative Importe und laden Sie Theme/Schriftarten.
  • library/vendor/ffmpeg/: Ausführbare lokale Python-Bearbeitungshilfen: Schnitte, Zusammenführungen, Zoom/Neurahmen, Pixelierung/Unschärfe, animierte Untertitel, Grading, Mix, Stille, Export und Qualitätssicherung.
  • library/vendor/blender/: Ausführbare headless Blender-Hilfen zur Inspektion, Szenen-Assemblierung, Konvertierung, Optimierung, Baking und Rendern. Erfordert Blender.

Lesen Sie nicht jede Bibliothek auf einmal. UPSTREAM.json dokumentiert Provenienz und LICENSE behält Upstream-Bedingungen bei. Ihr Code wird nicht automatisch durch das Bündeln getestet.

Nach dem Job routen

ArbeitLesen / verwenden
HTML-Bewegung, GSAP, Registry-BlöckeHyperFrames
React-Komposition / Daten-BatchesRemotion, Parameter
Filmmaterial bearbeiten, Grading, Geschwindigkeit, Audio, EndmontageFFmpeg
Browser/Desktop aufnehmen, Cursor-Kamera, Zoom, ZensurBildschirmaufnahme
Charaktere, Illustrationen, 3D-AssetsCharaktere, Asset-Beschaffung
Prozedurale Geometrie, Kamera, Lichter, Materialien, Rigging3D
Erzählung, Wort-Timings, Bewegungsuntertitel, TonAudio und Untertitel, Sounddesign
Werkzeugvergleich und gemischte Engine-PläneRouting

Für heruntergeladene Clips/Stock-Material verwenden Sie Media-Pipeline. Für Bewegungsentscheidungen verwenden Sie Bewegungsprinzipien. Überprüfen Sie Forschung für untersuchte Skills/Bibliotheken und warum sie passen. Siehe Externe Bibliotheken (und research/libraries-catalog.json) für eine lizenzgeprüfte Routing-Karte: was sicher zu bündeln vs. zu zitieren ist, für jede Art von Job. Die HyperFrames-Registry ist eine weitere Wiederverwendungsquelle; fragen Sie sie ab, bevor Sie einen Effekt erstellen. Verwenden Sie installiertes --help; dessen Vertrag kann sich vom heutigen Upstream-Skill unterscheiden.

Verifikation ist Teil der Produktion

Erstellen Sie den Helden-Frame vor dem Animieren. Jeder Frame muss in beliebiger Reihenfolge suchbar sein: keine Echtzeituhr, kein ungesetzter Zufall, keine Live-Netzwerkabhängigkeit oder autonome Animationsschleife. HyperFrames verwendet registrierte pausierte Zeitlinien; Remotion verwendet Frames. Rendern Sie repräsentative Frames und sehen Sie sie sich an; überprüfen Sie Eintritte, Halte, Schnittgrenzen, Untertiteländerungen und das Ende. Beheben Sie Clipping, unleserlichen Text, tote Luft und Audio-Synchronisation.

Wenn nach einem Video gefragt wird, exportieren Sie die vollständige Datei. Ein Standbild ist kein Abschluss.

python3 <skill-verz>/library/vendor/ffmpeg/scripts/probe.py final.mp4 --json
python3 <skill-verz>/scripts/verify_video.py final.mp4 --require-audio
python3 <skill-verz>/library/vendor/ffmpeg/scripts/look.py final.mp4 --tiles 3x2

Probieren UND decodieren Sie den finalen Export. Bestätigen Sie geplante Dauer, Abmessungen/FPS und Audio. Überprüfen Sie tatsächlich das Kontaktblatt. Hören Sie sich Audio an, wenn Wiedergabe verfügbar ist; geben Sie an, wenn nur technische Audio-Checks möglich waren. Schwärzung erfordert die Überprüfung jedes relevanten Intervalls nach Kameratransformationen und das Zensieren von Audio, wenn es das Geheimnis enthält.

Liefern Sie das abspielbare Video, das editierbare Projekt, tatsächliche Checks und jede reale Abhängigkeitsbeschränkung. Bewahren Sie Originale auf. Veröffentlichen/hochladen Sie nicht, geben Sie kein Guthaben aus oder installieren Sie keine Systemsoftware, es sei denn, der Autor der Anfrage autorisiert es. Bestehende Autorisierungen bleiben gültig.

Modell- und Evidenzdisziplin

Verwenden Sie strukturierte Pläne, eine kurze Shortlist, Schema-Standardwerte und ausführbare Helfer, um die Anzahl der Entscheidungen zu reduzieren, die ein schwächeres Modell erfinden muss. Geben Sie konkrete Fehler an das Modell zurück und ändern Sie den kleinsten fehlschlagenden Teil. Lesen Sie Evaluierung für gepaarte starke/schwache Modelltests. Behaupten Sie keine Parität mit einem stärkeren Modell, ohne es zu messen. Wiederherstellungszustand gehört in das Projekt, nicht in einen riesigen Prompt.

Unser eigener Code ist MIT. Engines/Assets/Stimmen behalten ihre eigenen Lizenzen. Optionale Werkzeuge werden nur installiert, wenn sie benötigt werden. Studieren Sie den Katana-Referenz-Workflow, gehen Sie aber nie davon aus, dass Higgsfields gehostete Modelle ein lokaler Code-Renderer sind oder dass Desktop-Katana eine CLI hat.

Verwandte Skills