Communitygithub.com

SingleGrain-Team/video-skills

Crea un vídeo de unos 30 segundos que explica un cambio de código (PR, release o diff local) a personas que nunca leerán el diff.

¿Qué es video-skills?

Este skill permite generar automáticamente un vídeo explicativo de ~30 segundos a partir de un cambio de código (como un Pull Request, release o diff sin commit), dirigido a audiencias que no leerán el código técnico. El vídeo sigue una estructura de cinco movimientos: un gancho con el número de archivos modificados, una secuencia rápida del diff real (ilegible a propósito), un resumen en lenguaje sencillo, cuatro destellos de capacidades anclados a fragmentos de código reales, y un cierre con el comando de instalación y la URL. Está diseñado para ser determinista, sin elementos aleatorios, y utiliza el generador HyperFrames para crear un proyecto editable. Soporta entradas desde GitHub (PR, release) o el árbol de trabajo local, y produce un MP4 1920x1080 H.264 junto con la carpeta del proyecto. Es ideal para lanzamientos, changelogs o vídeos explicativos que transforman diffs complejos en narrativas visuales accesibles.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SingleGrain-Team/video-skills/tree/HEAD/skills/pr-explainer-film

Preguntar en tu IA favorita

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

Documentación

pr-explainer-film

Una película muda por defecto, de ~30 segundos, en cinco movimientos. La forma es el punto clave: el espectador siente que el diff es ininteligible, luego obtiene la respuesta en palabras sencillas, después ve la prueba, y finalmente sabe qué escribir.

TiempoMovimientoPropósito
0-2sGanchoNombrar el tamaño del cambio ("15 archivos modificados.")
2-8sDifuminado del diffLos fragmentos reales pasan rápidamente; los contadores aumentan
8-13sPalabras sencillasUn titular de una frase más tres puntos breves
13-23sCuatro destellosUna capacidad cada uno, mostrada junto a las líneas reales que la sustentan
23-30sCierreEl comando de instalación se escribe carácter por carácter, luego la URL

Entradas

Recopila estos datos antes de construir. Pregunta solo por lo que falte.

  1. Fuente del cambio: un PR o release de GitHub (gh pr diff, gh pr view --json title,body,files), o un árbol de trabajo local (git diff más archivos no rastreados). Solo lectura; nunca modifiques el repositorio.
  2. Audiencia: quién no leerá el diff (clientes, compañeros de equipo, seguidores). Esto determina el vocabulario en el resumen y los destellos.
  3. CTA: el comando de instalación exacto y/o la URL. Úsalo textualmente. Si el producto tiene un solo comando canónico, muestra solo ese comando y ningún otro nombre de herramienta.
  4. Marca: paleta, logotipo (tu propio archivo), tipografía. Los valores predeterminados en la plantilla son neutros y oscuros.

Flujo de trabajo

  1. Lee el cambio. Obtén la lista de archivos con recuentos de añadidos/eliminados y los fragmentos reales. Escribe el cambio en una frase que un no ingeniero entendería; si no puedes, aún no entiendes el cambio.
  2. Elige el contenido (consulta references/content-rules.md): número del gancho, 5-8 fragmentos del diff para el difuminado, 3 puntos del resumen, exactamente 4 destellos de capacidades, CTA.
  3. Andamiaje. npx --yes hyperframes init <dir> --non-interactive --example=blank, luego copia template/index.html y template/film.config.js sobre los archivos generados. Coloca tu logotipo en assets/logo.png si tienes uno.
  4. Rellena film.config.js. Todo el texto, fragmentos y números residen allí. Edita index.html solo para cambiar las variables de marca en :root, los tiempos o el diseño.
  5. Valida: npx --yes hyperframes lint luego npx --yes hyperframes check. Corrige todos los errores. Advertencias aceptables conocidas: nested_structure_needs_subcomposition (la película es intencionadamente un solo archivo para facilitar el cambio de marca).
  6. Míralo. npx --yes hyperframes snapshot --at 1,4,6,8.3,11,14,17,19.5,22,26,29 y abre snapshots/contact-sheet-*.jpg. Verifica la lista a continuación; corrige y toma nuevas instantáneas hasta que esté limpio.
  7. Renderiza. npx --yes hyperframes render --quality high --workers 2 --output final.mp4. Confirma con ffprobe que sea 1920x1080, H.264, y de 28-34s.
  8. Revisa de 4 a 6 fotogramas extraídos del MP4 (ffmpeg -ss T -i final.mp4 -frames:v 1 f.png), no solo las instantáneas.

Reglas que hacen que el formato funcione

  • El diff debe ser real. Copia líneas reales del diff real. Nunca inventes código o recuentos. Calcula los recuentos a partir de git diff --shortstat más wc -l de los nuevos archivos.
  • Ilegible a propósito. El desplazamiento se acelera (power2.in) y se difumina. No lo ralentices para que la gente pueda leer; la carta de "demasiado para leer" compensa eso.
  • Palabras antes que pruebas. El resumen viene antes de cualquier destello de capacidad. Cada título de destello es un beneficio en 2-4 palabras; la descripción es una frase sin jerga; el fragmento son 1-5 líneas reales con la línea clave resaltada.
  • Exactamente cuatro destellos, una idea cada uno, de unos 2,6 segundos cada uno. Elimina los más débiles en lugar de reducir el texto.
  • Superficies alternas. Oscuro para el diff y los destellos, una escena clara para el resumen. El cambio de fondo señala "ahora es simple".
  • Cierra con el comando. Escribe el comando real carácter por carácter, luego muestra la URL. Sin segundo CTA.
  • Higiene de copia. Elimina los comentarios de código que mencionen competidores o herramientas no relacionadas antes de que lleguen a un fragmento. Nunca muestres una CLI que no sea la del CTA.
  • Tus propios activos. Usa tu propio logotipo, tipografías que la máquina ya tenga, y ningún medio de stock o de terceros. La música es opcional; si se usa, solo pistas con licencia para uso comercial (resuelve a través de media-use), y mantén la película completamente legible sin sonido.
  • Determinismo. Sin Math.random, Date.now ni llamadas de red en la composición; anima el texto escrito y los contadores a partir de un valor de progreso de interpolación para que la búsqueda sea exacta.

Lista de verificación de fotogramas (pasos 6 y 8)

  • El número del gancho y el texto coinciden con el cambio real.
  • La ventana del diff se recorta dentro de su marco; los encabezados de archivo y las líneas verdes/rojas son legibles en reposo, difuminadas al moverse.
  • Los contadores terminan en los números reales.
  • La diapositiva del resumen muestra los tres puntos antes de que se desvanezca.
  • Cada destello tiene título, frase y fragmento visibles juntos, nada recortado.
  • El fotograma final muestra el comando completo y la URL, escritos exactamente.

Entrega

Entrega final.mp4 y la carpeta del proyecto (index.html, film.config.js, assets/, meta.json). Reporta la ruta, duración y cualquier advertencia de validación que haya sido aceptada. La carpeta se rerenderiza con el mismo comando; para cambiar la marca o reutilizar para el próximo lanzamiento, edita solo film.config.js.

Consulta references/content-rules.md para límites de tamaño y redacción.

Individual skills in this repo

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

SingleGrain-Team/video-skills

Make a 30-45 second launch film for a product by staging it inside one persistent, neutral chat window. A user types a request, the assistant answers and calls the product as a connected tool, a progress card runs, a follow-up triggers a second tool action, and the result lands as a count-up headline number before closing on the logo, tagline and call to action. Use when you need a launch, feature or integration announcement video for something that plugs into AI assistants (a skill, MCP server, plugin, connector, CLI). Delivers a rendered 1920x1080 MP4 plus an editable single-file HyperFrames project.

SingleGrain-Team/video-skills

Build a motion graphic where a screen recording plays in a large frame beside a checklist, and each checklist item ticks off at the exact moment that step happens in the recording, ending with every item checked and a short hold. Use when someone has a screen recording (product walkthrough, tutorial, onboarding, install demo) plus a list of steps with timestamps and wants a "watch the steps get done" film. Input is a recording, step labels with timestamps, a title and an optional palette; output is a 1920x1080 H.264 MP4 and the editable HyperFrames project.

SingleGrain-Team/video-skills

Build a 15-20 second product launch film that shows the product's real screen on a laptop built from plain CSS (no 3D model, no generation model) in a dark studio, scrolls the page, zooms into the interface for one key action such as typing a search, and resolves to the logo lockup. Use when someone has a full-page screenshot or screen recording of their product, one action worth showing, and a logo, and wants a short silent-friendly launch teaser rendered as a 1920x1080 MP4 with an editable HyperFrames project.

SingleGrain-Team/video-skills

Builds a 6-8 second logo sting in which the brand mark rides inside a refracting liquid bead (distorted past legibility), the bead swells, holds still for a beat, then ruptures into droplets and leaves the logo lockup (mark plus wordmark) crisp and upright on screen. Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project, with no 3D model, stock footage or generation model. Use it for brand intros and outros, product-launch openers, channel stings and any "reveal our logo" moment, from an SVG or PNG logo (including raster-only logos), a wordmark string and a palette.

SingleGrain-Team/video-skills

Make a 20-30 second launch film for a product that is not tied to one interface, such as a CLI, package, plugin or agent skill. The identical prompt or command is typed into four visually different surfaces in turn (a wide terminal, a tall chat card, a floating palette, an editor cell), the film then hard-cuts into a fast reel of real outputs on a beat or fixed tempo grid, and it closes on the command in a large pill. Delivered as a rendered 1920x1080 MP4 plus the editable HyperFrames project. Music is optional - with a track the cuts land on detected beats, without one they land on a 120 bpm grid.

SingleGrain-Team/video-skills

Render a 5-6 second motion graphic in which an oversized condensed headline (2-4 words) punches in behind a presenter, using a background-removed cutout of the presenter layered on top of the lettering. A hard cut then removes the presenter while the same headline holds the exact same size and position, and a short supporting line appears for a reading hold. Use it for talking-head intros, chapter openers, launch announcements and social hooks when you have one presenter clip, a headline, a supporting line and a palette. Built on HyperFrames; delivers a 1920x1080 H.264 MP4 plus the editable project.

SingleGrain-Team/video-skills

Builds a 10-14 second product sting out of a short run of UI moments (an entry screen, a single counting metric, a navigation list, one click that opens a menu, then an endcard) cut together so every cut carries the previous motion forward and the piece reads as one continuous camera move. Delivered as a 1920x1080 H.264 MP4 plus an editable single-file HyperFrames project. Use it for app launches, feature teasers, social bumpers and site intros when you have a product's logo, a couple of screenshots, one headline number and its real nav labels, and want polished UI motion without narration.

Skills relacionados