Communitygithub.com

Aseel1600/Edit01

將一般網站/網址轉換成 HyperFrames 影片(網站導覽、展示或來自網站自身視覺的社交短片)。使用無頭 Chrome 螢幕截圖和品牌素材。適用於一般意圖 — 作品集/部落格/登陸頁面展示或來自網站的社交短片。不適用於:產品/SaaS 發布或宣傳(→ /product-launch-video,即使來自網址);無網站的議題解說(→ /faceless-explainer);GitHub PR(→ /pr-to-video);為現有影片加上字幕(→ /embedded-captions);短篇無旁白頁面重點動態圖形(→ /motion-graphics)。不確定是發布還是一般網站?問一個問題或從 /hyperframes 開始。

Edit01 是什麼?

此技能旨在將任何一般網站轉換成專業的 HyperFrames 影片,適用於展示、社交短片或網站導覽。整個工作流程包含 7 個步驟,從使用無頭 Chrome 捕捉網站並提取品牌資產開始,接著定義品牌識別、策略與訊息、腳本與分鏡、語音與時間軸、建置合成畫面,最後驗證並交付。每個步驟都設有關卡,部分需要使用者確認(💬),但可透過「自主模式」跳過偏好設定問題,而品質驗證關卡(如資產審核、逐拍 HTML 閱讀、完成定義清單)則無法跳過。此技能支援 HeyGen、ElevenLabs 和 Kokoro 等多種語音合成供應商,並能自動生成字幕。輸出結果為一個可預覽的 Studio 專案 URL,僅在使用者明確要求時才轉換為 MP4。此技能明確區分「一般網站展示」與「產品行銷發布」,若使用者意圖屬於後者,則會引導至專用的 /product-launch-video 技能。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Aseel1600/Edit01/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 並逐字轉達其輸出(不要改寫或重新表達)。 它會報告語音/BGM 將使用 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 限時動態、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 20 individual skills — each has its own dedicated page.

Aseel1600/Edit01

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

Aseel1600/Edit01

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Aseel1600/Edit01

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

Aseel1600/Edit01

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

Aseel1600/Edit01

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

Aseel1600/Edit01

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Aseel1600/Edit01

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Aseel1600/Edit01

Generate expressive, multilingual narration with fish.audio (S1 / S2-generation models) and reuse cloned voices via reference_id. Use when the user prefers fish.audio/Fish Audio TTS, wants a specific playground voice model, or needs high-emotion voice-clone narration.

Aseel1600/Edit01

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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.

Aseel1600/Edit01

Best practices for Remotion - Video creation in React

Aseel1600/Edit01

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

Aseel1600/Edit01

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.

相關技能