Communitygithub.com

1345AbhishekKumar/starter-nextjs

用於創作自訂 HyperFrames 影片合成的後備工作流程,支援任意長度或格式 — 較長或多場景作品、品牌/精華片段、蒙太奇、標題卡、靜態循環及自由形式組合。與輸入內容和長度無關。如果有明確適合輸入內容的專門工作流程(例如行銷產品、網站、主題解說、GitHub PR、現有素材、短動畫或 Remotion 移植),請優先使用該流程(請參閱 /hyperframes);僅在沒有適合的流程時,才將此作為一般後備方案使用。

starter-nextjs 是什麼?

此技能是 hyperframes 生態系統中的通用後備影片合成工作流程,專門處理專門流程(如產品發布或網站轉影片)無法涵蓋的自訂作品。它提供結構化指南,用於構思、規劃和建構任意長度或格式的影片,包含開放式請求的發現步驟,以及透過 `hyperframes-creative` 參考資料(如 `house-style.md` 和 `video-composition.md`)建立視覺識別的嚴謹系統。使用者需要經過一個硬性關卡,確保在撰寫 HTML 之前,已取得視覺識別、概念角度、字型搭配及前景密度計畫。此技能支援多種平台(如 Claude Code、Coder、Cursor),並強調「先佈局後動畫」的流程,以避免畫面重疊,同時將音訊處理(TTS、BGM、SFX)委派給 `hyperframes-media` 引擎,以獲得一致的結果。

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

在你喜歡的 AI 中提問

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

說明文件

media-use:在獲取音訊/圖片之前,請先呼叫 /media-use 從 HeyGen 目錄中解析背景音樂/音效/圖片。先執行 --adopt 註冊現有資產。詳情請參閱 /media-use 技能。

general-video — 一般影片工作流程

在開始建構前,請先確認路線。 這是用於自訂合成創作的後備方案。如果輸入內容明確符合某個專門工作流程,請優先使用該流程:已行銷產品 → /product-launch-video;一般網站 → /website-to-video;主題解說 → /faceless-explainer;GitHub PR → /pr-to-video;現有素材 → /embedded-captions · /talking-head-recut;短無旁白動畫 → /motion-graphics;Remotion 移植 → /remotion-to-hyperframes。超出範圍:即時/渲染時資料、已完成影片的非線性編輯風格處理,或產生 HyperFrames 無法捕捉的素材。不確定?請先閱讀 /hyperframes。

確實依照要求建構。 標題卡就是標題卡 — 而不是標題卡加上三個輔助場景、背景音樂和字幕。如果額外的場景或元素確實能提升作品品質,請提出建議;不要默默添加。對於小修改(修正顏色、調整一個持續時間、新增一個元素),請跳過規劃步驟,直接進行建構。

方法

發現階段 — 僅限開放式請求

對於模糊、探索性的請求(例如「為我們的品牌做些東西」、「酷炫的開場」)— 在選擇顏色前,先了解意圖:

  • 觀眾 — 誰會觀看?開發者 / 高階主管 / 一般消費者?
  • 平台 — 在哪裡播放?社群媒體 (15秒) / 網站主視覺 / 產品示範 / 內部使用?
  • 優先級 — 什麼最重要?動畫品質 / 內容準確性 / 品牌忠實度 / 製作速度?
  • 變化版本 — 一個最佳版本,還是 2-3 個有意義的不同選項(不同的節奏、能量或結構 — 而不僅僅是顏色互換)?

對於具體請求(例如「新增標題卡」、「修正場景 3 的時間點」),請跳過發現階段。

步驟 1 — 設計系統 → hyperframes-creative

首先建立視覺識別。如果專案有設計規格,請閱讀它(優先順序 frame.md → design.md → DESIGN.md;將其視為品牌真理 — 精確的顏色、字體、限制)。

如果沒有規格,你必須在選擇任何顏色或字體之前,同時閱讀 hyperframes-creative/references/house-style.md 和 hyperframes-creative/references/video-composition.md。 house-style.md 提供了「解讀提示 / 產生真實內容」的開場白、懶惰預設列表和圖層配方;video-composition.md 則提供了影片媒介的密度 / 比例 / 前景細節(資料條、註冊標記、等寬字體元資料、「8-10 個元素,其中兩個使用者沒要求的元素」),這些將「被製作出來的」與「被產生出來的」區分開來。只閱讀其中一個是最常見的失誤 — video-composition.md 正是代理程式會跳過的那個,而它正是防止輸出看起來扁平、置中、像網頁的那個。不要自行發明色板並跳過這些;進入 hyperframes-creative 這裡是強制性的,不是可選分支。接著,視需要從 references/visual-styles.md 提取一個指定的風格/氛圍,或從 references/design-picker.md 提取互動選擇器。規格/風格定義的是品牌,而非合成規則。

找出切入點(模糊簡報,無規格): 在選擇顏色之前,先寫一句話 — 這個名字/詞彙/主題會喚起什麼,以及什麼視覺世界(隱喻、場景、樂器、動機)可以表達它?例如,一個網路安全工具 → 保險庫門 / 周界掃描線 / 鎖芯;一個冥想應用程式 → 潮汐、呼吸、緩慢的光綻放。閱讀主題的意義,而不僅僅是它的字母;選擇一個具體的切入點,而不是字面上的重新設計。這是單場景作品(在這種情況下會正確跳過提示擴展)中提示擴展(步驟 2)的廉價替代品 — 這也是設計概念與漸層背景上通用標誌之間的區別。

步驟 2 — 提示擴展 → hyperframes-creative

對每個多場景合成執行此步驟(單場景作品和瑣碎編輯請跳過)。根據設計規格 + 主體風格來擴展請求,形成一致的、下游工作能以相同方式讀取的中間產物。請參閱 hyperframes-creative/references/prompt-expansion.md。

步驟 3 — 規劃

在撰寫 HTML 之前,先從高層次思考:

  1. 什麼 — 觀眾體驗:敘事弧線、關鍵時刻、情感節拍。
  2. 結構 — 有多少個合成、子合成 vs 內聯、哪些軌道承載影片 / 音訊 / 疊加層 / 字幕。關於單一檔案 vs 模組化子合成的決定,請參閱 hyperframes-core/references/composition-patterns.md § 兩種架構(經驗法則:≥3 個硬場景切換,或任何重複使用的場景 → 模組化;一個簡短的單場景作品保持單一檔案)。
  3. 節奏 — 在實作之前先命名模式(例如 fast-fast-SLOW-SHADER-hold);請參閱 hyperframes-creative/references/beat-direction.md。
  4. 時間點 — 哪個剪輯片段驅動持續時間、轉場落在哪裡、節奏為何。
  5. 佈局 — 先建構最終狀態(見下文)。
  6. 動畫 — 然後透過 hyperframes-animation 加入動畫。

先佈局,後動畫

將每個元素放置在其最顯眼的時刻所在的位置 — 完全進入、位置正確、尚未退出。先將其寫為靜態 HTML + CSS。先不要使用 GSAP。

原因: 如果你將元素定位在其動畫起始狀態(畫面外、縮放到 0、透明度 0),然後補間到你_認為_它們應該到達的位置,你就是在猜測最終佈局 — 重疊部分直到渲染時才會顯現。先建構最終狀態,你就能在加入動畫之前看到並修正佈局問題。

  1. 為每個場景識別主要影格 — 也就是最多元素同時可見的時刻。這就是你要建構的佈局。
  2. 為該影格撰寫靜態 CSS。內容容器必須使用內邊距來填充場景,而不是使用絕對偏移:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* 內邊距定位內容;可填充任何場景大小 */
  gap: 24px;
  box-sizing: border-box;
}

永遠不要在內容容器上使用 position: absolute; top: Npx — 當內容高於空間時它會溢出。將絕對定位保留給裝飾性元素。

⚠ 上述 width/height: 100% 只有在每個祖先元素都有明確的高度時才有效。 根元素 <div data-composition-id> 以及它和 .scene-content 之間的任何包裝元素都必須設定尺寸(根元素上設定 position: relative; width: 1920px; height: 1080px — 請參閱 hyperframes-core → 「Root must be sized」)。跳過此步驟,flex 容器會塌陷至約 0,內容會堆疊到左上角,第一個字形會在 x=0 處被裁切 — 而 lint/inspect 仍會回報 0 個問題。並且始終在 .scene-content 上保留 padding(≥80px):它是標題安全邊距。永遠不要用單純的 gap 來取代它。

  1. 加入入場動畫 — 使用 gsap.from() 從畫面外/不可見動畫到 CSS 位置(在子合成中,偏好使用 gsap.fromTo(),以便明確指定起始狀態;請參閱 hyperframes-core/references/sub-compositions.md)。CSS 位置是真實狀態;補間是通往該狀態的旅程。
  2. 退出由轉場處理 — 根據 hyperframes-animation/transitions/ 中的場景轉場規則,只有最終場景會將元素動畫化退出;在場景之間,轉場本身就是退出。

跨時間共享空間: 如果在同一區域中,元素 A 在元素 B 進入之前就退出了,兩者仍然需要為各自的主要影格設定正確的 CSS 位置 — 時間軸排序可以防止它們同時存在,而佈局步驟則可以捕捉到意外的重疊。分層光暈/陰影和 z 軸堆疊深度是_有意的_重疊;此步驟的目的是捕捉_非有意的_碰撞(兩個標題疊在一起、內容跑出影格)。

建構 — 委派給領域技能

這將技能的完整範圍(請參閱 description)映射到其參考資料 — 並非詳盡無遺;當意圖未列出時,請透過 hyperframes-creative(外觀/概念)、hyperframes-animation(動畫)、hyperframes-core(合約)、hyperframes-media(音訊/字幕)來路由。第一行是附加的 — 請閱讀它以及你的意圖行,而不是只讀其中一個。

建構…優先閱讀(按順序)
始終 — 每個非瑣碎的作品,在你下方的意圖行之上hyperframes-creative/references/house-style.md + references/video-composition.md(亦在步驟 1 / HARD-GATE 中把關;這是「被製作出來,而非被產生出來」的前景細節)
動態文字排版 / 文字導向hyperframes-animation/techniques.md(動態文字) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
標題卡 / 下方三分之一 / 疊加層 / 畫中畫 / 主體後文字hyperframes-creative/references/composition-patterns.md +(關於置中/縮放影格)hyperframes-core → 「Root must be sized」
標誌 / 品牌標記揭示hyperframes-animation/rules/svg-path-draw.md(繪製) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
資料 / 統計 / 數字hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
產品 / 應用程式 / UI 示範hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
音訊反應 / 音樂驅動hyperframes-creative/references/audio-reactive.md(預先提取頻段;映射到動畫)
旁白 / 語音 / 音樂 / 音效 / 字幕hyperframes-media → 共享音訊引擎 scripts/audio.mjs(一次呼叫 = TTS + BGM + SFX → audio_meta.json);透過 hyperframes-core 進行字幕創作 + 資產放置。請參閱下方的音訊。
多場景 / 轉場hyperframes-animation/transitions/overview.md 然後 transitions/catalog.md(讀完概覽還沒完 — GSAP 配方在目錄中)
模組化 / 子合成hyperframes-core/references/composition-patterns.md + references/sub-compositions.md

音訊:單一引擎(TTS · BGM · SFX)

僅在作品需要時才使用(根據「確實依照要求建構」 — 標題卡上不要有背景音樂)。不要手動製作 TTS 或外包複製:撰寫一個中立的 audio_request.json 並呼叫 hyperframes-media 中的共享引擎。它會自動根據一個開關進行降級 — 有 HeyGen 憑證 → HeyGen TTS + 音樂/SFX 檢索;無憑證 → ElevenLabs/Kokoro TTS、Lyria/MusicGen BGM 生成,以及內建的 SFX 庫。完整的標誌清單 + 請求/中繼資料結構:請參閱 hyperframes-media/scripts/audio.mjs 的標頭註解。

// audio_request.json — 每個旁白區段一行;`id` 是你的(將 audio_meta 連接回來)
{
  "lines": [
    { "id": "s1", "text": "你的開場白。", "sfx": ["whoosh"] },
    { "id": "s2", "text": "下一個節拍。" },
  ],
  "bgm": { "query": "calm cinematic underscore" }, // 省略 "mode" → 自動(有 HeyGen 則檢索,否則生成);設為 "none" 以停用
}
# <MEDIA_DIR> = 已安裝的 hyperframes-media 技能目錄(此技能的兄弟目錄)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

然後讀取 audio_meta.json:將每個 voices[].path 以及(bgm.path、sfx[])掛載為 <audio> 軌道,並使用 voices[].words 作為字幕,全部依照 hyperframes-core(音訊軌道 + 字幕創作)進行。如果 BGM 採用了生成路徑(bgm_pending: true),請在最終渲染前執行 hyperframes-media/scripts/wait-bgm.mjs。

輸出檢查清單 → hyperframes-cli

…

[已截斷以利翻譯]

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

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.

1345AbhishekKumar/starter-nextjs

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

相關技能