Communitygithub.com

Aseel1600/Edit01

用於製作簡短、以設計為主導的動態圖形,其中動態本身就是訊息:動態文字、統計數字計數、圖表/資料視覺化、標誌動畫、品牌組合、下三分之一、提示框、社交媒體疊加層、動畫標題/推文/新聞項目、動態海報或快速捕捉的頁面亮點。通常長度在 10 秒以下,最長約 30 秒,不含敘事弧線、旁白或真人主題。可輸出為 MP4 或透明疊加層。不適用於較長、多場景、有旁白或品牌宣傳片的作品(請使用 general-video)、有旁白的網站影片(website-to-video)、主題解說(faceless-explainer)、產品宣傳片(product-launch-video)、公關影片(pr-to-video)或為現有素材添加字幕(embedded-captions)。若不確定是快速動畫優先還是較長/有旁白的作品,請參閱 /hyperframes。

Edit01 是什麼?

此技能專門用於建立簡短、以設計為主導且無旁白的動態圖形,將動態本身作為核心訊息。它支援多種格式,包括動態文字(kinetic typography)、統計數字計數、圖表動畫、標誌動畫、下三分之一字幕以及社交媒體疊加層,通常長度在 10 秒以下。此技能遵循「資產優先」的工作流程:在開始設計鏡頭之前,先決定資產策略並取得實際素材,然後圍繞這些資產進行設計,最後透過重複使用目錄中的現有功能來進行組合。它主要支援 macOS Apple Silicon 或 Linux x64 平台,並使用 `hyperframes` 工具鏈進行初始化、建置和渲染。技能根據是否需要搜尋外部內容,將專案分類為「形式類別」(如 kinetic-type)或「搜尋驅動類別」(如 webpage、news),然後執行從計劃、素材來源、鏡頭設計、建置、渲染到驗證的六個步驟。

相容平台~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/Aseel1600/Edit01/tree/HEAD/.agents/skills/motion-graphics

在你喜歡的 AI 中提問

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

說明文件

motion-graphics — 分派入口

請在步驟 0 之前確認路線。 此技能用於製作簡短、以設計為主導且無旁白的動態圖形(動態即訊息;約 10 秒以下,無旁白)。較長、多場景或有旁白的作品 → /general-video;有旁白的網站影片 → /website-to-video;主題解說 → /faceless-explainer;產品宣傳片 → /product-launch-video;為現有素材添加字幕 → /embedded-captions。超出範圍:即時/渲染時資料,或無法捕捉的素材。不確定是動畫優先還是有旁白?請先閱讀 /hyperframes。

一個簡短的、以設計為主導的動態圖形。資產優先:在設計鏡頭之前,決定資產策略並取得真實素材,然後圍繞已取得的素材設計鏡頭,最後透過重複使用目錄功能來進行組合。所有成品都存放於 PROJECT_DIR = videos/<project-name>/(在步驟 0 建立);以下所有路徑都是相對於此目錄。

階段執行方式主要成品詳細流程
初始化Bashhyperframes.json步驟 0
規劃子代理 — 決定是否搜尋? + 分類 + 資產策略shot-plan.json(草稿:類別, asset_needs 查詢, 簡報)agents/director.md(第 1 部分)
素材來源 ◇Bash — 媒體使用解析(若 asset_needs 為空則跳過)assets/ + assets/index.mdphases/source/guide.md
設計子代理 — 圍繞已解析的資產進行鏡頭設計shot-plan.json(最終版:區塊 + 佈局 + 動態 + 定位)agents/director.md(第 2 部分)
建置子代理 — 重複使用優先的組合compositions/index.htmlagents/builder.md
渲染Bash — hyperframes render(MP4,或使用 --format webm/mov 作為疊加層)renders/video.mp4步驟 5
驗證Bash — lint / inspect -> 失敗時啟動修復子代理(就地修復)agents/finalize.md

◇ 素材來源 僅在所選類別宣告需要資產時執行。純程式碼/文字類別(例如 kinetic-type、大多數的 charts/stat)的 asset_needs: [] 會直接從規劃階段跳到設計階段。

類別 — 根據搜尋決策來劃分

規劃階段的第一個決策是:是否需要搜尋? 這個分支將類別分成兩組;然後選出具體類別 — 對於搜尋驅動的類別,根據搜尋結果的內容類型來決定。每個類別都是一個 categories/<id>/module.md(包含其規劃和建置規則);共享的動態詞彙庫位於 references/motion-vocabulary.md(→ hyperframes-animation 規則/藍圖 + 註冊區塊)。

形式類別 — 無需搜尋;由使用者提供內容:

類別意圖主要依賴
kinetic-type有力的台詞 / 引文 / 標題,動態優先的文字caption-* 區塊 + 動畫規則
stat單一主數字 / 計數器 + 環狀圖apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
charts長條圖 / 折線圖 / 圓餅圖 / 競賽圖 / 來自資料的百分比data-chart 區塊
logo-reveal標誌動畫 / 品牌組合(使用者標誌)logo-outro / rules/svg-path-draw
lower-thirds姓名 / 標題列、提示框、社交媒體疊加層caption-* + 註冊表疊加層區塊

搜尋驅動類別 — 先搜尋,再根據內容類型進行動畫處理(RWA 路徑):

回傳的內容類別動畫處理
網頁 / 連結webpage網頁 / UI 動畫(滾動、揭示、游標、提示框)
新聞文章news標題揭示 + 來源卡片 + 關鍵事實提示框
推文tweet動畫化推文卡片
圖片 / 實體asset-fusion資產的幾何形狀變成圖表(RWA 融合)

建置順序:一次一個,以覆蓋率優先(粗略即可)。kinetic-type 從原型移植過來;其餘類別遵循此模式。

先決條件

macOS Apple Silicon 或 Linux x64。系統工具:brew install node ffmpeg。執行一次 npx hyperframes doctor。macOS GPU 渲染:export PRODUCER_BROWSER_GPU_MODE=hardware。

可選金鑰(若未設定則使用本地備用方案)— 僅在需要透過媒體使用(media-use)來來源/產生資產的類別中使用:

金鑰用途備用方案
GEMINI_API_KEY / GOOGLE_API_KEY圖片生成(媒體使用解析)跳過生成 / 僅搜尋
(asset_scout / 搜尋提供者)webpage/news/tweet + asset-fusion 真實資產搜尋類別降級為無資產

流程

步驟 0 — 初始化

當前工作目錄是代理工作區根目錄;所有成品都寫入 PROJECT_DIR = videos/<project-name>/。:使用使用者提供的目錄,否則根據意圖使用簡短的 kebab-case 名稱(<subject>-motion)。不要使用工作區根目錄名稱或時間戳。

僅當 $PROJECT_DIR/hyperframes.json 不存在時:

PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank

init 會檢查已安裝的技能與 GitHub 上的最新版本,並在發現任何過期技能時更新全域集合。

限制: 永遠不要在 workspace 根目錄執行 hyperframes init;永遠不要在 PROJECT_DIR 內巢狀存放另一個 hyperframes/ 目錄;每個 Bash 命令(主代理 + 子代理)都是在 (cd "$PROJECT_DIR" && ...) 的子 shell 中執行 — 永遠不要使用裸 cd。

步驟 1 — 規劃(子代理:導演 第 1 部分)

分派一個子代理。提示詞 = 完整的 agents/director.md + ## 分派上下文(SKILL_DIR / PROJECT_DIR / 使用者的請求 / Schema: <SKILL_DIR>/references/shot-plan-ir.md)。它必須:

  1. 決定:是否需要搜尋?(第一個分支)
    • 否 → 選擇一個形式類別(kinetic-type / stat / charts / logo-reveal / lower-thirds);內容由使用者提供;asset_needs: []。
    • 是 → 將一個搜尋計劃輸出到 asset_needs[](新聞 / 網頁 / 推文 / 圖片;雙極查詢)。具體的搜尋驅動類別(webpage / news / tweet / asset-fusion)將由步驟 2 中回傳的內容類型確認,並在步驟 3 中最終確定。
  2. 撰寫一個草稿 shot-plan.json(包含包絡 + 所選形式類別 或 搜尋意圖 + asset_needs + 一段落描述鏡頭的簡報)。Schema:references/shot-plan-ir.md。

驗證:[ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing。

步驟 2 — 素材來源 ◇(Bash:媒體使用,有條件)

如果 shot-plan.json.asset_needs 非空,則解析資產(搜尋 / 產生 / 擷取 → 凍結的專案本地路徑 + 分類帳)。請參閱 phases/source/guide.md(封裝了 media-use resolve;搜尋驅動類別使用新聞/網頁/推文/圖片搜尋)。如果 asset_needs 為空,則跳到步驟 3。

# 僅供說明 — 請參閱 phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)

優雅降級:如果搜尋/提供者不可用,該類別將回退為無資產(在 context.log 中記錄)。

步驟 3 — 設計(子代理:導演 第 2 部分)

分派一個子代理(提示詞 = agents/director.md 第 2 部分 + 分派上下文,包含已解析的 assets/index.md(如果步驟 2 已執行)+ catalog-map.md)。它根據可用的資產來設計鏡頭:選擇目錄區塊 + hyperframes-animation 規則/藍圖、佈局、動態、節拍,以及(對於 asset-fusion)element_positions + 滴管調色板。最終確定 shot-plan.json(content.block + content.customize + 每個類別的內容)。

步驟 4 — 建置(子代理:建置者,重複使用優先)

分派一個子代理。提示詞 = 完整的 agents/builder.md + 分派上下文(shot-plan.json、catalog-map.md、該類別的 module.md、references/motion-vocabulary.md、references/builder-contract.md)。重複使用優先:npx hyperframes add <block> + 就地自訂;僅手動編寫空白部分 + asset-fusion 的輔助功能。輸出 compositions/index.html,需符合 HF 合約(在 window.__timelines 上的暫停 GSAP 時間軸、class="clip" + 穩定的 ID、tl.seek(0)、確定性)。

步驟 5 — 渲染(Bash)

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# 透明疊加層變體:--format webm (或 mov)

步驟 6 — 驗證(Bash → 失敗時啟動修復子代理)

(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)

exit 0 → 完成。若 lint/inspect 出現錯誤,則分派修復子代理(agents/finalize.md:快照 QA + 一次就地修復 + 重新渲染)。修復期間絕不更改固定時長。

報告 + 可選預覽

報告最終輸出(renders/video.mp4,或 .webm / .mov 疊加層變體)+ 時長。在執行期間不要開啟預覽。 僅在請求時提供,並在渲染後啟動,以便提供最終檔案:

(cd "$PROJECT_DIR" && npx hyperframes preview)   # Studio 使用者介面;或使用 `npx hyperframes play` 獲取可分享連結

標誌位存在於 hyperframes-cli 技能中(references/preview-render.md)。

恢復表

狀態從何處繼續
沒有 shot-plan.json步驟 1(規劃)
shot-plan.json 有 asset_needs,但沒有 assets/步驟 2(素材來源)
shot-plan.json 已最終確定,但沒有 compositions/index.html步驟 3/4(設計+建置)
compositions/index.html 存在,但沒有 renders/video.mp4步驟 5(渲染)+ 步驟 6
renders/video.mp4 存在報告 + 停止

設計筆記(維護者 — 執行時不會讀取此部分)

  • 資產優先的理由: 素材來源被提前執行,並為鏡頭設計提供資訊(RWA 流程:分析 → 搜尋 → 審閱 → 組合)。搜尋驅動類別(webpage/news/tweet)和 asset-fusion 都依賴於媒體使用搜尋(新聞/網頁/推文/圖片),這是媒體使用有記錄的 RWA 傳統。
  • 重複使用優先: 生態系統中與 LLM 生成的模板相對應的是「組合目錄區塊 + hyperframes-animation 規則」。HF 的暫停 GSAP 時間軸 ≙ Remotion 的 useCurrentFrame。
  • 類別模組合約: 一個 categories/<id>/module.md(規劃 + 建置),共享 references/motion-vocabulary.md(+ 可選評估)。新增一個類別 = 放下資料夾 + 在 agents/director.md 中註冊其分類器行 + 在 catalog-map.md 中註冊其行;階段管道保持不變。
  • 目錄結構:
    videos/<project-name>/
      hyperframes.json  context.log
      shot-plan.json            # 中間表示(導演輸出)
      assets/  assets/index.md  # 媒體使用輸出(如果有來源)
      compositions/index.html   # 建置者輸出
      renders/video.mp4
    
  • 註冊: 在 hyperframes 路由器中 — 新增「以設計為主導的簡短動態圖形」意圖 + 工作流程描述;從 /general-video 中劃出 motion-graphics 觸發條件;新增反向「請勿使用」邊緣。請參閱 motion-graphics-genre.md §5-7。

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

Aseel1600/Edit01

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

相關技能