Communitygithub.com

Fotogramas clave de video largo

Crea la imagen del fotograma inicial y final de cada escena (clip) del guion de video aprobado. Escribe una indicación por fotograma con un nombre de archivo fijo que contiene el número de escena y si es inicio o final, crea una carpeta para las imágenes, y puede generar las imágenes con una herramienta de imágenes disponible, o entregar las indicaciones al usuario de una vez o una por una. Úsalo después de long-video-director, o cuando el usuario solicite fotogramas iniciales, finales, clave o imágenes de escena.

¿Qué es Fotogramas clave de video largo?

Esta habilidad implementa la etapa 5 del flujo de trabajo de video largo. Su propósito es generar indicaciones de imagen detalladas y autocontenidas para los fotogramas inicial y final de cada escena (clip) de un guion de video aprobado. La habilidad lee el guion, numera las escenas secuencialmente, identifica clips de continuación (donde el fotograma inicial se reutiliza del final de la escena anterior) y escribe indicaciones siguiendo reglas estrictas: deben incluir bloques de estilo literales de la biblia visual, descripciones de personajes/entornos/objetos sin paráfrasis, y listas de archivos de referencia. Las indicaciones se guardan en archivos por lotes y se crea la carpeta `frames/` con nombres de archivo fijos (`scene-<número>_start.png`, `scene-<número>_end.png`). La habilidad luego pregunta al usuario si solo quiere las indicaciones, que Claude genere las imágenes, o ambas, y cómo entregarlas (de una vez o una por una). Si se generan imágenes, sigue reglas de orden (fotograma inicial antes que final), verifica el estilo con una prueba inicial, adjunta referencias apropiadas, y permite hasta 2 reintentos por imagen. Mantiene un archivo de estado (`frames/status.md`) y actualiza el proyecto con la etapa completada. Es compatible con Claude Code y flujos de video largo similares.

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

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Fotogramas clave de video largo?

Etapa 5 del flujo de trabajo de video largo. Salida: una indicación para el fotograma inicial y el fotograma final de cada escena, una carpeta frames/ y, opcionalmente, las imágenes terminadas.

En esta etapa, una escena significa un clip del guion (una toma, de 10 segundos como máximo). Las escenas se numeran en orden en todo el video.

Antes de comenzar

  1. Encuentra el proyecto en ~/.long-video/projects/<slug>/. Requiere video-script.md con status: approved. Si no está aprobado, detente y ejecuta long-video-director.
  2. Requiere film-style.md y visual-bible.md. Contienen la apariencia de cámara e iluminación y el estilo artístico definido.
  3. Carga la configuración del proyecto: relación de aspecto, resolución, proveedor de imágenes, nivel de aprobación, presupuesto.
  4. Revisa images/ en busca de las imágenes de personajes, entornos y objetos de long-video-assets. Sirven como referencias. Si faltan, menciónalo. Continúa solo si el usuario acepta escribir indicaciones sin ellas.
  5. Si frames/ o frame-prompts/ ya existen, pregunta: continuar (enumera lo que está hecho) o reiniciar.

Paso 1: Numerar las escenas

  1. Lee el guion en orden. Asigna a cada toma un número de escena: 1, 2, 3, y así sucesivamente, en todo el video. Rellena con ceros a la izquierda hasta 3 dígitos (scene-001), o 4 dígitos si hay más de 999.
  2. Construye el mapa de número de escena a id de toma del guion (por ejemplo, la escena 7 es la toma 2.3 del guion).
  3. Marca los clips de continuación (Continúa: en el guion). Para ellos, el fotograma inicial es el fotograma final de la escena anterior. No escribas una nueva indicación de inicio. El índice apunta a la imagen final anterior.
  4. Cuenta las imágenes: dos por escena, menos los fotogramas iniciales reutilizados. Informa al usuario el total.

Paso 2: Escribir las indicaciones de fotograma

Lee references/frame-prompt-templates.md. Escribe dos indicaciones por escena (una para una escena de continuación).

Para cada fotograma, trabaja a partir de la toma del guion:

  • Fotograma inicial. Lo que muestra el primer fotograma del clip: la primera posición de cámara, las poses y posiciones iniciales de los personajes, la iluminación en ese momento.
  • Fotograma final. Lo que muestra el último fotograma: hacia dónde se movió la cámara (por ejemplo, más cerca después de un zoom), cómo terminó la acción, cualquier cambio en la iluminación. Debe ser alcanzable desde el fotograma inicial durante la duración de la toma. Si la cámara está estática y nada se mueve, el fotograma final es la misma composición con un pequeño cambio natural (un gesto, un cambio de luz).
  • Ambos fotogramas muestran el mismo lugar, personajes y objetos, con la misma configuración de cámara a menos que la toma mueva la cámara.

Reglas para cada indicación:

  1. Autocontenido. Sin "igual que arriba". Incluye todo lo que necesita el generador.
  2. Bloque de estilo textual. Copia el bloque de estilo y los términos negativos de visual-bible.md exactamente. Agrega la "línea de indicación para generadores" del estilo de película. Agrega cámara, lente e iluminación de la toma.
  3. Descripciones de entidades textuales. Copia la descripción de cada personaje, entorno y objeto de la biblia visual. Nunca parafrasees.
  4. Referencias. Enumera los archivos de imagen a adjuntar: imagen del personaje y hoja, imagen del entorno, objetos. Para un fotograma final, enumera el fotograma inicial de la propia escena como la primera referencia. Usa los nombres de archivo exactos.
  5. Mismo encuadre. Usa la relación de aspecto de la configuración en cada indicación.
  6. Sin texto en la imagen. Sin leyendas, subtítulos, logotipos o letreros con texto legible, a menos que la historia lo requiera.
  7. Sin nombres de personas reales, marcas registradas o nombres de artistas vivos.

Guarda las indicaciones en frame-prompts/, en archivos por lotes de 20 escenas: scenes-001-020.md, scenes-021-040.md, y así sucesivamente. También escribe frame-prompts/index.md (formato en las plantillas).

Paso 3: Nombres de archivo y carpetas

Crea frames/ en la carpeta del proyecto. Nunca coloques imágenes en ningún otro lugar.

Los nombres de archivo son fijos y aparecen en el encabezado de cada indicación:

  • scene-<número>_start.png
  • scene-<número>_end.png

Ejemplos: scene-007_start.png, scene-007_end.png. Cualquier extensión funciona (png, jpg, webp), pero el nombre base debe coincidir. El nombre contiene el número de escena y la palabra inicio o final, por lo que cada fotograma se puede encontrar por nombre y se ordena secuencialmente.

Paso 4: Preguntar qué quiere el usuario

Pregunta: "¿Qué deseas de esta etapa?"

  • Solo indicaciones. El usuario crea las imágenes con su propia herramienta.
  • Imágenes. Claude genera las imágenes.
  • Ambas. El usuario recibe las indicaciones y Claude también genera las imágenes.

Los archivos de indicaciones siempre se guardan. Esta elección decide quién hace las imágenes.

Luego pregunta cómo entregar: todas a la vez, o una por una.

Solo indicaciones

  • Todas a la vez. Muestra la ruta completa de frames/ y de frame-prompts/. Muestra cómo funcionan los nombres de archivo, con un ejemplo. El usuario abre los archivos por lotes y trabaja con ellos. Ofrece verificar la carpeta más tarde.
  • Una por una. Muestra la primera indicación en el chat con su nombre de archivo y referencias a adjuntar. Espera a que el usuario diga que está guardada. Verifica que el archivo existe en frames/ con el nombre correcto. Luego muestra la siguiente indicación. Si el usuario dice "saltar" o "detener", guarda la posición en frames/status.md y detente.

Verifica la carpeta cada vez que el usuario lo solicite, o al final: compara los archivos encontrados con el índice y enumera lo que falta o tiene un nombre incorrecto.

Imágenes o ambas

Lee ../long-video-assets/references/image-generation.md y sigue sus pasos para encontrar un método, manejar la opción del navegador, ordenar, verificar y el estado. Usa el método guardado en la configuración si existe. Cambios para esta etapa:

  • Recuento y costo. Informa al usuario cuántas imágenes se necesitan y el tiempo o costo aproximado. Pregunta antes de comenzar un lote grande. Ofrece comenzar con un rango, por ejemplo, escenas 1 a 10.
  • Prueba de estilo. Genera scene-001_start primero. Muéstralo. Pregunta si coincide con el estilo definido y la apariencia del personaje. Corrige las indicaciones antes de continuar.
  • Orden. Para cada escena: fotograma inicial, luego fotograma final (el fotograma final usa el fotograma inicial como referencia cuando el método lo admite). Luego la siguiente escena.
  • Referencias. Adjunta las imágenes de personajes, entornos y objetos enumeradas en la indicación. Si el método acepta solo una referencia, usa la más importante (el personaje principal en el fotograma) y menciónalo.
  • Todas a la vez o una por una. Todas a la vez: genera todo el rango, luego muestra los resultados. Una por una: muestra cada par, espera la aprobación o una solicitud de repetición, luego continúa.
  • Opción de navegador. Mismas reglas que en la etapa de activos: confirmación explícita del recuento, tiempo y carpeta de descarga primero. Nunca ingreses contraseñas ni resuelvas CAPTCHAs.
  • Verificaciones. Después de cada imagen, verifica el sujeto, la coincidencia de estilo, la apariencia del personaje con respecto a las referencias y la diferencia entre los fotogramas inicial y final. Máximo 2 reintentos, luego marca needs-manual.
  • Nunca sobrescribir. Nunca sobrescribas un fotograma existente sin preguntar.

Si la generación falla o el usuario la rechaza, recurre a la ruta de solo indicaciones para las escenas restantes.

Paso 5: Estado y finalización

  1. Mantén frames/status.md actualizado:
| Escena | Fotograma | Archivo | Estado | Nota |
|--------|-----------|---------|--------|------|
| 001 | inicio | scene-001_start.png | hecho | |
| 001 | fin | scene-001_end.png | pendiente | |

Valores de estado: pendiente, hecho, necesita-manual, saltado.

  1. Actualiza project.json: "stage": "frames-prompts-done" después de que las indicaciones se guarden, y "stage": "frames-images-done" cuando cada fotograma exista y el usuario apruebe el conjunto.
  2. Informa al usuario las rutas de frames/ y frame-prompts/, y qué falta todavía.
  3. Ofrece continuar con long-video-clips (clips de video a partir de los fotogramas, o saltarlo y usar solo imágenes). Inícialo solo si el usuario acepta. No inicies ninguna otra etapa posterior a menos que el usuario lo solicite y esa etapa exista.

Autoverificación antes de guardar las indicaciones

  • Cada escena tiene una indicación de final. Cada escena que no es de continuación tiene una indicación de inicio.
  • Cada indicación tiene el nombre de archivo en su encabezado, que coincide con la regla de nomenclatura.
  • Cada indicación contiene el bloque de estilo, términos negativos y línea de indicación de película textualmente.
  • Cada personaje, entorno y objeto en la toma aparece con su descripción textual y sus archivos de referencia enumerados.
  • Los fotogramas inicial y final de una escena concuerdan en lugar, personajes e iluminación, y difieren según lo que dice la toma.
  • El recuento de indicaciones coincide con el recuento prometido al usuario.

Reglas

  • Nunca comiences sin un guion aprobado.
  • Nunca generes imágenes antes de que el usuario elija "imágenes" o "ambas".
  • Nunca renombres una imagen o un archivo de indicación después de que las indicaciones estén aprobadas.
  • Nunca pidas claves API en el chat.
  • Mantén los mensajes de chat cortos. Coloca el texto completo de la indicación en archivos y muestra solo muestras o la indicación actual.

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