Communitygithub.com

9018/mychat

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

mychat 是什麼?

這個技能「Website to HyperFrames」是一個 AI 代理技能,專門將一般網站(例如作品集、部落格、登陸頁面)的內容,透過無頭 Chrome 瀏覽器進行螢幕截圖,並結合品牌資產,自動化地轉換成具有專業感的影片,適用於網站導覽、作品展示或社交媒體短片。 技能的核心工作流程分為七個嚴謹的步驟,從初步的網站捕獲與品牌理解(Step 0),到最終的影片驗證與交付(Step 6)。每個步驟都設有檢查點(Gate),確保品質與方向正確。代理會根據使用者授權,在「協作模式」(遇到偏好問題會暫停詢問)或「自動模式」(跳過使用者偏好問題,但不可跳過品質驗證關卡)下運作。此技能明確區分了與其他影片製作場景的界線,例如產品促銷影片、主題解說影片或 GitHub PR 轉影片等,需透過預先定義的路由表來引導使用者至正確的專門技能。 它廣泛支援 HeyGen、ElevenLabs 等文字轉語音(TTS)服務,並提供詳細的影片類型、時長與格式指南(如 1920x1080 橫向、1080x1920 直向),讓生成的影片在不同平台上表現最佳。此技能非常適合需要批次將大量網站資產快速轉換為視覺化演示內容的開發者或行銷人員。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/9018/mychat/tree/HEAD/OpenMontage/.agents/skills/website-to-video

在你喜歡的 AI 中提問

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

說明文件

media-use:在獲取音訊/音效前,請先呼叫 /media-use 以從 HeyGen 目錄中取得 BGM/音效/圖片。先執行 --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。

關卡: 主代理已根據 DESIGN.md 和 STORYBOARD.md 從頭到尾閱讀每個 compositions/beat-N.html。逐拍檢查清單位於 step-5-build.md 中。


第 6 步:驗證與交付

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

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

交付一份讓你自豪的作品。 在交接前,捫心自問:我會把這個貼在社交媒體上並署上我的名字嗎?如果不會,那就修正問題。

關卡: npx hyperframes lint 和 npx hyperframes validate 以零錯誤通過,且最終回應包含活躍的 Studio 專案網址。


快速參考

影片類型

依影片類型劃分的典型限制 —— 作為起點,而非公式。節拍數應來自於內容和旁白,而非來自目標範圍。

類型典型時長時長驅動因素旁白
社交廣告(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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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

9018/mychat

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

9018/mychat

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.

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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.

9018/mychat

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.

9018/mychat

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.

9018/mychat

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

9018/mychat

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

相關技能