Communitygithub.com

SingleGrain-Team/video-skills

Erzeugt einen 6-8-sekündigen Logo-Sting, bei dem die Bildmarke in einer brechenden Flüssigkeitsperle (bis zur Unleserlichkeit verzerrt) reitet, die Perle anschwillt, kurz stillsteht, dann aufplatzt und in Tropfen zerfällt – zurück bleibt das Logo-Lockup (Marke plus Wortmarke) klar und aufrecht auf dem Bildschirm. Ausgeliefert als 1920×1080 H.264 MP4 plus editierbares HyperFrames-Projekt, ohne 3D-Modell, Stockmaterial oder Generierungsmodell. Ideal für Brand-Intros und -Outros, Produkt-Launch-Opener, Channel-Stings und jeden „Zeige unser Logo“-Moment – ausgehend von einem SVG/PNG-Logo (auch reine Rasterlogos), einer Wortmarke und einer Farbpalette.

Was ist video-skills?

Dieses Skill generiert einen professionellen, flüssigkeitsbasierten Logo-Reveal als 6–8-sekündiges Video. Es verwendet WebGL (Three.js), um eine Glasperle mit physikalischer Transmission, rauschbasierter Oberflächenverschiebung und Dispersion zu simulieren. Das Logo wird durch die Perle so stark verzerrt, dass es unleserlich wird, bevor die Perle nach einem kurzen Stillstand aufplatzt und 15 Tropfen wegfliegen. Danach gleitet die Bildmarke nach links, während die Wortmarke hinter ihr hervorwischt. Das Besondere ist die vollständige Deterministik: Alle Frames sind reine Funktionen der Suchzeit, sodass Renderings reproduzierbar und ohne Zufallselemente sind. Das Skill unterstützt sowohl SVG- als auch PNG-Logos (auch solche mit undurchsichtigem Hintergrund, der automatisch entfernt werden kann) und erfordert nur eine Bildmarke, eine Wortmarke (oder als Grafik) und eine Palette aus drei Farben. Der Workflow nutzt das HyperFrames-Tool zur Initialisierung, zum Linting, zur Überprüfung und zum Rendering. Das Ergebnis ist ein H.264-MP4 in 1920×1080 bei 30 fps sowie das gesamte bearbeitbare Projekt, sodass es durch Änderung von data-Attributen problemlos umgebrandet werden kann. Das Skill ist für Entwickler und Kreative gedacht, die ihr CI/CD-Pipeline für Videoinhalte nutzen möchten.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Flüssig-Logo-Reveal

Eine WebGL-Glasperle (Three.js) mit physikalischer Transmission, rauschversetzter Oberfläche und Dispersion sitzt vor dem Logo. Das Logo wird so stark gebrochen, dass es nicht lesbar ist. Druck baut sich auf, alles friert für einen Moment ein, die Perle platzt, 15 Tropfen fliegen weg, die Marke gleitet nach links, während die Wortmarke von hinten hervorwischt. Frames sind reine Funktionen der Suchzeit, daher sind Renderings deterministisch.

Eingaben

EingabeHinweise
LogomarkeSVG oder PNG. Nur die Marke (Symbol), annähernd quadratisch, transparenter Hintergrund.
WortmarkeEin Textstring, standardmäßig in Inter gesetzt. Falls die Marke eine echte Wortmarken-Grafik hat, siehe „Wortmarke als Grafik“.
PaletteDrei Farben: ein kräftiger Akzent, ein sanfter Farbton, ein gedämpftes Neutral. Sie werden zu verschwommenen Farbfeldern hinter dem Glas; das Glas ist farblos und zeigt nur, was dahinter ist. Schriftfarbe für die Wortmarke.
DauerStandard 7s. Der Halt, nachdem das Lockup landet, ist der einzige Teil, den Sie dehnen sollten.

Verwenden Sie nur Assets, die der Benutzer bereitgestellt hat oder die sich im Marken-Kit befinden. Rufen Sie niemals Logos aus dem Internet ab.

Nur-Raster-Logos

  • Die Vorlage erwartet ein PNG mit Alphakanal. Wenn das Logo einen undurchsichtigen Hintergrund hat (JPG, weißer Kasten), entfernen Sie ihn zuerst (npx hyperframes remove-background, oder fragen Sie den Benutzer nach einer transparenten Datei). Liefern Sie kein weißes Quadrat aus, das in der Perle gebrochen wird.
  • Ein kleines PNG (unter ~600px) ist in Ordnung, da die Marke im Ruhezustand mit etwa 250px angezeigt wird, aber in der Perle auf ~360px skaliert wird. Halten Sie die Quelle auf der langen Seite mindestens 512px.
  • Entfernen Sie transparente Ränder, sodass die sichtbare Marke das Bild ausfüllt; der Code dimensioniert die Bildbox, nicht die Tinte.
  • SVG: Rastern Sie es in ein PNG mit etwa 1720px auf der langen Seite (Headless-Chrome-Screenshot oder rsvg-convert -w 1720), behalten Sie den Alphakanal und setzen Sie data-logo-src darauf. Zeichnen Sie das Logo nicht neu und färben Sie es nicht um.
  • Falls das Markenlogo ein kombiniertes Lockup-Bild ist (Marke und Text verschmolzen), können Sie es nicht sauber trennen. Verwenden Sie das gesamte Lockup als Marke, setzen Sie data-wordmark="" und überspringen Sie den Wortmarken-Wipe (setzen Sie den Wortmarken-Clip auf immer versteckt). Die Marke dockt dann mittig, nicht links an.

Build-Workflow

  1. Gerüst erstellen: npx --yes hyperframes init <dir> -e blank --non-interactive --skip-skills, dann index.html durch die template/index.html dieses Skills ersetzen und template/js/ sowie template/assets/logo.png kopieren (mit der Bildmarke überschreiben).
  2. Die Laufzeit vendorisieren, sodass das Rendern nie das Netzwerk berührt. Führen Sie in einem Scratch-Verzeichnis (NICHT innerhalb eines anderen Projekts, npm i geht bis zur nächsten package.json hoch) npm i [email protected] [email protected] @fontsource-variable/inter aus, kopieren Sie dann in das Projekt:
    • gsap/dist/gsap.min.js nach vendor/gsap.min.js
    • three/build/three.module.js und three/build/three.core.js nach vendor/three/build/
    • three/examples/jsm/environments/RoomEnvironment.js nach vendor/three/examples/jsm/environments/
    • @fontsource-variable/inter/files/inter-latin-wght-normal.woff2 nach assets/fonts/
  3. Branding mit den data-Attributen auf #root in index.html: data-logo-src, data-wordmark, data-ink, data-fields (drei Hex-Farben). Halten Sie die Felder beim Akzent gesättigt und sonst weich; machen Sie das Feld hinter der Mitte der Perle niemals dunkel und flach.
  4. Linten und prüfen: npx --yes hyperframes lint dann npx --yes hyperframes check. Beide müssen sauber sein.
  5. Frame-Review (siehe unten). Optimieren. Wiederholen.
  6. Rendern: npx --yes hyperframes render --workers 2 --output final.mp4. Überprüfen: ffprobe sollte h264, 1920×1080, 30fps, die erwartete Dauer melden.

Bewegungsregeln (was das Format zum Funktionieren bringt)

  • Unleserlich, nicht unsichtbar. Vor dem Platzen sollte der Betrachter Farbe und verzerrte Formen der Marke sehen, sie aber nie lesen können. Wenn ein Frame das Logo erkennbar zeigt, erhöhen Sie thickness / Verschiebungsamplitude / Drehung; wenn die Perle ein flacher Klecks ohne Andeutung der Marke ist, verringern Sie sie.
  • Die Marke sitzt hinter dem Glas, im undurchsichtigen Durchgang. Die Vor-Platzen-Ebene verwendet alphaTest (undurchsichtige Warteschlange), damit der Transmissionsdurchgang von Three sie brechen kann. Eine einfache transparent: true-Ebene würde nicht gebrochen werden. Die „enthüllte“ Kopie ist transparent und wird erst eingetauscht, wenn die Hülle kollabiert ist.
  • Phasen, in der Reihenfolge (alle Konstanten in T oben in js/liquid-reveal.js): etablieren (enger Bildausschnitt zur vollen Perle, 0.7s) dann flüssige Performance, Druckaufbau (Perle wird breiter und flacher, Marke schwillt von 1.00 auf 1.06), Komma (0.4s totale Stille: Kamera, Marke, Perle und Shader-Uhr eingefroren), Ruptur (Hülle kollabiert in 0.2s mit Power-4-Ease-In, Tropfen starten radial), Andocken (Marke federt zurück und gleitet dann in ihren Lockup-Slot, während die Wortmarke von hinten hervorwischt), Halten.
  • Die Stille ist der Punkt. Der 0.4s-Einfrierpunkt vor dem Platzen ist das, was die Ruptur verkauft. Kein atmendes Schweben, keine Loop-Glühereffekte.
  • Die Shader-Uhr ist getaktet. Die Rauschzeit schreitet nur in autorisierten Fenstern voran und friert beim Komma und nach dem Andocken ein.
  • Die Wortmarke erscheint von der Marke aus, platzt nie herein. Ihr Clip-Linkskante folgt der rechten Kante der Marke, sodass der Text während des Andockens nie von der Marke übermalt wird.
  • Tropfen: Goldener-Winkel-festes Layout (kein Math.random), radialer Start, ein Schwerkraftterm, dann schrumpfen zu nichts, sodass der letzte Frame sauber ist.
  • Ende mit einem stillen Lockup. Marke und Wortmarke aufrecht, als Paar zentriert, kein Ausblenden. Wenn das Stück ein Intro ist, das in ein längeres Video geschnitten wird, verkürzen Sie das Halten anstatt auszublenden.
  • Determinismus: Alles wird aus der hf-seek-Zeit berechnet. Kein requestAnimationFrame, Date.now, Math.random. Die einzige DOM-Messung ist die Breite der Wortmarke, einmal beim Laden gemessen (Canvas measureText mit der ausgelieferten Schriftart).

Einstellknöpfe

WunschÄnderung
Länger oder kürzerT-Konstanten und data-duration auf #root und auf beiden .clip-Elementen (gleich halten)
Abstraktere Perlethickness (3.2) oder die Verschiebungsamplitude (0.15) erhöhen; zum Lesbarmachen verringern
Geleeartig vs. tropfenförmigdispersion, attenuationColor in liquidMaterial()
Größeres oder kleineres LockupL.markPx, L.fontPx, L.gap
Ruhigerer HintergrundDie drei Feldgewichte * 0.50 / 0.80 / 0.35 im Hintergrundshader verringern

Wortmarke als Grafik

Wenn die Marke eine Wortmarke als SVG/PNG bereitstellt, ersetzen Sie den Text #wordmark durch ein <img> mit derselben Positions- und Breitenlogik: Messen Sie sein Seitenverhältnis, setzen Sie seine Höhe auf L.fontPx * 0.8 und behalten Sie dieselbe clip-path-Logik bei. Geben Sie eine stilisierte Wortmarke niemals in einer Ersatzschriftart wieder.

Validierung

  • lint und check sauber (ein Lint-Fehler deaktiviert stillschweigend die Layout-Prüfungen).
  • Extrahieren Sie Frames und betrachten Sie sie: npx --yes hyperframes snapshot --at 0.3,1.5,3.3,3.55,3.9,6.5 und öffnen Sie snapshots/contact-sheet.jpg, oder ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png auf dem Rendering. Überprüfen Sie: (1) frühe Frames zeigen eine Perle, in der die Marke nicht gelesen werden kann, (2) der Frame direkt nach dem Platzen hat keinen Wortmarkentext, der die Marke überlappt, (3) mid-dock-Text wird von der Markenkante abgeschnitten, (4) der letzte Frame hat eine scharfe Marke plus Wortmarke, zentriert, keine Tropfen, keine abgeschnittenen Glyphen.
  • Häufige Fehler: leere Leinwand (Importmap-Pfad falsch oder WebGL three.core.js nicht kopiert), Wortmarke nicht zentriert (Schriftart nicht geladen vor dem Messen), Logo mit weißem Kasten (undurchsichtiges PNG).

Lieferung

Übergeben Sie final.mp4 und den Projektordner (index.html, js/, assets/, vendor/), sodass er durch Bearbeiten der data-*-Attribute umgebrandet werden kann. Audio ist optional; ein kurzer Pop-SFX zum Zeitpunkt der Ruptur T.pop ist der einzige Ton, den das Stück braucht. Besorgen Sie Ton über das Skill media-use mit einem kommerziell lizenzierten Ergebnis, andernfalls liefern Sie stumm.

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.

Verwandte Skills