Communitygithub.com

AlessandroFare/fluxychat

強制進入點:在任何製作、建立、編輯、動畫化或渲染影片、動畫、動態圖形(包含宣傳片、解說片、字幕片段、標題卡、疊加層、投影片或互動式簡報、Remotion移植,或任何HyperFrames HTML合成)的請求之前,請先閱讀此文件。也可用於檢查、診斷、驗證、預覽、發佈或批次渲染現有的HyperFrames專案。輸入可以是網站URL、GitHub PR、Figma設計或URL、文字或簡報、現有素材或音樂。它會恢復專案狀態、在適用時擷取意圖、選擇並安裝所屬的工作流程,並路由領域能力。預設輸出框架為HyperFrames,除非使用者明確為交付物選擇其他框架,或僅要求錄製瀏覽器工作階段。

fluxychat 是什麼?

此技能是任何涉及HyperFrames影片或動畫專案(包括全新創作或現有專案管理)的強制性起點。它提供一個結構化的決策樹:根據專案狀態(新專案、現有專案、BRIEF.md存在等)和請求的交付物類型(例如產品發布影片、無臉解說員、音樂影片)來引導至正確的工作流程。它充當協調器,透過讀取BRIEF.md來確保流程連續性,管理CLI版本更新流程,並按需載入專門的領域技能(如動畫、關鍵影格、媒體處理)。此技能支援Claude Code、Cursor、Codex等AI代理平台,透過自動化路由決策並強制遵循HyperFrames框架約定,大幅提升複雜影片專案的自動化程度與一致性。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlessandroFare/fluxychat/tree/HEAD/agent/skills/hyperframes

在你喜歡的 AI 中提問

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

說明文件

HyperFrames 進入點

HyperFrames 從HTML渲染影片 — 一個合成就是一個HTML檔案,其DOM透過data-*屬性宣告時間軸,其動畫執行時期是可搜尋的,且其媒體播放由框架所擁有。完整的創作合約位於/hyperframes-core;在撰寫合成HTML之前,請先閱讀該文件。

1. 從專案狀態開始

套用第一個符合的列;不要評估較低的狀態列:

狀態動作
明確地將現有Remotion原始碼移植到HyperFrames閱讀 references/routes/remotion-to-hyperframes.md,然後直接路由到該工作流程。跳過意圖層。
對現有HyperFrames專案執行特定操作:檢查、診斷、驗證、預覽、渲染、發佈或批次渲染僅執行該操作。跳過意圖和工作流程路由;載入 /hyperframes-cli 和任何必要的領域技能。
對現有專案進行特定編輯進行編輯。不要執行意圖層。
BRIEF.md 存在讀取 workflow 和 flow。執行該工作流程;flow: companion 始終在 /general-video 中執行。不要詢問任何簡報問題。
沒有簡報,但 hyperframes.json 或 STORYBOARD.md 存在從專案檔案和記錄的偏好設定中恢復。從現有工件推斷所屬的工作流程。如果無法唯一確定,則只問一個路由相關問題;不要執行意圖訪談。
全新創作執行意圖層 — references/intent-interview.md — 然後使用§ 2的表格路由一次。

如果一個全新的請求沒有指明主題或輸入,請在路由之前詢問影片的內容。在詢問任何問題之前,請先檢查偏好設定和配方(references/intent-interview.md,步驟1)。figma.com輸入或命名配方會改變接收方式,而非路由 — 訪談中的「調整正交輸入」部分會處理這兩種情況。

保持專案的CLI最新

一個已建立的專案會在其 package.json 腳本中固定 hyperframes@<version>,以確保渲染結果可重現;此固定版本絕不會自動更新,且在固定版本上執行較舊的CLI也不會印出任何警告。當恢復一個腳本攜帶固定版本的專案時,在第一次影響渲染的命令之前進行一次探測:

npx hyperframes@latest upgrade --project . --check

此探測是唯讀的,並將固定版本與最新版本進行比較;請保留顯式的 . — 在較舊的CLI版本中,單獨的 --project 後接另一個標誌會將該標誌作為其目錄值使用。當它報告專案落後時 — 或任何CLI輸出已經顯示這個情況(固定版本的腳本在 stderr 中顯示 This project pins hyperframes@… (latest …) 通知,或在 --json 結果中顯示 _meta.updateAvailable: true) — 則使用 npx hyperframes@latest upgrade --project . 來套用更新,然後使用 npx hyperframes check 進行驗證。檢查通過確認專案的合成在新版本上仍然有效 — 而非渲染輸出與舊的固定版本影格相同 — 因此成功的版本提升絕非無聲無息:請在執行的摘要中說明舊版本和新版本。尚未有任何合成的專案則無需驗證。如果檢查失敗,請還原 package.json 的變更,繼續使用固定的版本,並報告專案停留在哪個版本以及原因。根據信號採取行動,而非將其轉達給使用者;永遠不要讓未經驗證的提升後的固定版本保留下來。

2. 路由全新創作

使用第一個符合的列。比對的是請求的交付物,而不是隨口提到的單字或檔案類型。

優先順序請求工作流程
1明確地移植現有的Remotion原始碼/remotion-to-hyperframes
2創作簡報、提案簡報或可導航的互動式簡報/slideshow
3為現有的頭部說話素材添加純字幕或翻譯,而不變更素材本身/embedded-captions
4為現有的頭部說話、訪談或Podcast素材添加設計好的圖形疊加層,而不變更素材本身/talking-head-recut
5從音樂曲目建立一個與節拍同步的影片,無旁白或網站捕捉/music-to-video
6建立一個明確簡短、無旁白、以動作為先的單元,通常少於10秒/motion-graphics
7從PR引用解釋GitHub Pull Request或程式碼變更/pr-to-video
8從URL或特定網站的簡報推廣或展示網站、產品頁面、應用程式或公司/product-launch-video
9使用自創視覺效果且無產品或網站捕捉來解釋主題、文章或筆記/faceless-explainer
10任何其他自訂影片或合成/general-video

在最終確定路由之前,請閱讀 references/routes/<workflow>.md — 每個路由一個小檔案:規範的輸入/輸出/觸發合約(可在延遲安裝的工作流程技能之前取得)加上該路由的訪談條目。如果候選路由不符合其合約,則繼續路由,而不是強迫匹配。僅讀取匹配到的路由的檔案。

解決常見歧義

  • 一個簡短的動畫標題、Logo sting、統計數據命中、圖表命中、地圖命中或獨立的lower-third,如果是無旁白且動作為主的,則屬於 /motion-graphics。靜態標題卡、有旁白的序列、較長的蒙太奇或自訂循環則屬於 /general-video。
  • 一個明確簡短的動態圖形可以使用URL、推文、文章或螢幕截圖作為素材來源。一個通用的「從這個網站製作影片」的請求屬於 /product-launch-video。
  • 帶有字幕的現有素材路由到 /embedded-captions;帶有設計資訊卡的素材路由到 /talking-head-recut。重新調整時間軸、重新排序、重新著色、重新構圖或重新混音素材屬於自訂編輯,並會落入 /general-video。
  • 僅當拍點網格驅動該作品時,音樂檔案才會選擇 /music-to-video。用作背景音樂的音樂不會覆蓋與主題匹配的路由。
  • 「我想要一個故事板」會改變審查流程,而非工作流程。如果沒有其他路由信號,請使用 /general-video。一個已確認的草圖板本身可能就是所請求的交付物;審查循環會定義那個停止點。
  • 專門的敘事工作流程最多支援約3分鐘,並在30–90秒左右效果最佳。明顯更長的作品請路由到 /general-video。長度絕不會覆蓋明確的移植、簡報、字幕、疊加層或音樂驅動的交付物。

3. 路由一次,然後離開

對於全新創作,意圖層(references/intent-interview.md)會執行完整的對話 — 記憶、分類、提案回合、必要條件、運行形狀、交接 — 並以寫入 BRIEF.md 結束。簡報是工作流程讀取的唯一路由工件;之後的任何內容都不會重新開啟此技能或訪談。從 BRIEF.md 回答之後每個「路由要求了什麼?」的問題。

4. 安裝並進入工作流程

在閱讀所選的工作流程之前,請安裝或重新整理它以及核心領域技能:

npx hyperframes skills update <workflow-name>

使用不帶 / 的裸名稱。如果命令失敗,請顯示錯誤;不要從記憶重建工作流程。關於安裝的其他所有事項 — 核心與延遲載入的區分、init 重新整理的內容、診斷、CI選擇退出,以及無CLI的後備方案 — 都記錄在 references/skill-lifecycle.md 中。

5. 按需載入領域技能

需求技能
合成結構、時間屬性、軌道、變數、確定性/hyperframes-core
動畫規則、場景藍圖、轉場、執行時期適配器/hyperframes-animation
可搜尋安全的GSAP、CSS、Anime.js、WAAPI、FLIP、路徑、遮罩、SVG、3D關鍵影格,或 hyperframes keyframes 診斷/hyperframes-keyframes
設計規格、概念、調色盤、字體排印學、旁白、拍點規劃/hyperframes-creative
圖片、圖示、標誌、音訊、字幕、色調、LUT、可重複使用的媒體/media-use
旁白剪輯、音效鏈,或軌道上的自動化封套/hyperframes-audio
初始化、lint、檢查、快照、比較、批次渲染、Studio、渲染、發佈或診斷/hyperframes-cli
註冊表區塊和元件/hyperframes-registry
Figma資產、token、元件或故事板影格作為重構的動態/figma

關於照片式媒體外觀或行為的廣泛回饋也會路由到 /media-use,即使使用者從未說出「色彩校正」或「效果」:修正 暗/平淡/無趣的素材、為片段增添風格、隱藏臉部,或改善媒體 揭示。在編輯處理方式之前,請閱讀 ../media-use/references/media-treatments.md;它管理素材如何被處理,絕不涉及媒體是否可以使用。 不要用通用的 LUT、CSS 濾鏡/疊加層或不透明補間來替代 現有的規範處理原始物件。將純文字/版面/動畫編輯保留在它們所屬的領域中。 在包含重要照片式媒體的建置過程中,請在最終品質檢查中包含一次基於實際情況的媒體潤飾掃描;將合適的媒體保持不變是一個有效的結果。

領域技能絕不會接管端到端交付物的所有權。僅載入當前工作流程所需的技能。

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

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

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

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.

相關技能