Communitygithub.com

SingleGrain-Team/video-skills

Construit un sting de logo de 6 à 8 secondes où le symbole de la marque se tient à l'intérieur d'une goutte de liquide réfractante (distordue jusqu'à l'illisibilité), la goutte gonfle, reste immobile un instant, puis éclate en gouttelettes et laisse le logo complet (symbole + mot-symbole) net et droit à l'écran. Livré en MP4 H.264 1920×1080 avec le projet HyperFrames modifiable, sans modèle 3D, vidéo libre de droits ni modèle de génération. Utilisez-le pour les intros et outros de marque, les lancements de produits, les stings de chaîne et tout moment de « révélation de notre logo », à partir d'un logo SVG ou PNG (y compris les logos uniquement matriciels), d'une chaîne de mot-symbole et d'une palette.

Qu'est-ce que video-skills ?

Cette compétence génère une animation de révélation de logo de 6 à 8 secondes, entièrement procédurale et déterministe, en utilisant Three.js et GSAP. Elle crée une goutte de verre avec transmission physique, déplacement de surface bruité et dispersion, qui réfracte le logo derrière elle jusqu'à le rendre illisible. Après une phase de compression et un arrêt total, la goutte éclate, libérant 15 gouttelettes, et le logo se révèle net, avec le mot-symbole qui apparaît par un wipe depuis le symbole. Le rendu est déterministe : chaque image est une fonction pure du temps, garantissant des résultats reproductibles. La compétence est conçue pour les agents d'IA comme Claude Code et les utilisateurs de HyperFrames. Elle prend en charge les logos SVG et PNG (y compris les logos matriciels avec fond non transparent, qui sont automatiquement nettoyés) et une palette de trois couleurs. Le workflow inclut l'initialisation du projet, l'installation des dépendances, la configuration des attributs de données, le linting et le rendu final en MP4 H.264 1920×1080. L'accent est mis sur l'illisibilité contrôlée avant l'éclatement, un arrêt total pour vendre l'effet, et la déterminisme complet, sans éléments aléatoires. La livraison inclut le fichier vidéo et le projet complet pour une réutilisation et un re-branding faciles.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Révélation de logo liquide

Une bille de verre WebGL (Three.js) avec transmission physique, surface déplacée par du bruit et dispersion se tient devant le logo. Le logo est réfracté si fortement qu'il est illisible. La pression monte, tout se fige un instant, la bille éclate, 15 gouttelettes s'envolent, le symbole glisse vers la gauche tandis que le mot-symbole apparaît derrière lui. Les images sont des fonctions pures du temps de recherche, donc les rendus sont déterministes.

Entrées

EntréeRemarques
Symbole du logoSVG ou PNG. Symbole uniquement (pas le mot-symbole), de forme carrée, fond transparent.
Mot-symboleUne chaîne de texte typographiée en Inter par défaut. Si la marque a un vrai mot-symbole graphique, voir « Mot-symbole comme œuvre d'art ».
PaletteTrois couleurs : un accent fort, une teinte douce, un neutre atténué. Elles deviennent des champs de couleur floutés derrière la bille ; la bille est incolore et ne montre que ce qui se trouve derrière elle. Couleur d'encre pour le mot-symbole.
Durée7 s par défaut. La seule partie que vous devriez étendre est le temps d'arrêt après que le logo complet s'est posé.

Utilisez uniquement les actifs fournis par l'utilisateur ou présents dans le kit de marque. Ne récupérez jamais de logos sur le Web.

Logos uniquement matriciels

  • Le modèle attend un PNG avec alpha. Si le logo a un fond opaque (JPG, boîte blanche), supprimez-le d'abord (npx hyperframes remove-background, ou demandez à l'utilisateur un fichier transparent). Ne livrez pas un carré blanc réfracté à l'intérieur de la bille.
  • Un petit PNG (moins de ~600 px) convient car le symbole est affiché à environ 250 px au repos, mais il est agrandi à environ 360 px à l'intérieur de la bille. Gardez la source d'au moins 512 px sur le côté le plus long.
  • Rognez les bords transparents pour que le symbole visible remplisse l'image ; le code dimensionne la boîte de l'image, pas l'encre.
  • SVG : convertissez en PNG d'environ 1720 px sur le côté le plus long (capture d'écran Chrome headless, ou rsvg-convert -w 1720), conservez l'alpha, et pointez data-logo-src vers celui-ci. Ne redessinez pas et ne recolorez pas le logo.
  • Si le logo de la marque est une image combinée (symbole et texte fusionnés), vous ne pouvez pas le séparer proprement. Utilisez l'image complète comme symbole, définissez data-wordmark="" et sautez l'apparition du mot-symbole (définissez le clip du mot-symbole pour qu'il soit toujours masqué). Le symbole se positionne alors au centre, pas à gauche.

Workflow de construction

  1. Échafaudage : npx --yes hyperframes init <dir> -e blank --non-interactive --skip-skills, puis remplacez son index.html par le template/index.html de cette compétence et copiez template/js/, template/assets/logo.png (remplacez par le symbole de la marque).
  2. Intégrez le runtime pour que le rendu ne touche jamais le réseau. Dans un répertoire temporaire (PAS à l'intérieur d'un autre projet, npm i remonte jusqu'au package.json le plus proche), exécutez npm i [email protected] [email protected] @fontsource-variable/inter, puis copiez dans le projet :
    • gsap/dist/gsap.min.js vers vendor/gsap.min.js
    • three/build/three.module.js et three/build/three.core.js vers vendor/three/build/
    • three/examples/jsm/environments/RoomEnvironment.js vers vendor/three/examples/jsm/environments/
    • @fontsource-variable/inter/files/inter-latin-wght-normal.woff2 vers assets/fonts/
  3. Marquez-le avec les attributs de données sur #root dans index.html : data-logo-src, data-wordmark, data-ink, data-fields (trois couleurs hexadécimales). Gardez les champs saturés pour l'accent et doux ailleurs ; ne faites jamais en sorte que le champ derrière le centre de la bille soit sombre et plat.
  4. Lint et vérification : npx --yes hyperframes lint puis npx --yes hyperframes check. Les deux doivent être propres.
  5. Révision des images (ci-dessous). Ajustez. Répétez.
  6. Rendu : npx --yes hyperframes render --workers 2 --output final.mp4. Sondez-le : ffprobe doit indiquer h264, 1920×1080, 30 ips, la durée attendue.

Règles de mouvement (ce qui fait fonctionner le format)

  • Illisible, pas invisible. Avant l'éclatement, le spectateur doit voir de la couleur et des formes déformées du symbole, jamais le lire. Si une image montre le logo de manière reconnaissable, augmentez thickness / l'amplitude de déplacement / la rotation ; si la bille est une goutte plate sans aucun indice du symbole, diminuez-les.
  • Le symbole se trouve derrière le verre, dans le passage opaque. Le plan avant l'éclatement utilise alphaTest (file d'attente opaque) pour que le passage de transmission de Three.js puisse le réfracter. Un simple plan transparent: true ne serait pas réfracté. La copie « révélée » est transparente et n'est échangée qu'après l'effondrement de l'enveloppe.
  • Phases, dans l'ordre (toutes les constantes dans T en haut de js/liquid-reveal.js) : établissement (cadrage serré à bille pleine, 0,7 s) puis performance liquide, montée en pression (la bille s'aplatit et s'élargit, le symbole gonfle de 1,00 à 1,06), virgule (0,4 s d'immobilité totale : caméra, symbole, bille et horloge du shader gelés), rupture (l'enveloppe s'effondre en 0,2 s avec une atténuation puissance 4, les gouttelettes partent radialement), positionnement (le symbole recule puis glisse vers son emplacement définitif tandis que le mot-symbole apparaît derrière lui), maintien.
  • L'immobilité est le point clé. La pause de 0,4 s avant l'éclatement est ce qui vend la rupture. Pas de respiration, de flottement ou de lueur en boucle.
  • L'horloge du shader est verrouillée. Le temps de bruit n'avance que dans les fenêtres définies et se fige lors de la virgule et après le positionnement.
  • Le mot-symbole émerge du symbole, jamais il n'apparaît brusquement. Le bord gauche de son clip suit le bord droit du symbole, de sorte que le texte n'est jamais recouvert par le symbole pendant le positionnement.
  • Gouttelettes : disposition fixe à angle d'or (pas de Math.random), lancement radial, un terme de gravité, puis rétrécissement jusqu'à disparaître pour que l'image finale soit propre.
  • Terminer sur un logo immobile. Symbole et mot-symbole droits, centrés en paire, sans fondu. Si la pièce est une intro qui sera montée dans une vidéo plus longue, raccourcissez le maintien au lieu d'ajouter un fondu.
  • Déterminisme : tout est calculé à partir du temps hf-seek. Pas de requestAnimationFrame, Date.now, Math.random. La seule mesure DOM est la largeur du mot-symbole, prise une fois au chargement (canvas measureText avec la police livrée).

Boutons de réglage

Résultat souhaitéModification
Plus long ou plus courtConstantes T et data-duration sur #root et sur les deux éléments .clip (maintenez-les égaux)
Bille plus abstraiteAugmentez thickness (3,2) ou l'amplitude de déplacement (0,15) ; diminuez pour la lisibilité
Aspect gélatineux vs. gouttelettesdispersion, attenuationColor dans liquidMaterial()
Logo plus grand ou plus petitL.markPx, L.fontPx, L.gap
Fond plus calmeDiminuez les trois pondérations de champ * 0.50 / 0.80 / 0.35 dans le shader d'arrière-plan

Mot-symbole comme œuvre d'art

Si la marque fournit un SVG/PNG de mot-symbole, remplacez le texte #wordmark par une <img> avec la même logique de position et de largeur : mesurez son rapport d'aspect, définissez sa hauteur sur L.fontPx * 0.8, et conservez la même logique clip-path. Ne retapez jamais un mot-symbole stylisé dans une police de substitution.

Validation

  • lint et check propres (une erreur de lint désactive silencieusement les audits de mise en page).
  • Extrayez des images et regardez-les : npx --yes hyperframes snapshot --at 0.3,1.5,3.3,3.55,3.9,6.5 et ouvrez snapshots/contact-sheet.jpg, ou ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png sur le rendu. Vérifiez : (1) les images précoces montrent une bille où le symbole est illisible, (2) l'image juste après l'éclatement n'a pas de texte de mot-symbole chevauchant le symbole, (3) le texte en cours de positionnement est rogné par le bord du symbole, (4) l'image finale a un symbole et un mot-symbole nets, centrés, sans gouttelettes, sans glyphes rognés.
  • Échecs courants : toile blanche (chemin d'importmap incorrect, ou three.core.js WebGL non copié), mot-symbole décentré (police non chargée avant la mesure), logo avec une boîte blanche (PNG opaque).

Livraison

Remettez final.mp4 et le dossier du projet (index.html, js/, assets/, vendor/) afin qu'il puisse être re-marqué en modifiant les attributs data-*. L'audio est optionnel ; un court effet sonore de pop au moment de la rupture T.pop est le seul son dont la pièce a besoin. Obtenez tout son via la compétence media-use avec un résultat sous licence commerciale, sinon livrez-le sans son.

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 associés