Communitygithub.com

site-promo-film

Muestra al agente cómo planificar, construir o editar un 'film promocional de producto' para obtener como resultado concreto un video terminado. El procedimiento abarca el film promocional de producto, renderizado como código, el estudio: el brief en una ventana, modo guiado: `?`. Úsalo cuando un nuevo encargo requiera este oficio.

¿Qué es site-promo-film?

Este skill de agente de IA especializado permite a asistentes como Claude Code, Cursor o Codex planificar, construir y editar films promocionales de producto completamente desde código. El film es una función donde cada fotograma se renderiza desde cero en un canvas HTML, usando `seek(t)` para dibujar el frame en el tiempo `t`. El sistema emplea Chrome Headless para capturar múltiples subfotogramas por frame, que luego ffmpeg combina y codifica para producir el video final. Esto permite revisar cada fotograma, hacer cambios de bajo costo y mantener un bucle exacto. El skill incluye una plantilla completa con motor de animación (springs, cámaras, línea de tiempo con 24 transiciones), partes vectoriales de dispositivos (Mac, iPhone, iPad, terminal, navegador), efectos visuales (desenfoque de profundidad, texto knockout, máquina de escribir) y scripts de renderizado, narración, mezcla de audio, detección de ritmo y entrega final. También cuenta con un 'Studio' visual que guía al usuario a través de un asistente en ventana para definir el brief del film, seleccionar formatos, looks, música y voces, generando un `brief.json` que el agente puede leer para iniciar la producción. El modo guiado (`?`) proporciona instrucciones paso a paso para cada fase del proceso, desde la concepción hasta la entrega del video terminado.

Compatible con✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/gfazioli/manovella/tree/HEAD/plugins/manovella/skills/site-promo-film

Preguntar en tu IA favorita

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

Documentación

Film promocional de producto, renderizado como código

Una página, un canvas, y seek(t) dibuja el fotograma en el tiempo t desde cero. Chrome Headless captura N subfotogramas por fotograma, ffmpeg los mezcla y codifica. El film es una función; el video es un muestreo de ella, lo que hace que cada fotograma sea revisable, cada cambio sea barato y el bucle exacto.

Estos archivos se envían con este skill. Cópialos en la carpeta de trabajo del film; no reescribas el motor.

ArchivoQué es
template/promo.htmlEl motor más una demo de 8 segundos: resortes de forma cerrada, pistas de suma de resortes, una cámara, ayudas de texto (cifras tabulares, giros), titulares, un cursor real, una cadena de morph de un objeto y un compositor WebGL para 3D real. Se abre y renderiza tal cual.
template/reel.htmlUn film largo en una línea de tiempo: seis escenas, seis formatos (tipografía cinética, un navegador, una cuadrícula bento con enfoque selectivo, una terminal, un cover-flow 3D de dispositivos, una tarjeta final), cinco transiciones, un look por escena, capítulos. ~56 s, no es un bucle. El catálogo de §2, en ejecución.
template/film.jsEl motor que comparten las páginas: el escenario (jitter subpixel por subfotograma, para que nada se escalone o brille en movimientos lentos), FILM.draw para rasters, resortes y cámaras, la línea de tiempo (escenas, capítulos, puntos de control y veinticuatro transiciones: dieciséis en el canvas 2D, ocho como shaders de fragmento en un contexto WebGL2) y efectos (profundidad de campo, texto knockout, escritura). Documentado al inicio.
template/parts.jsPartes vectoriales: una ventana de macOS, un navegador, una terminal, un iPhone, un iPad, una MacBook, un iMac, teclas, un interruptor, un anillo, un botón, el puntero. Cada una devuelve el rectángulo donde va su contenido.
template/parts.htmlCada parte en una hoja 16:10, una página como las demás: PAGE=parts.html node render.mjs stills parts 0 hace el PNG del que se convierte docs/parts.jpg (sips -s format jpeg -s formatOptions 92).
template/fx.jsEl look, cargado por la página: un fondo (liso, degradado, campo o imagen; luz suave de marca; puntos, cuadrícula o líneas en paralaje; un suelo en perspectiva; un foco), un acabado (viñeta, grano) y los efectos que se apoyan en él (vidrio esmerilado, ondas de clic, titulares con enfoque selectivo). Veintitrés preajustes y photo, cada campo sobreescribible, documentado al inicio del archivo. Compartido con release-film.
template/type.jsTitulares y tipografía cinética (§3): TYPE.draw(ctx, t, spec) en trece estilos — rise, focus, settle, track, wipe, cascade, weight, split, flap, type, swap, odometer, decode — con una marca de énfasis, un ritmo y TYPE.load para las caras de una familia. Una función pura de t, como el resto.
template/fonts/Veinte familias con licencia abierta (latin + latin-ext woff2, cada una con su OFL.txt) y fonts.json, sus caras. Un film copia solo lo que usa en src/fonts/; scripts/fonts.mjs add obtiene otra.
scripts/render.mjsstills <dir> t…, sheet <dir> (los puntos de control de la línea de tiempo), looks <dir> <t>, loopcheck, video <out> [workers]. Lee el tamaño, fps, duración y capítulos de la página; aplica jitter a cada subfotograma; renderiza en fragmentos reanudables; FROM/TO, PREVIEW=1, RESUME=1, KEEP=1, AUDIO=, SHUTTER=; la extensión elige el formato (.mp4, .mov ProRes, .webm, .gif; HEVC=1; ALPHA=1 para un .mov o .webm transparente); verifica la pista antes del renderizado y el archivo después; falla en una captura cuya página perdió un contexto WebGL, y en un segundo renderizado de un corte mientras uno se ejecuta. Documentado al inicio.
scripts/narrate.mjsLa historia de un film (story.json: una frase por paso, la de un tutorial o un promocional que habla) en una voz, un reloj y subtítulos: voice/*.aiff, narration.wav (el AUDIO del film), narration.js (el tiempo de cada paso, para la página) y captions.srt / .vtt. El say de la Mac, o --from una carpeta con tus propias grabaciones. "human": "natural" varía las pausas como lo haría una persona; los sonidos de un modelo ([risa]) se mantienen fuera de los subtítulos. Documentado al inicio.
scripts/voice.mjsLa misma historia contada por un modelo de voz que se ejecuta en la Mac ("mlx" en story.json: Chatterbox para una lección, Orpheus para un promocional, Kokoro para un borrador rápido o un film en italiano), más cercano a una persona que say: dice cada paso (voice-mlx.py, a través de mlx-audio), lo ritma y nivela, luego llama a narrate.mjs. Una toma es una semilla; "tone" (calm, warm, bright) es cuán libremente lee el modelo, "human" varía el ritmo de cada línea dentro del 3 % y permite que una línea haga un sonido ([risa], [suspiro]: la ortografía de cada modelo, o se omite). --audition compara tomas, --recordings se detiene en las grabaciones, --setup hace el Python y obtiene los modelos una vez en cada Mac (voice-constraints.txt fija lo que instala) y dice si esa Mac repite las tomas grabadas aquí. Documentado al inicio.
scripts/mix.mjsUna voz y una pista de música en una banda sonora, para AUDIO=: ambas medidas (EBU R128), la música --under LU por debajo de la voz mientras habla, --lift dB arriba entre líneas, baja antes de que cada línea comience; imprime lo que salió, medido en el resultado. Documentado al inicio.
scripts/contact.mjsUna hoja de contacto con subtítulos de una carpeta de fotogramas o looks (subtítulos de labels.json en ella); --size WxH la hace exactamente de ese tamaño (--font, --gap, --pad; los fotogramas nunca se recortan; un .jpg se escribe como JPEG); --dark para una hoja oscura. --compare A=<dir> B=<dir> [C=<dir>] <out.png>: dos o tres carpetas lado a lado, una columna etiquetada cada una y una fila por fotograma que compartan, para una elección A/B en una imagen.
scripts/beats.mjsEl ritmo de una banda sonora, a partir de sus muestras: el tempo, si se mantiene, cada pulso, los compases, las secciones, y el bpm y AUDIO_AT para dar a la página; --out beats.js para una página que sigue una pista que se desplaza (FILM.beats). render.mjs lo importa para medir los pulsos de la página contra los de la pista. --selftest.
scripts/clickcheck.mjs¿Se ve cada clic?: para cada uno de los CLICKS de la página, qué tan rápido se mueve el punto clickeado en pantalla y qué distancia recorre el cursor antes de la presión y durante ella. Sale 1 en un clic que nadie verá (release-film §3b), 2 en una página sin cursor.
scripts/layoutcheck.mjs¿Está cada titular en el marco, separado y legible?: en cada punto de control, cada titular que TYPE.draw dibuja, contra el área segura, los otros titulares y el fondo a su alrededor (los límites están en su encabezado). Sale 1 en un titular que falla, 2 en una página que no dibuja ninguno a través de TYPE.draw.
scripts/deliver.mjsEl último paso (§8): los videos terminados y sus carátulas salen de la carpeta de trabajo a una carpeta propia; una vez que el film está listo, trash tira la carpeta de trabajo después de verificar que su fuente está segura en el kit. --selftest.
scripts/fonts.mjsLas fuentes del kit: add "<Familia>" [ejes] desde Google Fonts con su licencia, check, list.

Además de ellos, studio/ (el Estudio, abajo), guide.md (el modo guiado, abajo) y README.md (el catálogo en imágenes, y ejemplos de solicitudes para cada momento de un film).

Configuración: una carpeta de trabajo, ~/Downloads/<nombre>-trabajo/ (~/Downloads es la raíz de trabajo a menos que workRoot en el archivo de configuración, abajo, diga lo contrario), con la página y estos archivos en su src/, y npm i playwright-core allí. Impulsa el Chrome instalado a través de channel: 'chrome', así que no se descarga nada más. <nombre> es <producto>-<qué> (acme-promo, acme-2.4-whats-new), y nombra la carpeta de entrega y cada archivo entregado también (§8).

Estudio: el brief en una ventana

La entrada visual. Un asistente en una ventana propia: recetas, formatos, looks, imágenes desde la Mac, tipo y movimiento mostrados en movimiento en el motor real, en el color y aspecto del producto, el sonido (las pistas de la biblioteca de música reproducidas, la voz de un modelo de voz escuchada diciendo una línea antes de que sea elegida), y cada elección escrita en un brief.json. No se instala nada y no se renderiza nada. /manovella:studio también lo abre.

  • Cuándo: invocado con studio, o sin nada mientras nada en la conversación dice qué film hacer. Un usuario que ha dicho lo que quiere en palabras va directamente a §0.

  • Ejecuta node <directorio de este skill>/studio/studio.mjs desde el espacio de trabajo, en segundo plano (sus repositorios hermanos son los productos ofrecidos), y di en una línea que la ventana está abierta. Sale por sí solo, imprimiendo una línea, y la salida te despierta: BRIEF <ruta>, o CANCELLED, CLOSED, TIMEOUT (dilo y detente). La ventana es la propia aplicación del Estudio donde esta Mac la ha construido (~/Applications/Manovella.app, su nombre, versión e icono en el Dock), de lo contrario una ventana de la aplicación Chrome; MANOVELLA_WINDOW=chrome mantiene Chrome. Sin ninguno de ellos abre el navegador por defecto; --no-open imprime la URL en su lugar, para una sesión cuya pantalla está en otro lado.

  • La biblioteca de música es opcional: una carpeta con la música de los films del usuario, guardada donde sea que les guste (una unidad sincronizada, una carpeta de proyecto). Está donde apunta MANOVELLA_MUSIC para una ejecución, de lo contrario musicLibrary en ~/Library/Application Support/manovella/settings.json (~/.config/manovella/settings.json fuera de macOS; un ~ inicial se expande); musicLibraryIgnore en el mismo archivo enumera nombres de carpeta que saltar, y deliverToLibrary (true o false, por defecto false) dice si los films terminados también van a ella. Nada se detecta automáticamente. Un archivo anterior con brandLibrary y brandLibraryIgnore se lee como musicLibrary y musicLibraryIgnore con deliverToLibrary activado, lo que hacía antes, y se reescribe con las nuevas claves en el primer cambio realizado en la Configuración del Estudio. El mismo archivo toma projectFolders (donde el Estudio busca productos), pictureFolders (sus imágenes de fondo; sin establecer: ~/Pictures) y workRoot (donde van <nombre>-trabajo y, a menos que el film se entregue en la biblioteca o el proyecto tenga una instrucción, <nombre>/; sin establecer: ~/Downloads); la ventana de Configuración del Estudio (el engranaje junto al logotipo, o ⌘, en Manovella.app) escribe todas ellas, y deliver.mjs lee workRoot también. Nada más en el código lee las claves de la biblioteca: para un film hecho sin el Estudio, este párrafo es la instrucción para mí.

    • El Estudio ofrece cada archivo de audio (mp3, m4a, aac, wav, aiff, flac, ogg) en el nivel superior de la biblioteca y en cada carpeta dentro de ella, directamente o en la carpeta audio/ de esa carpeta; las carpetas ocultas y los nombres en musicLibraryIgnore se saltan. Una carpeta por marca es opcional y agrupa sus pistas; la carpeta nombrada después del producto se enumera primero ("de este producto"). Un archivo de notas opcional junto a las pistas (…notes.txt o .md: un párrafo por pista, comenzando con el nombre del archivo de la pista: qué es, su estado de ánimo, dónde encaja) dice para qué sirve cada una, y el Estudio lo muestra.
    • Films terminados: con deliverToLibrary activado y una biblioteca establecida, <biblioteca>/<Marca>/video/<nombre>/ (§8); de lo contrario, donde las instrucciones del propio proyecto guardan los medios terminados, si no <nombre>/ en la raíz de trabajo (~/Downloads/<nombre>/ por defecto).
    • Una nueva pista que se ha hecho (abajo) se guarda en la biblioteca, en la carpeta del producto cuando la biblioteca mantiene una por marca, con su párrafo en el archivo de notas de esa carpeta, cuando existe una biblioteca; de lo contrario, solo va en el src/audio/ del film. Una carpeta en un proveedor de archivos (Google Drive, iCloud Drive, Dropbox) puede mantener sus archivos "sin datos" hasta que se abran, así que abre o copia un archivo antes de medirlo. Los archivos que una biblioteca guarda se copian, nunca se mueven fuera de ella.
  • brief <ruta>, como argumento o desde una línea BRIEF: lee el brief; responde §0.

    • formats: [] es mi elección de tres. Para un promocional o un film en capítulos, uno, dos o tres nombrados son los formatos de los storyboards, en ese orden, y yo elijo el resto, cada uno diferente; el formato de un release y el de un tutorial es el suyo (whatsnew, tutorial), nunca se llena. look: null es la hoja de looks (§4).

    • frame: en qué se muestra el producto, sea cual sea el formato; null es el formato propio de cada uno (un navegador para un walkthrough, una terminal para una línea de comandos, una ventana de Mac para un tutorial), mi elección.

      • window: la aplicación en su ventana de macOS (PARTS.window).
      • macbook: una MacBook de frente, la ventana de la aplicación o el navegador del sitio en su pantalla (PARTS.laptop, PARTS.notch dibujado al final).
      • imac: un iMac de frente, en su soporte, la ventana de la aplicación o el navegador del sitio en su escritorio (PARTS.desktop: su rect es el cuerpo, 547 : 375, y el soporte se dibuja debajo; color es uno de los siete de Apple, o el acento de la marca para el más cercano de ellos). Sin notch: la cámara está en el bisel blanco.
      • iphone, ipad: el dispositivo (PARTS.phone con PARTS.island dibujado al final; PARTS.tablet, acostado o vertical por su rect, la cámara en su borde largo), el diseño propio del producto en él (§1), y cada clic un toque: un disco suave que presiona, con la ondulación del look, nunca PARTS.ARROW; un tutorial dice tocar.
      • browser: el producto como una página en PARTS.browser, su dirección real en el campo.
      • terminal: PARTS.terminal, escrito con FILM.typed.
      • bare (el Solo la UI del Estudio): la UI del producto por sí sola, un panel flotante con esquinas redondeadas y una sombra, sin cromo de ventana ni dispositivo alrededor. El producto todavía está en pantalla: un film sin ninguno es el formato Tipografía cinética, no este.

      El marco se mantiene para cada escena que muestra el producto, en cada storyboard: un tutorial de una aplicación de iPhone se cuenta en un iPhone desde su primer paso hasta su último. Un formato que es en sí mismo una superficie se adapta a él: Browser walkthrough con iphone es el sitio en el teléfono a ese ancho; Terminal con macbook o imac es la ventana de la terminal en el escritorio de la Mac. Dispositivos en 3D es el único formato que muestra varios: el dispositivo elegido lidera el cover-flow (la primera tarjeta en mirar a la cámara, y a la que vuelve), y los demás lo siguen. Donde el marco y un formato chocan, gana lo que la persona que lo pidió espera ver: es un promocional de producto, no una demostración de la máquina: un film de pantalla sin marco es Just the UI.

    • palette: un array de seis o siete colores, del brief, o de la marca, o de una imagen; el primer color es el fondo, el segundo es el acento, y el resto aparece en el look y el texto. Los looks de la hoja lo usan. El Estudio muestra un selector de color que devuelve una imagen o un color hexadecimal, y no acepta un blanco o un negro puro, sino los de la paleta.

    • model: el modelo de voz elegido; voice es el ajuste del modelo (más grave o más agudo en pasos de semitono, o "original"), tone es calm, warm, bright (o natural para "human": "natural", no "mlx"); pace es el ritmo de las líneas (slow, normal, fast). music es la pista elegida: su ruta de la biblioteca, o el nombre de un archivo en src/audio/ (y "theme" y "mood" de su párrafo de notas, para conocimiento; no se usan más). mix es "under": -20, "lift": 6 o un ajuste personalizado en el Estudio. revoice es el Repite conmigo que dice "lo haré de nuevo" después de escuchar la voz del usuario en la línea de los subtítulos, dejado fuera de los reales; los desarrolladores lo usan para grabaciones reales (§3c).

    • silence: true (sin voz, sin música), music (solo música), voices (voces sin música), "music+voice" (ambas). El predeterminado del Estudio es la elección del usuario, guardada en las configuraciones.

    • scenes: un array de escenas, cada una con name, cada una con story: [{caption, action, format, frame?, cursor, click?}] (§0–2, en una sola lista cuando el formato es uno solo, por escena cuando no). Cada paso opcionalmente tiene id, y el último paso de una escena es opcionalmente un capítulo. El botón de reproducción del storyboard pone el cursor al inicio de la escena; el botón de reproducción alrededor de cada paso pone el cursor en el primer fotograma de ese paso. Los storyboards están en el archivo del brief, y cada escena tiene su aspecto de los creators del storyboard de la hoja, no del mío, a menos que yo haga esa hoja.

      • El formato es la superficie de toda la escena cuando es fijo; cuando no lo es, cada paso puede elegir el suyo, y el fondo cambia con él (una demora que el Estudio muestra cuando se pasa el cursor por encima). La Tipografía cinética es el formato en el que el producto no se ve. El formato de un Walkthrough es browser (§2a); Línea de comandos es terminal (§2b); Aplicación es una captura de pantalla (§2c); Mosaico es una cuadrícula (§2d).
      • cursor es el tipo de cursor del paso: arrow, beam, hand, none; pointer es un clic; dwell es tiempo de permanencia con un cursor redondo; tap es un toque en un dispositivo táctil; none, por defecto, es pulso por segundo, sin cursor (el clic sigue estando).
      • click es una etiqueta opcional que nombra la acción, mostrada en la nota del paso en el storyboard y como parámetro de cursor (y no hay transliteración).

      Un brief sin storyboards (solo scenes: []) es una historia que tengo que construir a partir del brief y las imágenes de la Mac, una historia en $\approx$10–40 pasos, detallada en el espacio de descripción del paso de §1 y sin requerir una fuente de comandos de mi parte: el agente del Estudio no ejecuta comandos.

    • storyboard: false (hecho: el usuario ha terminado con el storyboard), null (el usuario no tiene storyboards, así que el Estudio no los ofrece), o un array de arrays con las filas y columnas del storyboard, dibujado y recortado como un canvas de storyboard: formato, encuadre, texto de paso, notas y dimensión, un 35 mm dibujado en cada fotograma. El Estudio coloca estos arrays en el archivo del brief cuando se cambia al modo de revisión.

    El brief sigue hasta la línea de tiempo (§5).

Modo guiado

Cuando no sabes qué hacer, pide ayuda. El flujo de trabajo está en guide.md: cada paso, su comprobación y su salida, en secuencia. El modo guiado se invoca con ? y luego el número del paso (?3), o ? solo para el siguiente paso. ?? imprime la guía completa. Cada paso tiene un comando de ejemplo.

  1. Brief: qué hacer. Sin esto, no hay film. Lee el brief (§brief.json), o pregúntale al usuario: qué producto, qué formato, qué historia. Escríbelo, resúmelo en una línea que lleve al siguiente paso.
  2. Historia: una historia por formato. Si brief.json tiene escenas, ve a §2; de lo contrario, escribe una secuencia de pasos, cada uno un paso del usuario a través del producto: una línea por paso, el formato, el encuadre, el cursor y un vistazo de lo que se ve. Dibújala como storyboards en una página que se pueda ver. La salida: BRIEF <ruta> escrita arriba (el archivo del brief con las escenas) y storyboard.html con la página de storyboard. Comprobación: el usuario la ve y la confirma o la edita.
  3. Página: el HTML en el que se renderiza el film. Una página html por escena, escenas y transiciones en la línea de tiempo: <canvas> en un <div> que llena la ventana, <link> al look, <script> al motor y a la página. No hay HTML compartido: cada escena es autónoma. Compilada en src/<escena>.html. La salida: la página que se renderiza por sí sola. Comprobación: se abre (open src/<escena>.html) y reproduce.
  4. Motor: los datos de la escena y el control. Escribe las transiciones, los capítulos, los controles de cursor (posición y clic). Prueba: seek(0) a seek(duration) en src/<escena>.html muestra cada paso. Narración: añade una pista de voz. El Estudio maneja las preguntas de voz; aquí, maneja el archivo de narración y el archivo de audio.
  5. Look: el color y el sentimiento. Elige una paleta del brief.json o pregúntale a la Mac (elige una imagen y extrae los colores). Escribe el look: el fondo, el acabado, las fuentes, el tamaño del texto. Prueba: PAGE=<escena> node render.mjs stills <escena> 0.5 hace un fotograma en el medio de la escena. Muestra cuatro o cinco looks, uno por escena, y el usuario elige.
  6. Línea de tiempo: el ritmo. Escribe los tiempos de escena, los capítulos, los puntos de control. Renderiza: node render.mjs sheet <escena> imprime la hoja de la línea de tiempo con los tiempos. Aprueba.
  7. Renderizado: haz el video. node render.mjs video <out>.mp4 desde la carpeta de trabajo. La salida: el archivo de video. Comprobación: open <out>.mp4.
  8. Entrega: mueve el video fuera de la carpeta de trabajo. node scripts/deliver.mjs (el último paso). La salida: un archivo en la carpeta de entrega, y la carpeta de trabajo se tira a la basura.
  9. Hecho: el film está listo. Resúmelo: qué se hizo, qué formato, qué duración, y qué hacer a continuación.

El modo guiado no sustituye a la lectura de los archivos de la plantilla: las opciones de render.mjs, los parámetros de TYPE.draw, los efectos en fx.js y las partes en parts.js son el lugar donde buscar. guide.md es el mapa; el código es el territorio.

Individual skills in this repo

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

Skills relacionados