ratava/videoexpress-scripting-skill

Guionización de VideoExpress

Produce un paquete de prompts listo para producción: un documento vivo que mapea una pieza completa (canción, narración, historia) en una secuencia de clips, cada uno con un plan de imagen de inicio y un prompt multishot de VE listo para pegar. Luego apoya la generación: diagnostica fallos reportados, corrígelos globalmente y barre cada clip afectado.

Dos hechos impulsan casi todo en esta habilidad:

1. El modelo renderiza sustantivos, no intenciones. Cada sustantivo, conteo, símil y token suelto es candidato a aparecer en pantalla.
2. Cada generación solo sabe lo que se le da. Un clip encadenado ve una sola imagen fija (el último fotograma del clip anterior) más el prompt. No tiene memoria del movimiento del clip anterior, de nada que estuviera fuera del encuadre ni de prompts anteriores. Cualquier cosa no visible en el fotograma inicial o descrita en el prompt será inventada.

Dónde leer a continuación

Lee solo lo que necesite el paso actual. Todo en references/ es autocontenido.

Cuando estás…	Lee
Iniciando un nuevo proyecto, o el usuario tiene un concepto o guion	references/project-intake.md — el sistema de preguntas, verificación de viabilidad, pruebas de desarrollo, briefing y aprobación de la Biblia Central
Escribiendo o revisando bloques de personajes, outfits o ubicaciones; imágenes de inicio; referencias de personaje consistente; personajes no humanos	references/bible.md
Eligiendo un aspecto visual, o escribiendo cualquier prompt en un estilo Create Mode o personalizado	references/styles/README.md (receta compartida e índice), luego la hoja de estilo que necesites
Escribiendo cualquier prompt de video	references/multishot-template.md — la estructura de etiquetas, plantilla en blanco y ejemplo trabajado
Planificando la cuadrícula de clips, encadenamiento, movimientos de cámara o cualquier segmento [ACTION]	references/camera-and-motion.md
Escribiendo [LIGHT AND IMAGE] o [PRODUCTION SOUND], cualquier clip con diálogo, o tomas en primera persona / HUD	references/light-sound-dialogue.md
Escribiendo o depurando cualquier prompt; el usuario reporta un fallo	references/prompt-rules.md — cómo el motor lee un prompt, y la tabla fallo → causa → regla
Se te pide operar app.videoexpress.ai con un agente capaz de usar navegador	references/browser-workflow.md — lee primero, sigue paso a paso

Para una solicitud de prompt única a mitad de proyecto, el conjunto habitual es multishot-template.md + prompt-rules.md + el que corresponda de bible.md, camera-and-motion.md, light-sound-dialogue.md y una hoja de estilo que toque el clip. Para un fallo reportado, comienza con la tabla en prompt-rules.md.

Flujo de trabajo

0. Ingesta — ejecuta references/project-intake.md (después de las preguntas de novedades a continuación, si es el primer uso de la habilidad en la conversación): punto de partida (concepto o guion), lista de decisiones con sugerencias, verificación de viabilidad, pruebas de desarrollo, aprobación del briefing y la Biblia Central.
1. Concepto — escenas, motivos, personajes, mundo y un arco visual mapeado a la estructura de la fuente (más abajo).
2. Biblia — bloques de personajes, bloques de outfits y bloques de ubicaciones bloqueados, escritos una vez y pegados textualmente en todas partes (bible.md).
3. Tiempo — una cuadrícula de clips a la duración del clip de la herramienta, con los hits clave verificados contra el audio real por el usuario (camera-and-motion.md).
4. Paquete de prompts — prompts de imagen de inicio y prompts de video multishot para cada clip (multishot-template.md más las referencias relevantes).
5. Soporte de generación — diagnostica fallos reportados por mecanismo, corrígelos globalmente y barre cada clip afectado (prompt-rules.md).

Cuando el guion esté aprobado, comienza la producción en la misma respuesta: si el asistente opera VE, pregunta si abrir las pestañas de VideoExpress en el navegador ahora, y da el primer prompt listo para pegar con su configuración independientemente de quién lo opere (references/project-intake.md, Iniciar producción).

El paquete es un documento vivo. Espera muchas rondas de revisión mientras el usuario genera clips.

Primer uso en una conversación: novedades

La primera vez que esta habilidad se usa en una conversación, sea cual sea el primer mensaje del usuario (un nuevo proyecto, un prompt único, una pregunta sobre la habilidad, un problema reportado), pregunta esto antes que nada, como preguntas de sí/no, una a la vez, con opciones numeradas donde la plataforma no tenga un widget de preguntas:

Una vez por versión donde la memoria lo permita. Primero verifica cualquier memoria persistente que puedas leer (las memorias guardadas del asistente, un archivo de memoria del proyecto) para encontrar una nota de que las preguntas de novedades de esta versión ya se mostraron. Si existe, omite ambas preguntas. Si no, hazlas; luego, si la memoria está activada, guarda la nota de una línea "Guionización de VideoExpress [versión]: novedades mostradas." e informa al usuario una vez: "Recordaré que has visto esto, así que no preguntaré de nuevo para esta versión." Sin memoria, o cuando no se encuentre ninguna nota, pregunta como abajo: preguntar de nuevo es el recurso seguro.

1. "Guionización de VideoExpress se ha actualizado a la versión [versión]. ¿Te gustaría un resumen rápido de las novedades?" Toma la versión de metadata.version de este archivo, sin el sufijo -dev. Si la respuesta es sí, lee references/changelog.md y muestra sus notas de la versión actual (la primera línea del archivo dice qué secciones) como una lista con viñetas: un título corto por versión, la más nueva primero, luego una viñeta corta por cada elemento Destacado (Headline) y Nuevo (New) (los elementos Corregido (Fixed) de una versión pueden compartir una viñeta). Nunca comprimas las notas en una oración o un paréntesis.
2. Para cada elemento Destacado en esas notas de la versión actual que tenga una pregunta, a menos que se cumpla su condición "Saltar si": haz su pregunta. Si la respuesta es sí, da el enlace de instalación y di que abre los pasos de instalación: para VideoExpress Prompt, https://github.com/ratava/videoexpress-scripting-skill/wiki/Install-VideoExpress-Prompt (la página tiene una sección para cada plataforma, incluyendo ChatGPT y Grok).

Luego responde al primer mensaje del usuario, o comienza la ingesta de un nuevo proyecto. Si la habilidad se inició sin un mensaje propio (solo su nombre o comando de barra), trátalo como un proyecto nuevo: ve directamente a la tarjeta "¿Cómo quieres empezar?" (references/project-intake.md, Paso 1), como una tarjeta de pregunta (opciones numeradas donde la plataforma no tenga un widget de preguntas), no un menú en prosa. Cuando el primer mensaje ya dice lo que se quiere (una idea, un guion, un prompt único, una toma fallida), actúa sobre ello sin preguntar qué quiere el usuario. Haz las preguntas de novedades una vez por conversación, nunca más adelante en ella.

Nombra la conversación según el proyecto. Una vez que un nuevo proyecto tenga un título provisional (de la idea del usuario o del briefing), renombra la conversación a "[título] · VideoExpress" si tienes una herramienta que lo renombre (Grok puede renombrar sus chats; ChatGPT no). De lo contrario, deja el nombre como está.

Diseño de concepto

• Diseña 2–4 motivos recurrentes que lleven el video (un color de acento, un gesto, un efecto de luz, un objeto que regrese). Los motivos dan continuidad que la generación de IA no puede proporcionar por sí sola.
• Mapea la estructura de la fuente a una tabla de escenas: escena → rango de tiempo → clips → outfit → ubicación → estado del motivo. Escala los motivos a través de las escenas.
• Los momentos clave merecen eventos visuales. Los grandes hits o líneas clave obtienen revelaciones o ráfagas de movimiento; las acumulaciones obtienen quietud para que el hit impacte; y los cambios de escena aterrizan en los límites de las secciones.
• Dale a cada escena una apertura lógica. Establece al personaje llegando, notando algo o reaccionando antes de la acción principal.
• Favorece lo que se genera de forma fiable: movimientos de cámara constantes, cambios de luz, atmósfera flotante, un sujeto claro. Espectáculo en el fondo, actuación en el primer plano.
• El diálogo se sincroniza con labios de dos maneras (una línea citada en el prompt multishot, o el cuadro de diálogo Lipsync HD; consulta light-sound-dialogue.md). En tomas sin diálogo, mantén las bocas cerradas o fuera de vista para que no se invente habla, y nunca termines un clip con algo en la boca o comida en una mano si el siguiente clip tiene diálogo.
• El interés de fondo (vehículos, multitudes, vida urbana) se nombra explícitamente y se mantiene a distancia para que nunca cruce al sujeto.

Reglas que aplican a cada prompt

Estas son las que causan más daño cuando se olvidan. Las referencias contienen el detalle y el resto.

• Al seguir un paquete de prompts, cada prompt comienza con su referencia de clip entre corchetes, exactamente como el paquete lo declara para esa imagen o clip: [Clip 12] para un prompt de video, [Image 12A] para una imagen de inicio, [Clip 12 TEST 1] para una variante de prueba. Va primero, antes de cualquier ancla de estilo o [REFERENCE USE], para que cada mosaico de biblioteca y toma pueda coincidir con el paquete. Detalles en multishot-template.md.
• Los bloques de la Biblia se pegan palabra por palabra. Parafrasear es desviación. Cuando una imagen de inicio clava el aspecto visual, los prompts de video reutilizan la redacción exacta de ese prompt de imagen, no la redacción más antigua de la biblia.
• Coincide con el fotograma, no con el plan. Mira el fotograma de apertura encadenado o la imagen de inicio aceptada antes de escribir: describe los objetos, el encuadre y la geometría de los obstáculos exactamente como los muestra el fotograma.
• Las comillas significan habla. Cita cada línea hablada una vez, en [ACTION], y no cites nada más. Máximo dos hablantes por clip.
• Afirmaciones en todas partes excepto en [NEGATIVES]. VE lee cualquier otra sección como cosas a incluir, incluso con "no" o "nunca" delante, así que indica lo que debe existir y lo que debe permanecer quieto, y pon cada exclusión en [NEGATIVES], cada una escrita con "No" ("No music, no hum"). Lidera cada segmento con el movimiento del sujeto.
• Cámara: bloqueada a menos que se pida, cada movimiento nombrado de forma idéntica en cada clip, cada movimiento tiene un destino, nunca regreses a un espacio que ha salido del encuadre. Nunca escribas un movimiento relativo a otro clip.
• Un detalle se mantiene solo al tamaño que VE lo dibujó por última vez. Un acercamiento que agranda una cara u objeto, o un objeto que sale del encuadre y vuelve, hace que VE lo redibuje a partir del texto. Comienza cada clip desde una imagen de inicio en su encuadre más cercano; un plano más cercano es un clip nuevo.
• Encadenamiento: señala el riesgo de detalle, no impongas. Un clip encadenado se abre en el último fotograma de la toma, y un detalle se mantiene solo al tamaño que VE lo dibujó por última vez. Cuando un encadenamiento planificado corre el riesgo de desviación de detalle (un encuadre más cercano que el último fotograma, un alejamiento y retorno, una cara u objeto detallado pequeño en el último fotograma), dilo una vez por proyecto o sección del paquete (un episodio, por ejemplo) en las reglas globales de esa sección, con las opciones: mantener el encuadre coincidente, regenerar el clip padre, o comenzar desde una nueva imagen de inicio. Cómo encadenar es elección del usuario.
• No hay eventos contados; no se promete texto. Describe pantallas, letreros y otros objetos portadores de texto como formas abstractas y luz.
• Los efectos añaden luz, nunca la reemplazan. Mantén una luz clave sobre el sujeto; reformula el brillo en el segmento final; nunca encadenes desde un fotograma oscurecido.
• Un bloque [PRODUCTION SOUND] por segmento, con la etiqueta de tiempo del segmento; un solo bloque después del último segmento se vincula solo a ese segmento y deja el resto a VE, a menudo como música. Sonidos transitorios vinculados a acciones; nunca pidas silencio (se renderiza como retumbar y chisporroteo); ajusta la duración del clip a la acción y el habla; cierra cada bloque con lo que se escucha en ese segmento.
• Los aspectos visuales estilizados necesitan el ancla de estilo al principio del prompt de video (justo después de la referencia de clip, antes de [REFERENCE USE]) y en cada [LIGHT AND IMAGE], más negativos antirrealistas.
• Mantén desactivado "Automatically enhance my video prompt". Reescribe a prosa corta y elimina la biblia, las etiquetas de tiempo y la referencia de clip. El cuadro de prompt tiene unos 6 000 caracteres; recorta primero el texto de estilo repetido y los negativos.
• Desactiva Consistent Character al hacer imágenes de inicio sin personajes (entornos vacíos, primera persona, insertos). Afecta solo a Create Image; Create Video lo ignora.

El documento del paquete de prompts

1. Resumen: tabla de escenas (escena, clips, rango de tiempo, outfit, duración VE); nota sobre el formato del prompt; referencias a suministrar con cada clip; regla de pegado (solo el texto dentro de bloques de código se pega; los encabezados llevan metadatos).
2. Reglas globales: las reglas anteriores y de las referencias que aplican a este proyecto.
3. Biblia: bloque central del personaje, bloques de outfit, bloques de ubicación, línea de estilo.
4. Por escena: imágenes de inicio (cada una con una referencia declarada como Image 12A, y un prompt autocontenido que comienza [Image 12A]), luego por clip: línea de encabezado (referencia de clip como Clip 12 · rango de tiempo · duración VE · FRESH desde imagen X o CHAIN desde clip N · etiqueta de rol) y el prompt multishot completo, comenzando [Clip 12], en un bloque de código.
5. Edición, tiempo y control de calidad: transiciones, la lista de verificación de QC por toma (en prompt-rules.md), elementos abiertos.

Para alternativas, añade una nueva pestaña o sección en lugar de sobrescribir clips funcionales, e incluye cualquier clip adyacente que deba cambiar para entregarse correctamente. Mantén las referencias de clip e imagen estables una vez que comience la generación, ya que son lo que identifica las tomas; si se cortan clips, mantén los huecos y anótalos. Las alternativas obtienen su propia referencia (Clip 12B), nunca una reutilizada.

Estilo de trabajo durante la producción

• Los usuarios reportan fallos uno a la vez, a menudo con un fotograma. Diagnostica el mecanismo (tabla en prompt-rules.md), corrígelo globalmente y barre cada clip aún no generado con el mismo riesgo.
• Lee el fotograma que el usuario envía: anota lo que realmente se renderizó y escribe el siguiente prompt para que coincida con lo que existe.
• Cuando el usuario edita el paquete directamente, vuelve a leer antes de escribir y nunca sobrescribas sus cambios sin decirlo.
• Cuando el usuario expresa una preferencia ("quédate con eso", "prefiero este aspecto"), trátalo como una nueva regla y aplícala en todas partes, incluyendo reescribir el bloque de la biblia para que coincida con el fotograma.
• Protege las tomas de recompensa: protege sus condiciones previas en cada prompt anterior.
• Cuando el usuario pida ver un prompt antes de una ejecución, muestra el prompt completo listo para pegar, luego pide ejecutarlo. No ejecutes primero.
• Aísla fallos persistentes. Cuando un problema sobrevive a dos rondas de prompt, deja de reformular. Mantén un prompt base fijo y ejecuta una toma por variante, cada una cambiando una variable, con una referencia única por variante ([Clip 12 TEST 1], [Clip 12 TEST 2]), más una toma de control de un prompt previamente limpio. Registra qué variables importaron.
• Sabe cuándo parar. Si una secuencia se ha desviado mucho del concepto, dilo y ofrece reiniciar la secuencia.