Communitygithub.com

long-video-render

Erstellen Sie das fertige Video und führen Sie die Überprüfungsschleife durch. Baut den Schnitt aus Clips (oder Bildern mit Kamerabewegungen), Stimme, Sound-Stems und Untertiteln zusammen, rendert eine Vorschau in niedriger Qualität mit eingebrannten Szenennummern und Zeiten, sammelt und wendet Änderungen an, und rendert bei Zustimmung das finale Video in hoher Qualität.

Was ist long-video-render?

Dieses Skill ist der neunte und letzte Schritt des Long-Video-Workflows. Es nimmt alle in den vorherigen Schritten erstellten Assets (Videoclips, Bilder, Sprachaufnahmen, Sound-Stems) und setzt sie zu einem fertigen Video zusammen. Zunächst wird eine Vorschauversion in niedriger Auflösung mit eingebrannten Szenennummern und Zeitstempeln gerendert, damit der Kunde diese überprüfen kann. Die Feedback-Schleife sammelt Änderungswünsche, klassifiziert sie (Schnitt, Bild, Ton, Sprache, Story) und leitet sie an die entsprechenden vorherigen Schritte weiter, falls nötig. Nach expliziter Freigabe einer bestimmten Vorschauversion wird das finale Video in hoher Qualität (H.264, Ziel-Lautstärke) erstellt. Das Skill unterstützt sowohl einen gebündelten FFmpeg-Renderer als auch optionale externe Videobearbeitungsprogramme wie FilmCraft oder EffectCraft.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samanfirouzi/long-video-skill/tree/HEAD/skills/long-video-render

In Ihrer bevorzugten KI fragen

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

Dokumentation

Long Video Render

Stufe 9 des Long-Video-Workflows. Ausgabe: Vorschau-Renderings (niedrige Qualität), bis der Benutzer zustimmt, dann ein finales Video in hoher Qualität.

Eine Szene ist ein Clip des Drehbuchs, nummeriert in der Reihenfolge des Videos, wie in den vorherigen Schritten. Szenennummern werden in das Vorschau-Video eingebrannt, damit der Prüfer darauf verweisen kann.

Vorbereitung

  1. Finden Sie das Projekt in ~/.long-video/projects/<slug>/. video-script.md mit status: approved ist erforderlich.
  2. Laden Sie die Projektkonfiguration: Auflösung, Seitenverhältnis, Untertitel-Modus (visuals.captions), Lautstärkeanforderungen, Plattform.
  3. Überprüfen Sie ffmpeg und ffprobe (ffmpeg -version). Der gebündelte Renderer benötigt ffmpeg mit libx264 und libass.
  4. Wenn render/ bereits existiert, fragen Sie: Fortsetzen (Versionen auflisten) oder Neustarten.

Schritt 1: Bestandsaufnahme

Überprüfen Sie jede Szene und listen Sie auf, was existiert:

ElementWoVerwendung
Videoclipclips/scene-<NNN>_clip.* (oder _take2 und später, je nach Freigabe)Das Bild der Szene
Nur Bilderframes/scene-<NNN>_start.*Ein Standbild mit einer Kamerabewegung aus dem Drehbuch (Push-In, Pull-Out, Pan)
Stimmeaudio/lines/scene-<NNN>_<sprecher>_<NN>.*Erzählung und Dialog
Sound-Stemssound/mix/sfx_track.wav, amb_track.wav, music_track.wavEffekte, Atmosphäre, Musik

Melden Sie die Lücken in einer kurzen Tabelle. Eine Szene ohne Clip und ohne Bild ist ein Hindernis: Listen Sie diese Szenen auf und bieten Sie an, zu long-video-keyframes oder long-video-clips zurückzukehren. Fehlende Stimme oder Sound ist nur erlaubt, wenn der Benutzer diese Schritte übersprungen hat. Wenn ein Schritt übersprungen wurde, fragen Sie nicht erneut danach.

Wenn der Clips-Schritt übersprungen wurde (clips_mode: images-only), wird jede Szene zu einem Standbild mit einer Kamerabewegung aus dem Drehbuch.

Schritt 2: Auswahl des Montagewerkzeugs

  1. Prüfen Sie auf einen Videobearbeiter, den Claude steuern kann: einen verbundenen Bearbeitungs-MCP-Server in dieser Sitzung oder ein CLI auf dem Gerät (FilmCraft: filmcraft-cli commands; EffectCraft: effectcraft-cli --help). Siehe ../long-video-sound/references/tools.md, Abschnitt 5.
  2. Wenn einer verfügbar ist, fragen Sie: Verwenden (der Benutzer kann das Projekt öffnen und anpassen) oder den gebündelten Renderer verwenden. Standardmäßig den gebündelten Renderer. Wenn der Benutzer den Editor wählt, lesen Sie zuerst dessen Befehlsliste und Dokumentation, arbeiten Sie an einer Kopie, fragen Sie vor dem Installieren oder Erstellen von etwas und behalten Sie dieselben Dateinamen bei.
  3. Sagen Sie, welches Werkzeug verwendet wird.

Der Rest dieses Skills beschreibt den gebündelten Renderer. Mit einem Editor führen Sie die gleichen Schritte über dessen Befehle durch und exportieren die Vorschau- und Finaldateien in dieselben Ordner und mit denselben Namen.

Schritt 3: Erstellen der Schnittliste

Lesen Sie references/edl-format.md. Schreiben Sie render/edl.json aus den Projektdateien:

  • Ein Eintrag pro Szene mit ihrer Dauer (aus dem Drehbuch oder der tatsächlichen Cliplänge, wenn diese kürzer oder länger ist), Bildquelle, Kamerabewegung für Standbilder und Ausgangsüberblendung,
  • Sprachplatzierungen: Startzeit der Szene plus ein kurzer Offset (standardmäßig 0,3 s), Zeilen in Reihenfolge mit kleinen Lücken,
  • die Sound-Stems,
  • Untertitel aus dem Sprachtext (Start und Ende aus der Dauer jeder Sprachdatei), wenn die Konfiguration Untertitel wünscht,
  • Breite, Höhe und fps aus der Konfiguration. Standard-fps ist 24. Das Standard-Lautstärkeziel ist -14 LUFS mit True Peak unter -1,5 dBTP.

Regeln:

  • Verwenden Sie die genauen Szenendauern aus dem genehmigten Drehbuch. Dehnen oder verkürzen Sie die Geschichte nicht.
  • Ein Clip, der länger als seine Szene ist, wird am Ende gekürzt. Ein Clip, der kürzer als seine Szene ist, hält sein letztes Bild. Melden Sie beides.
  • Eine Sprachzeile, die über das Ende ihrer Szene oder über das Videoende hinausgeht, wird als Warnung gemeldet.
  • Überblendungen: Standardmäßig cut. fade (Abdunkeln zu Schwarz) nur dort, wo das Drehbuch es sagt. Cross-Dissolves benötigen ein Editor-Tool.
  • Überprüfen Sie den Plan vor dem Rendern: node <skill-ordner>/scripts/build-render.mjs render/edl.json review render/review --plan.

Zeigen Sie eine kurze Zusammenfassung: Anzahl der Szenen, Gesamtlaufzeit im Vergleich zum Ziel, Clips versus Standbilder, Warnungen. Beheben Sie Probleme, die behoben werden können, ohne die Geschichte zu ändern. Fragen Sie den Benutzer nach allem, was nicht behoben werden kann.

Schritt 4: Rendern der Vorschauversion

Vorschauqualität: niedrige Auflösung (ca. 360p), hohe Komprimierung, Szenennummer und Zeit eingebrannt in der oberen linken Ecke und Untertitel, wenn die Konfiguration eingebrannte Untertitel verwendet.

node <skill-ordner>/scripts/build-render.mjs render/edl.json review render/review --version 1
  • Ausgabe: render/review/<slug>_review_v1.mp4, plus eine .report.json mit Dauer, Größe und Lautstärke.
  • Szenensegmente werden zwischengespeichert. Spätere Vorschauen rendern nur geänderte Szenen, sind also viel schneller.
  • Für Videos, die länger als ein paar Minuten sind, führen Sie den Befehl im Hintergrund aus und warten Sie auf das Ende. Nicht abfragen.
  • Wenn der Untertitel-Modus srt ist, wird eine .srt-Datei neben dem Video geschrieben.

Überprüfen Sie den Bericht: tatsächliche Dauer im Vergleich zur geplanten, Lautstärke, Streams. Teilen Sie dem Benutzer dann den vollständigen Pfad und die Größe mit.

Sagen Sie, wie Sie überprüfen können: Sehen Sie sich die Datei an, notieren Sie die Szenennummer und die Zeit, die in der Ecke mit jedem Kommentar angezeigt werden. Claude sendet oder lädt die Datei nicht hoch. Der Benutzer teilt sie mit dem Kunden. Bieten Sie an, einen Upload vorzubereiten, nur wenn der Benutzer fragt, und fragen Sie zuerst.

Schritt 5: Änderungen sammeln

Fragen Sie: „Änderungen? Wenn es endgültig ist, sagen Sie es, und ich werde die hochqualitative Version rendern.“

Der Benutzer kann das Feedback des Kunden einfügen. Lesen Sie references/review-feedback.md. Für jeden Kommentar:

  1. Finden Sie die Szenennummer oder die Zeit, auf die er sich bezieht. Wenn der Kommentar vage ist, stellen Sie eine kurze Frage.
  2. Klassifizieren Sie ihn und wählen Sie die Route:
    • Schnittebene (Trimmen, Länge, Reihenfolge, Untertiteltext, Untertitel ein/aus, Überblendung, Pegel von Stimme, Musik oder Effekten): hier in edl.json oder der Verstärkung der Stems beheben.
    • Bild einer Szene (Aussehen, Charakter, Komposition, Bewegung): zurück zu long-video-keyframes oder long-video-clips für diese Szenen. Neue Dateien erhalten die Namen im Stil _take2. Dann die Schnittliste aktualisieren.
    • Sprachzeile (Vortrag, Aussprache, Wortlaut): long-video-voice für diese Zeilen. Eine Wortlautänderung am genehmigten Drehbuch benötigt die Zustimmung des Benutzers und eine Drehbuchrevision.
    • Sound (Effekt, Atmosphäre, Musik): long-video-sound für diese Cues, dann noch einmal mischen.
    • Geschichte oder Struktur (Szenen hinzufügen oder entfernen): long-video-director, dann nur die betroffenen nachgelagerten Szenen wiederholen.
  3. Schreiben Sie die Liste in render/review-log.md mit Version, Szene, Anfrage, Route und Status.
  4. Zeigen Sie dem Benutzer den Plan in einer kurzen Tabelle. Fragen Sie nach einem Ja, bevor Sie eine Regeneration durchführen, die Credits oder Zeit kostet.
  5. Wenden Sie die Änderungen an, rendern Sie dann die nächste Vorschau (--version 2 usw.). Behalten Sie jede ältere Vorschaudatei.
  6. Teilen Sie dem Benutzer mit, was sich geändert hat, Szene für Szene, und den neuen Dateipfad.

Wiederholen Sie dies, bis der Benutzer zustimmt. Schweigen oder „sieht gut aus soweit“ ist keine Zustimmung.

Schritt 6: Rendern des finalen Videos

Nur, nachdem der Benutzer explizit gesagt hat, dass eine bestimmte Vorschauversion endgültig ist.

  1. Bestätigen: „Finale Version aus Vorschau v rendern?“ Stellen Sie sicher, dass die Schnittliste dieser Version entspricht und dass im Prüfprotokoll kein offener Änderungsantrag mehr vorhanden ist.
  2. Finale Qualität: Auflösung der Konfiguration, hochwertiges H.264 (crf 18, slow preset), AAC 192k, Zwei-Durchgang-Lautstärkenormalisierung auf das Ziel, keine Vorschaulabel. Untertitel werden nur eingebrannt, wenn die Konfiguration eingebrannt sagt. Andernfalls wird eine .srt-Datei geschrieben.
  3. Ausführen, im Hintergrund für lange Videos:
node <skill-ordner>/scripts/build-render.mjs render/edl.json final render/final
  1. Überprüfen Sie mit dem Bericht und ffprobe: Dauer stimmt mit dem Plan überein, Auflösung und fps sind korrekt, es gibt einen Video- und einen Audiostream, die Lautstärke liegt nahe am Ziel (innerhalb von etwa 1 LU) und der True Peak liegt unter -1 dBFS.
  2. Optional auf unerwartete schwarze Bilder und lange Stille prüfen: ffmpeg -i DATEI -vf blackdetect=d=0.5 -af silencedetect=noise=-50dB:d=3 -f null -. Melden Sie die Ergebnisse.
  3. Aktualisieren Sie project.json: "stage": "final-rendered", "final_video": "<pfad>" und die genehmigte Vorschauversion.
  4. Teilen Sie dem Benutzer den vollständigen Pfad, die Größe und die Dauer mit. Erinnern Sie an die Credits in sound/credits.md für die Videobeschreibung.
  5. Bieten Sie an, mit long-video-publish fortzufahren (YouTube-Titeloptionen, Beschreibung, Tags und Thumbnail-Prompt). Starten Sie es nur, wenn der Benutzer zustimmt. Nicht veröffentlichen oder hochladen. Starten Sie keine andere spätere Stufe, es sei denn, der Benutzer fragt danach und diese Stufe existiert.

Regeln

  • Rendern Sie niemals die finale Version ohne explizite Zustimmung zu einer bestimmten Vorschauversion.
  • Ändern Sie niemals das genehmigte Drehbuch. Wenn Feedback es erfordert, leiten Sie es weiter und fragen Sie.
  • Senden, teilen oder laden Sie niemals ein Video ohne die eindeutige Anfrage des Benutzers hoch.
  • Löschen Sie niemals ältere Vorschau-Renderings.
  • Generieren Sie niemals Bilder, Clips, Sprache oder Sound ohne die Zustimmung des Benutzers zum Plan neu.
  • Halten Sie Chatnachrichten kurz. Fügen Sie die Änderungsliste in render/review-log.md ein.

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

long-video-assets

Video and animation skill. Build the visual foundation for a long video from an approved story. Extracts the recurring characters, environments and key objects, helps the user choose one art style from suggested options (10 at a time, more on request), then writes image generation prompts for every character (portrait plus character sheet), environment and object, all sharing one locked style. Can also generate the images (installed tool, API, MCP or browser) or hand the user a folder and file names to fill. Use after lon

long-video-director

Turn an approved story into a shot-by-shot video script, acting as the director. Asks whether the video uses a narrator or characters who speak (or both), suggests professional filming choices (camera type, lenses, camera movement, lighting, color, pacing), saves them as a separate film style file, then writes a script that matches the project config. Outputs film-style.md and video-script.md. Use after long-video-story (and long-video-assets) are done, or when the user asks for the video script, shot list, camera style or lighting plan.

long-video-keyframes

Create the start and end frame image for every scene (clip) of the approved video script. Writes one image prompt per frame with a fixed file name that holds the scene number and start or end, makes a folder for the images, and can generate the images with an available image tool, or hand the prompts to the user all at once or one by one. Use after long-video-director, or when the user asks for start frames, end frames, keyframes or scene images.

long-video-sound

Video and animation skill. Create the sound effects, ambience and background music for the video and place them on the timeline. Plans the sound design from the approved script, sources or makes each sound (Openverse for openly licensed recordings and music, Earshot to make sounds from words and to listen to and judge sounds, Clipwing real-sfx to place real sounds on exact frames), records licences and credits, and mixes separate stems (effects, ambience, music) with the music ducked under speech. Or gives the user a fold

long-video-story

Agree on the story for a long video. The user either supplies a story or asks Claude to write one. When Claude writes, it first asks which story style to use (for example niche discovery, or a provocative-questions narration), runs that style's skill, and revises until the user approves. Use after long-video-setup, or when the user says "story for my video", "give me an idea", or wants to change an unapproved story. Ends only when the user explicitly approves the story.

long-video-voice

Create the spoken audio (narration and character voices) for the approved video script. First decides whether the video needs speech and asks the user to confirm. If yes, builds a voice cast (narrator plus each speaking character), makes a short sample of each voice with an available tool such as an ElevenLabs MCP and asks the user to approve the voices, then generates one audio file per spoken line with a name that holds the scene number and speaker. Or gives the user the lines, file names and folder to record or generate themselves. Use after long-video-clips (or long-video-keyframes), or when the user asks for narration, voiceover, voices or dialogue audio.

Verwandte Skills