alyshadotmd/video-editing

B-Roll-Verarbeitung

Das Ziel: Jedes B-Roll-Video wird einmal angesehen, die besten Momente werden ausgewählt, und nur diese Clips werden behalten. Jeder behaltene Clip wird mit einem 1-Sekunden-Puffer geschnitten und nach seinem Inhalt getaggt, sodass jede Aufnahme später ohne erneutes Ansehen des Materials gefunden werden kann.

Diese Fähigkeit ist für Claude Code und Runneth entwickelt. Sie benötigt drei Dinge:

• Eine Möglichkeit, das Video zu sehen: In Runneth sieht es ein Videomodell an. Claude kann kein Video ansehen, also liest es stattdessen Standbilder: kleine Kontaktbögen mit 2 Bildern pro Sekunde, um Momente zu finden (ffmpeg -i IN.mp4 -vf fps=2,scale=160:-2,tile=10x6 sheet_%02d.jpg), Vollbilder, um sie zu beurteilen (ffmpeg -ss <time> -i IN.mov -frames:v 1 frame.jpg), plus das Audiotranskript, falls eines verfügbar ist. Wenn es keine Möglichkeit zur Transkription gibt, arbeite nur mit den Bildern.
• Eine Möglichkeit, Videos zu schneiden: ffmpeg oder ein beliebiger Videoeditor.
• Einen B-Roll-Bibliotheksordner: Ein Ort für Clips plus zwei Arten von Textdateien (ein Index und eine Datei pro Dreh). Vorlagen befinden sich im Ordner templates/ neben dieser Datei.

Sprich mit dem Editor in einfacher Alltagssprache, eine Idee nach der anderen.

Bevor du beginnst: Die Werkzeuge

In Runneth ist alles bereits installiert: Überspringe diesen Abschnitt.

In Claude Code benötigt diese Fähigkeit die kostenlosen Videowerkzeuge, die die video-editing-setup-Fähigkeit installiert. Überprüfe leise, ob ~/.video-editing-tools/bin/ffmpeg -version läuft. Wenn ja, verwende die Werkzeuge in ~/.video-editing-tools/bin (ffmpeg, ffprobe, python) überall dort, wo diese Fähigkeit ffmpeg, ffprobe oder python3 sagt, und fahre fort. Wenn nicht, befolge zuerst die video-editing-setup-Fähigkeit und kehre dann hierher zurück.

Schritt 0: Stelle zuerst eine Frage

Bevor du etwas anderes tust, frage den Editor genau dies als eine Frage mit zwei Optionen:

"Möchtest du, dass ich dir zuerst die Zeitstempel vorschlage, oder soll ich einfach loslegen?"

• Schlage sie mir zuerst vor → befolge jeden Schritt unten, einschließlich Schritt 3 (der Editor wählt aus).
• Einfach loslegen → führe jeden Schritt von Anfang bis Ende durch, ohne anzuhalten. Wähle in Schritt 3 selbst die Momente aus, indem du "Was einen Moment zum Behalten wert macht" verwendest. Frage nicht nach Genehmigung, Projektnamen oder irgendetwas anderem auf dem Weg; lasse Unbekannte als _not given_ in der Drehdatei und erwähne sie einmal am Ende.

Überspringe die Frage, wenn der Editor in seiner Nachricht bereits gesagt hat, welche Option er möchte ("mach einfach", "frag mich nicht", "schlag mir die Auswahlen vor"). Wenn niemand da ist, um zu antworten, behandle es als "einfach loslegen".

Schritt 1: Behalte das vollständige Video, bis die Auswahlen geschnitten sind

1. Speichere jedes B-Roll-Video unverändert und in voller Länge mit einem einfachen Namen: broll-<n>-<was-es-ist>.<ext> (z. B. broll-4-unboxing.mov). Notiere, zu welchem Projekt und welcher Marke es gehört, sowie das Drehdatum.
2. Überprüfe seine Länge und Ausrichtung.
3. Erstelle eine leichte Arbeitskopie zum Ansehen und Auswählen. Mit ffmpeg: ffmpeg -i IN.mov -vf scale=540:960 -c:v libx264 -preset veryfast -crf 25 -g 15 -pix_fmt yuv420p -c:a aac -b:a 96k -movflags +faststart OUT.mp4 (der kurze Keyframe-Abstand sorgt für flüssiges Scrubbing; tausche 540:960 gegen 960:540 bei Querformatmaterial).

Schritt 2: Tagge es

1. Sieh dir die Arbeitskopie an und schreibe eine Arbeitskarte, die jeden Abschnitt des Videos lückenlos abdeckt: Zeitbereich, Tags aus der Tag-Liste der Bibliothek und einen einfachen Satz, was passiert. Unbrauchbare Abschnitte bleiben ebenfalls in der Karte, mit einer kurzen Notiz, warum (unscharf, Überprüfung des Bildausschnitts), damit klar ist, dass sie angesehen wurden. Die Karte dient nur zum Auffinden der Auswahlen; sie wird zusammen mit den Arbeitskopien gelöscht, und nur behaltene Clips erhalten gespeicherte Tags.
2. Überprüfe, was ein KI-Betrachter nicht wissen kann: wessen Material es ist, ob das Produkt auf dem Bildschirm wirklich das Produkt der Marke ist (ein Kaffee im Bild ist nur Kaffee), und alles, was seltsam aussieht. Verwende die kleinen Kontaktbögen, um Momente zu finden, und sieh dir dann die Vollbilder an, bevor du einen Moment als brauchbar bezeichnest. Kleine Bilder verbergen ein weiches Produkt und wohin die Augen des Creators schauen.
3. Eine großartige Idee, die sich als unbrauchbar herausstellt, wird zu einer Nachdreh-Notiz.
4. Schreibe einen einfachen Satz, der den Zweck jedes Videos benennt (wofür es gefilmt wurde, um es zu zeigen), ermittelt allein aus dem Material. Schritt 3 behält immer den Moment, der ihn zeigt, falls er brauchbar ist.
5. Gib an, ob jedes Video Lifestyle (kein Produkt darin, für jede Marke wiederverwendbar) oder Produkt-Material ist.

Schritt 3: Wähle die Momente aus

Wenn der Editor zuerst eine Vorschau möchte:

1. Gib dem Editor die Arbeitskopien und eine kurze Liste der stärksten Momente aus deiner Arbeitskarte als Ausgangspunkt.
2. Der Editor markiert jeden Moment, den er behalten möchte: Startzeit, Endzeit und warum er ihn ausgewählt hat. Jedes Format ist in Ordnung (eine Auswahl-App, eine Tabellenkalkulation, ein Notizdokument, Zeitstempel in einer Nachricht), solange jede Auswahl einen Start, ein Ende und einen Grund hat.
3. Die Gründe sind genauso wichtig wie die Zeiten. Auf diese Weise lernt diese Fähigkeit den Geschmack des Editors (Schritt 4, Punkt 6).

Wenn der Editor gesagt hat, einfach loslegen:

1. Wähle die Momente selbst aus, indem du "Was einen Moment zum Behalten wert macht" in der Reihenfolge verwendest. Behalte immer den Zweck des Videos (Regel 4) und archiviere die zeitlosen Aufnahmen (Regel 9).
2. Wenn dieselbe Aktion mehr als einmal vorkommt, behalte die sauberste Aufnahme.
3. Schreibe für jede Auswahl einen Start, ein Ende und einen einzeiligen Grund.
4. Überprüfe jede Auswahl auf Vollbildern, bevor du sie schneidest, mindestens jede halbe Sekunde von Anfang bis Ende (nicht nur die Mitte): Das Produkt ist scharf, die Augen erfüllen Regel 3 in jedem Bild, und die Zeiten stimmen (KI-Zeiten sind ungefähr, nicht exakt). Verwerfe jede Auswahl, die dies nicht erfüllt, oder beschneide sie auf den Abschnitt, der es erfüllt.
5. Vergleiche vor dem Speichern die Auswahlen jedes Videos nebeneinander. Wenn zwei Auswahl fast dieselbe Aufnahme zeigen (gleicher Bildausschnitt, gleiches Motiv), behalte nur die mit der meisten Aktion und verwerfe die andere (Regel 11).

Schritt 4: Schneide die Auswahlen und speichere sie

1. Schneide jede Auswahl in voller Qualität aus der Originaldatei, mit 1 Sekunde zusätzlichem Material vor und nach den Auswahlzeiten, begrenzt auf den Anfang und das Ende des Videos. Benenne jeden Clip <drehdatum>-v<video>-<auswahl>-<was-passiert>.mp4 (z. B. 2026-10-22-v4-4-unbox-tear-top.mp4). Das Datum verhindert Namenskonflikte, da alle Drehs für eine Marke im selben Ordner landen und die Videoumrissnummern bei jedem Dreh neu beginnen. Mit ffmpeg ist ein hochwertiger Schnitt -c:v libx264 -crf 16. Wenn ein Clip zu groß ist, um an seinen Bestimmungsort verschoben zu werden, erhöhe den crf etwas (18), anstatt ihn zu verkürzen.
2. Eine Auswahl ohne Länge (Start gleich Ende) ist eine Notiz, kein Clip. Sie wird in die Nachdreh-Notizen der Drehdatei aufgenommen (z. B. "unscharf, nachdrehen").
3. Speichere die Clips im B-Roll-Ordner der Marke, dem einzigen Ort, an dem das gesamte B-Roll dieser Marke über alle Projekte hinweg lebt.
4. Schreibe die Drehdatei, eine pro Dreh, unter shoots/<drehdatum>-<marke>.md im Bibliotheksordner (Vorlage: templates/shoot-file.md): den Zweck jedes Videos, dann jeden behaltenen Clip mit seinem Dateinamen, der Auswahlzeit, Tags, was passiert, und warum er ausgewählt wurde. Die Gründe des Editors kommen wörtlich hinein; Gründe, die die KI geschrieben hat, werden mit "(KI)" markiert. Beende es mit Nachdreh-Notizen und den Aufnahmen, die dieser Marke noch fehlen.
5. Füge jeden Clip unter seinen Tags in der "Finde nach Tag"-Tabelle des Bibliotheksindex hinzu. Starte den Index beim ersten Mal mit templates/b-roll-library-index.md. Lösche dann die originalen Vollvideos und alle Arbeitskopien. Nur die ausgewählten Clips bleiben erhalten.
6. Lerne aus den Gründen: Verwandle jeden der Gründe des Editors in eine allgemeine Regel und füge sie in "Was einen Moment zum Behalten wert macht" unten ein (oder in die B-Roll-Auswahlfähigkeit, wenn es darum geht, wo ein Clip in einem Video platziert wird). Halte die Liste kurz: Umschreibe und kombiniere Regeln, anstatt neue hinzuzufügen. Nur die Gründe des Editors ändern die Regeln; mit "(KI)" markierte Gründe bleiben, wie sie sind.
7. Wenn der Editor einen behaltenen Clip später ablehnt, lösche ihn, entferne ihn aus der Drehdatei und dem Index und verwandle seinen Grund in eine Regel.

B-Roll später finden

Wenn jemand nach einer bestimmten Art von Aufnahme fragt ("Unboxing für diese Marke", "ich, müde aussehend"), suche in der "Finde nach Tag"-Tabelle des Bibliotheksindex und gib die passenden Clips zurück. Ein nackter Tag (pet) stimmt mit jedem Detail darunter überein (pet:cat, pet:dog). Lifestyle-Clips gelten für jede Marke; Produkt-Clips gehören zu ihrer eigenen Marke.

Was einen Moment zum Behalten wert macht

Diese Regeln stammen von den Auswahlen und Gründen eines echten Editors bei einem UGC-Produktdreh. Wende sie in der Reihenfolge an und ersetze sie dann durch die Regeln deines eigenen Editors, sobald seine Gründe eingehen.

1. Bewegung. Der beste Moment in einer Aufnahme ist der, in dem sich etwas ändert: eine Kopfdrehung, eine Handgeste, ein neuer Gesichtsausdruck, ein Haustier, das hereinkommt. Eine Aufnahme, in der sich nichts bewegt, wirkt wie ein Foto. Eine statische Aufnahme wird nur als kurzer Akzent behalten (eine saubere Produkt-Nahaufnahme); tagge sie mit static.
2. Ein Gesicht, das das Gefühl darstellt. Ein Seufzer, ein Gähnen, den Kopf in den Händen, ein breites Lächeln. Der Gesichtsausdruck zeigt die Stimmung der Zeile von selbst.
3. Augen mit Absicht. Der Blick in die Kamera zählt nur, wenn er beabsichtigt ist: ein Selfie, Sprechen oder Reagieren auf den Zuschauer oder das Zeigen des Produkts auf die Linse. Ansonsten gehören die Augen zum Motiv der Aufnahme (das Getränk, der Laptop, die Verpackung). Ein Creator, der einfach nur dasitzt und in die Linse schaut oder zur Seite blickt, überprüft sich selbst im Bild (oft auf einem daneben stehenden Telefonbildschirm), und dieser Abschnitt ist nicht die Aufnahme. Die echte Aufnahme ist der Abschnitt, in dem er nicht überprüft: das Gähnen, das Rühren, der Seufzer. Beginne nach einer Überprüfung und ende vor der nächsten; ein Abschnitt, in dem mehr als einmal überprüft wird, wird übersprungen.
4. Der Zweck des Videos wird immer ausgewählt. Jedes B-Roll-Video wurde gefilmt, um etwas zu zeigen, und der Moment, der es am deutlichsten zeigt, ist immer ein Behalter. Lies den Zweck aus dem Material selbst ab: worauf die meiste Zeit des Videos verwendet wird oder was der Creator aufbaut und dann zeigt. Der Zweck kann alles sein: ein Produkt, das glatt ausgießt; das Pulver eines Mitbewerbers, das klumpt; ein chaotischer "Vorher"-Zustand; ein Haustier, das etwas Lustiges tut. Das Produkt bei der Arbeit zu zeigen, ist eine Art von Zweck, nicht die Regel. Wenn der Moment, der den Zweck zeigt, nicht brauchbar ist (verschwommen, außerhalb des Bildausschnitts), wird er stattdessen zur ersten Nachdreh-Notiz.
5. Reales Leben im Bild. Haustiere, kleine lustige Momente (eine leere Verpackung wegwerfen) und andere ungeplante Details lassen B-Roll echt wirken und geben den Zuschauern etwas zum Anschauen.
6. Die natürliche, schmeichelhafte Version. Wenn der Creator dieselbe Aktion zweimal ausführt, gewinnt diejenige, die natürlich aussieht und wie ein echter Mensch (ein Gähnen mit der Hand vor dem Mund).
7. Scharfer Fokus. Eine Aufnahme zählt, wenn das Produkt und das Gesicht scharf sind. Beurteile die Schärfe auf einem Vollbild, niemals auf einem Kontaktbogen. Wenn das Produkt an keiner Stelle der Aufnahme scharf ist, ist die gesamte Aufnahme unbrauchbar. Eine großartige Idee, die unscharf geworden ist, wird zu einer Nachdreh-Notiz.
8. Das gesamte Produkt. Zeige die vollständige Verpackung und drehe sie, um die Rückseite zu zeigen. Drehen fügt Bewegung hinzu und führt das Produkt ein, und die Rückseite enthält Details wie Inhaltsstoffe.
9. Zeitlose Aufnahmen, jedes Mal. Archiviere diese bei jedem Produktdreh, auch wenn das aktuelle Video sie nicht verwendet: Unboxing (Aufreißen, hineinsehen, eines herausnehmen), Produkt in Gebrauch (öffnen, eingießen, mischen, nippen), auf die Inhaltsstoffe zeigen, Creator, der mit dem Produkt lächelt, saubere Produkt-Nahaufnahme, das Produkt halten. Jede gute Nahaufnahme ist ebenfalls archivierenswert (ein Glas, das zur Linse gehalten wird, Hände, die mischen); tagge sie mit closeup:<was>, damit sie als kurzer Akzent verwendet werden kann.
10. Kurz ist in Ordnung. Ein sauberer 2-Sekunden-Ausschnitt ist ein brauchbarer Clip.
11. Eine Version jeder Aufnahme. Wenn zwei Momente fast gleich aussehen (dasselbe Glas nah an der Linse), archiviere nur den, in dem etwas passiert (es umrühren). Die statische Version wird nie daneben gespeichert.
12. Schneide auf die Hauptaktion. Jedes B-Roll-Video hat eine Höhepunktsbewegung, für die es gefilmt wurde (die Decke über sich hochziehen, das Eingießen, das Gähnen). Die Auswahl enthält diese Bewegung mit nur einem kurzen Takt davor. Vorbereitung und Herumfummeln (die Decke anpassen, das Kissen zurechtrücken, die Verpackung bereitlegen) bleiben außen vor, auch wenn sie im selben Abschnitt sind.

Regeln für jeden Tag

• Jeder behaltene Clip hat einen Start, ein Ende, Tags, eine einfache Beschreibung und einen Grund.
• Tags beschreiben nur, was im Clip zu sehen ist, sodass jeder, der denselben Clip taggt, dieselben Tags auswählen würde, ohne die Marke oder das Drehbuch zu kennen. Was ein Clip für ein Video bedeutet (ein "Vorher"-Shot, ein Schmerzpunkt), wird später in der B-Roll-Auswahlfähigkeit entschieden.
• Füge das Detail nach dem Doppelpunkt hinzu (tag:<was>), wann immer es sichtbar ist und jemand danach suchen könnte.
• Zeiten stammen aus der Zeitleiste der Originaldatei. Die Drehdatei zeichnet die Auswahlzeiten auf; der Clip selbst beginnt 1 Sekunde früher.
• Von der KI generierte Zeiten sind ungefähr, nicht exakt. Überprüfe sie auf Vollbildern, bevor du schneidest.