Communitygithub.com

SingleGrain-Team/video-skills(リキッドロゴリビール)

ブランドマークが屈折する液体のビーズ内部で歪み、膨らみ、一瞬静止した後、破裂して液滴が飛び散り、ロゴロックアップ(マーク+ワードマーク)を鮮明に画面中央に残す、6~8秒のロゴスティングを生成します。3Dモデル、ストック映像、生成モデルは使用せず、1920x1080 H.264 MP4と編集可能なHyperFramesプロジェクトを納品します。

video-skills(リキッドロゴリビール) とは?

このスキルは、WebGL(Three.js)を使った完全に決定論的なロゴリビールアニメーションを生成します。SVGまたはPNGのブランドロゴマーク、ワードマーク文字列、および3色のカラーパレットを入力として受け取り、ガラスのビーズ内部でロゴが激しく屈折して判読不能になるフェーズ、ビーズが膨張して一瞬静止するフェーズ、そしてビーズが破裂して15個の液滴が飛び散り、マークが左にスライドしながらワードマークが背後から現れるフェーズを経て、最終的に鮮明なロゴロックアップを表示します。アニメーションの全フレームはシーク時間の純粋関数であり、レンダリングは完全に再現可能です。対応プラットフォームはHyperFrames(Webベースのビデオレンダリングツール)であり、コマンドラインベースで動作します。主な特徴は、ラスターロゴのみからの入力対応、ブランドカラーの背景フィールド、フォント(Inter)を使用したワードマーク、そしてビーズの厚みや変位振幅を調整できるチューニングノブです。このスキルは、ブランドイントロやアウトロ、製品発表のオープニング、チャンネルスティングなど、「ロゴを披露する」瞬間に最適で、生成モデルに依存しないクリーンでプロフェッショナルなアニメーションを提供します。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

リキッドロゴリビール

WebGL(Three.js)で実装された物理的な透過性、ノイズで変位した表面、分散効果を持つガラスのビーズがロゴの前に配置されます。ロゴは強く屈折し、判読不可能になります。圧力が高まり、すべてが一瞬静止した後、ビーズが破裂し、15個の液滴が飛び散り、マークは左にスライド、ワードマークはその後ろからワイプアウトで現れます。すべてのフレームはシーク時間の純粋関数であり、レンダリングは決定論的です。

入力

入力備考
ロゴマークSVGまたはPNG。マークのみ(シンボル)、正方形に近い形状、透明な背景。
ワードマークデフォルトでInterフォントでタイプセットされたテキスト文字列。ブランドに実際のワードマークグラフィックがある場合は、「ワードマークをアートワークとして」を参照。
パレット3色:強いアクセントカラー、ソフトなティントカラー、落ち着いたニュートラルカラー。これらはガラスの背後にあるぼやけたカラーフィールドになります。ガラス自体は無色で、後ろにあるものだけを映します。ワードマークのインク色。
時間デフォルト7秒。ロックアップが着地した後のホールド部分のみを伸ばすことができます。

ユーザーが提供したアセットまたはブランドキットにあるアセットのみを使用してください。Webからロゴを取得しないでください。

ラスターロゴのみの場合

  • テンプレートはアルファチャンネル付きのPNGを必要とします。ロゴに不透明な背景(JPG、白いボックス)がある場合は、まず背景を削除してください(npx hyperframes remove-background、またはユーザーに透明ファイルを依頼してください)。白い四角形がビーズ内部で屈折しているような状態を納品しないでください。
  • 小さいPNG(約600px未満)でも問題ありません。マークは静止時で約250pxで表示されますが、ビーズ内部では約360pxに拡大されるため、ソース画像の長辺は少なくとも512px以上にしてください。
  • 透明なパディングをトリミングして、表示されるマークが画像を満たすようにしてください。コードは画像のボックスサイズを調整し、インクの領域ではありません。
  • SVGの場合:長辺約1720pxのPNGにラスタライズし(ヘッドレスChromeのスクリーンショット、またはrsvg-convert -w 1720)、アルファを保持し、data-logo-srcをその画像に指定してください。ロゴの再描画や色変更は行わないでください。
  • ブランドロゴが結合されたロックアップ画像(マークとテキストが一体化)の場合、きれいに分割できません。ロックアップ全体をマークとして使用し、data-wordmark=""を設定し、ワードマークワイプをスキップします(ワードマーククリップを常に非表示に設定)。マークは左ではなく中央にドッキングします。

ビルドワークフロー

  1. スキャフォールディング:npx --yes hyperframes init <dir> -e blank --non-interactive --skip-skills を実行し、生成された index.html をこのスキルの template/index.html で置き換え、template/js/ および template/assets/logo.png(ブランドマークで上書き)をコピーします。
  2. ランタイムをベンダー化し、レンダリングがネットワークにアクセスしないようにします。スクラッチディレクトリ(別のプロジェクト内では実行しないでください。npm i は最も近い package.json まで遡ります)で npm i [email protected] [email protected] @fontsource-variable/inter を実行し、その後プロジェクトにコピーします:
    • gsap/dist/gsap.min.js を vendor/gsap.min.js へ
    • three/build/three.module.js と three/build/three.core.js を vendor/three/build/ へ
    • three/examples/jsm/environments/RoomEnvironment.js を vendor/three/examples/jsm/environments/ へ
    • @fontsource-variable/inter/files/inter-latin-wght-normal.woff2 を assets/fonts/ へ
  3. index.html の #root にデータ属性を設定してブランディングします:data-logo-src、data-wordmark、data-ink、data-fields(3つの16進カラーコード)。フィールドはアクセントカラーで彩度を高く、それ以外はソフトに保ちます。ビーズの中心の背後にあるフィールドを暗くフラットにしないでください。
  4. リンターとチェックを実行:npx --yes hyperframes lint の後に npx --yes hyperframes check。両方ともエラーがないこと。
  5. フレームレビュー(下記)。調整。繰り返し。
  6. レンダリング:npx --yes hyperframes render --workers 2 --output final.mp4。プローブ:ffprobe で h264、1920x1080、30fps、期待される時間が報告されることを確認。

モーションルール(フォーマットを機能させるためのルール)

  • 判読不可能であって、不可視ではない。 破裂前、視聴者はマークからの色と歪んだ形状を見ることができますが、決して読める状態ではありません。フレームでロゴが認識できる場合は、thickness / 変位振幅 / スピンを上げてください。ビーズがマークの兆候のない平らな塊になっている場合は、下げてください。
  • マークはガラスの背後、不透明パスに配置。 破裂前の平面は alphaTest(不透明キュー)を使用し、Three.js の透過パスがそれを屈折できるようにします。単純な transparent: true の平面は屈折しません。「表示後」のコピーは透明で、シェルが崩壊した後にのみ切り替えられます。
  • フェーズ、順番に(すべての定数は js/liquid-reveal.js の先頭 T で定義):確立(クローズクロップからフルビーズ、0.7秒)→ 液体パフォーマンス、圧力蓄積(ビーズが幅広く平らに潰れ、マークが1.00から1.06に膨張)→ コンマ(0.4秒の完全な静止:カメラ、マーク、ビーズ、シェーダークロックがすべて停止)→ 破裂(シェルが0.2秒でパワー4のイーズインで崩壊、液滴が放射状に飛び出す)→ ドック(マークが反跳しロックアップスロットにスライド、ワードマークが背後からワイプアウト)→ ホールド。
  • 静止がポイント。 破裂前の0.4秒間のフリーズが破裂の効果を高めます。どこにも無意味な呼吸、フローティング、ループするグローはありません。
  • シェーダークロックはゲート制御。 ノイズの時間は許可されたウィンドウ内でのみ進行し、コンマとドック後は停止します。
  • ワードマークはマークから出現し、決してポップインしない。 そのクリップ左端はマークの右端を追跡するため、ドック中にマークによってテキストが上書きされることはありません。
  • 液滴:黄金角固定レイアウト(Math.random 不使用)、放射状打ち上げ、1つの重力項、その後収縮して消滅し、最終フレームをクリーンに保ちます。
  • 静止ロックアップで終了。 マークとワードマークは直立し、ペアで中央に配置。フェードアウトはなし。これが長い動画にカットされるイントロである場合は、フェードする代わりにホールドを短くしてください。
  • 決定論:すべては hf-seek 時間から計算されます。requestAnimationFrame、Date.now、Math.random は使用しません。唯一のDOM測定はワードマークの幅で、読み込み時に1回だけ行われます(提供されたフォントでcanvas measureText を使用)。

調整ノブ

希望変更箇所
長く/短くT 定数と #root および両方の .clip 要素の data-duration(同じ値に保つ)
より抽象的なビーズthickness(3.2)または変位振幅(0.15)を上げる;読みやすくするには下げる
ゼリー状 vs. 水滴状liquidMaterial() 内の dispersion、attenuationColor
ロックアップの大/小L.markPx、L.fontPx、L.gap
より落ち着いた背景背景シェーダー内の3つの * 0.50 / 0.80 / 0.35 フィールド重みを下げる

ワードマークをアートワークとして

ブランドからワードマークのSVG/PNGが提供された場合、#wordmark テキストを同じ位置・幅ロジックの <img> に置き換えます。アスペクト比を測定し、高さを L.fontPx * 0.8 に設定し、同じ clip-path ロジックを維持します。スタイライズされたワードマークを代替フォントでタイプし直さないでください。

検証

  • lint と check がクリーンであること(lintエラーがあるとレイアウト監査が黙って無効になります)。
  • フレームを抽出して確認:npx --yes hyperframes snapshot --at 0.3,1.5,3.3,3.55,3.9,6.5 を実行し snapshots/contact-sheet.jpg を開く、またはレンダリングに対して ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png を実行。以下を確認:(1) 初期フレームでマークが読めないビーズが表示されていること、(2) 破裂直後のフレームでワードマークテキストがマークと重なっていないこと、(3) ドック途中のテキストがマークの端でクリップされていること、(4) 最終フレームで鮮明なマーク+ワードマークが中央に配置され、液滴やクリップされたグリフがないこと。
  • よくある失敗:空白のキャンバス(importmapのパスが間違っている、またはWebGL three.core.js がコピーされていない)、ワードマークが中央にない(フォントが測定前に読み込まれていない)、白いボックスのロゴ(不透明なPNG)。

納品

final.mp4 とプロジェクトフォルダー(index.html、js/、assets/、vendor/)を納品します。これにより、data-* 属性を編集することでブランドを変更できます。音声はオプションです。破裂時間 T.pop における短いポップ音だけが、この作品に必要な唯一の効果音です。サウンドは media-use スキルを使用して商用ライセンスされた結果から調達するか、そうでなければ無音で納品します。

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.

関連スキル