Communitygithub.com

nian-pangolin/wan3-drama-skills

Transforma guiones en storyboards cinematográficos y los segmenta en unidades de ≤15 segundos para la planificación de videos cortos.

¿Qué es wan3-drama-skills?

Esta habilidad está diseñada para convertir guiones de series (uno o varios episodios) en storyboards cinematográficos altamente detallados, segmentándolos en unidades (párrafos) de no más de 15 segundos cada una. Es ideal para la planificación previa a la producción de videos cortos, como los que se usan en plataformas de dramas en línea. El proceso desglosa cada escena en una secuencia de tomas con especificaciones profesionales: código de plano (WS, MS, MCU, CU, ECU), técnica de cámara, descripción del primer plano, acción visual entre corchetes, diseño de sonido entre corchetes y diálogos (o la indicación de 'sin diálogo'). La salida es un archivo de texto plano con formato 'storyboard.txt', estructurado en tres niveles: episodio, unidad y toma. La habilidad prioriza la densidad de corte (al menos 2-3 tomas por línea de diálogo), la continuidad espacial dentro de cada unidad y el uso de ganchos narrativos al final de cada episodio. Está optimizada para asistentes de IA como Claude Code, Cursor o Codex, proporcionando reglas claras para la generación consistente de storyboards profesionales.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nian-pangolin/wan3-drama-skills/tree/HEAD/cinematic-storyboard

Preguntar en tu IA favorita

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

Documentación

Habilidad: Storyboard Cinematográfico y Segmentación en Unidades

Convierte el guion de uno (o varios) episodios en un «storyboard cinematográfico» y segmenta el storyboard en «unidades» (párrafos), cada unidad corresponde a un fragmento de video de ≤15 segundos.

Condición de activación

Cuando el usuario proporciona texto de guion (que incluye encabezados de escena, personajes, descripciones de acción △, diálogos, VO/OS, etc.) y desea:

  • Generar un «storyboard cinematográfico», «guion de cámara», «guion de tomas», o
  • «Segmentar / dividir en unidades / fragmentos de 15 segundos» el storyboard, o
  • Solicita explícitamente un formato de salida «como storyboard.txt»

utiliza esta habilidad.

Formato de entrada

La entrada es el guion de uno o más episodios, con una estructura típica como la siguiente:

Episodio X
X-X Nombre de la escena Tiempo (día/noche) Interior/Exterior
Personajes: Personaje1 Personaje2 ...
Subtítulos: (opcional, ej. Época Republicana · Ciudad de Shen · Bund)
△Descripción de acción (indicación para storyboard, usualmente comienza con △ o 【Primer plano】, etc.)
Nombre del personaje (indicación de emoción/acción): contenido del diálogo
Nombre del personaje (VO): monólogo interior
Nombre del personaje (OS): voz en off / recuerdo
(Flashback) / (Corte a) / (Transición) y otras marcas

Formato de salida (estructura de tres niveles)

La salida es texto plano, adoptando una estructura de tres niveles: «Episodio → Unidad → Toma».

Primer nivel: Título del episodio

Storyboard del Episodio X

Segundo nivel: Unidad (segmentación del storyboard)

Cada unidad corresponde a un fragmento de video de ≤15 segundos, con el formato:

Unidad N: X-X Nombre de la escena Tiempo Interior/Exterior Descripción de bloqueo de escena: <Descripción de la posición espacial de los personajes, distancia relativa, movimientos dentro del fragmento>
  • Unidad N: comienza desde 1, numeración continua dentro de cada episodio
  • Seguido del encabezado de escena original (se conserva X-X Nombre de la escena Tiempo Interior/Exterior), puede incluir anotaciones de estado como (Flashback), (Transición), (Gancho final)
  • Después de Descripción de bloqueo de escena: se describe la posición física de los personajes en esta unidad, su distancia entre sí, orientación, ubicación de coberturas, etc., proporcionando una base espacial para la planificación de la cámara

Tercer nivel: Líneas de toma

Cada toma dentro de una unidad se numera comenzando desde 1, una línea por toma, con el formato:

N. Código de plano (Técnica de cámara) Primer plano: <Descripción del primer plano o "Ninguno">.【Descripción de la acción visual】【Descripción del diseño de sonido】<Parte del diálogo>
  • <Parte del diálogo>: si hay diálogo, escribe Nombre del personaje: contenido del diálogo (para VO/OS escribe Nombre del personaje(VO):contenido del diálogo); si no hay diálogo, escribe :(Sin diálogo)

Ejemplo completo de línea de toma:

4. CU (Plano fijo) Primer plano: Ninguno.【Primer plano del rostro de Qin Shuyao, desde el cuello hasta la coronilla. Sus ojos brillan, su actitud es arrogante pero complaciente】【Voz baja y lenta, con un toque de emoción, habla despacio】Qin Shuyao: El Bund esta noche está demasiado tranquilo.
1. WS (Plano travelling con cámara baja) Primer plano: La ventanilla del coche antiguo, borrosa y cubierta de gotas de lluvia.【Qin Shuyao, con un qipao ajustado, está de pie en el halo de luz de la puerta. La cámara se acerca lentamente por el camino de piedra mojado】【Sonido ambiente: jazz tenue mezclado con el ruido lejano de las ruedas del coche】:(Sin diálogo)

Explicación detallada de los campos de la línea de toma

1. Código de plano (obligatorio, al principio)

CódigoSignificadoUso
WSPlano general / Plano amplio (Wide Shot)Establecer escena, relaciones ambientales, coreografía de grupo, escenas de impacto
MSPlano medio (Medium Shot)Personaje de medio cuerpo, acción, relación de dos personajes, movimiento
MCUPlano medio corto (Medium Close-Up)Por encima del pecho, avance emocional, plano principal para diálogo
CUPrimer plano (Close-Up)«Rostro, desde el cuello hasta la coronilla», estallido emocional, objetos clave
ECUPrimer plano extremo (Extreme Close-Up)Ojos, dedos, marcas de sangre, énfasis extremo en detalles
  • La descripción del primer plano facial se unifica como «Primer plano del rostro de XXX, desde el cuello hasta la coronilla», garantizando consistencia en la generación.

2. Técnica de cámara (obligatorio, inmediatamente después del código de plano, entre paréntesis en chino)

Se escribe dentro de ( ), describiendo la posición y el movimiento de la cámara. Vocabulario común (se puede combinar chino e inglés):

  • Fijos: Plano fijo, Gran angular fijo, Picado fijo
  • Avances/Retrocesos: Plano travelling, Avance lento, Avance rápido, Avance extremo, Retroceso en riel
  • Paneos/inclinaciones: Paneo horizontal, Paneo horizontal de seguimiento, Barrido rápido horizontal (Whip Pan), Inclinación hacia abajo, Inclinación guiada por la mirada (Tilt Down), Inclinación lenta hacia arriba
  • Angulaciones: Contrapicado bajo, Picado alto, Contraplano over-the-shoulder, Plano over-the-shoulder, Plano inclinado (Dutch Angle)
  • Cámara en mano/seguimiento: Ligero movimiento de mano, Movimiento de mano, Steadicam de seguimiento, Seguimiento a ras de suelo, Zoom envolvente
  • Especiales/efectos: Cámara lenta (Slow-mo), Match Cut, Descenso de grúa grande (Crane Down), Cambio de enfoque nítido a desenfocado, Cambio rápido de enfoque, Punto de vista subjetivo (POV)
  • Transiciones: Disolución (Dissolve), Transición por obstrucción de primer plano (Wipe), Corte duro (Hard Cut), Transición de avance y retroceso

3. Primer plano (obligatorio)

Después de Primer plano: escribe el objeto específico que obstruye el primer plano o Ninguno. El primer plano se utiliza para crear profundidad y sensación de voyeurismo, por ejemplo:

  • Primer plano: La ventanilla del coche antiguo, borrosa y cubierta de gotas de lluvia.
  • Primer plano: El hombro borroso de Qin Shuyao. (para over-the-shoulder, siempre escribir hombro borroso)
  • Primer plano: El cañón de la pistola del asesino. / Primer plano: Las velas nupciales rojas y llameantes, desenfocadas.
  • Cuando no hay primer plano, escribe Primer plano: Ninguno.

4.【Descripción de la acción visual】(primer corchete, obligatorio)

Describe la imagen específica dentro de esta toma: acciones del personaje, movimientos, expresiones, punto final del movimiento de la cámara, cambios ambientales. Debe ser específica y ejecutable, con información espacial y de orientación.

5.【Descripción del diseño de sonido】(segundo corchete, obligatorio)

Cada toma debe tener una marca independiente de la capa de sonido/actuación, eligiendo una o combinando las siguientes dimensiones:

  • Sonido ambiente: 【Sonido ambiente: Pasos nítidos de tacones altos】, 【Relincho de caballo que rasga la noche】, 【Fuego de armas denso】
  • Respiración: 【Respiración: Inhalación brusca 0.8s】, 【Respiración: Pausa de respiración tranquila 1.0s】 (se puede incluir segundos)
  • Silencio: 【Silencio 2.0s】
  • Microexpresión/Indicación de actuación: 【Microexpresión: Músculo mandibular tenso】, 【Movimiento ligero y silencioso】
  • Tono del diálogo (cuando hay diálogo): 【Voz baja y lenta, con un toque de emoción】, 【Grito, volumen muy alto】, 【VO interior, voz extremadamente desesperada y ronca】

6. Parte del diálogo (obligatorio, al final de la línea)

  • Con diálogo: Nombre del personaje: contenido del diálogo
  • Monólogo interior: Nombre del personaje(VO):contenido del diálogo
  • Voz en off/recuerdo: Nombre del personaje(OS):contenido del diálogo
  • Sin diálogo: :(Sin diálogo) (con dos puntos en chino, consistente con el ejemplo)

Reglas de segmentación en unidades (Segmentación del storyboard · Clave)

  1. Prioridad de duración: Cada unidad corresponde a un fragmento de video de ≤15 segundos. Según el número de tomas y el ritmo, normalmente cada unidad tiene 3-6 tomas.
  2. Base de segmentación: Se crea una nueva unidad en los siguientes puntos:
    • Cambio significativo de espacio/posición (movimiento del personaje, nuevo personaje entra en cuadro, formación de un cerco)
    • Cambio de escena/tiempo-espacio (entrada en flashback, transición, regreso a la realidad)
    • Cambio de ritmo dramático (p. ej., de ternura a conflicto, de confrontación a estallido)
  3. Descripción de bloqueo de escena: Al comienzo de cada unidad, se debe describir la posición física de los personajes, su distancia entre sí, orientación y coberturas, como base espacial para todas las tomas de esa unidad.
  4. Coherencia de la unidad: Las tomas dentro de la misma unidad comparten el mismo espacio y tiempo; entre tomas hay una descomposición de la acción continua.
  5. Gancho final: La última unidad de cada episodio debe tener una anotación después de la descripción de la escena: (Gancho final del episodio) o (Gancho final), y la última imagen «se corta a negro, dejando un gancho de suspense».

Reglas de desglose de tomas (Storyboard · Clave)

  1. Densidad de corte ante todo: Cada pausa semántica (coma, punto y coma, partícula de tono), cada cambio de emoción, cada persona/objeto mencionado, debe tener un corte. Es mejor cortar de más que de menos.
  2. Al menos 2-3 tomas por línea de diálogo: Hablante → reacción del oyente; las líneas con coma se cortan en la coma, insertando entre medias tomas del oyente/objeto mencionado.
  3. Prohibido el mismo personaje y mismo ángulo en tomas consecutivas: Si dos tomas adyacentes tienen el mismo personaje y el mismo ángulo, se deben fusionar o cambiar de ángulo/código de plano/insertar una toma de reacción. Los monólogos largos de un solo personaje deben intercalar tomas de reacción de los espectadores entre las frases.
  4. VO/OS como tomas independientes: Los monólogos interiores, voces en off y recuerdos son tomas separadas, a menudo emparejadas con primeros planos o tomas de punto de vista subjetivo.
  5. Acciones clave △ como tomas independientes: Las acciones clave sin diálogo (sacar arma, caer del caballo, empujar una puerta, presionar una marca de sangre) son tomas separadas, con :(Sin diálogo).
  6. Over-the-shoulder obligatorio con primer plano borroso: Para diálogos/confrontaciones de dos personas, priorizar contraplanos over-the-shoulder, con Primer plano: Hombro borroso de XXX.
  7. Profundidad de primer plano: En tomas clave, usar estratégicamente el primer plano (gotas de lluvia, humo, cañón de arma, marco de puerta, llama de vela) para crear profundidad y emoción.
  8. Sin repetición de diálogo: Cuando una línea de diálogo se divide en múltiples tomas, distribuir los fragmentos semánticos secuencialmente a cada toma; las tomas adyacentes nunca repiten el diálogo.

Recomendaciones para selección de código de plano / técnica de cámara / sonido

  • Toma de establecimiento: usar WS + travelling/picado + sonido ambiente; Estallido emocional: usar CU/ECU + avance rápido + respiración; Escena de acción: usar MS + cámara en mano/Steadicam + efectos de sonido densos; Transición: usar Match Cut / Dissolve / Wipe / Whip Pan.
  • Diseño de sonido: debe coincidir con la emoción de la imagen: escenas tranquilas usar «silencio / respiración», conflicto usar «grito / fuego denso», agonía/desesperación usar «susurro de hilo de voz / recuerdo etéreo».

Transiciones y marcas especiales

  • Las marcas del guion como (Flashback), (Corte a), (Transición) se reflejan en la anotación de la unidad de escena como (Flashback), (Transición), etc.
  • Los cambios de escena/tiempo-espacio se manejan con una toma de transición dedicada (Match Cut / Dissolve / Wipe / Corte duro), y en 【acción visual】 se explica la lógica de la transición (p. ej., «inversión del eje de acción similar», «coincidencia de forma y dinámica»).

Requisitos de salida

  1. El inicio imprime el título del episodio Storyboard del Episodio X.
  2. Salida en orden «Unidad → Toma»; las tomas dentro de una unidad se numeran consecutivamente desde 1, pero no son continuas entre unidades (cada unidad comienza de nuevo desde 1).
  3. Cada toma ocupa su propia línea, el orden de los campos es estrictamente: Número. Código de plano (Técnica de cámara) Primer plano: X.【Acción visual】【Sonido】Diálogo.
  4. Cada toma debe incluir: código de plano, técnica de cámara, primer plano, 【acción visual】, 【sonido】 y parte del diálogo (sin diálogo escribe :(Sin diálogo)), ninguno puede faltar.
  5. Cuando se procesan múltiples episodios de forma continua, se genera por episodio, y entre episodios se coloca el título Storyboard del Episodio X.
  6. La salida final es texto plano, que se puede guardar directamente como archivo .txt, con nombre de archivo recomendado storyboard.txt o {número_de_episodio}_storyboard.txt.
  7. Cobertura: asegurar que cada línea de diálogo y cada acción clave △ del guion tenga una toma correspondiente, sin omitir ganchos ni transiciones.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados