Communitygithub.com

SingleGrain-Team/video-skills

建立一個6-8秒的商標開場動畫,品牌標誌在折射液體珠粒中扭曲至無法辨識,接著珠粒膨脹、停頓一拍、破裂成液滴,最終留下清晰直立的商標組合。

video-skills 是什麼?

這是一個專為品牌開場與結尾設計的AI技能,能將SVG或PNG商標、文字標誌與色系轉換為1920x1080的H.264 MP4影片及可編輯的HyperFrames專案。動畫效果基於WebGL (Three.js) 的玻璃珠粒,具有物理折射、噪點位移表面與色散,商標在珠粒內被劇烈扭曲而無法辨識,經過壓力累積、靜止一拍後珠粒破裂,15滴液滴飛散,商標滑入定位並帶出文字標誌。整個過程無需3D模型、素材影片或生成式AI模型,所有幀皆為搜尋時間的純函數,渲染結果確定性高,支援Claude Code、Cursor、Codex等平台。技能提供明確的輸入規範(商標、文字標誌、色系、時長)與調整參數(厚度、振幅、色散等),並內建校驗工具確保輸出品質。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

液體商標揭示動畫

一個WebGL (Three.js) 玻璃珠粒,具備物理透射、噪點位移表面與色散,置於商標前方。商標被劇烈折射而無法閱讀。壓力累積,一切停頓一拍,珠粒爆裂,15滴液滴飛散,然後商標向左滑入定位,文字標誌從其後方擦出。所有幀皆為搜尋時間的純函數,因此渲染結果是確定性的。

輸入

輸入說明
商標圖案SVG 或 PNG。僅圖案(符號),接近正方形,透明背景。
文字標誌預設使用Inter字體排版的文字字串。如果品牌有實際的文字標誌圖形,請參閱「文字標誌作為圖稿」。
色系三種顏色:強烈強調色、柔和淡色、沈穩中性色。它們成為玻璃後方的模糊色塊;玻璃本身無色,僅顯示其後方的內容。文字標誌的墨水顏色。
時長預設7秒。組合定位後的停頓是唯一可以延長的部分。

僅能使用使用者提供或品牌資料夾中的素材。切勿從網路擷取商標。

僅點陣圖的商標

  • 範本需要含透明通道的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,然後將此技能的template/index.html取代其index.html,並複製template/js/、template/assets/logo.png(以品牌圖案覆蓋)。
  2. 將執行時期納入vendor,使渲染時無需網路連線。在暫存目錄中(勿在另一個專案內,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(三個十六進制顏色)。保持色塊在強調色處飽和,其他地方柔和;切勿讓珠粒中央後方的色塊變得暗沉且平坦。
  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秒內以四次方緩入塌陷,液滴徑向發射)、定位(商標回彈然後滑入定位槽,同時文字標誌從其後方擦出)、停頓。
  • 靜止是關鍵。 爆裂前的0.4秒凍結是讓破裂感真實的關鍵。任何地方都沒有無意義的呼吸、漂浮或循環發光。
  • 著色器時鐘受控。 噪點時間僅在指定的時間窗口內推進,並在逗號階段與定位完成後凍結。
  • 文字標誌從商標中浮現,絕不突然出現。 其剪裁的左邊緣追蹤商標的右邊緣,因此文字絕不會在定位過程中與商標重疊。
  • 液滴:黃金角固定佈局(無 Math.random),徑向發射,一個重力項,然後縮小至消失,使最終影格乾淨。
  • 以靜止的商標組合結束。 商標與文字標誌直立、居中成對,無淡出。如果作品是將被剪入較長影片的開場,請縮短停頓時間而非淡出。
  • 確定性:所有內容均從 hf-seek 時間計算得出。無 requestAnimationFrame、Date.now、Math.random。唯一的DOM測量是文字標誌寬度,在載入時測量一次(使用內附字體的canvas measureText)。

調整旋鈕

想要改變
更長或更短T 常數與 #root 及兩個 .clip 元素上的 data-duration(保持相等)
更抽象的珠粒提高 thickness (3.2) 或位移振幅 (0.15);降低以提高可讀性
果凍感 vs. 液滴感liquidMaterial() 中的 dispersion、attenuationColor
更大或更小的組合L.markPx、L.fontPx、L.gap
更平靜的背景降低背景著色器中三個 * 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.

相關技能