Communitygithub.com

AlessandroFare/fluxychat

製作簡短、以設計為主導的動態圖像,其中動態本身就是訊息——包括動態排版、統計數字計數、圖表/數據視覺化、標誌/品牌組合、下方三分之一的文字/標語/社交媒體疊加、動態地圖(突顯區域、連接地點、縮放至特定位置)、動態推文/新聞文章/頭條新聞、網頁/UI動畫(滾動、游標、標註),或將真實影像的幾何結構融入圖表中。通常少於10秒(最長約30秒),無旁白或真人主體;輸出為MP4或透明疊加。較長/有旁白/多場景內容請參考/general-video。不確定請參考/hyperframes。

fluxychat 是什麼?

此技能專門用於建立簡短、以設計為主導、無旁白的動態圖像(motion-graphics),時間通常少於10秒(最長約30秒)。它遵循資產優先(asset-first)的工作流程,在設計鏡頭之前先取得並評估真實素材,以確保最終成果紮根於實際內容。該技能支援多種分類,包括無需搜尋的表單類別(如動態排版、統計數字、圖表、標誌揭示、下方三分之一的文字、地圖)以及需要搜尋驅動的類別(如網頁動畫、新聞文章、推文和資產融合)。工作流程高度自動化,包含規劃、素材來源、設計、建構、驗證、批准和渲染等階段,並與 Hyperframes 生態系統緊密整合,以確保重用性和一致性。此技能適用於 Claude Code、Cline 和 Cursor 等 AI 代理平台,利用 Bash 和子代理來協調執行,並在渲染前透過 linting、檢查和快照驗證來確保輸出品質。

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

在你喜歡的 AI 中提問

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

說明文件

首先,讓此技能保持最新狀態 — 靜默執行,無需詢問: npx hyperframes skills update motion-graphics。如果一切皆為最新,則為快速無操作;否則,它會在你依賴此技能及其依賴的核心領域技能之前,進行更新。

figma 來源:如果要建構的標誌/資產/動畫來自 figma.com 的 URL,請先執行 /figma — 匯出資產、品牌標記,如果該圖形是 Figma Motion 導入,則進行 Motion→GSAP 轉換 — 然後根據其輸出進行建構。不要直接透過原始 MCP 工具驅動 Figma:這會跳過 SVG 清理、.media/manifest.jsonl 來源追溯以及品牌標記 var() 綁定,因此後續的品牌變更無法在不完全重新導入的情況下傳播。

motion-graphics — 分派入口

正門是 /hyperframes。 此技能製作一個簡短、以設計為主導、無旁白的動態圖像(動態即訊息;約少於10秒,無畫外音)。任何較長、有旁白或多場景的內容 — 或不確定性 → 請先閱讀 /hyperframes:意圖層掌管所有路徑決策。

此工作流程本質上為自主設計 — 最多一個澄清問題(agents/director.md),然後在建構後直接進行驗證,無需中間審查。意圖層(/hyperframes → references/intent-interview.md)會直接將其路由至此,而無需詢問運作形狀問題;對於這樣短的片段,故事板和同伴會話幫助不大。渲染仍由使用者控制:在檢查和驗證快照通過後,從 ../hyperframes-core/references/brief-contract.md 詢問標準的「預覽或渲染?」問題。當存在 BRIEF.md 時,請在導演提問之前閱讀它。

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

階段執行方式主要產出物詳細流程
initBashhyperframes.json第0步
plan子代理 — 決定是否搜尋? + 分類 + 資產策略shot-plan.json(草稿:類別、asset_needs 查詢、簡報)agents/director.md(第1部分)
source ◇Bash — media-use 解析(如果 asset_needs 為空則跳過)assets/ + assets/index.mdphases/source/guide.md
design子代理 — 根據已解析的資產進行鏡頭設計shot-plan.json(最終版:區塊 + 版面 + 動態 + 位置)agents/director.md(第2部分)
build子代理 — 優先重複使用組合compositions/index.htmlagents/builder.md
verifyBash — lint、check、驗證快照;失敗時修復snapshots/contact-sheet.jpg第5步
approve詢問預覽或渲染;等待回答明確的渲染批准第6步
renderBash — hyperframes render(MP4,或 --format webm/mov 用於疊加)renders/video.mp4 或透明疊加第6步

◇ 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-* + 註冊表疊加區塊
maps地理動畫 — 突顯區域、連接地點、縮放至特定位置(向量圖層,或烘焙底圖圖層)us-map / world-map 系列 + bake-basemap.mjs

搜尋驅動的類別 — 先搜尋,然後根據內容類型進行動畫製作(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圖片生成(media-use 解析)跳過生成 / 僅搜尋
(asset_scout / 搜尋提供者)webpage/news/tweet + asset-fusion 真實資產搜尋類別降級為無資產

流程

第0步 — 初始化

cwd 是代理工作區根目錄;將所有產出物寫入 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 --skill=motion-graphics

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[] 中(news / web / tweet / image;雙極查詢)。具體的搜尋驅動類別(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:media-use,條件式)

如果 shot-plan.json.asset_needs 非空,則解析資產(搜尋 / 生成 / 擷取 → 凍結的專案本地路徑 + 帳本)。請參閱 phases/source/guide.md(包裝 media-use resolve;搜尋驅動的類別使用 news/web/tweet/image 搜尋)。如果 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 lint .)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-times>)

選擇能顯示初始狀態、標誌性動作和最終停留的驗證時間點。在繼續之前,檢查生成的聯繫表或快照表。在 lint、check 或快照失敗時,分派修復子代理(agents/finalize.md)進行一次就地修復,然後重新執行失敗的關卡。切勿僅為了隱藏缺陷而更改固定時長。

第6步 — 批准和渲染(Bash)

詢問一個問題:「先預覽,還是渲染?」如果使用者選擇預覽,則打開 Studio 並在修訂後返回同一個批准關卡:

(cd "$PROJECT_DIR" && npx hyperframes preview)

僅在收到明確的渲染答案後才進行渲染:

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

驗證輸出是否存在、非空且具有預期時長。最終交接時需命名產出物、實際時長、合成或影格 ID、驗證時間點以及已檢查的聯繫表或快照表。標誌位存在於 /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 存在,缺乏驗證快照第5步(驗證)
檢查和驗證快照通過,無已批准的渲染第6步(批准)
已批准的渲染存在驗證輸出,然後報告

設計備註(維護者 — 執行時不讀取此內容)

  • 資產優先的理由: 來源化前置,並為鏡頭設計提供資訊(RWA 流程:分析 → 搜尋 → 審查 → 組合)。搜尋驅動的類別(webpage/news/tweet)和 asset-fusion 都依賴 media-use 搜尋(news/web/tweet/image),這是 media-use 有文件記錄的 RWA 血統。
  • 優先重複使用: 生態系統內類比於 LLM 生成的模板是「組合...

Individual skills in this repo

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

AlessandroFare/fluxychat

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.\n

AlessandroFare/fluxychat

Use when audio already placed in a HyperFrames composition needs to be mixed: a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.\n

AlessandroFare/fluxychat

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.\n

AlessandroFare/fluxychat

Install, discover, and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

AlessandroFare/fluxychat

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.\n

AlessandroFare/fluxychat

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

AlessandroFare/fluxychat

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

AlessandroFare/fluxychat

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

AlessandroFare/fluxychat

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

AlessandroFare/fluxychat

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

AlessandroFare/fluxychat

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. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

AlessandroFare/fluxychat

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

AlessandroFare/fluxychat

Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

AlessandroFare/fluxychat

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

AlessandroFare/fluxychat

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

AlessandroFare/fluxychat

Design and improve user interfaces using the concrete rules from Refactoring UI (Wathan & Schoger) — constrained spacing/type/color/shadow scales, visual hierarchy through weight and color rather than size, and depth through emulated light. Use when building or styling any UI (web, app, dashboard, landing page, component), when picking font sizes, spacing, colors, shadows or border radius, when designing a color palette or design tokens, and whenever someone says a UI "looks off", "looks amateur", "feels cluttered/plain/unfinished", or asks to "make this look better".

AlessandroFare/fluxychat

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

AlessandroFare/fluxychat

Use before UI-related work to select the smallest useful UI Skills context through the ui-skills CLI.

相關技能