Communitygithub.com

1345AbhishekKumar/starter-supabase

將一般網站/網址轉換成 HyperFrames 影片(網站導覽、展示或來自網站自身視覺的社群短片)。使用無頭 Chrome 螢幕截圖和品牌素材。

starter-supabase 是什麼?

此技能專為將任何一般網站(如作品集、部落格或登陸頁面)轉換為專業的 HyperFrames 影片而設計,非常適合製作網站導覽、展示影片或社群媒體短片。它透過七個協作步驟來運作,從捕捉網站(Step 0)開始,接著定義品牌識別(Step 1)、制定策略與訊息(Step 2)、建立分鏡與劇本(Step 3)、處理旁白與時間軸(Step 4)、建構視覺合成畫面(Step 5),最後進行驗證與交付(Step 6)。此工作流程支援 HeyGen 的語音和音樂服務,但也允許離線使用本地引擎。關鍵在於它明確區分了一般網站影片與產品發表影片:如果使用者意圖是行銷或推廣產品,即使從同一個網址開始,也應導向 /product-launch-video 技能。此技能也定義了詳細的審核關卡(包括素材審計、每拍子 HTML 檢查和完成定義檢查清單),即使是在「自主模式」下也無法跳過,以確保品質。最終交付物是 localhost Studio 專案 URL,僅在使用者明確要求時才轉換為 MP4。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-supabase/tree/HEAD/.agents/skills/website-to-video

在你喜歡的 AI 中提問

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

說明文件

media-use: 在獲取音訊/圖片之前,請先呼叫 /media-use 以從 HeyGen 目錄中取得背景音樂/音效/圖片。先執行 --adopt 來註冊現有素材。詳見 /media-use 技能。

網站轉 HyperFrames 影片

捕捉一個網站,然後從中製作出專業的影片。

在第 0 步之前確認路線。 此技能是製作 來自/關於一般網站的 影片。如果使用者真的是 行銷/發表/推廣一個產品(即使從這個網址開始,甚至是「我們網站的宣傳片」)→ 請使用 /product-launch-video。沒有網站的議題解說 → /faceless-explainer;GitHub PR → /pr-to-video;重新剪輯/重新調色/重新排列現有影片檔案 → 超出範圍。如果被路由到這裡是因為模糊的「製作影片」,或不確定是產品發表還是一般網站?先閱讀 /hyperframes(完整的路由表 + § HyperFrames 不能做的事)。

使用者會這樣說:

  • "把這個網站變成一支 15 秒的 Instagram 社群短片"
  • "從 https://... 製作一支 30 秒的網站導覽/展示影片"
  • "捕捉我們的首頁,並從它自己的視覺元素建立一支影片"

此工作流程有 7 個步驟。每個步驟會產生一個工件,作為下一個步驟的關卡。預設是協作模式——標記為 💬 的關卡會停下來詢問使用者。如果使用者指示自主模式("你來決定", "給我驚喜"),則會跳過 💬 使用者偏好關卡;請參閱 step-2-brief.md 了解其傳遞方式。

自主模式不等於「跳過所有關卡」。 自動模式涵蓋使用者偏好問題(TTS 提供者、語音、色彩強調、節拍數量、音樂開/關、字幕開/關——由代理代為決定)。它不涵蓋品質驗證關卡。以下項目在自動模式下仍不可跳過:

  • 素材審計(步驟 3)——檢視連絡表並為每個素材說明「使用/跳過」的理由
  • 每拍子 HTML 讀取(步驟 5)——每個拍子的結構化證據區塊
  • 完成定義檢查清單(步驟 6)——包括動畫對應、每個警告的 WCAG 驗證、音訊/動畫播放
  • 誠實揭露章節(步驟 6)——「我未驗證的項目」必須出現在你的最終摘要中

如果你發現自己在推理:「自動模式說偏向行動,所以我應該跳過 X」——而 X 是驗證關卡,不是偏好問題——那麼這個推理是錯誤的。偏向行動的原則適用於決定 要建構什麼,而不是決定 是否要驗證。


步驟 0:捕捉與理解品牌

閱讀: references/step-0-capture.md

捕捉網站,然後讀取提取的資料以理解 品牌和產品——它的功能、目標受眾、說話的語氣、以及它所處的氛圍。捕捉到的素材是稍後使用的品牌工具包,而不是構成影片的基礎元件。

在撰寫簡報之前顯示登入狀態——執行 npx hyperframes auth status 並 逐字轉述其輸出(不要改寫或重寫)。 它會回報語音/背景音樂將使用 HeyGen 還是本地引擎,以及當未登入時如何登入。如果未登入,請停止並等待使用者選擇——登入,或說 "go"/"offline" 以繼續使用本地引擎——然後再詢問簡報或任何其他事項。 將它視為一個真正的決策點,而不是一個隨意的註記;不要將選擇併入簡報問題中,也不要把金鑰寫入每個儲存庫的 .env 檔案。(在自主模式下,記錄狀態然後繼續離線模式。)請參閱 ../hyperframes-media → Preflight 以取得權威指南。

關卡: 網站摘要已列印——策略優先(產品功能、目標受眾、品牌語氣)在素材/顏色/字型清單之前;已顯示登入狀態(已登入,或繼續離線模式)。


步驟 1:品牌識別

閱讀: references/step-1-design.md

撰寫 DESIGN.md——一份涵蓋視覺識別的品牌備忘錄:顏色、字體排印、元件樣式、佈局原則。使用 design-styles.json 取得精確的計算值。

加速選項: 對於快節奏影片(廣告看板風格的每拍子切換),DESIGN.md 可以是僅包含顏色 + 字體 + 注意事項的 50 行摘要——而不是 300 行的文件。步驟 5 中的子代理提示會直接貼上品牌價值,因此 DESIGN.md 的深度僅對複雜構圖有意義。

關卡: DESIGN.md 已存在(任何長度),至少包含:顏色調色盤、字體選擇、以及注意事項。


步驟 2:策略與訊息

閱讀: references/step-2-brief.md,references/capabilities.md(掃描目錄——只在需要時深入閱讀特定章節)

在討論視覺或素材之前,先與使用者確認 影片必須傳達的訊息。解析使用者的提示——他們可能已經提供了影片類型和風格。只詢問缺少的項目:這支影片必須說的一件事、敘事弧線、以及目標觀眾。

關卡: 影片類型、長度、格式,以及——至關重要的是——訊息和敘事弧線都已鎖定。沒有這些,步驟 3 就無法撰寫概念優先的分鏡腳本。


步驟 3:分鏡腳本與劇本 💬

閱讀: references/step-3-storyboard.md

以概念優先的方式撰寫分鏡腳本:訊息 → 敘事弧線 → 服務於弧線的拍子 → 每個拍子的技巧 → 最後加上品牌重點。然後撰寫相應的旁白劇本。向使用者展示兩者,並附上逐拍摘要。反覆修改直到獲得他們批准。

關卡: STORYBOARD.md + SCRIPT.md 已存在 並且 使用者已批准該計劃。


步驟 4:旁白、時間軸與字幕 💬

閱讀: references/step-4-vo.md

如果步驟 2 說不需要旁白——詢問關於背景音樂,然後跳到步驟 5。否則:詢問使用者要使用哪個 TTS 提供者(HeyGen TTS、ElevenLabs 或 Kokoro),生成音訊、轉錄、將時間戳記對應到拍子。然後詢問字幕。

關卡: (a) 沒有要求旁白且分鏡腳本有手動拍子時間軸,或 (b) narration.wav + transcript.json 已存在且拍子時間軸已使用實際長度更新。


步驟 5:建構合成畫面

閱讀: hyperframes 技能(載入它——每個規則都很重要) 閱讀: references/step-5-build.md

按照分鏡腳本(步驟 3)中選擇的架構和節奏建構 index.html 和合成畫面。子代理在回報之前,會對每個拍子執行 hyperframes lint 和 hyperframes snapshot。

關卡: 每個 compositions/beat-N.html 都已由主代理根據 DESIGN.md 和 STORYBOARD.md 從頭到尾讀取完畢。每個拍子的檢查清單位於 step-5-build.md。


步驟 6:驗證與交付

閱讀: references/step-6-validate.md

進行 lint、驗證、根據影片長度按比例拍攝快照(公式:max(拍子數 × 3, ceil(影片秒數 / 2))),並審查每個快照。在交付前修復問題。交付 localhost Studio 專案 URL——僅在使用者明確要求時才渲染成 MP4。僅在交接時提供 Studio URL——它是最終的穩定預覽;建構階段的快照是無頭的,所以不要在構建過程中彈出預覽。

交付一個你引以為傲的作品。 在交接前,問問自己:我會把這個貼上社群媒體並署上我的名字嗎?如果不會,就修正問題。

關卡: npx hyperframes lint 和 npx hyperframes validate 通過並顯示零錯誤,且最終回應包含活動中的 Studio 專案 URL。


快速參考

影片類型

各影片類型的典型限制——作為起點,而非公式。拍子數量應來自內容和旁白,而不是來自一個目標範圍。

類型典型長度長度驅動因素旁白
社群廣告 (IG/TikTok)10–15 秒平台限制可選
產品展示30–60 秒劇本長度完整旁白
功能發布公告15–30 秒功能複雜度完整旁白
品牌形象片20–45 秒音樂曲目可選,側重音樂
發表預告片10–20 秒鉤子能量極簡

拍子數量特意未列於此表中——它應來自分鏡腳本,而不是來自「社群廣告 = 3-4 個拍子」。一個複雜產品的社群廣告可能需要 5 個精心安排時間的拍子。一個只有一個強烈視覺論點的品牌形象片可能只需要 3 個。

格式

  • 橫向: 1920x1080 (預設)
  • 直立: 1080x1920 (Instagram Stories, TikTok)
  • 方形: 1080x1080 (Instagram 動態牆)

參考檔案

檔案何時閱讀
step-0-capture.md步驟 0——捕捉、理解品牌和產品,撰寫策略優先的網站摘要
step-1-design.md步驟 1——撰寫 DESIGN.md 品牌備忘錄(5 個章節,250-350 行;對於廣告看板風格的社群廣告可使用 50 行的快速路徑)
step-2-brief.md步驟 2——與使用者確認訊息、敘事弧線、目標觀眾
capabilities.md步驟 2 和 5——HyperFrames 能做的所有功能的完整清單(24 個章節)。在簡報階段掃描目錄,在構建階段深入閱讀特定章節
step-3-storyboard.md步驟 3——分鏡腳本 + 劇本(合併),附帶使用者審查關卡
step-4-vo.md步驟 4——TTS 提供者選擇、生成、時間軸
step-5-build.md步驟 5——建構 index.html + 合成畫面
step-6-validate.md步驟 6——lint、驗證、快照(按影片長度比例)、預覽
techniques.md步驟 3 和 5——13 種原始動畫技巧,附帶程式碼模式(需改編,不要直接複製貼上)
html-in-canvas-patterns.md步驟 5——HTML-in-Canvas 效果的完整程式碼模式(位於 hyperframes 技能中)

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

1345AbhishekKumar/starter-supabase

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

1345AbhishekKumar/starter-supabase

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

1345AbhishekKumar/starter-supabase

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

1345AbhishekKumar/starter-supabase

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

1345AbhishekKumar/starter-supabase

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

1345AbhishekKumar/starter-supabase

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

1345AbhishekKumar/starter-supabase

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

1345AbhishekKumar/starter-supabase

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

1345AbhishekKumar/starter-supabase

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

1345AbhishekKumar/starter-supabase

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

1345AbhishekKumar/starter-supabase

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

1345AbhishekKumar/starter-supabase

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /website-to-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

1345AbhishekKumar/starter-supabase

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

相關技能