Communitygithub.com

alyshadotmd/video-edición

Planifica y coloca b-roll en un video a partir de su primer montaje: revisa el corte línea por línea, decide qué líneas necesitan b-roll y qué tipo de plano, extrae los mejores momentos de una librería de b-roll etiquetada, enumera lo que aún necesita grabarse y coloca el b-roll una vez que el editor lo aprueba. Úsalo después de que exista un primer montaje y alguien quiera añadir b-roll, pregunte qué b-roll necesita un video, o solicite una lista de planos de b-roll.

¿Qué es video-edición?

Esta habilidad está diseñada para que agentes de IA como Claude Code y Runneth realicen la selección y colocación inteligente de b-roll en videos, a partir de un primer corte. El agente analiza cada línea del diálogo, decide qué líneas se benefician de material de archivo (b-roll) y elige el tipo de plano más adecuado (literal, contextual, de producto, etc.) consultando una librería de clips etiquetados. La habilidad sigue reglas estrictas de edición: prioriza mostrar literalmente lo que se dice, evita repetir momentos, apila clips del mismo video original para no saturar la edición, y trabaja siempre en números de fotograma para evitar fallos de sincronización. Además, genera una lista de lo que aún falta por filmar y permite al editor aprobar, intercambiar o descartar cada decisión. Está optimizada para flujos de trabajo profesionales, con soporte para ffmpeg y editores de video tradicionales, y se integra perfectamente con la habilidad complementaria broll-processing para procesar el material bruto.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alyshadotmd/video-editing/tree/HEAD/skills/broll-selection

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Selección de b-roll

El objetivo: el b-roll correcto en la línea correcta, elegido como lo haría el editor. El b-roll cumple dos funciones: aporta contexto a lo que se dice y mantiene a la audiencia enganchada.

Esta habilidad está diseñada para Claude Code y Runneth. Lee de una librería de b-roll etiquetada: una carpeta de clips cortos más un índice con una tabla "Buscar por etiqueta" (cada etiqueta, luego los clips que la tienen). La habilidad broll-processing construye una, y cualquier carpeta de clips con etiquetas también funciona. Colocar los clips necesita ffmpeg o cualquier editor de video.

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

Antes de empezar: las herramientas

En Runneth, todo ya está 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 funciona, usa las herramientas en ~/.video-editing-tools/bin (ffmpeg, ffprobe, python) dondequiera que esta habilidad diga ffmpeg, ffprobe o python3, y continúa. Si no funciona, sigue primero la habilidad video-editing-setup, luego vuelve aquí.

Paso 0: Asegúrate de que el b-roll esté en la librería

Esta habilidad coloca clips de una librería de b-roll etiquetada. Antes de planificar, verifica que cada archivo de b-roll para este video esté en la librería, con un archivo de grabación. Cualquier b-roll en bruto que no esté se procesa primero con la habilidad broll-processing, luego vuelve aquí.

Paso 1: Lee el primer corte

  1. Obtén la línea de tiempo del corte: cada línea hablada con su hora de inicio y final en el corte. Un transcripción con tiempos de palabra funciona mejor.
  2. Lee lo que se sabe del proyecto: el guion y los archivos de grabación de la marca en la librería de b-roll (cada clip conservado con sus etiquetas y por qué fue elegido).

Paso 2: Decide qué necesita cada línea

Para cada línea, escribe lo que se dice y el tipo de plano que lo muestra, en las etiquetas de la librería. Aquí es donde un clip adquiere su significado: el mismo bostezo puede ser el "antes" en un video y un momento relatable en otro. Reglas, en orden:

  1. Planifica todo el video antes de colocar nada. No llenes las líneas en orden. Primero revisa los planos más fuertes y asigna cada uno a la línea que encaja más literalmente, luego llena las líneas restantes con lo que quede. Un plano gastado al principio en un encaje aproximado no puede usarse después donde encaje exactamente (leer en la cama pertenece a "tráelo a la cama conmigo mientras leo mi libro", no a una línea anterior de "rutina nocturna").
  2. Muestra la línea literalmente. Literal significa que un espectador sin sonido entendería la línea solo con el plano. Una acción que solo está cerca no cuenta: esponjar una almohada es una tarea, no "relajarse y descansar". "Esto acaba de llegar" recibe el paquete sin abrir completo; "los ingredientes" recibe a alguien señalando los ingredientes; "tratando de pasar el día" recibe una cara cansada, un suspiro o un bostezo.
  3. Empareja el producto con el momento. Una entrega significa el paquete completo; una rutina nocturna significa el producto en uso. Usa la forma que el espectador esperaría en ese punto de la historia.
  4. Usa el mejor 1 a 2 segundos de un clip largo. Elige el segmento con más acción: el movimiento principal para el que se filmó el clip (subir la manta), nunca los movimientos previos o posteriores. Los primeros planos funcionan como acentos cortos.
  5. Encadena clips relacionados en una mini historia. Desempaquetar va: rasgar la tapa, mostrar el interior, sacar uno. Usar el producto va: abrir, verter, mezclar, sorber. Trabajar en el sofá va a acostarse para una siesta. Segmentos cortos de una misma acción colocados uno tras otro (medio segundo rasgando la bolsa, medio segundo abriéndola, medio segundo sacando un paquete) crean una mini historia potente.
  6. El creador feliz con el producto va cerca del final. Úsalo junto al llamado a la acción, o en cualquier línea que no sea visual por sí misma.
  7. Un clip significa lo que muestra toda su grabación. Lee el propósito del archivo de grabación y el clip completo antes de usar un segmento. Trabajar en el sofá y luego dormir allí es alguien pasando un día cansado; muestra cansancio diurno, por lo que encaja en una línea de "pasando el día" y nunca en una línea de "acostado en la cama por la noche".
  8. Nunca repitas un momento. Dos clips cortados del mismo video de b-roll original no pueden ir ambos en una edición cuando muestran el mismo momento, es decir, las mismas etiquetas o similares (dos tomas de cansancio en el mostrador, dos bostezos, dos sorbos). Los clips del mismo video que muestran cosas diferentes (abrir, mezclar, un primer plano del vaso) pueden usarse por separado. Cuando un video tiene dos momentos similares, coloca el más fuerte en la línea que mejor encaje y busca algo más para la otra línea, o deja esa línea con la persona hablando. Los segmentos consecutivos de una misma acción que forman una mini historia (regla 4) cuentan como un solo uso. Apila un video en lugar de dispersarlo. Apunta a no más de dos lugares separados por video de b-roll en una edición. Cuando un video tiene varios buenos momentos, apila los relacionados en una mini historia en la línea que encaje (meterse a la cama con el gato, luego leer con la bebida) en lugar de dispersarlos por el video, lo que resulta repetitivo. Los primeros planos de producto (todo lo etiquetado como closeup:, como remover el vaso justo delante de la lente) son la excepción: se mantienen solos como acentos y no cuentan para los dos lugares del video.
  9. Una línea sin un clip que realmente encaje se queda con la persona hablando. Un clip suficientemente cercano que muestra algo diferente es peor que ningún b-roll. Añade la toma que falta a la lista de pendientes de filmar solo cuando claramente ayudaría al video.

Paso 3: Extrae los clips

  1. Para cada línea, busca clips que coincidan en la tabla "Buscar por etiqueta" de la librería. Los clips de la librería llevan 1 segundo de margen a cada lado, así que recorta hasta la selección real.
  2. Los clips de estilo de vida (sin producto) pueden provenir de cualquier grabación de marca. Los clips de producto provienen solo de esta marca.
  3. Cuando nada en la librería encaje, la línea va a la lista de "pendientes de filmar" con una descripción de una línea del plano.

Paso 4: Muestra al editor el plan

Muestra una tabla corta: número de línea, lo que se dice, el b-roll (grabación, clip, segundos exactos) y por qué. Luego la lista de pendientes de filmar. El editor aprueba, intercambia o corta. Los clips se colocan una vez que el editor da el visto bueno.

Paso 5: Colócalo

  1. Recorta cada segmento aprobado de su clip.
  2. Colócalo sobre el corte en su línea, con el audio del hablante ejecutándose debajo sin cambios. Corta el b-roll en los puntos de corte o en los espacios entre palabras.
  3. Trabaja en números de fotograma, no en segundos. Convierte cada corte de a-roll y cada borde de b-roll a un número de fotograma entero (tiempo x velocidad de fotogramas, redondeado) antes de colocar nada, y activa/desactiva segmentos por número de fotograma. Tiempos como 28.867s a 30fps caen entre fotogramas y dejan un fotograma suelto visible.
  4. Apila los b-roll juntos fotograma a fotograma. Cuando dos segmentos de b-roll se sitúan uno al lado del otro, el segundo comienza en el número de fotograma exacto donde termina el primero, para que ningún fotograma de la persona hablando se cuele entre ellos.
  5. El b-roll cerca de un corte se ajusta al corte. Cuando un borde de b-roll cae dentro de aproximadamente 0.3s (9 fotogramas a 30fps) de un corte de a-roll, mueve ese borde al fotograma del corte. Un segmento que comienza en la primera palabra de una línea comienza en el corte de esa línea, para que la cabeza parlante nunca parpadee unos fotogramas antes del b-roll.
  6. Vuelve a verificar la edición después de colocar: la duración del audio coincide con la duración del video, cada segmento de b-roll se alinea con su línea, y los subtítulos (si los hay) aún se leen claramente sobre el nuevo metraje.
  7. Ningún segmento por debajo de aproximadamente 0.3 segundos. Construye una lista de cada borde en el video terminado, cortes de a-roll y bordes de b-roll juntos, en números de fotograma. Cada segmento entre dos bordes, cabeza parlante o b-roll, tiene al menos 9 fotogramas a 30fps. Uno más corto es un destello y falla. La detección de escenas sola no los detecta, porque dos tomas de la misma persona se parecen, así que verifica la lista, luego captura los fotogramas a ambos lados de cada borde para confirmar. Mide dónde caen realmente los cortes de a-roll (el fotograma con el mayor cambio de imagen cerca de cada corte planificado) en lugar de confiar en tiempos convertidos de segundos.
  8. Convierte la retroalimentación del editor sobre la colocación en reglas generales en el Paso 2 anterior. Reescribe y combina reglas en lugar de acumular nuevas.

Individual skills in this repo

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

alyshadotmd/video-editing

Turn raw talking-head footage full of repeated takes (one long recording, or several recordings of the same script) into a tight rough cut. Find every take of every line, judge each take on its words, sound and picture, pick the keeper for each line, and either show the editor the picks first or go straight to the cut. The cut is checked so no word is chopped and no pause is left in before anyone sees it. Built for Claude Code and Runneth. Use when someone uploads raw talking-head footage and asks to find the takes, pick the best ones, make a cut list or rough cut it. Triggers: "process my a-roll", "find my takes", "pick the best takes", "rough cut this", "cut list", "edit my talking head", "which take is best

alyshadotmd/video-editing

Turn raw b-roll footage into a tagged, searchable library of short clips. Watch each b-roll video once, tag every useful moment with timestamps, pick the moments worth keeping (the editor picks, or the AI picks on its own if the editor says so), cut only those picks with a 1-second buffer, and learn the editor's taste from their reasons. Use when someone uploads b-roll, asks to tag, bank or label b-roll, or asks to find a kind of shot ("find me unboxing b-roll"). Triggers: "process my b-roll", "tag this b-roll", "bank this b-roll", "b-roll library", "find me unboxing b-roll", "do we have b-roll of", "label my b-roll

alyshadotmd/video-editing

>- Add burned-in captions to a vertical (9:16) talking-head video: exact word timings, one word at a time or short chunks broken by meaning, white outlined Figtree Bold with an optional highlighted word, placed in the safe area clear of the face and the hook headline. Built for Claude Code and Runneth. Use after framing and the headline, when someone asks for captions, subtitles or on-screen words.

Skills relacionados