Communitygithub.com

1345AbhishekKumar/starter-nextjs

將一般網站或網址轉換為 HyperFrames 影片(網站導覽、展示或社群短片),利用無頭 Chrome 截圖與品牌素材。

starter-nextjs 是什麼?

此技能專為將任何一般網站(如作品集、部落格、登陸頁面)轉換為專業的 HyperFrames 影片而設計。它會先擷取網站內容,並透過一系列嚴謹的步驟產出影片:包含品牌識別分析(步驟1)、策略與訊息對齊(步驟2)、概念優先的分鏡與腳本(步驟3)、語音旁白與字幕生成(步驟4)、根據分鏡建立視覺合成畫面(步驟5),最後進行驗證與交付(步驟6)。每個步驟都有明確的閘門控制,確保品質,即使是在自主模式下,驗證閘門也無法繞過。此技能明確區分適用情境:它適用於一般的網站展示或社群短片,不適用於產品/新創發布、無網站的主題解說、GitHub PR 轉影片或為現有影片加入字幕等情境。整個流程還包含了資產審核、逐拍 HTML 審查、以及詳盡的完成定義檢查清單,確保最終產出的影片是開發者願意掛名發布的高品質作品。支援 HeyGen、ElevenLabs、Kokoro 等 TTS 提供商,以及多種影片格式和時長。

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

在你喜歡的 AI 中提問

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

說明文件

media-use: 在取得音訊/圖片之前,請先呼叫 /media-use 來從 HeyGen 目錄中解決背景音樂(BGM)、音效(SFX)或圖片問題。首先執行 --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)— 每個節拍都需要結構化的證據區塊
  • DoD 檢查清單(步驟 6)— 包含動畫對應圖、逐警告的 WCAG 驗證、音訊/動態播放
  • 誠實揭露部分(步驟 6)— 「我未驗證的項目」必須出現在你的最終摘要中

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


步驟 0:擷取與了解品牌

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

擷取網站,然後閱讀提取的數據來了解 品牌和產品 — 它的功能、目標客群、說話的語氣、以及它所在的氛圍。所擷取的資產是供後續使用的品牌工具包,而不是構成影片的積木。

在簡報前顯示登入狀態 — 執行 npx hyperframes auth status 並如實轉述其輸出(不要改寫或重寫)。 它會報告語音/背景音樂是使用 HeyGen 還是本地引擎,以及當未登入時如何登入。如果未登入,請停止並等待使用者選擇 — 是登入,還是說「繼續」/「離線」以繼續使用本地引擎 — 然後再詢問簡報或其他任何事情。 將其視為一個真正的決策點,而非一個隨意的備註;不要將選擇合併到簡報問題中,也不要將密鑰寫入每個儲存庫的 .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(beats × 3, ceil(duration_seconds / 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 限時動態、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 — 用於 Canvas 中 HTML 效果的完整程式碼模式(存在於 hyperframes 技能中)

Individual skills in this repo

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

1345AbhishekKumar/starter-nextjs

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

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

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

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

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

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

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

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

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

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

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

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

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.

相關技能