Communitygithub.com

director-de-video-largo

Convierte una historia aprobada en un guion plano por plano, actuando como director. Pregunta si el video usa narrador o personajes que hablan (o ambos), sugiere opciones profesionales de filmación (tipo de cámara, lentes, movimiento de cámara, iluminación, color, ritmo), las guarda como un archivo de estilo de filmación independiente, luego escribe un guion que coincida con la configuración del proyecto. Genera film-style.md y video-script.md. Úsalo después de que long-video-story (y long-video-assets) estén listos, o cuando el usuario pida el guion del video, la lista de tomas, el estilo de cámara o el plan de iluminación.

¿Qué es director-de-video-largo?

Este skill actúa como el director en la etapa 4 del flujo de trabajo de video largo. Toma una historia aprobada y la convierte en un guion técnico detallado, plano por plano. Primero, consulta al usuario sobre el modo de narración (narrador, personajes que hablan o mixto) y, basándose en la biblia visual y la configuración del proyecto, guía la selección de un estilo de filmación profesional (cámara, lentes, movimiento, iluminación, color, ritmo y transiciones). Luego, escribe un guion de video completo que respeta fielmente la historia aprobada, la configuración del proyecto (idioma, duración, relación de aspecto, etc.) y el estilo de filmación bloqueado. El skill es compatible con plataformas que ejecuten el flujo de trabajo 'long-video' (como Claude Code o Cursor). Su utilidad principal es estructurar y documentar la visión creativa y técnica del video, asegurando coherencia entre la historia, el estilo visual y el guion final, todo dentro de restricciones prácticas de producción y presupuesto.

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

Preguntar en tu IA favorita

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

Documentación

Director de video largo

Etapa 4 del flujo de trabajo de video largo. Tú eres el director. Salida: film-style.md y video-script.md en la carpeta del proyecto.

Antes de comenzar

  1. Encuentra el proyecto en ~/.long-video/projects/<slug>/. Se requiere story.md con status: approved. Si no está aprobado, detente y ejecuta long-video-story.
  2. Se requiere visual-bible.md (IDs de entidades y el estilo artístico fijado). Si falta, informa al usuario que primero se necesita el estilo artístico y ofrécete a ejecutar long-video-assets. Continúa solo si el usuario elige omitirlo. En ese caso, pide una breve descripción del estilo artístico y anótalo como "no fijado" en el estilo de filmación.
  3. Carga la configuración del proyecto. Toma de ella: idioma, duración objetivo, relación de aspecto, audiencia, tono, enfoque visual, fuente y proveedor de voz en off, subtítulos, música, presupuesto. No vuelvas a preguntar lo que la configuración ya responde.
  4. Si film-style.md o video-script.md ya existen, pregunta: continuar o reiniciar uno de ellos.

Paso 1: Narración o personajes que hablan

Pregunta: "¿Cómo debería hablar el video?"

  • Narrador. Una voz cuenta la historia sobre las imágenes.
  • Personajes hablan. Los personajes hablan entre sí en pantalla. Sin narrador, o solo unas pocas líneas de título.
  • Mixto. Un narrador lleva la historia y los personajes hablan en escenas clave.

Antes de que el usuario responda, da una línea sobre lo que cada opción significa para la producción. Usa el visuals.approach y audio.voiceover de la configuración:

  • Los personajes que hablan necesitan una voz distinta por personaje. Las imágenes fijas o la animación simple no pueden mostrar sincronización labial real, así que indica cuál de estos aplica: herramienta de sincronización labial necesaria, entrega fuera de pantalla (el hablante no se muestra mientras habla) o un estilo que oculte las bocas.
  • Un narrador es lo más barato y funciona con cualquier enfoque visual.

Recomienda una opción basada en la historia y la configuración. Si la elección entra en conflicto con la configuración (por ejemplo, voiceover.source es none), señálalo y pregunta si se debe actualizar la configuración.

Si los personajes hablan, pide una descripción de voz para cada personaje de la biblia visual (edad, tono, acento). Usa el proveedor TTS de la configuración si existe.

Paso 2: Estilo de filmación, como el director

Lee references/cinematography-options.md. Guía al usuario a través de los grupos a continuación, un grupo a la vez. Para cada grupo, sugiere de 3 a 4 opciones que se adapten a esta historia. Da a cada una una razón de una línea. Marca la que recomiendas. El usuario puede elegir, combinar o describir la suya propia.

  1. Cámara y apariencia del formato
  2. Lentes y encuadre
  3. Movimiento de cámara
  4. Iluminación
  5. Color y gradación
  6. Ritmo y transiciones. El ritmo funciona dentro del límite de clip: la duración promedio del plano debe mantenerse entre 5 y 8 segundos a menos que la configuración indique lo contrario. Ofrece variedad a través del tamaño del plano, el movimiento y el ritmo de corte, no a través de planos largos.

Reglas:

  • Todo debe encajar con el estilo artístico fijado y el enfoque visual de la configuración. No sugieras una cámara de cine física para un estilo ilustrado en 2D. Para estilos ilustrados o de imágenes fijas, ofrece los movimientos de cámara virtuales equivalentes (acercamiento, paralaje, paneo a través de la imagen) y di lo que la producción realmente puede hacer.
  • No contradigas el bloque de estilo en visual-bible.md. El estilo de filmación se suma a él.
  • Vincula cada sugerencia con la historia: estado de ánimo, escenario, época, género.
  • Usa palabras sencillas. Explica un término la primera vez que lo uses.
  • Pregunta la elección del usuario para cada grupo antes de continuar. Si el usuario dice "tú decides", elige la opción recomendada y di qué elegiste.

Paso 3: Confirmar y guardar el estilo de filmación

  1. Muestra el estilo de filmación completo como un resumen: modo de habla, cámara y formato, lentes, movimiento, iluminación, color, ritmo, transiciones, más el bloque de estilo artístico copiado de la biblia visual.
  2. Pide al usuario confirmar o cambiar elementos.
  3. Ante un "sí" explícito, escribe film-style.md usando references/film-style-template.md.
  4. Ofrece también guardarlo como un preset reutilizable en ~/.long-video/film-styles/<nombre-preset>.md. Usa minúsculas, dígitos y guiones. Si el usuario declina, omítelo.

El estilo de filmación ahora está bloqueado. No lo cambies mientras escribes el guion sin preguntar.

Paso 4: Escribir el guion

Lee references/script-format.md y sigue su formato y reglas de tiempo.

Reglas:

  • Coincide con la configuración: idioma, duración objetivo, relación de aspecto, audiencia, tono, subtítulos, modo de voz en off.
  • Mantente fiel a la historia aprobada. Cubre cada latido. No agregues hechos, eventos o afirmaciones que no estén en la historia. Donde la historia sea texto de narración (por ejemplo de long-video-story-questions), mantén ese texto palabra por palabra y agrégale estructura alrededor.
  • Divide la historia en escenas, y cada escena en planos. Cada plano recibe: duración, imagen, cámara (tamaño, ángulo, movimiento), iluminación, sonido, transición.
  • Límite de duración del clip. Cada plano (una imagen o clip) dura como máximo 10 segundos. Apunta a 5 a 8 segundos. Lee video.max_clip_seconds y video.preferred_clip_seconds de la configuración si están establecidos. Valores predeterminados: máximo 10, preferido 5 a 8. Los planos de menos de 5 segundos solo se permiten por una razón (un inserto rápido, un momento de impacto). Nunca excedas el máximo. Si un momento necesita más tiempo del que permite el límite, divídelo en clips consecutivos (planos) en un límite de oración, cláusula o acción. Los clips pueden compartir el mismo entorno, cámara e iluminación, y la imagen puede permanecer igual o continuar la misma acción. El resultado final es más largo que cualquier clip individual. Marca cada clip subsiguiente con Continúa: <id del plano anterior>, y mantén la narración o el diálogo palabra por palabra. No inventes nuevos movimientos de cámara o nuevas imágenes solo para llenar los clips adicionales.
  • Aplica el estilo de filmación a cada plano. Varía el tamaño del plano y el movimiento para el ritmo, dentro del estilo bloqueado.
  • Usa IDs de entidad de la biblia visual para cada personaje, entorno y objeto. Si un plano necesita algo que no está en la biblia, enuméralo bajo "Nuevos activos necesarios" en lugar de inventarlo en silencio.
  • Narración: escribe el texto en el idioma de la configuración. Diálogo: escribe PERSONAJE: línea con una nota de entrega entre paréntesis cuando sea relevante. Mantén cada línea decible en una respiración.
  • Suma la duración total. Debe estar dentro del 10 por ciento de la duración objetivo. Si no es así, ajústala antes de mostrarla.

Paso 5: Revisión

  1. Muestra una tabla de resumen: número de escena, título, duración, recuento de planos, modo de habla. Muestra la duración total frente al objetivo.
  2. Muestra la primera escena completa. Ofrece otras escenas a petición.
  3. Enumera cualquier "Nuevos activos necesarios".
  4. Pide al usuario aprobar o solicitar cambios.
  5. Aplica cambios. Mantén el estilo de filmación a menos que el usuario pida cambiarlo. Si el estilo de filmación cambia, actualiza film-style.md y vuelve a verificar cada plano.
  6. Repite hasta que el usuario apruebe explícitamente. El silencio o "se ve bien hasta ahora" no es aprobación. Si no está claro, pregunta: "¿Fijar este guion?"

Antes de mostrar el guion, ejecuta esta autoverificación y corrige cualquier falla:

  • La duración total está dentro del 10 por ciento del objetivo.
  • Cada latido de la historia aparece en el guion.
  • Cada plano tiene duración, cámara, iluminación y sonido.
  • Ningún plano es más largo que el límite de clip (10 segundos por defecto). La mayoría de los planos caen en el rango preferido (5 a 8 segundos). Informa el recuento de planos fuera de él.
  • Cada ID de entidad existe en la biblia visual, o está listado bajo nuevos activos.
  • El idioma coincide con la configuración.
  • Ningún plano usa un movimiento de cámara o iluminación que el estilo de filmación excluya.

Paso 6: Guardar

  1. Escribe video-script.md con el encabezado de la referencia de formato, estado approved y la fecha de aprobación.
  2. Asegúrate de que film-style.md esté guardado.
  3. Actualiza project.json: "stage": "script-approved", "film_style": "film-style.md", "script": "video-script.md".
  4. Informa al usuario ambas rutas de archivo y la duración total. Si hay nuevos activos necesarios, díselo y ofrécete a ejecutar long-video-assets para ellos.
  5. Ofrece continuar con long-video-keyframes (imágenes de fotograma inicial y final para cada escena). Inícialo solo si el usuario acepta. No inicies ninguna otra etapa posterior a menos que el usuario lo solicite y esa etapa exista.

Reglas

  • Nunca escribas el guion antes de que el estilo de filmación esté confirmado.
  • Nunca apruebes el guion sin un "sí" explícito.
  • Nunca cambies la historia. Si la historia tiene un problema, informa al usuario y ofrécete a reabrir long-video-story.
  • Nunca sugieras un estilo que la producción no pueda entregar con el enfoque visual del usuario.
  • Mantén los mensajes de chat cortos. Pon el texto completo en los archivos.

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-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-render

Assemble the finished video and run the review loop. Builds the edit from the clips (or images with camera moves), voice, sound stems and captions, renders a low quality review version with scene numbers and time burned in so a client can review it, collects and applies changes (re-rendering reviews as often as needed), and when the user approves, renders the high quality final video. Uses a video editor with a CLI or MCP (FilmCraft, EffectCraft or another) if one is available and the user wants it, otherwise the bundled ffmpeg renderer. Use after long-video-sound, or when the user asks to render, assemble, export, preview or finalize the video.

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