Communitygithub.com

SingleGrain-Team/video-skills

建立一個 10-14 秒的產品短片,由一系列 UI 畫面(進入畫面、單一計量數據、導覽清單、點擊開啟選單、結尾卡)剪輯而成,每個剪輯都延續前一個動作的動能,讓整部影片看起來像一個連續的鏡頭移動。最終輸出為 1920x1080 H.264 MP4 格式,並附帶一個可編輯的單一檔案 HyperFrames 專案。適用於應用程式發表、功能預告、社交媒體片頭和網站介紹,只要你有產品的標誌、幾張截圖、一個標題數字和真實的導覽標籤,且希望營造出精美的 UI 動畫效果而無需旁白。

video-skills 是什麼?

這項技能用於自動化生成高品質的產品 UI 動畫短片(Product Sting),專為需要快速製作應用發表、功能預告或社交媒體片頭的開發者與設計師設計。它將一連串 UI 畫面(例如登入畫面、導覽清單、計數器、選單按鈕)剪輯成一個流暢、看似連續的鏡頭移動,並遵循嚴格的動畫規則,例如統一的緩動函數(expo.in / expo.out)和匹配的運動向量,以確保視覺連貫性。支援 HyperFrames 平台,並透過收集品牌素材(標誌、顏色、字型)、截圖、導覽標籤等輸入,自動生成可編輯的 HyperFrames 專案檔和最終的 MP4 影片。整個流程包括初始化專案、替換素材、調整導覽列寬度、檢查衝突、渲染影片,最後進行驗證。使用者只需提供必要資產,無需手動調整動畫細節,即可獲得專業級產品動畫。

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

在你喜歡的 AI 中提問

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

說明文件

UI 短片

一個簡短、預設無聲的 UI 節奏影片。外觀完全由兩件事決定:一個緩動系列,以及每個剪輯處匹配的運動向量。請勿添加閒置動畫或裝飾。

需要收集的輸入

  • 品牌:名稱、標誌(含 Alpha 通道的 PNG 或 SVG)、2-3 種顏色(底色、墨色、強調色)、一個合法用於渲染的字型(開放字型亦可;預設為 Inter)。
  • 兩張 1920x1080 的真實產品截圖(一個入口/登入畫面,以及一個包含指令、表單或標題且可裁剪的詳細畫面)。
  • 一個值得計數的數據(例如 "662 項技能"),附帶標籤和副標題。
  • 真實的主要導覽標籤(5 個),以及哪一個會被高亮顯示(第三個)。
  • 觀眾應採取的唯一動作(一個按鈕標籤)以及它開啟的 4 個選單選項。
  • 結尾卡:一個 2 個字的標語、網址,以及可選的在縮放卡片中輸入的指令。

僅使用你擁有或擁有使用權限的資產。切勿在影片中使用第三方標誌或 UI。

時間段

時間段幀數 (30 fps)內容
A 品牌組合1-35標誌圖示 + 文字標誌,兩個部分互相撞擊,然後升起
B 入口36-72截圖卡片從下方進入,一道品牌色光澤橫掃而過,向左離開
C 縮放73-113卡片以 1.5 倍從右側進入;包含詳細截圖的裁剪區域和一個正在輸入的指令;升起離開
D 計數器114-154數據卡片升起,數字從 0 滾動到 N,向右離開
E 導覽155-209行從左側瀑布式進入,一個強調色藥丸從第 1 行移動到第 3 行
F 動作210-304按鈕以超大尺寸到達並收縮,游標點擊,選單開啟,高亮移動到第 3 個選項
G 結尾卡305-325標語 + 品牌組合 + 網址以回拉方式落地,彈簧穩定,並在標誌上產生閃爍效果

總共 325 幀 = 10.83 秒。所有動畫都基於 F(n) = (n - 1) / 30。

工作流程

  1. 搭建:npx --yes hyperframes init <目錄名> --non-interactive --resolution landscape。這會生成專案檔案;然後取代 index.html 並新增 assets/。
  2. 將此技能中的 template/index.html 和 template/assets/ 複製到專案中。將三個預留位置的圖片取代為真實的標誌和截圖(保留檔案名稱,或更新 src/url() 引用)。
  3. 僅重新定義品牌層::root 顏色標記、文字字串、NAV、MENU 陣列、ICO 路徑資料 (24x24 viewBox, 1.7 筆畫, 圓頭端點;繪製通用圖形,絕不使用其他公司的標記)、指令字串 CMD、計數目標 (AMT 中的 662) 和裁剪區域 (#c-crop background 位置/大小:選擇你想顯示的詳細截圖區域;大小 = 截圖寬度 x 縮放比例,位置 = 在縮放像素中裁剪區域的負偏移)。
  4. 重新測量兩個導覽數字。更改標籤後,渲染一次,開啟一個靜止的導覽幀(大約 t = 6.5 秒),讀取每個標籤的右邊緣。將 NAV[i].w 設為該行的寬度(圖示 + 標籤),前三個行的 pw = w + 46。高亮落在第 3 行,且必須完全覆蓋該行。
  5. npx --yes hyperframes check。單一檔案佈局會產生 nested_structure_needs_subcomposition 警告;在此格式中這是預期的。錯誤和對比度部分必須沒有問題。
  6. 渲染:npx --yes hyperframes render --quality looks --workers 2 --output final.mp4。
  7. 檢查幀(請參閱驗證部分),修正,重新渲染。交付 final.mp4 和專案資料夾。

音樂可選。如果使用,請透過媒體使用目錄或生成方式取得,確認授權允許商業使用,以其自己的音軌新增為 <audio id="bed" class="clip" ...> 片段(需要 id),並保持低音量。影片可以無聲播放。

動畫規則(不可違反)

  1. 單一緩動系列:進入使用 EO = 1 - 2^(-10p),離開使用其鏡像 EI = 2^(10(p-1))。將它們作為函數傳遞。字串 "expo.out"/"expo.in" 是不同的曲線,會使每次離開偏移數個像素。無過衝、無線性、無預設彈性或回彈。
  2. 每個剪輯處匹配向量(請參閱 references/seams.md)。剪輯前沒有動畫靜止;剪輯後沒有動畫從靜止開始。軸線和方向必須在兩側一致。
  3. 曲線是補間動畫,決策是標記。打字節奏、里程表值和高亮路徑是透過 tl.set 逐幀標記的,這保證了精確性和搜尋安全性。
  4. 故意不均勻:導覽行的間距不均勻,且打字有三個雙幀。
  5. 快速移動帶有模糊效果,模糊程度與同一緩動曲線一起變化,在速度達到峰值時達到最大。
  6. 兩部分標誌反向彈跳:一個阻尼彈簧 A * e^(-t/0.279) * sin(2*pi*t/0.5),一部分為 +A,另一部分為 -A。結尾卡中的文字在同一個彈簧上間隔 2 幀依次出現。
  7. 計數器的最後一個數字帶有僅垂直方向的模糊效果(SVG feGaussianBlur stdDeviation="0 4")。
  8. 無閒置動畫。如果一個節奏感覺空洞,請增加資訊,而不是晃動。
  9. 不要更改幀數、持續時間、片段 data-start/data-duration、EO/EI、標記陣列的長度或場景包裝補間動畫,除非你重新規劃兩側的銜接處。

技術說明

  • 創作在 720x720 方形("世界")中進行,每個 .scene 將其縮放 1.5 倍到 1920x1080,並由 .w 包裝器(偏移 280)將方形置中。因此,離開螢幕的移動使用較大的像素值。
  • 片段邊界略低於幀時間(1.166,而非 1.1667)。
  • 深色主題需要第二層導覽:淺色文字在亮色藥丸上會消失。在強調色藥丸上改為使用墨色,並在淺色背景上為強調色的小文字使用墨色(而非強調色):例如在奶油色背景上使用橘色文字會無法通過 3:1 對比度門檻。
  • 切勿在執行時測量文字;這會與字型載入競爭。根據一次渲染計算數值。
  • 如果使用的字型不是系統字型,請將其註冊到你可控的字型系列下。

驗證

  1. npx --yes hyperframes check 通過(執行階段、佈局、動畫、對比度)。
  2. 提取 6-8 幀並查看:ffmpeg -ss <時間> -i final.mp4 -frames:v 1 f.png,大致在 0.5、1.8、3.1、4.4、6.5、8.5、9.4、10.7 秒。使用 hstack/vstack 並排以一次檢視。
  3. 確認:標誌置中;入口截圖可讀;輸入的指令未被裁剪;計數器停留在目標值;藥丸停留在預期行上且寬度足夠;選單從按鈕角落開啟,且高亮移動到第 3 個選項;結尾卡文字置中且清晰可讀。
  4. 根據 references/seams.md 抽查兩個接縫。
  5. 使用 ffprobe 檢查輸出:1920x1080、h264、30 fps、持續時間約 10.83 秒。

交付物

final.mp4(1920x1080 H.264)加上專案資料夾(index.html、assets/)。該專案可編輯:透過更改資料而非動畫來重新定義品牌。

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

Builds a 6-8 second logo sting in which the brand mark rides inside a refracting liquid bead (distorted past legibility), the bead swells, holds still for a beat, then ruptures into droplets and leaves the logo lockup (mark plus wordmark) crisp and upright on screen. Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project, with no 3D model, stock footage or generation model. Use it for brand intros and outros, product-launch openers, channel stings and any "reveal our logo" moment, from an SVG or PNG logo (including raster-only logos), a wordmark string and a palette.

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.

相關技能