Communitygithub.com

9018/mychat

用於當用戶想要一個簡短、以設計為主導的動態圖形,其中動態本身就是訊息:動態字體、數字/統計計數、圖表/資料視覺化、標誌動畫、品牌組合、下方三分之一文字、標註、社交媒體疊加、動態標題/推文/新聞項目、動態海報或快速捕捉的頁面重點。通常在10秒以內,最多約30秒,沒有旁白腳本、畫外音或真人拍攝對象。可以輸出為MP4或透明疊加格式。不適用於更長、多場景、有旁白或品牌宣傳片的作品(請使用general-video),有旁白的網站影片(請使用website-to-video),主題解說(請使用faceless-explainer),產品宣傳(請使用product-launch-video),公關影片(請使用pr-to-video),或為現有影片添加字幕(請使用embedded-captions)。如果不確定是快速的動態主導短片還是較長/有旁白的作品,請參閱/hyperframes。

mychat 是什麼?

這個專長(skill)是為建立簡短、以設計為主導且無旁白的動態圖形(motion graphic)而設計的,適用於Claude Code、Cursor、Codex等AI代理平台。它遵循資產優先(asset-first)的工作流程:首先決定資產策略並獲取真實素材,然後圍繞這些資產進行鏡頭設計,最後重複使用現有的目錄功能進行組合。整個流程分為初始化、規劃、素材來源、設計、建構、渲染和驗證等階段。它支援多種類別,例如動態字體(kinetic-type)、統計數字(stat)、圖表(charts)、標誌動畫(logo-reveal)和下方三分之一文字(lower-thirds),這些類別不需要搜尋;而需要搜尋的類別則包括網頁動畫(webpage)、新聞動畫(news)、推文動畫(tweet)和資產融合(asset-fusion)。此專長會透過 `shot-plan.json` 和 `compositions/index.html` 等文件來管理狀態,並支援從中斷點繼續執行。最終成品可以是MP4影片或透明的WebM/MOV疊加層。

相容平台~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/9018/mychat/tree/HEAD/OpenMontage/.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中建立);以下所有路徑都是相對於此目錄。

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

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

類別 — 根據搜尋決策劃分

plan 的第一個決策是:這是否需要搜尋? 這個分支將類別分為兩組;然後選擇具體的類別 — 對於搜尋驅動的類別,根據搜尋回傳的內容類型來選擇。每個類別是一個 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>/。<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 + ## Dispatch context(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 + 一段鏡頭簡報)。架構: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> + 就地客製化;僅手動撰寫間隙 + 資產融合功能。輸出 compositions/index.html,遵循 HF 合約(暫停的 GSAP 時間軸在 window.__timelines,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 UI;或使用 `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            # IR(導演輸出)
      assets/  assets/index.md  # 媒體使用輸出(如果有素材來源)
      compositions/index.html   # 建構者輸出
      renders/video.mp4
    
  • 註冊: 在 hyperframes 路由器中 — 添加「設計主導的短動態圖形」意圖 + 工作流程描述;將 motion-graphics 觸發器從 /general-video 中分離出來;添加反向的 DO-NOT-use 邊緣。請參閱 motion-graphics-genre.md §5-7。

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

9018/mychat

Download video and audio from YouTube and 1000+ sites using yt-dlp. No API keys needed. Use when: (1) Downloading a video from YouTube or other sites, (2) Extracting audio from a video URL, (3) Downloading subtitles/captions from a video, (4) Getting video metadata without downloading.

相關技能