Communitygithub.com

long-video-story

Acordar la historia para un video largo. El usuario proporciona una historia o pide a Claude que la escriba.

¿Qué es long-video-story?

Esta habilidad gestiona la etapa 2 del flujo de trabajo de video largo: acordar la historia. El usuario puede proporcionar su propia historia o pedirle a Claude que la escriba. Si Claude escribe, primero pregunta qué estilo de historia usar (por ejemplo, descubrimiento de nicho o narración con preguntas provocadoras), ejecuta la habilidad de ese estilo y revisa hasta que el usuario apruebe. Se utiliza después de long-video-setup, o cuando el usuario dice 'historia para mi video', 'dame una idea', o quiere cambiar una historia no aprobada. La etapa finaliza solo cuando el usuario aprueba explícitamente la historia. Admite múltiples estilos, incluyendo un estilo 'abierto' donde Claude sugiere ideas y escribe una estructura predeterminada. Es compatible con plataformas como Claude Code, Cursor y otras que ejecutan habilidades Markdown con frontmatter YAML y comandos de archivo.

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

Preguntar en tu IA favorita

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

Documentación

Historia de video largo

Etapa 2 del flujo de trabajo de video largo. Salida: un story.md aprobado en la carpeta del proyecto.

Esta etapa termina solo cuando Claude y el usuario acuerdan la historia. Ninguna etapa posterior comienza antes de eso.

Antes de empezar

  1. Encuentra el proyecto activo: ~/.long-video/projects/<slug>/project.json. Si el usuario tiene varios, pregunta cuál.
  2. Si no existe ningún proyecto, ejecuta long-video-setup primero.
  3. Carga la configuración del proyecto desde ~/.long-video/configs/<config-name>.json. Úsala para duración, idioma, audiencia, tono, formato y enfoque visual. No vuelvas a preguntar lo que la configuración ya responde.
  4. Si story.md ya existe con estado draft, ofrece continuarlo. Si el estado es approved, pregunta si se debe reabrir.

Paso 1: Pregunta de entrada

Pregunta: "¿Tienes una historia, o quieres que yo escriba una?"

  • Tengo una historia. El usuario la pega o describe. Ve al Paso 5.
  • Escribe una para mí. Ve al Paso 2.
  • Tengo una idea general. El usuario da una semilla (tema, tópico, una línea). Guárdala, luego ve al Paso 2.

Paso 2: Pregunta por el estilo de historia

Pregunta siempre esto cuando Claude escriba la historia. No lo saltes y no elijas un estilo por el usuario.

  1. Lee references/story-styles.md. Revisa qué habilidades de estilo están instaladas.
  2. Muestra los estilos disponibles, cada uno con su descripción de una línea. Incluye siempre open.
  3. Pide al usuario que elija uno. También puede describir su propio estilo. Si lo hace, trátalo como open con su descripción como instrucciones adicionales.
  4. Guarda la elección en project.json como "story_style": "<id>".

Paso 3: Obtén el tema

Sigue el tipo del estilo elegido.

  • ideas (por ejemplo niche): llama a la habilidad del estilo. Pasa el resumen de configuración y cualquier semilla. Devuelve un tema. Luego pregunta qué escritor usar (regla de emparejamiento del Paso 4 en el registro).
  • writer (por ejemplo questions): si el usuario tiene un tema o semilla, úsalo. Si no, pide uno. No sugieras temas.
  • open: presenta ideas, como se indica a continuación.

Estilo abierto: presentar ideas

  1. Si no hay semilla, haz como máximo 3 preguntas cortas: área temática o intereses, algo que evitar, eventos reales o fuentes a usar.
  2. Escribe 4 propuestas que se ajusten a la configuración. Cada propuesta tiene: título, logline de una oración, los primeros 15 segundos como gancho, y por qué funciona para esta audiencia.
  3. Haz que las 4 propuestas sean claramente diferentes entre sí.
  4. Pide al usuario que elija una, combine dos, pida más, o dé una nueva dirección. Repite hasta que el usuario elija.

Paso 4: Escribe la historia

Llama al escritor.

  • Una habilidad de escritor (por ejemplo long-video-story-questions): llámala con el tema, la duración objetivo, el idioma y el resumen de configuración. Su propio formato de salida gana. No lo remodeles a la estructura predeterminada.
  • open: escribe la estructura predeterminada a continuación.

Estructura predeterminada (estilo abierto)

Ajusta la longitud objetivo en la configuración. La narración hablada tiene aproximadamente 150 palabras por minuto, por lo que un video de 15 minutos necesita alrededor de 2,250 palabras habladas. No escribas el guion final ahora. Escribe la historia: lo que sucede, en orden, con suficiente detalle para que el usuario la evalúe.

  1. Título (provisional).
  2. Logline.
  3. Gancho. La apertura de 15 a 30 segundos.
  4. Esquema de la historia. Actos o capítulos. Para cada uno: lo que sucede, el punto de inflexión, porcentaje aproximado del tiempo de ejecución.
  5. Historia completa. Recontado en prosa, de principio a fin.
  6. Final y llamado a la acción.
  7. Hechos a verificar. Enumera cada afirmación factual que necesita una fuente. Escribe "ninguno" para ficción pura.

Reglas para el estilo abierto:

  • No inventes hechos para una historia de no ficción. Marca las incógnitas en "Hechos a verificar".
  • No copies obras existentes. Usa estructura y redacción originales.
  • Mantén el idioma y el tono de la configuración.

Guarda el borrador

Guárdalo en story.md con este encabezado, estado draft:

---
title: <título provisional>
status: draft
revision: 1
style: <id del estilo>
writer: <id del escritor o "open">
config: <nombre de configuración>
---

Pon el texto debajo del encabezado. Muestra la historia en el chat.

Paso 5: Confirmar o revisar

Si el usuario trajo su propia historia en el Paso 1, guárdala primero como story.md con el encabezado anterior (style: user).

Pregunta: aprobar, o solicitar cambios. Pregunta en un nuevo mensaje después de la historia. No pongas la pregunta dentro de la salida de una habilidad de escritor.

  • Cambios solicitados. Aplícalos. Si una habilidad de escritor hizo el texto, mantén sus reglas (formato, tono, honestidad) mientras editas. Aumenta revision. Muestra lo que cambió en dos o tres líneas, luego muestra la historia actualizada. Pregunta de nuevo.
  • Pregunta o duda. Respóndela. Ofrece un cambio si la respuesta muestra un problema.
  • Quiere una historia diferente. Vuelve al Paso 2. Guarda el archivo antiguo como story.rev<N>.md.
  • Aprobar. Necesita un sí explícito. El silencio, "se ve bien hasta ahora" o "ok pero..." no es aprobación. Si no está claro, haz una pregunta directa: "¿Bloqueamos esta historia?"

Repite hasta que esté aprobado. No apresures al usuario.

Paso 6: Bloquear

  1. Establece status: approved en el front matter de story.md. Añade approved: <fecha ISO>.
  2. Actualiza project.json: establece "stage": "story-approved".
  3. Informa al usuario la ruta del archivo. Di que la etapa de historia está completada.
  4. Ofrece continuar con long-video-assets (personajes, entornos, objetos y estilo). Inícialo solo si el usuario está de acuerdo.

Reglas

  • Nunca marques una historia como aprobada sin un sí explícito.
  • Nunca cambies una historia aprobada en silencio. Reabrirla necesita la solicitud del usuario y establece el estado de nuevo a draft.
  • Nunca omitas la pregunta de estilo cuando Claude escribe la historia.
  • Nunca llames a una habilidad de estilo que no esté instalada.
  • Mantén las propuestas y revisiones cortas. Muestra el texto completo solo para la historia en sí.

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