Communitygithub.com

SingleGrain-Team/video-skills

Construye un sting de presentación de logo de 6-8 segundos donde la marca viaja dentro de una gota de vidrio líquido refractada (distorsionada hasta ser ilegible), la gota se hincha, se congela un instante, luego estalla en gotitas y deja el logotipo (marca más texto) nítido y erguido en pantalla. Se entrega como un MP4 H.264 1920×1080 más el proyecto editable de HyperFrames, sin modelo 3D, metraje de stock ni modelo generativo. Úsalo para intros y outros de marca, aperturas de lanzamiento de productos, stings de canal y cualquier momento de 'revelar nuestro logo' a partir de un SVG o PNG (incluyendo logos solo raster), un texto de marca y una paleta.

¿Qué es video-skills?

Esta habilidad para asistentes de IA (compatible con Claude Code, Cursor, Codex y otros) genera una animación profesional de revelación de logotipo con un enfoque puramente algorítmico y determinista. A diferencia de soluciones que usan modelos 3D, metraje de archivo o modelos generativos (como IA de video), esta herramienta se basa en WebGL (Three.js) para crear una gota de vidrio con transmisión física, desplazamiento de superficie por ruido y dispersión. El logotipo se coloca detrás de la gota, se refracta hasta volverse ilegible y luego, en una secuencia coreografiada, la gota se congela, estalla en 15 gotitas y el logotipo aparece nítido. Es útil para diseñadores, creadores de contenido y equipos de marketing que necesitan intros de marca personalizadas y replicables sin depender de servidores externos ni activos con derechos de autor. Funciona con HyperFrames, un renderizador de fotogramas basado en web, y admite logotipos SVG o PNG (incluyendo aquellos sin fondo transparente, que pueden procesarse). La animación es totalmente determinista: cada fotograma es una función pura del tiempo de búsqueda, lo que garantiza renders reproducibles. Incluye parámetros de ajuste como el grosor de la gota, la amplitud de desplazamiento, la duración y la paleta de colores, y proporciona comandos para validación (lint, check) y renderizado final en MP4.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SingleGrain-Team/video-skills/tree/HEAD/skills/liquid-logo-reveal

Preguntar en tu IA favorita

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

Documentación

Revelación de logotipo líquido

Una gota de vidrio WebGL (Three.js) con transmisión física, superficie desplazada por ruido y dispersión se sitúa frente al logotipo. El logotipo se refracta tanto que no puede leerse. Se acumula presión, todo se congela por un instante, la gota estalla, 15 gotitas vuelan, y la marca se desliza hacia la izquierda mientras el texto emerge desde detrás de ella. Los fotogramas son funciones puras del tiempo de búsqueda, por lo que los renders son deterministas.

Entradas

EntradaNotas
Marca del logotipoSVG o PNG. Solo la marca (símbolo), forma más bien cuadrada, fondo transparente.
Texto de marcaUna cadena de texto tipografiada en Inter por defecto. Si la marca tiene un texto gráfico real, consulta 'Texto como obra gráfica'.
PaletaTres colores: un acento fuerte, un tinte suave, un neutro apagado. Se convierten en campos de color borrosos detrás del vidrio; el vidrio es incoloro y solo muestra lo que tiene detrás. Color de tinta para el texto de marca.
DuraciónPor defecto 7 s. La pausa después de que el logotipo se asienta es la única parte que deberías estirar.

Usa únicamente los activos que el usuario haya proporcionado o que estén en el kit de marca. Nunca obtengas logotipos de la web.

Logotipos solo raster

  • La plantilla requiere un PNG con canal alfa. Si el logotipo tiene fondo opaco (JPG, recuadro blanco), elimínalo primero (npx hyperframes remove-background, o pídele al usuario un archivo transparente). No entregues un cuadrado blanco refractándose dentro de la gota.
  • Un PNG pequeño (menos de ~600 px) es suficiente porque la marca se muestra a unos 250 px en reposo, pero se escala a ~360 px dentro de la gota. Mantén la fuente al menos 512 px en el lado más largo.
  • Recorta el relleno transparente para que la marca visible llene la imagen; el código dimensiona el cuadro de la imagen, no la tinta.
  • SVG: rasteriza a un PNG de unos 1720 px en el lado más largo (captura de pantalla con headless Chrome, o rsvg-convert -w 1720), conserva el alfa y apunta data-logo-src a él. No redibujes ni recolorees el logotipo.
  • Si el logotipo de la marca es una imagen combinada (marca y texto fusionados), no puedes separarlos limpiamente. Usa el logotipo completo como marca, establece data-wordmark="" y omite la aparición del texto (configura el clip del texto para que esté siempre oculto). La marca entonces se ancla al centro, no a la izquierda.

Flujo de trabajo de construcción

  1. Andamio: npx --yes hyperframes init <dir> -e blank --non-interactive --skip-skills, luego reemplaza su index.html con el template/index.html de esta habilidad y copia template/js/, template/assets/logo.png (sobrescribe con la marca).
  2. Añade las dependencias como archivos locales para que el renderizado nunca toque la red. En un directorio temporal (NO dentro de otro proyecto, npm i sube hasta el package.json más cercano) ejecuta npm i [email protected] [email protected] @fontsource-variable/inter, luego copia en el proyecto:
    • gsap/dist/gsap.min.js a vendor/gsap.min.js
    • three/build/three.module.js y three/build/three.core.js a vendor/three/build/
    • three/examples/jsm/environments/RoomEnvironment.js a vendor/three/examples/jsm/environments/
    • @fontsource-variable/inter/files/inter-latin-wght-normal.woff2 a assets/fonts/
  3. Personaliza con los atributos data-* en #root dentro de index.html: data-logo-src, data-wordmark, data-ink, data-fields (tres colores hex). Mantén los campos saturados en el acento y suaves en los demás; nunca hagas que el campo detrás del centro de la gota sea oscuro y plano.
  4. Revisa y verifica: npx --yes hyperframes lint luego npx --yes hyperframes check. Ambos deben estar limpios.
  5. Revisión de fotogramas (abajo). Ajusta. Repite.
  6. Renderiza: npx --yes hyperframes render --workers 2 --output final.mp4. Verifícalo: ffprobe debe reportar h264, 1920×1080, 30 fps, la duración esperada.

Reglas de movimiento (lo que hace que el formato funcione)

  • Ilegible, no invisible. Antes del estallido, el espectador debe ver color y formas distorsionadas de la marca, nunca leerla. Si un fotograma muestra el logotipo reconocible, aumenta thickness / amplitud de desplazamiento / giro; si la gota es una mancha plana sin indicio de la marca, redúcelos.
  • La marca está detrás del vidrio, en el pase opaco. El plano previo al estallido usa alphaTest (cola opaca) para que el pase de transmisión de Three pueda refractarlo. Un plano transparent: true normal no se refractaría. La copia 'revelada' es transparente y se intercambia solo después de que la carcasa haya colapsado.
  • Fases, en orden (todas las constantes en T al principio de js/liquid-reveal.js): establecimiento (recorte cercano a gota completa, 0,7 s) luego rendimiento líquido, acumulación de presión (la gota se aplasta más ancha y plana, la marca se hincha de 1,00 a 1,06), coma (0,4 s de inmovilidad total: cámara, marca, gota y reloj del sombreado congelados), ruptura (la carcasa colapsa en 0,2 s con una facilidad de potencia 4, las gotitas se lanzan radialmente), anclaje (la marca retrocede y luego se desliza a su posición de bloqueo mientras el texto emerge desde detrás), pausa.
  • La inmovilidad es el punto. La congelación de 0,4 s antes del estallido es lo que vende la ruptura. Sin respiración ociosa, flotación o brillo en bucle en ningún lugar.
  • El reloj del sombreado está controlado. El tiempo de ruido avanza solo en ventanas autorizadas y se congela en la coma y después del anclaje.
  • El texto emerge desde la marca, nunca aparece de golpe. El borde izquierdo de su clip sigue el borde derecho de la marca, por lo que el texto nunca es sobrescrito por la marca durante el anclaje.
  • Gotitas: diseño fijo de ángulo dorado (sin Math.random), lanzamiento radial, un término de gravedad, luego se reducen a nada para que el fotograma final esté limpio.
  • Termina con un bloqueo estático. Marca y texto erguidos, centrados como un par, sin atenuación. Si la pieza es una intro que se cortará en un video más largo, acorta la pausa en lugar de atenuar.
  • Determinismo: todo se calcula a partir del tiempo hf-seek. Sin requestAnimationFrame, Date.now, Math.random. La única medición del DOM es el ancho del texto, tomada una vez al cargar (canvas measureText con la fuente incluida).

Ajustes

QuieresCambia
Más largo o más cortoConstantes T y data-duration en #root y en ambos elementos .clip (mantenlos iguales)
Gota más abstractaaumenta thickness (3,2) o la amplitud de desplazamiento (0,15); reduce para legibilidad
Aspecto gelatinoso vs. de gotitadispersion, attenuationColor en liquidMaterial()
Bloqueo más grande o más pequeñoL.markPx, L.fontPx, L.gap
Fondo más tranquiloreduce los tres pesos de campo * 0.50 / 0.80 / 0.35 en el sombreado de fondo

Texto como obra gráfica

Si la marca proporciona un SVG/PNG del texto, reemplaza el texto #wordmark con un <img> de la misma lógica de posición y ancho: mide su relación de aspecto, establece su altura a L.fontPx * 0.8 y mantén la misma lógica de clip-path. Nunca reescribas un texto estilizado con una fuente sustituta.

Validación

  • lint y check limpios (un error de lint deshabilita silenciosamente las auditorías de diseño).
  • Extrae fotogramas y míralos: npx --yes hyperframes snapshot --at 0.3,1.5,3.3,3.55,3.9,6.5 y abre snapshots/contact-sheet.jpg, o ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png sobre el render. Verifica: (1) los primeros fotogramas muestran una gota donde la marca no puede leerse, (2) el fotograma justo después del estallido no tiene texto superpuesto a la marca, (3) el texto a medio anclar está recortado por el borde de la marca, (4) el fotograma final tiene marca más texto nítidos, centrados, sin gotitas, sin glifos recortados.
  • Fallos comunes: lienzo en blanco (ruta de importmap incorrecta, o three.core.js de WebGL no copiado), texto descentrado (fuente no cargada antes de medir), logotipo con recuadro blanco (PNG opaco).

Entrega

Entrega final.mp4 y la carpeta del proyecto (index.html, js/, assets/, vendor/) para que pueda ser personalizado editando los atributos data-*. El audio es opcional; un breve SFX de estallido en el momento de ruptura T.pop es el único sonido que la pieza necesita. Obtén cualquier sonido a través de la habilidad media-use con un resultado con licencia comercial; de lo contrario, entrégalo sin sonido.

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

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

Make a roughly 30-second film that explains a code change (a pull request, release or uncommitted diff) to people who will never read the diff. It opens by showing the real diff scrolling past too fast to follow, cuts to a plain-language summary, fires four capability beats each pinned to a real code snippet, and closes on how to get it (install command and URL). Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project. Use when asked to turn a PR, changelog or release into a launch or explainer video.

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