Communitygithub.com

long-video-render

Ensambla el video final y ejecuta el bucle de revisión. Construye la edición a partir de clips (o imágenes con movimientos de cámara), voz, pistas de sonido y subtítulos; renderiza una versión de revisión de baja calidad con números de escena y tiempo incrustados para que el cliente la revise; recopila y aplica cambios (re-renderizando las revisiones tantas veces como sea necesario); y, cuando el usuario aprueba, renderiza el video final de alta calidad. Utiliza un editor de video con CLI o MCP (FilmCraft, EffectCraft u otro) si está disponible y el usuario lo desea; de lo contrario, usa el renderizador ffmpeg incluido. Se usa después de long-video-sound, o cuando el usuario solicita renderizar, ensamblar, exportar, previsualizar o finalizar el video.

¿Qué es long-video-render?

Long-video-render es la etapa 9 del flujo de trabajo de video largo. Su función principal es tomar todos los elementos producidos en etapas anteriores (clips de video, voces, pistas de sonido y subtítulos) y ensamblarlos en un video final. Para ello, primero crea un archivo de lista de edición (EDL) en formato JSON, que define la duración exacta de cada escena, la fuente de imagen, los movimientos de cámara para imágenes fijas, las transiciones, la ubicación de las líneas de voz y las pistas de sonido. Luego, renderiza una versión de revisión de baja calidad (aproximadamente 360p) con números de escena y tiempo incrustados en la esquina superior izquierda, para que el usuario o el cliente puedan revisarla y dar retroalimentación. Soporta múltiples iteraciones de revisión (v1, v2, etc.) y solo re-renderiza las escenas que cambiaron, lo que hace que las revisiones posteriores sean mucho más rápidas. Finalmente, cuando el usuario aprueba explícitamente una versión específica, renderiza el video final en alta calidad (resolución completa, H.264 con crf 18, preset slow, AAC 192k, normalización de sonoridad a -14 LUFS). El renderizador incluido usa ffmpeg con libx264 y libass, pero también puede delegar a editores externos como FilmCraft o EffectCraft si están disponibles y el usuario lo prefiere. Es útil para desarrolladores y creadores de contenido que necesitan un flujo de trabajo automatizado de edición de video, desde la revisión hasta la exportación final, sin tener que abrir manualmente un editor de video.

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

Preguntar en tu IA favorita

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

Documentación

Renderizado de video largo

Etapa 9 del flujo de trabajo de video largo. Salida: renders de revisión (baja calidad) hasta que el usuario aprueba, luego un video final de alta calidad.

Una escena significa un clip del guion, numerado en orden a lo largo del video, como en las etapas anteriores. Los números de escena se queman en el video de revisión, para que el revisor pueda señalarlos.

Antes de empezar

  1. Encuentra el proyecto en ~/.long-video/projects/<slug>/. Requiere video-script.md con status: approved.
  2. Carga la configuración del proyecto: resolución, relación de aspecto, modo de subtítulos (visuals.captions), necesidades de sonoridad, plataforma.
  3. Verifica ffmpeg y ffprobe (ffmpeg -version). El renderizador incluido necesita ffmpeg con libx264 y libass.
  4. Si render/ ya existe, pregunta: continuar (lista las versiones) o reiniciar.

Paso 1: Inventario

Verifica cada escena y lista lo que existe:

ElementoDóndeSe usa como
Clip de videoclips/scene-<NNN>_clip.* (o _take2 y posteriores, el que el usuario aprobó)La imagen de la escena
Solo imágenesframes/scene-<NNN>_start.*Una imagen fija con un movimiento de cámara del guion (acercamiento, alejamiento, panorámica)
Vozaudio/lines/scene-<NNN>_<speaker>_<NN>.*Narración y diálogo
Pistas de sonidosound/mix/sfx_track.wav, amb_track.wav, music_track.wavEfectos, ambiente, música

Reporta los vacíos en una tabla corta. Una escena sin clip ni imagen es un bloqueador: lista esas escenas y ofrece volver a long-video-keyframes o long-video-clips. La falta de voz o sonido solo está permitida si el usuario eligió saltarse esas etapas. Si una etapa se saltó, no la solicites de nuevo.

Si la etapa de clips se saltó (clips_mode: images-only), cada escena se convierte en una imagen fija con un movimiento de cámara tomado del plano del guion.

Paso 2: Elegir la herramienta de ensamblaje

  1. Verifica si hay un editor de video que Claude pueda controlar: un servidor MCP de edición conectado en esta sesión, o un CLI en el dispositivo (FilmCraft: filmcraft-cli commands; EffectCraft: effectcraft-cli --help). Consulta ../long-video-sound/references/tools.md, sección 5.
  2. Si hay uno disponible, pregunta: usarlo (el usuario puede abrir el proyecto y ajustarlo), o usar el renderizador incluido. Por defecto, el renderizador incluido. Si el usuario elige el editor, primero lee su lista de comandos y su documentación, trabaja en una copia, pregunta antes de instalar o construir algo, y mantén los mismos nombres de archivo.
  3. Di qué herramienta se usará.

El resto de esta habilidad describe el renderizador incluido. Con un editor, haz los mismos pasos a través de sus comandos y exporta los archivos de revisión y finales a las mismas carpetas y nombres.

Paso 3: Construir la lista de edición

Lee references/edl-format.md. Escribe render/edl.json a partir de los archivos del proyecto:

  • una entrada por escena con su duración (del guion, o la duración real del clip cuando es más corto o más largo dentro de la duración de la escena), fuente de imagen, movimiento de cámara para imágenes fijas, y transición de salida,
  • ubicaciones de voz: el tiempo de inicio de la escena más un pequeño desplazamiento (0.3 s por defecto), líneas en orden con pequeños espacios,
  • las pistas de sonido,
  • subtítulos a partir del texto de la voz (inicio y fin de cada archivo de voz según su duración), si la configuración requiere subtítulos,
  • ancho, alto y fps de la configuración. El fps predeterminado es 24. El objetivo de sonoridad predeterminado es -14 LUFS con pico verdadero por debajo de -1.5 dBTP.

Reglas:

  • Usa las duraciones exactas de las escenas del guion aprobado. No estires ni acortes la historia para que encaje.
  • Un clip más largo que su escena se recorta del final. Un clip más corto que su escena mantiene su último fotograma. Reporta ambos.
  • Una línea de voz que se extiende más allá del final de su escena, o más allá del final del video, se reporta como una advertencia.
  • Transiciones: cut por defecto. fade (fundido a negro) solo donde el guion lo indique. Las disoluciones cruzadas necesitan una herramienta de editor.
  • Verifica el plan antes de renderizar: node <carpeta_de_habilidad>/scripts/build-render.mjs render/edl.json review render/review --plan.

Muestra un resumen corto: número de escenas, duración total contra el objetivo, clips versus imágenes fijas, advertencias. Corrige los problemas que se puedan solucionar sin cambiar la historia. Pregunta al usuario sobre cualquier cosa que no se pueda.

Paso 4: Renderizar la versión de revisión

Calidad de revisión: baja resolución (aproximadamente 360p), alta compresión, número de escena y tiempo quemados en la esquina superior izquierda, y subtítulos si la configuración usa subtítulos quemados.

node <carpeta_de_habilidad>/scripts/build-render.mjs render/edl.json review render/review --version 1
  • Salida: render/review/<slug>_review_v1.mp4, más un .report.json con duración, tamaño y sonoridad.
  • Los segmentos de escena se almacenan en caché. Las revisiones posteriores vuelven a renderizar solo las escenas cambiadas, por lo que son mucho más rápidas.
  • Para videos de más de unos minutos, ejecuta el comando en segundo plano y espera a que termine. No hagas polling.
  • Si el modo de subtítulos es srt, se escribe un archivo .srt junto al video.

Verifica el informe: duración real contra la planificada, sonoridad, flujos. Luego informa al usuario de la ruta completa y el tamaño.

Di cómo revisar: ver el archivo, anotar el número de escena y la hora que se muestran en la esquina con cada comentario. Claude no envía ni sube el archivo. El usuario lo comparte con el cliente. Ofrece preparar una subida solo si el usuario lo pide, y pregunta primero.

Paso 5: Recopilar cambios

Pregunta: "¿Algún cambio? Si es definitivo, dímelo y renderizaré la versión de alta calidad."

El usuario puede pegar los comentarios del cliente. Lee references/review-feedback.md. Por cada comentario:

  1. Encuentra el número de escena o la hora a la que se refiere. Si el comentario es vago, haz una pregunta corta.
  2. Clasifícalo y elige la ruta:
    • A nivel de edición (recorte, duración, orden, texto de subtítulos, subtítulos activados o desactivados, transición, niveles de voz, música o efectos): corrígelo aquí en edl.json o la ganancia de las pistas.
    • Imagen de una escena (aspecto, personaje, composición, movimiento): vuelve a long-video-keyframes o long-video-clips para esas escenas. Los nuevos archivos reciben nombres de estilo _take2. Luego actualiza la lista de edición.
    • Línea de voz (entrega, pronunciación, redacción): long-video-voice para esas líneas. Un cambio de redacción en el guion aprobado necesita la aprobación del usuario y una revisión del guion.
    • Sonido (efecto, ambiente, música): long-video-sound para esas pistas, luego mezcla de nuevo.
    • Historia o estructura (añadir o eliminar escenas): long-video-director, luego rehacer solo las escenas afectadas aguas abajo.
  3. Escribe la lista en render/review-log.md con la versión, escena, solicitud, ruta y estado.
  4. Muestra al usuario el plan en una tabla corta. Pide un sí antes de cualquier regeneración que cueste créditos o tiempo.
  5. Aplica los cambios, luego renderiza la siguiente revisión (--version 2, y así sucesivamente). Conserva cada archivo de revisión anterior.
  6. Informa al usuario de lo que cambió, escena por escena, y la nueva ruta del archivo.

Repite hasta que el usuario apruebe. El silencio o "se ve bien hasta ahora" no es aprobación.

Paso 6: Renderizar el video final

Solo después de que el usuario diga explícitamente que una versión de revisión específica es definitiva.

  1. Confirma: "¿Renderizar el final a partir de la revisión v?" Verifica que la lista de edición coincida con esa versión, y que no haya ninguna solicitud de cambio aún abierta en el registro de revisión.
  2. Calidad final: la resolución de la configuración, H.264 de alta calidad (crf 18, preset slow), AAC 192k, normalización de sonoridad de dos pasos al objetivo, sin etiquetas de revisión. Los subtítulos se queman solo si la configuración indica quemados. De lo contrario, se escribe un archivo .srt.
  3. Ejecútalo, en segundo plano para videos largos:
node <carpeta_de_habilidad>/scripts/build-render.mjs render/edl.json final render/final
  1. Verifica con el informe y ffprobe: la duración coincide con el plan, la resolución y fps son correctos, hay un flujo de video y uno de audio, la sonoridad está cerca del objetivo (dentro de aproximadamente 1 LU) y el pico verdadero está por debajo de -1 dBFS.
  2. Opcionalmente, verifica si hay fotogramas negros inesperados y silencios largos: ffmpeg -i FILE -vf blackdetect=d=0.5 -af silencedetect=noise=-50dB:d=3 -f null -. Reporta los hallazgos.
  3. Actualiza project.json: "stage": "final-rendered", "final_video": "<path>" y la versión de revisión aprobada.
  4. Indica al usuario la ruta completa, el tamaño y la duración. Recuérdales los créditos en sound/credits.md para la descripción del video.
  5. Ofrece continuar con long-video-publish (opciones de título de YouTube, descripción, etiquetas y aviso de miniatura). Inícialo solo si el usuario acepta. No publiques ni subas. No inicies ninguna otra etapa posterior a menos que el usuario lo solicite y esa etapa exista.

Reglas

  • Nunca renderices el final sin una aprobación explícita de una versión de revisión específica.
  • Nunca cambies el guion aprobado. Si los comentarios lo necesitan, dirígelo y pregunta.
  • Nunca envíes, compartas ni subas un video sin la solicitud clara del usuario.
  • Nunca elimines renderizaciones de revisión anteriores.
  • Nunca regeneres imágenes, clips, voz o sonido sin el sí del usuario sobre el plan.
  • Mantén los mensajes de chat cortos. Pon la lista de cambios en render/review-log.md.

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.

Skills relacionados