alyshadotmd/video-editing

Procesamiento de B-roll

El objetivo: cada video B-roll se ve una vez, se seleccionan los mejores momentos y solo se conservan esos clips. Cada clip conservado se corta con un búfer de 1 segundo y se etiqueta según su contenido, para que cualquier toma pueda encontrarse más tarde sin tener que volver a ver el metraje.

Esta habilidad está diseñada para Claude Code y Runneth. Necesita tres cosas:

• Una forma de ver el video: en Runneth, un modelo de video lo ve. Claude no puede ver video, así que lee fotogramas fijos en su lugar: pequeñas hojas de contacto de 2 fotogramas por segundo para encontrar momentos (ffmpeg -i IN.mp4 -vf fps=2,scale=160:-2,tile=10x6 sheet_%02d.jpg), fotogramas a tamaño completo para juzgarlos (ffmpeg -ss <time> -i IN.mov -frames:v 1 frame.jpg), además de la transcripción de audio cuando esté disponible. Si no hay forma de transcribir, trabaja solo con los fotogramas.
• Una forma de cortar video: ffmpeg, o cualquier editor de video.
• Una carpeta de biblioteca de B-roll: un lugar para los clips más dos tipos de archivos de texto (un índice y un archivo por sesión de grabación). Las plantillas están en la carpeta templates/ junto a este archivo.

Habla con el editor en lenguaje cotidiano, una idea a la vez.

Antes de empezar: las herramientas

En Runneth, todo está ya instalado: omite esta sección.

En Claude Code, esta habilidad necesita las herramientas de video gratuitas que instala la habilidad video-editing-setup. Verifica silenciosamente que ~/.video-editing-tools/bin/ffmpeg -version funcione. Si es así, usa las herramientas en ~/.video-editing-tools/bin (ffmpeg, ffprobe, python) donde esta habilidad diga ffmpeg, ffprobe o python3, y continúa. Si no funciona, sigue primero la habilidad video-editing-setup y luego vuelve aquí.

Paso 0: Haz una pregunta primero

Antes de hacer cualquier otra cosa, pregúntale al editor exactamente esto, como una pregunta con dos opciones:

"¿Quieres que te proponga las marcas de tiempo primero, o que me ponga directamente a trabajar?"

• Propónmelas primero → sigue cada paso a continuación, incluido el Paso 3 (el editor elige).
• Ponte a trabajar directamente → ejecuta cada paso de principio a fin sin detenerte. En el Paso 3, elige los momentos tú mismo usando "Qué hace que un momento valga la pena conservar". No pidas aprobación, nombres de proyectos ni nada más por el camino; deja los valores desconocidos como _no proporcionado_ en el archivo de la sesión de grabación y menciónalos una vez al final.

Omite la pregunta si el editor ya dijo qué opción prefiere en su mensaje ("hazlo", "no me preguntes", "propón las selecciones"). Si no hay nadie para responder, trátalo como "ponte a trabajar directamente".

Paso 1: Conserva el video completo hasta que las selecciones estén cortadas

1. Guarda cada video B-roll intacto y con su duración completa, con un nombre simple: broll-<n>-<lo-que-es>.<ext> (por ejemplo broll-4-unboxing.mov). Anota a qué proyecto y marca pertenece, y la fecha de la sesión de grabación.
2. Verifica su duración y orientación.
3. Crea una copia de trabajo ligera para visualizar y seleccionar. Con 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 (el intervalo corto de fotogramas clave permite un desplazamiento suave; intercambia 540:960 por 960:540 en metraje apaisado).

Paso 2: Etiquétalo

1. Reproduce la copia de trabajo y escribe un mapa de trabajo que cubra cada tramo del video, sin espacios: rango de tiempo, etiquetas de la lista de etiquetas de la biblioteca y una frase simple de lo que sucede. Los tramos inutilizables también quedan en el mapa, con una breve nota sobre por qué (desenfoque, comprobación del encuadre), para que quede claro que se han revisado. El mapa es solo para encontrar las selecciones; se elimina junto con las copias de trabajo, y solo los clips conservados reciben etiquetas guardadas.
2. Comprueba lo que un visor de IA no puede saber: de quién es el metraje, si el producto en pantalla es realmente el producto de la marca (un café en la toma es solo café), y cualquier cosa que parezca extraña. Usa las pequeñas hojas de contacto para encontrar momentos, luego mira los fotogramas a tamaño completo antes de considerar cualquier momento utilizable. Los fotogramas pequeños ocultan un producto suave y hacia dónde miran los ojos del creador.
3. Una gran idea que resultó inutilizable se convierte en una nota de regrabación.
4. Escribe una línea simple que nombre el propósito de cada video (para qué se filmó), deducido solo del metraje. El Paso 3 siempre conserva el momento que lo muestra, si es utilizable.
5. Indica si cada video es lifestyle (sin producto, reutilizable para cualquier marca) o producto.

Paso 3: Selecciona los momentos

Si el editor quiere una propuesta primero:

1. Proporciona al editor las copias de trabajo y una lista breve de los momentos más fuertes de tu mapa de trabajo como punto de partida.
2. El editor marca cada momento que quiere conservar: hora de inicio, hora de finalización y por qué lo eligió. Cualquier formato vale (una aplicación de selección, una hoja de cálculo, un documento de notas, marcas de tiempo en un mensaje), siempre que cada selección tenga un inicio, un final y una razón.
3. Las razones importan tanto como las marcas de tiempo. Así es como esta habilidad aprende el gusto del editor (Paso 4, punto 6).

Si el editor dijo ponte a trabajar:

1. Elige los momentos tú mismo, usando "Qué hace que un momento valga la pena conservar" en orden. Siempre conserva el propósito del video (regla 4) y archiva las tomas perennes (regla 9).
2. Cuando la misma acción ocurre más de una vez, conserva la toma más limpia.
3. Escribe un inicio, un final y una razón de una línea para cada selección.
4. Comprueba cada selección en fotogramas a tamaño completo antes de cortar, al menos cada medio segundo desde el inicio hasta el final (no solo el medio): el producto está nítido, los ojos cumplen la regla 3 en cada fotograma, y las marcas de tiempo son correctas (las marcas de la IA son aproximadas, no exactas). Descarta cualquier selección que no pase, o recórtala al tramo que sí pase.
5. Antes de guardar, compara las selecciones de cada video una al lado de la otra. Cuando dos selecciones muestran casi la misma toma (mismo encuadre, mismo sujeto), conserva solo la que tenga más acción y descarta la otra (regla 11).

Paso 4: Corta las selecciones y guárdalas

1. Corta cada selección a máxima calidad desde el archivo original, con 1 segundo de metraje adicional antes y después de las marcas de tiempo de la selección, limitado al inicio y final del video. Nombra cada clip <fecha-sesión>-v<video>-<selección>-<lo-que-sucede>.mp4 (por ejemplo 2026-10-22-v4-4-unbox-tear-top.mp4). La fecha evita que los nombres choquen, ya que todas las sesiones de una marca caen en la misma carpeta y los números de video se reinician en cada sesión. Con ffmpeg, un corte de alta calidad es -c:v libx264 -crf 16. Si un clip es demasiado grande para moverlo donde debe ir, sube un poco el crf (18) en lugar de acortarlo.
2. Una selección sin duración (inicio igual a final) es una nota, no un clip. Va en las notas de regrabación del archivo de la sesión (por ejemplo "desenfocado, regrabar").
3. Guarda los clips en la carpeta de B-roll de la marca, el único lugar donde vive todo el B-roll de esa marca en todos los proyectos.
4. Escribe el archivo de la sesión, uno por sesión, en shoots/<fecha-sesión>-<marca>.md dentro de la carpeta de la biblioteca (plantilla: templates/shoot-file.md): el propósito de cada video, luego cada clip conservado con su nombre de archivo, marca de tiempo de selección, etiquetas, lo que sucede y por qué se eligió. Las razones del editor van textualmente; las razones escritas por la IA se marcan "(IA)". Termínalo con notas de regrabación y las tomas que aún faltan para esta marca.
5. Añade cada clip bajo sus etiquetas en la tabla "Buscar por etiqueta" del índice de la biblioteca. La primera vez, inicia el índice desde templates/b-roll-library-index.md. Luego elimina los videos originales completos y todas las copias de trabajo. Solo se conservan los clips seleccionados.
6. Aprende de las razones: convierte cada una de las razones del editor en una regla general y fusiónala en "Qué hace que un momento valga la pena conservar" a continuación (o en la habilidad de selección de B-roll cuando se trate de dónde va un clip en un video). Mantén la lista breve: reescribe y combina reglas en lugar de añadir nuevas. Solo las razones del editor cambian las reglas; las razones marcadas "(IA)" se quedan como están.
7. Si el editor rechaza un clip conservado más tarde, elimínalo, sácalo del archivo de la sesión y del índice, y convierte su razón en una regla.

Encontrar B-roll más tarde

Cuando alguien pida un tipo de toma ("unboxing para esta marca", "yo con aspecto cansado"), búscalo en la tabla "Buscar por etiqueta" del índice de la biblioteca y devuelve los clips coincidentes. Una etiqueta simple (pet) coincide con cada detalle bajo ella (pet:cat, pet:dog). Los clips lifestyle cuentan para cualquier marca; los clips de producto pertenecen a su propia marca.

Qué hace que un momento valga la pena conservar

Estas reglas provienen de las selecciones y razones de un editor real en una sesión de productos UGC. Aplícalas en orden, luego reemplázalas con las reglas de tu propio editor a medida que lleguen sus razones.

1. Movimiento. El mejor momento en una toma es donde algo cambia: un giro de cabeza, un gesto de mano, una nueva expresión, una mascota que entra caminando. Una toma donde nada se mueve parece una foto. Una toma estática solo se conserva como un acento breve (un primer plano limpio de producto); etiquétala static.
2. Un rostro que actúe el sentimiento. Un suspiro, un bostezo, la cabeza entre las manos, una gran sonrisa. La expresión muestra el sentimiento de la línea por sí sola.
3. Ojos con intención. Mirar a la cámara solo cuenta cuando es intencional: un selfi, hablar o reaccionar al espectador, o mostrar el producto al objetivo. De lo contrario, los ojos pertenecen al sujeto de la toma (la bebida, el portátil, el paquete). Un creador que mira al objetivo mientras está sentado, o mira hacia un lado, se está revisando en el encuadre (a menudo mirando una pantalla de teléfono colocada a un lado), y ese tramo no es la toma. La toma real es el tramo donde no se revisa: el bostezo, el remover, el suspiro. Empieza después de cualquier revisión y termina antes de la siguiente; un tramo donde se revisa el encuadre más de una vez se salta.
4. El propósito del video siempre se selecciona. Cada video B-roll se filmó para mostrar algo, y el momento que lo muestra más claramente siempre se conserva. Lee el propósito del metraje en sí: a qué dedica la mayor parte del video, o qué configura el creador y luego muestra. El propósito puede ser cualquier cosa: un producto que se vierte suavemente, el polvo de un competidor que se apelmaza, un "antes" desordenado, una mascota haciendo algo gracioso. Mostrar el producto funcionando es un tipo de propósito, no la regla. Si el momento que muestra el propósito no es utilizable (borroso, fuera de cuadro), se convierte en la primera nota de regrabación.
5. Vida real en el encuadre. Mascotas, pequeños momentos divertidos (lanzar un paquete vacío) y otros detalles no planeados hacen que el B-roll se sienta real y dan a los espectadores algo que mirar.
6. La versión natural y favorecedora. Cuando el creador hace la misma acción dos veces, gana la que parece natural y de una persona real (un bostezo con la mano sobre la boca).
7. Enfoque nítido. Una toma cuenta cuando el producto y el rostro están enfocados. Juzga el enfoque en un fotograma a tamaño completo, nunca en una hoja de contacto. Si el producto nunca está nítido en ningún punto de la toma, toda la toma está descartada. Una gran idea que salió borrosa se convierte en una nota de regrabación.
8. El producto completo. Muestra el paquete completo y dale la vuelta para mostrar la parte trasera. Girarlo añade movimiento y presenta el producto, y la parte trasera lleva detalles como ingredientes.
9. Tomas perennes, siempre. Archiva estas de cada sesión de producto, incluso si el video actual no las va a usar: unboxing (rasgar, mirar dentro, sacar uno), producto en uso (abrir, verter, mezclar, sorber), señalar los ingredientes, creador sonriendo con el producto, primer plano limpio del producto, sosteniendo el producto. Cualquier buen primer plano también vale la pena archivarlo (un vaso levantado hacia el objetivo, manos mezclando); etiquétalo closeup:<qué> para que pueda usarse como acento breve.
10. Corto está bien. Un fragmento limpio de 2 segundos es un clip utilizable.
11. Una versión de cada toma. Cuando dos momentos se parecen casi igual (el mismo vaso sostenido cerca del objetivo), archiva solo aquel donde algo está sucediendo (removiéndolo). La versión estática nunca se guarda junto a él.
12. Corta a la acción principal. Cada video B-roll tiene un movimiento de remate para el que fue filmado (subirse la manta, el vertido, el bostezo). La selección contiene ese movimiento con solo un instante antes. La preparación y los ajustes (ajustar la manta, recolocar la almohada, preparar el paquete) se quedan fuera, incluso si están en el mismo tramo.

Reglas para cada etiqueta

• Cada clip conservado tiene un inicio, un final, etiquetas, una descripción simple y una razón.
• Las etiquetas describen solo lo que se puede ver en el clip, para que cualquier persona que etiquete el mismo clip elija las mismas etiquetas sin conocer la marca ni el guion. Lo que un clip significa para un video (una toma de "antes", un punto de dolor) se decide más tarde, en la habilidad de selección de B-roll.
• Añade el detalle después de los dos puntos (etiqueta:<qué>) siempre que sea visible y alguien pueda buscarlo.
• Las marcas de tiempo provienen de la línea de tiempo del archivo original. El archivo de la sesión registra las marcas de tiempo de selección; el clip en sí comienza 1 segundo antes.
• Las marcas de tiempo generadas por IA son aproximadas, no exactas. Verifícalas en fotogramas a tamaño completo antes de cortar.