Communitygithub.com

SingleGrain-Team/video-skills

建立動態圖像,將螢幕錄影播放於大框架旁搭配核對清單,每個清單項目在錄影中對應步驟發生的瞬間打勾,最後所有項目都勾選並短暫停留。

video-skills 是什麼?

此技能用於從螢幕錄影和時間戳步驟清單,自動生成一個視覺化的「步驟進行中」影片。它將錄影畫面放在左側,右側顯示核對清單,當錄影播放到某個步驟的時間點時,該步驟會瞬間打勾,並在最後所有步驟完成後停留片刻。對於開發者或技術內容創作者來說,這非常適合用來製作產品教學、入門指南或安裝示範影片,讓觀眾可以直觀地看到每個步驟在實際操作中完成的時刻。支援平台包括任何能執行 Node.js 和 HyperFrames 的環境,輸入為螢幕錄影檔案、步驟標籤與時間戳、標題及選用調色盤。輸出為 1920x1080 的 H.264 MP4 檔案和可編輯的 HyperFrames 專案。其工作流程涉及載入 HyperFrames 工具、生成 spec.json、執行腳本建立構圖、驗證時間點和佈局,最後進行渲染與交付。

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

在你喜歡的 AI 中提問

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

說明文件

checklist-overlay

螢幕錄影在左側,核對清單在右側。每個項目在螢幕上步驟發生的瞬間打勾。最後一個勾選後,影片停留在已全部勾選的清單上。

輸入

輸入備註
錄影一個本機影片檔案,最好為 16:9。無聲可接受。
步驟3 到 7 個項目:{ "label": "...", "at": <錄影中的秒數> }。標籤為簡短的命令式短語(約 2 到 4 個詞)。
標題一行。說明結果(例如「在 5 個步驟中將技能加入你的 agent」)。
副標題選用一行。
調色盤選用的十六進位代碼覆寫:bg, surface, panel, ink, muted, accent, border, accentInk。預設為深色搭配橘色強調色。請確保 accentInk 夠暗以便在 accent 上閱讀。

如果有人未提供時間戳,請掃描錄影(使用 ffmpeg 每 1 到 2 秒提取影格並檢查),選取每個步驟明顯已完成或正在進行中的第一個影格。請勿猜測。

工作流程

  1. 載入 /hyperframes、/hyperframes-core、/hyperframes-cli 以取得專案合約。
  2. 撰寫 spec.json:
    { "title": "...", "subtitle": "...", "palette": { "accent": "#ff6b2b" },
      "steps": [ { "label": "開啟應用程式", "at": 1.5 }, { "label": "搜尋", "at": 7.9 } ] }
    
  3. 將構圖生成至專案目錄: node <skill>/scripts/create.mjs spec.json <recording.mp4> <project-dir> [--hold 2.2] 它會複製錄影、提取最後一個影格(以便在錄影結束後畫面保持靜止),並寫入與錄影同尺寸的 index.html。總長度 = 錄影長度 + 停留時間(預設 2.2 秒)。
  4. npx --yes hyperframes check 必須通過,且無任何錯誤或警告。
  5. 進行驗證(如下),然後渲染:npx --yes hyperframes render --workers 2 --quality delivery --output final.mp4。

時間規則

  • 勾選動作必須與步驟同步,絕不能提前。填色和勾選繪製從 t = at 開始;繪製約在 0.3 秒後完成。在 at 之前,項目中不得有任何看起來已勾選的部分。
  • 時間戳為錄影時間,且錄影從構圖時間 0 開始,因此 at 原樣使用。如果你剪輯了錄影,請將每個 at 偏移相同的量。
  • 「下一個」項目的輪廓可在前一個打勾後不久出現。它只能是輪廓,不能是填色或勾選。
  • 勾選動作至少間隔 1.5 秒,以便每個都能被看清楚。如果兩個步驟太接近,請合併它們。
  • 最後一個勾選應至少在錄影結束前 1.5 秒,或提高 --hold 值,使完成清單至少可見 2 秒以上。
  • 計數器(n / N)、進度條和影格環脈衝都與相同的 at 值同步,因此它們會保持一致。

佈局(16:9 錄影)

1920x1080 畫布,邊距 56 像素。標題和副標題在上方;錄影畫框為主要元素,寬約 1250 像素(約佔寬度的 65%),核對清單面板為 520 像素寬的直欄,在其右側,高度與畫框相同,項目均分高度。這樣可確保錄影中的 UI 文字清晰可讀。請勿將畫框縮小到低於約 1100 像素寬;對於較高的錄影,生成器會根據長寬比縮放畫框。非 16:9 的錄影:請檢查畫框在標題下方仍能容納,或先裁切錄影。

標籤以 32 像素大小換行至兩行;字數控制在約 26 個字元以內。

驗證

請在渲染後的 final.mp4 上執行,而非僅檢查截圖:

  1. 對於每個步驟,在 at 前 0.08 秒和 at 後 0.45 秒各提取一個影格:ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png。
  2. 檢查它們。之前:項目未勾選,計數器為 i-1。之後:項目已填色並有勾選標記,計數器為 i,進度條已前進。
  3. 在最後的停留期間(約結束前 0.2 秒)提取一個影格:所有項目已勾選,計數器顯示 N / N,進度條已滿。
  4. 檢查錄影中的文字在畫框中是否清晰可讀,且無標籤被裁剪。若有問題,請修正 spec.json 或調色盤並重新生成。
  5. 使用 ffprobe 檢查檔案:1920x1080、h264,持續時間 = 錄影長度 + 停留時間。

交付

回報 final.mp4 的路徑、其持續時間以及所使用的步驟時間戳。保留專案目錄(index.html、assets/、spec.json),以便日後可透過不同標籤或調色盤重新生成影片。如果使用者想在 Studio 中編輯,請先執行 npx hyperframes preview。

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 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.

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.

相關技能