Communitygithub.com

changelog-clips

Crea breves demostraciones de UI por cada cambio enviado, a partir de las pantallas reales de una aplicación web. Entrega clips MP4/WebM silenciosos en formato web, cuadrado y vertical, pósteres del resultado y fuente editable. Ideal para medios de changelog, bucles de notas de lanzamiento y clips individuales de actualización de funciones; usa una skill de película de lanzamiento completa para un montaje.

¿Qué es changelog-clips?

Changelog clips es una skill para agentes de IA (como Claude Code, Cursor o Codex) que automatiza la creación de demostraciones visuales de cambios en aplicaciones web. Su propósito es capturar una secuencia real de interacción (antes, hover, presión, resultado) de un componente nativo completo de la interfaz, y convertirla en clips de vídeo silenciosos en múltiples formatos (web, cuadrado, vertical) listos para ser incrustados en changelogs, notas de lanzamiento o redes sociales. La skill se basa en capturas de pantalla reales de la aplicación, utilizando Puppeteer y ffmpeg para grabar la interfaz sin intervención humana, y siguiendo reglas estrictas de fidelidad visual: no se permiten UI inventadas, rectángulos superpuestos, transiciones falsas ni procesamiento simulado. Cada clip se compone de una sola acción y su resultado, manteniendo una cámara fija y un relleno uniforme alrededor del panel. La skill también incluye pasos de revisión automática (con una puntuación mínima de 8 sobre 10) y exportación de pósteres estáticos para accesibilidad. Está diseñada para trabajar con Node 20, ffmpeg y Chrome, y requiere la instalación de puppeteer-core. El resultado final incluye archivos MP4, WebM, PNG, una fuente editable y un reproductor local, junto con un informe de revisiones. Es útil para equipos de producto, ingenieros de frontend y creadores de contenido técnico que necesitan generar rápidamente material visual de alta calidad para comunicar cambios a usuarios o stakeholders.

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

Preguntar en tu IA favorita

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

Documentación

Clips de changelog

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 API, datos de pago, identificadores gubernamentales, registros médicos ni otros datos sensibles. Explica las dependencias locales faltantes antes de instalarlas en el proyecto de trabajo. El acceso a la red es para el producto autorizado y sus activos licenciados, además de 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.

Un panel nativo, una acción, su resultado retenido y luego un Reinicio de demostración anunciado. Mantén la cámara fija y deja un relleno uniforme alrededor de todo el panel. Lee style.md antes de construir y critique.md antes de evaluar.

Entradas y configuración

Lee primero las notas de la versión e inspecciona el producto en funcionamiento. Recopila solo lo que no puedan proporcionar: los cambios a anunciar, una URL de demostración o aplicación local, datos de muestra seguros, archivos de marca/fuentes y los tamaños solicitados. La versión uno cubre cambios visibles en la web. Retén cambios solo de API en lugar de inventar un panel de control. No anuncies una función como enviada basándote en una vista previa próxima.

Verifica Node 20+, ffmpeg y Chrome (scripts/chrome.mjs, o CHROME_PATH). Instala puppeteer-core@^24 en el proyecto de trabajo (se ejecuta en Node 20; versiones principales más nuevas pueden requerir una versión más reciente de Node). SKILL_DIR a continuación es la carpeta que contiene este archivo.

mkdir -p changelog-clips
cp -R "$SKILL_DIR/reference" changelog-clips/film
cp -R "$SKILL_DIR/scripts" changelog-clips/scripts
cp -R "$SKILL_DIR/music" changelog-clips/music
cd changelog-clips
npm init -y
npm install -D 'puppeteer-core@^24'

Crea una carpeta de film separada para cada cambio; la referencia es el control de apariencia, y examples/compare-matching-stays/ muestra una lista nativa. Elimina las capturas copiadas después de estudiar su formato y reemplázalas con las de este producto. Elimina la carpeta out/ copiada si está presente. Mantén cada film autocontenido. En versiones posteriores, reutiliza la marca y los clips sin cambios; recaptura solo las acciones cambiadas.

Producto e historia

Escribe PRODUCT.md con el producto real, la marca, los permisos de datos y la fuente de cada afirmación de la versión. Escribe STORY.md con una entrada por clip: ID estable, fuente/fecha de la versión, título, estado anterior, ruta accesible, control/acción real, resultado retenido, método de reinicio, límites de captura y política de reproducción prevista. Cada clip independiente debe tener sentido junto a su propio texto de versión. No combines dos cambios en una misma línea de tiempo.

Haz que el título coincida con la finalización demostrada: elegir un punto de repetición no es ejecutar una repetición, y previsualizar un horario analizado no es guardarlo. Di "Elige..." o "Previsualiza..." cuando ese sea el resultado real; no tomes prestada la afirmación más amplia de la versión para una demostración más limitada.

Antes de comprometerte con un cambio, mide su componente nativo completo y el texto de resultado decisivo al tamaño de visualización real. Registra las dimensiones CSS, el tamaño del texto y el tamaño resultante de 358 px en la historia. Una solicitud de dos clips no significa que existan dos cambios adecuados. Retén un elemento incompatible y explica por qué; nunca lo entregues como un clip de teléfono/red social terminado con una nota a pie de página en letra pequeña. Selecciona otro cambio genuinamente documentado si encaja. Cuando se solicitan varias formas y el usuario no nombró el cambio, mide cada candidato documentado con cada forma solicitada antes de elegir, y prefiere uno cuyo componente completo encaje en todas ellas; entrega una familia parcial solo cuando ninguno lo haga. Si ninguno encaja, devuelve la limitación del producto sin inventar UI ni reducir el mínimo.

Un componente puede encajar solo en algunas formas. Declara cada forma no soportada y su razón medida en clip.json's heldShapes (por ejemplo {"4:3":"El resultado nativo mide 10.7 px a 358 px; mínimo 12"}). El pintor, la verificación previa y el exportador omiten esa forma retenida, mientras verifican y entregan las compatibles. El manifiesto marca esto como parcial; informa de cada forma solicitada faltante de manera destacada. Una familia parcial no es una prueba de tres formas superada. Si todas las formas están retenidas, entrega las mediciones/informe, no una película.

Muestra ese plan para revisión a menos que el usuario haya solicitado trabajo desatendido. Por defecto, 1200 × 900 web, 1080 × 1080 cuadrado y 1080 × 1350 vertical. Estas son composiciones separadas, no recortes de una misma película. Un título de versión breve y estático se sitúa fuera de la UI en redes sociales; el clip web usa texto de versión adyacente.

Captura y adaptación

  1. Encuentra una tarjeta o panel nativo completo que contenga tanto la acción como su resultado. Verifica su diseño nativo estrecho antes de la captura. A un ancho de visualización de 358 px, la etiqueta, el valor o el resultado cambiado debe tener aproximadamente 12 px o más. Si el componente completo no puede cumplir eso, elige una vista compacta que la aplicación realmente tenga o informa la limitación. Nunca lo redibujes ni lo reestiliches para la película.
  2. Copia/adapta film/plans/capture.json y su capture-setup.mjs. Establece su URL, viewport, selectores, configuración de muestra y evidencia de inspect. Registra piece y target en rects.before, y nuevamente después del resultado. Captura toda la superficie before, hover, pressed, changed (aún en hover) y result (puntero eliminado). Usa presiones reales del ratón hacia abajo/arriba para que la aplicación proporcione su propia pulsación. Ejecuta node scripts/centring.mjs film/plans/capture.json --no-crawl antes de la captura.
  3. Ejecuta node scripts/screens.mjs film/plans/capture.json film/captures. Usa animate para los propios fotogramas CSS/Web Animations de la aplicación. Incluye suficientes límites para la extensión nativa más grande; la herramienta de captura mide la región antes de la acción. Para una acción instantánea, una duration explícita corta registra evidencia con found: []: cambia toda la captura instantáneamente. Para movimiento controlado por JS que la herramienta de captura no puede buscar, proporciona una grabación nativa determinista; nunca la reemplaces con un fundido o un movimiento ensamblado a partir de fotogramas fijos.
  4. Copia la fuente licenciada del producto en film/fonts/, establece film/clip.json y ejecuta node scripts/build-clip.mjs film film/clip.json. Las opciones se muestran a continuación. Deriva la geometría de toda la superficie, el objetivo del cursor y los enlaces de fotogramas nativos de captures/screens.json, muestra las superficies nativas, escribe config.js y ejecuta las comprobaciones de tamaño nativo de cada forma. Un fallo retiene el elemento: detente antes de exportarlo. Revisa cada captura antes de usarla. La referencia suministrada ya tiene su configuración, por lo que reconstruirla es opcional.
{
  "id": "new-view", "title": "Tu título de versión", "kind": "panel",
  "paper": "#F7F4EE", "ink": "#17191F", "groundSource": "Tu paleta aprobada o superficie de aplicación muestreada",
  "radius": 20, "clearOnExit": true, "primaryTextPx": 24,
  "font": {"family": "ProductSans", "file": "fonts/product.woff2", "weight": "300 900"}
}

primaryTextPx es el tamaño CSS nativo medido del texto de resultado decisivo, no un objetivo inventado por la película. paper proviene de este producto, no de la muestra anterior. radius es el radio nativo del componente en píxeles CSS. clearOnExit mantiene el hover hasta que el puntero abandona el objetivo real. Adapta esos campos y el objeto timing opcional en config.js; conserva el pintor de cámara fija y superficie completa en film.js. Los fotogramas de animación nativos se reproducen a su fps capturado. Si la acción es más larga, mueve la salida del cursor y el reinicio más tarde para que termine y el resultado estabilizado se lea durante al menos un segundo; la referencia deja más de cuatro segundos. No trunques el procesamiento real ni retrates una solicitud en cola como completada.

Mantén el puntero en reposo alejado de la etiqueta crítica. Prefiere el control visible en sí mismo como rects.target; para una fila etiquetada, clip.json puede establecer "targetFraction": [0.72, 0.5] para elegir un punto claro dentro de esa área de impacto real (por defecto [0.5, 0.5]). Adapta capture-setup.mjs para mover el ratón real a las mismas fracciones del cuadro delimitador de ese objetivo antes de presionar/soltar. La captura y la película deben usar el mismo punto; mover solo el puntero dibujado tergiversaría la pulsación nativa. Verifícalo en los fotogramas de acción de ancho de teléfono decodificados.

Revisar y entregar

node scripts/render.mjs film --all --check --check-fresh --stress --phone --times key --sheet --review --out film/out
node scripts/export-clips.mjs film

Estos comandos de entrega finalizan. Para trabajo desatendido, espera por ambos, completa la revisión e informa del reproductor film/out/index.html exportado y las rutas de los medios. La vista previa interactiva es una herramienta de edición supervisada: node scripts/preview.mjs film inicia un servidor persistente hasta que se detiene con Ctrl-C. Ejecútalo por separado cuando haya alguien presente para usarlo; nunca lo añadas a un comando de entrega/verificación en primer plano desatendido.

export-clips.mjs verifica cada forma primero y rechaza nuevas exportaciones de vídeo si la verificación del film falla. Luego renderiza MP4 H.264 silenciosos a 30 fps, WebM VP9 y PNG de resultado en film/out/. Su --poster <seconds> opcional selecciona un resultado estabilizado (por defecto 3.5). Escribe un reproductor local con contexto adyacente, pausa/reproducción y manejo de movimiento reducido. El reinicio de la película está etiquetado; no es un ciclo de producto sin costura. Mantén el póster de resultado estático para movimiento reducido. La etiqueta aparece antes del reinicio y permanece visible hasta el final; inspecciona también el último y el primer fotograma decodificados.

Lee cada tira completa de cambio de UI, hover/presión/soltar y reinicio en cada forma; inspecciona los fotogramas MP4 decodificados en esos eventos. Puntúa con critique.md, luego consigue un revisor nuevo si está disponible. Arregla la fuente y repite solo las verificaciones afectadas. Ninguna puntuación por debajo de 8; después de dos rondas de corrección fallidas, informa la falla restante en lugar de ocultarla. La verificación de estrés cubre las palabras dibujadas, así que inspecciona el texto nativo capturado por separado a 358 px.

Entrega films editables con todas las capturas/fuentes y licencias locales, rutas de MP4/WebM/póster, subtítulos de versión, afirmaciones de fuente, el comando de regeneración y REVIEW.md con puntuaciones y limitaciones. Abre los MP4 terminados para revisión. Apunta a un clip web de menos de 1 MB, preservando primero la legibilidad; informa los bytes reales y el tiempo transcurrido.

Los bucles por defecto son silenciosos. music/README.md explica la canción opcional incluida hecha con IA (toma A seleccionada). Nunca sustituyas una partitura sintetizada. Una canción suministrada o seleccionada usa el ajustador interno; mantén las exportaciones silenciosas para incrustaciones.

Invariantes

  • Capturas de producto reales y solo datos del usuario/propios o de muestra. Sin UI inventada, rectángulos levantados, parches de texto, transiciones entre estados o procesamiento falso.
  • Recinto nativo completo, relleno opuesto uniforme, escala fija y cámara. Sin ondas de clic adicionales ni maquetas de dispositivo.
  • seek(t, values) pinta solo a partir de argumentos; ctx.reset() cada fotograma, lienzos principal/auxiliar respaldados por CPU, imágenes locales preparadas. Sin relojes, llamadas aleatorias, temporizadores ni red en el pintor.
  • Cada palabra del film es una entrada de template.fields. El texto nativo crítico debe leerse independientemente de las verificaciones de estrés de copia dibujada.
  • Un reinicio nunca pretende deshacer una compra, envío o acción irreversible. Usa un reinicio de estado de muestra explícitamente etiquetado, o reproduce una vez y conserva el resultado real.

Ostlery es una empresa ficticia creada para los ejemplos de omnigami.

Esta skill es propiedad de omnigami, © 2026 Auberon LLC. Usa lo que produce para cualquier fin, incluido el trabajo comercial, y modifica la skill para tu propio uso; no redistribuyas ni vendas la skill. Términos completos: LICENSE.md

Individual skills in this repo

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

Skills relacionados