Communitygithub.com

product-film

Lanza un vídeo promocional desde las pantallas reales de tu producto: 34 segundos en cinco actos (problema, promesa, el producto en acción, resultado, llamada a la acción) con cursor grande, cámara móvil, subtítulos y sonido, en formato ancho, cuadrado y vertical. Úsalo cuando el usuario solicite un vídeo de lanzamiento, vídeo de producto, promocional, demo, teaser o gráficos en movimiento para su producto, app o sitio web.

¿Qué es product-film?

Product-film es una habilidad para agentes de IA (como Claude Code, Cursor, Codex, etc.) que genera vídeos promocionales cinematográficos a partir de las pantallas reales de un producto digital. El resultado es un vídeo de 34 segundos (ampliable hasta ~40 segundos) estructurado en cinco actos: problema, promesa, el producto en acción (con tres o cuatro pasos), resultado y llamada a la acción. La habilidad captura pantallas reales del producto navegando su sitio o demo, extrae la marca (colores, tipografía, logotipo) y compone el vídeo con un cursor grande animado, cámara que se mueve por la interfaz, subtítulos sincronizados y música (nu-disco a 120 BPM). Soporta tres formatos: 16:9 (ancho), 1:1 (cuadrado) y 9:16 (vertical). La habilidad está orientada a desarrolladores y creadores de contenido que necesitan un vídeo de lanzamiento rápido y profesional sin edición manual. El flujo de trabajo incluye: 1) capturar la marca y las pantallas del producto, 2) escribir una historia en cinco actos basada en la propuesta de valor real, 3) capturar los estados de la interfaz necesarios, 4) construir el vídeo en HTML/JS, 5) revisar con checklists y 6) renderizar los tres formatos. Incluye reglas estrictas: solo pantallas reales, cada afirmación debe tener fuente documentada, el cursor debe estar quieto al hacer clic, y los tiempos de pausa no pueden comprimirse. La habilidad es de omnigami (© 2026 Auberon LLC) y su uso es libre para proyectos comerciales, pero no se permite redistribuir ni vender la habilidad en sí.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/omnigami-ai/plugins/tree/main/plugins/omnigami-launch-films/skills/product-film

Preguntar en tu IA favorita

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

Documentación

Vídeo de producto

Las instrucciones explícitas del usuario tienen prioridad sobre este flujo de trabajo. Trabaja solo en productos autorizados y datos de muestra. No solicites contraseñas, claves de API, datos de pago, identificadores gubernamentales, historiales médicos u otros datos sensibles. Explica las dependencias locales faltantes antes de instalarlas en el proyecto en curso. El acceso a la red es para el producto autorizado y sus activos bajo licencia, más la dependencia npm declarada; respeta los controles de acceso. Renderiza un trabajo a la vez y espera a que termine. Mantén la publicación, el envío y el despliegue fuera de esta tarea.

Si varias habilidades pudieran hacer esto: cuando la solicitud no nombre esta habilidad y tu agente también tenga otras habilidades omnigami que hagan el mismo tipo de cosas (otros vídeos de lanzamiento, tomas, decks o maquetas), enuméralas por nombre y pregunta al usuario cuál quiere antes de empezar. Si está nombrada, o es la única instalada, continúa.

Para páginas de producto en japonés, coreano o chino, mantén el texto en ese idioma y establece el lang del vídeo al <html lang> de la página; las fuentes Noto incluidas y los saltos de frase manejan el texto.

Haz un vídeo de lanzamiento que venda un producto: el problema en letras enormes, una línea de promesa, cuatro pasos de prueba en las pantallas reales del producto, el resultado y una llamada a la acción mantenida hasta el último fotograma. Comienza desde el vídeo terminado en reference/ (Lamplit, una herramienta de desarrollo ficticia creada para los ejemplos de omnigami; historia en reference/STORY.md). Su kit de herramientas (tipografía, cursor, cámara de página, campos de color, columna de subtítulos, dibujo, música) se mantiene; sus palabras, pantallas y pasos se convierten en los del usuario.

Lee style.md antes de construir y critique.md antes de juzgar.

Iniciar o reanudar

  • Verifica Node 20+, ffmpeg y un navegador local de la familia Chrome (scripts/chrome.mjs lo encuentra; CHROME_PATH lo sobrescribe). Explica cualquier dependencia faltante.
  • Usa lo que el usuario haya dado: la URL del producto, cualquier cosa que mostrar o evitar, la llamada a la acción (registrarse, instalar, una URL). Lee el sitio antes de preguntar. Pregunta una vez por lo que el sitio no pueda responder. Si el usuario no quiere preguntas o una ejecución desatendida, decide desde el sitio.
  • Si product-film/ ya existe con film/STORY.md, esto es una revisión: trabaja en ese vídeo. Para otro vídeo, usa una carpeta nueva y reutiliza las notas de marca de PRODUCT.md.

Configura un primer vídeo:

mkdir product-film && cd product-film
cp -R "$SKILL_DIR/reference" reference && cp -R "$SKILL_DIR/scripts" scripts && cp -R "$SKILL_DIR/music" music
mkdir film && tar -C "$SKILL_DIR/reference" --exclude='./assets/screens' --exclude='./assets/brand' --exclude='./plans' -cf - . | tar -C film -xf -
npm init -y >/dev/null && npm i -D 'puppeteer-core@^24'

film/ es la referencia sin sus pantallas, marca y planes. puppeteer-core@^24 funciona en Node 20; las versiones principales más nuevas pueden requerir una versión más nueva de Node.

SKILL_DIR es la carpeta de este archivo. reference/ permanece intacta para comparar.

Conocer el producto, luego escribir la historia

  1. node scripts/capture.mjs <url> capture: mira cada captura de pantalla y lee capture/brand.json. Encuentra qué hace el producto, sus propias palabras, su color de marca y marca, las afirmaciones que hace y de dónde viene cada una, y dónde se puede acceder a su interfaz de usuario real (la página misma, una demo en vivo, un sandbox).
  2. Escribe film/STORY.md con la forma de reference/STORY.md. Es una historia, no un recorrido por las funcionalidades:
    • el espectador y su objetivo: para quién es el producto y la única tarea para la que vienen, en los propios términos del sitio;
    • el problema en su camino, que el propio sitio nombra (el gancho): la forma antigua y lo que les cuesta, cada línea de la cual se tacha;
    • el giro: la respuesta del gancho en sus propios términos (lo opuesto a sus problemas, en la menor cantidad de palabras posible), con el producto nombrado en un compás;
    • tres o cuatro pasos hacia el objetivo en el producto real, cada uno con un subtítulo (lo que el espectador hace o aprende, unas pocas palabras), la pantalla real y los estados a capturar, la acción y el resultado en pantalla que responde al subtítulo;
    • la recompensa: el objetivo alcanzado; la llamada a la acción: la única acción;
    • los tiempos en la cuadrícula de 120 BPM y cada afirmación con su fuente. Los números provienen solo de una fuente que cites. Vuelve a leerlo como lo haría un desconocido: si el resultado de un paso no responde a su subtítulo, o un paso no avanza hacia el objetivo, cámbialo.
  3. Muestra al usuario la historia en pocas líneas (los cinco actos, las dos acciones) y pide una revisión, a menos que hayan solicitado una ejecución desatendida. Nunca tomes el silencio como aprobación.

Capturar las pantallas reales

  1. Escribe film/plans/app.json con la forma de reference/plans/lamplit.json (el formato está al inicio de scripts/screens.mjs):
    • cada estado que muestra la historia, como pasos de click, type, drag (una pulsación mantenida, para el estado presionado propio de la app) y capture;
    • cada pantalla completa, a escala 3, para que la cámara pueda acercarse;
    • un campo escrito como type con around su panel (una captura por letra);
    • rects: cada elemento que usa la cámara, un campo de color o el cursor, por nombre. Un conjunto de capturas sirve para todos los formatos: cada formato las enmarca por sí mismo. Descarta los banners de cookies con un paso click. Usa hide para cualquier cosa que el vídeo dibuje por sí mismo.
  2. Ejecútalo:
    node scripts/screens.mjs film/plans/app.json film/assets/screens
    
  3. Mira cada captura. Corrige el plan hasta que cada estado sea correcto. Si la interfaz necesita un inicio de sesión, usa una demo pública, capturas de pantalla proporcionadas por el usuario o un navegador local ya autenticado que el usuario autorice explícitamente. Nunca pidas credenciales. Nunca captures datos de clientes y nunca dibujes una interfaz imaginada.

Construir el vídeo

Edita film/index.html. Sus secciones están etiquetadas como KEEP (MANTENER), ADAPT (ADAPTAR) y REPLACE (REEMPLAZAR).

  • ADAPTA las palabras: DEFAULTS y FIELDS, desde STORY.md, incluyendo los subtítulos de los pasos (step1 … step4) y sus tiempos en STEPS.
  • ADAPTA los colores: los fondos (INK, NIGHT, INK2), el texto y el único acento del producto (la referencia es oscura primero; un producto claro toma su papel y tinta). Pon la marca del producto en film/assets/brand/mark.svg; crece bajo el giro, se abre en la única línea y lidera los bloqueos.
  • ADAPTA la prueba: P (cuándo ocurre cada clic y cambio), screenAt (qué captura está en pantalla), los encuadres en proofScene (rectángulos de página que la cámara muestra completos, con un conjunto más estrecho para vertical), floats (el elemento en juego, solo sobre un campo oscuro), PATCH (las únicas regiones que cambian cuando un estado avanza en su lugar: mídelas diferenciando las capturas), SETTLED (cuándo el resultado de cada paso se ha estabilizado en pantalla) y los cursorSets del cursor.
  • Cada clic sincronizado con el cursor: escribe cada conjunto de cursor con clickKeys (su comentario muestra los tres de Lamplit de esa manera). El cursor se desliza hacia adentro, llega y descansa quieto sobre el objetivo durante 0.3–0.5 s, presiona exactamente cuando el estado presionado propio de la app se muestra (el mismo tiempo P impulsa ambos), se mantiene quieto durante la presión y luego se va. Un campo se hace clic de la misma manera; las palabras comienzan a escribirse una vez que la presión termina, y el cursor se aparta y se mantiene quieto mientras escriben. Nunca sitúes la llegada del cursor y su salida a ambos lados del clic: se deslizaría fuera del botón mientras presiona. Elimina APPROVED_CURSOR y los conjuntos propios de Lamplit (su corte aprobado es anterior a esta regla). Las comprobaciones del vídeo fallan en cualquier presión donde el cursor no esté descansando sobre su rectángulo objetivo, o se haya movido en los 0.25 s anteriores.
  • ADAPTA la recompensa y la llamada a la acción: TILES (tres de tus pantallas reales) y tu nombre, dirección, línea a escribir y eslogan. Mantén los tiempos de los actos en las líneas de compás y mantén las señales sincronizadas con los actos.
  • MANTÉN el kit de herramientas, la cámara, los campos, el dibujo y la cuadrícula de 120 BPM, con espacio donde el espectador lo necesite (style.md, "Pausas"): el subtítulo de cada paso se lee antes de su primera acción; después de que cada resultado se estabiliza, aproximadamente un segundo para leerlo antes del siguiente movimiento de cámara o cursor; después de un cambio de página o un deslizamiento largo, la pantalla se mantiene antes del clic. Mantenlo animado: nada en la prueba permanece inmóvil por más de aproximadamente 1.8 s. Cuando tus palabras sean más largas o más cortas, mueve las pausas (TU, ST, P), no el funcionamiento propio del producto. Cuando los pasos necesiten más espacio del que dan 34 s, alarga el vídeo un compás (2 s) a la vez, hasta aproximadamente 40 s: mueve ST y DURATION juntos, mantén las proporciones de los actos (style.md, "Los cinco actos") y actualiza los tiempos de STORY.md. La canción se ajusta a la nueva duración (aterriza en la última línea de compás al menos 3.5 s antes del final); con --music, estira la última de music.sections hasta el nuevo número de compases.

Escribe PRODUCT.md en la raíz del proyecto: la URL, qué hace el producto, el color de marca y la marca (con licencias), las palabras elegidas, la fecha.

Revisar, renderizar, entregar

  1. Comprobaciones de hojas y teléfono para cada formato:
    node scripts/render.mjs film --all --times key --sheet
    node scripts/render.mjs film --all --phone
    
    Luego tiras de 12 fotogramas en cada barrido, retroceso e inundación, en ancho y en vertical: node scripts/render.mjs film --size 9:16 --strip <time>.
  2. Puntúa con critique.md y corrige los peores problemas. Antes de enviar, obtén un juicio nuevo. Si tu agente puede iniciar un subagente sin la memoria de esta sesión, dale critique.md, STORY.md y las imágenes, nada más, y corrige lo que encuentre. De lo contrario, relee critique.md y puntúa desde las imágenes solamente. Nada se envía por debajo de 8. Después de tres rondas, informa qué queda.
  3. Verifica la repetibilidad, una página nueva, nombres largos y las propias comprobaciones del vídeo: node scripts/render.mjs film --all --check --check-fresh --stress. No renderices hasta que los tres formatos pasen. Un fotograma que difiera solo en una página nueva generalmente significa una imagen dibujada por primera vez a mitad del vídeo: dibújala una vez en prepare(). Un nombre que se desborda debe ajustarse a su formato en la longitud de estrés. Las comprobaciones también fallan en una presión donde el cursor no está descansando sobre su objetivo, un campo escribiendo con el cursor en movimiento, un resultado con menos de 0.9 s antes del siguiente movimiento, un subtítulo sin tiempo para leer antes de su clic, una pausa muerta de más de 1.8 s en la prueba y una duración fuera de la cuadrícula de compás. Corrige el tiempo, no las comprobaciones.
  4. Renderiza:
    node scripts/render.mjs film --all --video --blur 4 --audio music/song.mp3 --sound --poster <time>
    
    Esto escribe out/16x9.mp4, out/1x1.mp4 y out/9x16.mp4: 60 fps, con desenfoque de movimiento, la canción y los efectos de la habilidad, aproximadamente −14 LUFS. Toma varios minutos: ejecútalo en primer plano y espera a los tres archivos antes de entregar. En una ejecución desatendida, un renderizado dejado en segundo plano puede ser interrumpido cuando la sesión termine. La canción (music/song.mp3: nu-disco a 120 BPM) se ajusta a cada formato: comienza en una línea de compás y, cerca del final, aterriza un golpe, donde su batería se detiene y el resto se cierra y se desvanece (desde sus pistas en music/song-stems/). --from <seconds> comienza en otra de sus distintas secciones de 8 compases (la canción dura aproximadamente dos minutos). --music da la partitura sintetizada en su lugar; la canción propia del usuario funciona con --audio their.wav.
  5. Ejecuta node scripts/preview.mjs film y da su dirección de localhost. Reproduce cada formato y edita las palabras; las ediciones guardadas necesitan un nuevo renderizado para llegar a los MP4.
  6. Escribe README.md (los archivos, cómo previsualizar, cómo cambiar una palabra, cómo renderizar) y out/CAPTION.md (un post de menos de 280 caracteres en las propias palabras del producto, con su URL). Entrega los enlaces a los MP4, los pósters, el subtítulo, un breve resumen de comprobación y el único cambio que más mejoraría el vídeo. Pon las puntuaciones detalladas en out/REVIEW.md.

Revisiones

Para una solicitud como "mantén el resultado por más tiempo" o "muestra la exportación en su lugar", edita la historia y el vídeo actuales. Mantén lo que se aprobó y las palabras guardadas del usuario. Vuelve a capturar solo los estados que cambiaron, vuelve a ejecutar las comprobaciones, renderiza de nuevo y actualiza STORY.md y PRODUCT.md.

Reglas estrictas

  • Solo pantallas reales, capturadas; solo datos de muestra; solo la marca del usuario.
  • Cada afirmación en pantalla tiene una fuente en STORY.md.
  • Espacio para respirar: el subtítulo de cada paso se lee antes de que nada se mueva, el elemento se ve antes de que se actúe sobre él y cada resultado se lee durante aproximadamente un segundo antes del siguiente movimiento de cámara o cursor. Sin pausas muertas de más de aproximadamente 1.8 s. Cuando la historia no quepa, alarga el vídeo un compás a la vez (hasta aproximadamente 40 s) o elimina un paso; nunca comprimas las pausas.
  • El cursor está quieto sobre su objetivo cuando presiona, sincronizado con el estado presionado propio de la app (clickKeys).
  • seek(t, values) pinta solo desde sus argumentos: sin relojes, aleatoriedad sin semilla, temporizadores o red. Lienzos respaldados por CPU, reiniciados en cada fotograma.
  • Cada archivo que carga el vídeo reside dentro de film/.

Archivos

  • reference/: el vídeo de lanzamiento de Lamplit, STORY.md, el plan de captura (plans/lamplit.json), las pantallas capturadas, la marca y las fuentes con sus licencias OFL (Instrument Sans, JetBrains Mono). Lamplit es una empresa ficticia creada para los ejemplos de omnigami.
  • style.md: la gramática, con números. critique.md: la revisión.
  • music/: la canción de la habilidad y sus pistas.
  • scripts/: screens.mjs (pantallas reales en estados), capture.mjs (marca desde una URL), render.mjs (fotogramas fijos, tiras, comprobaciones, MP4), preview.mjs, music.mjs, song.mjs (ajusta una canción suministrada), sfx.mjs con el kit de sonido y chrome.mjs.

Esta habilidad es de omnigami, © 2026 Auberon LLC. Usa lo que haga para cualquier cosa, incluido trabajo comercial, y cambia la habilidad para tu propio uso; no redistribuyas ni vendas la habilidad. Términos completos: LICENSE.md

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills relacionados