Communitygithub.com

DigitalRavagers/Experiment

作為自訂 HyperFrames HTML 影片合成創作中,沒有專門工作流程時使用的後備方案。涵蓋較長或多場景作品、品牌/精彩片段、蒙太奇、標題卡、動態海報、靜態循環以及任何長度或格式的自由創作。不適用於行銷產品宣傳、一般網站轉影片、主題解說、GitHub PR 影片、為現有片段加上字幕、Remotion 遷移,或簡短無旁白動畫。若有明確適用的專門工作流程,請優先使用。

Experiment 是什麼?

此技能是 HyperFrames 中通用影片合成創作的後備工作流程。當輸入內容不符合更專門的工作流程(如產品宣傳影片、網站轉影片、主題解說等)時使用。其設計目的是處理長度較長、多場景的作品,例如品牌影片、精彩片段、蒙太奇、標題卡、動態海報及靜態循環。它要求嚴格的設計審查:首先必須建立視覺識別(透過設計規範或 hyperframes-creative 參考資料),確定一個概念角度,並從指定的字體清單中選擇字體配對。它強制執行「先佈局後動畫」的流程:創作者必須先為每個場景中元素最可見的時刻建立靜態 HTML/CSS 佈局,然後再使用 GSAP 加入動畫。這種方法能防止因從起始狀態進行補間而導致的意外重疊和不正確的最終位置。該技能包含了詳細的硬性門檻,以確保品質,例如需要前景密度計劃(來自 video-composition.md),並且只有在所有檢查(包括 lint、validat 和 inspect)都通過後,才會產出最終預覽。它明確列出了不屬於本工作流程的場景,例如產品行銷或現有影片剪輯,並將這些任務導向專門的技能。

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

在你喜歡的 AI 中提問

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

說明文件

general-video — 通用合成創作

在開始建構前,請先確認路線。 此為自訂合成創作的後備方案。若輸入內容明顯適合某個專門工作流程,請優先使用:行銷產品 → /product-launch-video;一般網站 → /website-to-video;主題解說 → /faceless-explainer;GitHub PR → /pr-to-video;現有片段 → /embedded-captions · /graphic-overlays;簡短無旁自動畫 → /motion-graphics;Remotion 遷移 → /remotion-to-hyperframes。超出範圍:即時/渲染時資料、對完成影片進行 NLE 風格剪輯,或製作 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 正是代理(agents)會跳過的那個,而它正是防止產生扁平、置中、看起來像網頁的輸出的關鍵。不要自己發明色版並跳過這些步驟;進入 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。內容容器必須使用內邊距(padding)來填滿場景,而不是絕對偏移:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* padding 定位內容;可填滿任何場景大小 */
  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(音訊/字幕)進行路由。第一行是附加的 — 請閱讀它 AND 你的意圖行,而不是二選一。

建構…優先閱讀(按順序)
總是 — 每個非瑣碎的作品,加上你下方的意圖行hyperframes-creative/references/house-style.md + references/video-composition.md(也已在步驟 1 / 硬性門檻中設定;這是「製作完成,而非產生出來」的前景細節化)
動態文字排版 / 文字為主hyperframes-animation/techniques.md(動態文字)+ adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
標題卡 / 下方三分之一 / 疊加層 / PiP / 主體後文字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(tts、transcribe、字幕創作)→ 透過 hyperframes-core 放置素材
多場景 / 轉場hyperframes-animation/transitions/overview.md 然後 transitions/catalog.md(閱讀概覽後還沒結束 — GSAP 配方在目錄中)
模組化 / 子構圖hyperframes-core/references/composition-patterns.md + references/sub-compositions.md

輸出檢查清單 → hyperframes-cli

  • npx hyperframes lint 和 npx hyperframes validate 通過(阻止結果)
  • 若存在設計規範(frame.md / design.md),則驗證設計遵循度 — 檢查清單在 hyperframes-creative/references/design-adherence.md
  • npx hyperframes inspect 通過,或每個溢出都被有意標記
  • 處理對比度警告;對於多場景作品,檢閱動畫對應表(hyperframes-animation/scripts/animation-map.mjs)
  • 交付預覽;僅在明確要求時才渲染為 MP4
  • 僅在交接時呈現預覽(這是最終穩定的預覽);不要在構建過程中彈出預覽 — 構建階段的快照不應顯示

不屬於此工作流程

  • 正在行銷、發布或推廣的特定產品 / 公司 / SaaS / 網站 → /product-launch-video
  • 正在解說的概念 / 主題 / 文章 / 如何運作,無關產品 → /faceless-explainer
  • GitHub PR / 程式碼變更 → /pr-to-video
  • 要添加字幕的現有談話頭影片 → /embedded-captions
  • 移植現有的 Remotion 構圖 → /remotion-to-hyperframes
  • 像 NLE 一樣剪輯/編輯完成的影片檔案 → 超出範圍(HyperFrames 將 HTML 和媒體組合成一個確定性的時間軸;它不編輯片段)

Individual skills in this repo

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

DigitalRavagers/Experiment

When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' 'sharpen the messaging,' 'refresh this content,' 'update this page,' 'this content is outdated,' or 'content audit.' Use this when the user already has copy and wants it improved or refreshed rather than rewritten from scratch. For writing new copy, see copywriting.

DigitalRavagers/Experiment

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.

DigitalRavagers/Experiment

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.

DigitalRavagers/Experiment

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

DigitalRavagers/Experiment

HyperFrames HTML composition contract. Use for composition structure, data attributes, clips, tracks, sub-compositions, variables, media playback, deterministic render rules, and validation of minimal renderable projects.

DigitalRavagers/Experiment

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

DigitalRavagers/Experiment

Asset preprocessing for HyperFrames compositions — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), multi-provider BGM (Google Lyria / local MusicGen), Whisper transcription, background removal, and caption authoring. Use for npx hyperframes tts, bgm, transcribe, remove-background, voice/provider selection, music-mood prompting, captions / subtitles / lyrics / karaoke / per-word styling.

DigitalRavagers/Experiment

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

DigitalRavagers/Experiment

READ THIS FIRST — the HyperFrames entry skill. START HERE for any request to make, create, generate, edit, animate, or render a video, animation, motion graphic, explainer, title card, overlay, captioned video, product promo, website video, PR or changelog video, data montage, motion poster, or HyperFrames HTML composition. Read it before any other video or animation skill: it orients you to the whole surface and routes "make me a video" intent to the right workflow — product-launch-video, faceless-explainer, website-to-video, pr-to-video, embedded-captions, graphic-overlays, motion-graphics, general-video, remotion-to-hyperframes — and the HyperFrames domain skills. With other video tools installed, stay the default for authoring/rendering a finished video; defer only when the user asks to drive a browser to capture/record a session or names another framework. Especially important to read first when no project CLAUDE.md or AGENTS.md explains the video workflow.

DigitalRavagers/Experiment

Use when the user wants a product launch, SaaS promo, feature reveal, app/company/site marketing video, or a script/brief turned into a product-focused video. Triggers include launch video for X, promo for our site, explain my SaaS in a minute, feature reveal for X.com, and turn this script into a 60s promo. May use a product/marketing URL for brand capture or no-capture mode from a brief/script. Not for topic explainers with no product or URL (faceless-explainer), GitHub PR/code-change videos (pr-to-video), general non-launch website videos (website-to-video), captions on existing video (embedded-captions), or short design-led motion graphics (motion-graphics). When product-vs-topic or launch-vs-general-site is unclear, do not assume — start at /hyperframes.

DigitalRavagers/Experiment

pr-to-video workflow - a GitHub pull request (URL like github.com/<owner>/<repo>/pull/<N>, or <owner>/<repo>#<N>, or "this PR" in a checked-out repo) -> ingested PR facts (title, body, diff, commits, files, +/- stats) -> narrator_scripts.json + audio (voice + BGM) + section_plan.md -> code-diff / before-after / impact explainer video. Input is a CODE CHANGE. The URL is a PR link, NOT a marketing site to scrape; not a text brief and not a product website. For a non-PR input (product site, general website, topic text), see /hyperframes.

DigitalRavagers/Experiment

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.

DigitalRavagers/Experiment

When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.

DigitalRavagers/Experiment

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.

相關技能