Communitygithub.com

SingleGrain-Team/video-skills

製作一個 20-30 秒的產品啟動影片,不綁定特定介面,例如 CLI、套件、外掛或代理工具技能。將相同的提示或指令依序輸入四個視覺上不同的表面(寬終端機、高聊天卡片、浮動面板、編輯器單元),然後影片快速切換到實際輸出結果的節奏編排,最後以大型膠囊按鈕顯示指令結尾。輸出為 1920x1080 MP4 與可編輯的 HyperFrames 專案。音樂為選項——有音樂時剪輯會對齊偵測到的節拍,無音樂時則對齊 120 BPM 的節奏網格。

video-skills 是什麼?

這個技能用於製作一個「一致體驗」的產品展示影片。其核心主張是「無論你在哪裡輸入,它都運作相同」。影片結構包含:將同一個指令依序輸入四個視覺上截然不同的表面(寬終端機、高聊天卡片、浮動面板、編輯器單元);然後快速切換 16-24 個實際輸出結果的節奏編排;最後以黑暗背景的大型膠囊按鈕重新顯示指令與品牌資訊結尾。它支援有音樂(對齊歌曲節拍)或無音樂(對齊 120 BPM 網格)兩種模式,目標總時長為 20-30 秒。技能依賴 HyperFrames 框架進行渲染,並要求所有素材均為原創或已授權,禁止使用第三方媒體。適合開發者或 AI 代理工具用於展示 CLI、套件、外掛或代理技能等不綁定特定 UI 的產品。

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

在你喜歡的 AI 中提問

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

說明文件

one-prompt-reel

這部影片所宣稱的:「無論你在哪裡輸入,它都運作相同。」證明來自於重複。一個字串,四個看似無關的表面,然後是一連串它所產出的結果,最後再次顯示這個字串。

輸入

輸入項目必填說明
prompt是確切的指令或句子。約 50 字元以內效果最佳;它會被輸入四次,再加上結尾一次。
reel 圖片是16-24 個實際輸出:螢幕截圖、產品畫面、從先前渲染中擷取的靜態圖。僅限您自己的素材。
品牌名稱、標語、網址是用於結尾卡片。
標誌否方形 PNG 含透明度。省略則結尾僅顯示文字。
音樂否您擁有商業授權的曲目。如果不確定授權,請保持無聲。

工作流程

  1. 建立專案架構。 建立一個專案資料夾,將 template/ 複製進去(包含 index.html 和 assets/gsap.min.js),並將 reel 圖片放入 assets/reel/。然後執行: npx --yes hyperframes check
  2. 填入 CONFIG 區塊,位於 index.html 的 <script> 頂部。所有專案相關設定都在那裡:prompt、bpm、reel 檔案清單、brand、tagline、url、logo。除非下方規則強制要求,否則請勿重新調整其他結構。
  3. 選擇剪輯網格。
    • 無音樂: 保留 cuts: null。剪輯來自 bpm 和 reelPattern(預設:8 個一拍剪輯,接著 16 個半拍剪輯,在 120 BPM 下 = 4 秒 + 4 秒)。每個表面持續 surfaceBeats 拍,因此整部影片保持對齊網格。
    • 有音樂: 將曲目以 <audio id="music" data-timeline-role="music" src="assets/music.mp3" data-start="0" data-duration="24" data-track-index="5"> 加入,執行 npx hyperframes beats,開啟 beats/assets/music.mp3.json,將落在 reel 開始時間之後的節拍時間(以秒為單位)複製到 CONFIG.cuts 中(多一個條目標記最後一個剪輯的結束,也就是結尾開始的時間)。將 bpm 設為曲目的節奏,以便打字區段也能對齊。如果節拍密度超過 0.2 秒,則每隔一個取一個。在最後一秒淡出音樂(/hyperframes-audio)。
  4. 渲染前檢查。 npx --yes hyperframes snapshot --at 1.8,4.3,6.8,9.2,11,15,20,23 並開啟 PNG 檔案。檢查每個表面打字中、一個 reel 剪輯以及結尾。
  5. 渲染。 npx --yes hyperframes render --workers 2 -o final.mp4。
  6. 從 MP4 中提取 4-6 幀(使用 ffmpeg,每個表面一幀、一個 reel 剪輯、結尾)並檢查。如果有任何部分被裁切、無法閱讀或空白,修正後重新渲染。

影片結構(預設值 24 秒)

時間節拍
0-10 秒四個表面,每個 2.5 秒。從右側滑入,打字約 1.5 秒,按下 ENTER,向左滑出。一個小標籤標示表面名稱及其位置(1/4)。
10-18 秒硬切並伴隨白色閃光。24 張全出血輸出圖片,每張帶有緩慢推入效果。指令以膠囊按鈕形式位於左下方整個 reel 期間;計數器位於右下方。
18-24 秒黑暗結尾:標誌、名稱、標語,指令在帶有餘燼邊緣的膠囊按鈕中再次輸入,網址,單次發光脈衝。

讓它有效的規則

  • 四個表面必須在輪廓上有所不同,而不僅僅是顏色。 寬而低、高而窄、浮動在漸層上、帶有側邊樹的深色。如果你瞇著眼會混淆其中兩個,重新繪製一個。用純 HTML 和 CSS 構建;切勿模仿任何真實產品的介面、標誌或色板。
  • 相同字串,相同打字速度。 每個表面在相同時間內輸入相同的 prompt。這種一致性是重點。
  • 使用時間軸補間(tween)來打字,而不是計時器。一個基於 {n} 計數器的補間(其 onUpdate 會擷取字串)是 seek 安全的;setInterval 則不是。
  • 使用 tl.set 以半拍循環閃爍游標,絕對不要用 CSS 動畫或 repeat: -1。
  • 對齊網格進行剪輯。 每個表面邊界、剪輯和結尾的進入點都必須落在節拍上,無論網格是音樂性的還是單純的節奏。脫離網格的剪輯是第一個讓人感覺草率的問題。
  • 加速一次。 先慢速剪輯,然後半長度剪輯。不要重複加速。
  • Reel 圖片是證據。 實際輸出,而非裝飾。偏好 1920x1080 的靜態圖;使用 object-fit: cover 縮放不常見的尺寸。交替深色和淺色相鄰圖片,使每個剪輯都能被感知。
  • 沒有第三方媒體。 沒有標誌、其他產品的 UI 螢幕截圖、庫存素材或您無法隨附的字型。字型:明確指定一個字體家族(等寬字型使用 "JetBrains Mono",CLI 會自動解析);通用 ui-monospace 堆疊在測試中會按比例渲染。
  • 保持標題可讀。 檢查對比度;hyperframes check 會對文字強制執行 WCAG AA 標準,因此標籤在奶油色舞台背景上需要使用中暗色調的墨水。
  • 無聲是可以接受的。 不要添加未知授權的音樂;具有非商業條款的 AI 生成曲目不可使用。
  • 保持閃光補間的 immediateRender: false,否則佈局審核會在 t=0 時看到白色疊加層。

驗證

  • npx --yes hyperframes check 必須以「Check passed」結束(語法檢查、佈局、對比度)。
  • 快照幀應顯示所有四個表面在退出前完全輸入完成,沒有標籤重疊表面,沒有空白或半載入的 reel 圖片。
  • ffprobe 應回報為 1920x1080、h264、時長在 20-30 秒範圍內。

交付

將 final.mp4 放在專案(index.html、assets/)旁邊。如果儲存庫慣例要求簡短備註,請列出:提示詞、節奏或節拍來源、reel 圖片來源、音樂授權(或「無聲」)以及渲染指令。提及 Studio(npx hyperframes preview)可以重新調整任何時序。

詳見 references/surfaces.md 以了解四個表面規格,以及 references/grid.md 以了解時序計算。

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

相關技能