Communitygithub.com

samyakiasonline-ctrl/hyperframe

HyperFrames 的所有動畫知識 — 包含原子動作規則、多階段場景藍圖、場景轉場、更廣泛的動態設計技術,以及七個運行時配接器(預設 GSAP,外加 Lottie、Three.js、Anime.js、CSS 關鍵影格、Web Animations API、TypeGPU)。適用於任何動態或動畫任務:選取 2-4 條規則組合、載入藍圖,或查閱特定執行時的 API(例如 GSAP 緩動 / Lottie 播放器 / Three.js 混合器)。也涵蓋審查現有構圖的編舞(動畫映射)與 24 種指定文字動畫效果。HyperFrames 原生:單一暫停時間軸、可安全搜尋、確定性。

hyperframe 是什麼?

此技能將所有 HyperFrames 動畫知識濃縮於一個套件中,協助開發者與 AI 代理者處理任何動態或動畫任務。其核心是原子動作規則(可組合 2-4 條規則,快速產出程式碼)與多階段場景藍圖(適合品牌揭露、社交證明等複雜編排)。技能提供詳盡的路由表,涵蓋 GSAP、Lottie、Three.js、Anime.js、CSS 關鍵影格、Web Animations API 及 TypeGPU 等七種運行時配接器的 API 與最佳實務,並支援將 HTML 渲染為紋理以供 WebGL 後製。同時包含審查現有構圖動畫映射的腳本、24 種指定文字動畫效果,以及空間運動僅使用 GSAP 變換別名、預先計算佈局常數等關鍵限制。此技能設計用於 Claude Code、Cursor 或 Codex 等 AI 代理工具,確保動畫的確定性與可搜尋性。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samyakiasonline-ctrl/hyperframe/tree/HEAD/.claude/skills/hyperframes-animation

在你喜歡的 AI 中提問

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

說明文件

外掛安裝: 在執行設定或更新命令之前,若此技能位於 HyperFrames 外掛內部,請遵循外掛執行規則。獨立安裝則保留下方的更新說明。

HyperFrames 動畫

所有動態知識集中於一個技能:規則(原子配方)、藍圖(多階段場景範本)、轉場(場景到場景)、技巧(更廣泛的動態設計模式)與配接器(各運行時 API)。

關於構圖合約(資料屬性、子構圖、確定性),請參閱 hyperframes-core。

預設:組合原子規則

從 rules-index.md 中選取 2-4 條規則,用一個暫停的 GSAP 時間軸將它們組合在一起,即可完成。這比從藍圖開始更快,且產生的程式碼更少。

在以下情況載入藍圖

  • 場景符合現有的預設計多階段範本(品牌揭露、社交證明等),且重複使用其階段管線可節省實際創作時間
  • 你需要一個可執行的真實程式碼,用於複雜的 4-5 階段編舞

藍圖位於 blueprints-index.md。每個條目指向 blueprints/<id>.md(配方)。請勿投機地讀取它;僅在你已確定需要場景層級編排時才載入。

路由

想要…閱讀
根據觸發器/標籤選取原子動畫模式rules-index.md
讀取一條規則的完整 HTML / CSS / GSAP 配方rules/<name>.md
選取多階段場景範本blueprints-index.md
讀取一個藍圖的完整配方blueprints/<id>.md
創作場景轉場(由 CSS 驅動,在兩個片段之間)transitions/overview.md、transitions/catalog.md
查閱更廣泛的動態設計技巧techniques.md
運動模糊 — 在元素上快門殘影,以及何時不應使用它references/motion-blur.md
分析現有構圖的動畫映射scripts/animation-map.mjs
GSAP API — 時間軸 / 補間 / 位置參數adapters/gsap.md
GSAP — 即插即用的效果配方rules/gsap-effects.md
GSAP — 變換 / 性能adapters/gsap-transforms-and-perf.md
GSAP — 緩動 / 交錯adapters/gsap-easing-and-stagger.md
GSAP — 時間軸 / 標籤adapters/gsap-timeline-and-labels.md
Lottie / dotLottie(After Effects 匯出,window.__hfLottie)adapters/lottie.md
角色動畫(行走循環、吉祥物、關節木偶、手勢)adapters/lottie.md → 角色
Three.js / WebGL(3D 場景、AnimationMixer、hf-seek)adapters/three.md
Anime.js(window.__hfAnime)adapters/animejs.md
CSS 關鍵影格(animation-delay / play-state / fill-mode)adapters/css-animations.md
Web Animations API(element.animate()、currentTime 搜尋)adapters/waapi.md
TypeGPU / WebGPU(navigator.gpu、WGSL、計算管線)adapters/typegpu.md
HTML 作為紋理 + WebGL/GLSL 後製效果(透過 drawElementImage 捕獲即時 DOM)adapters/html-in-canvas-patterns.md
指定文字動畫效果(24 個 ID,透過外部 animate-text 技能)adapters/animate-text.md

選擇運行時

  • GSAP 是 95% 動態工作的預設選項 — 涵蓋時間軸編排、變換、緩動、交錯。此技能中的所有原子規則皆基於 GSAP。
  • Lottie 當素材具有自己的預先烘焙時間軸(通常為 After Effects 匯出),包括行走、做手勢或反應的角色。
  • Three.js 用於 3D 場景、攝影機運動、著色器驅動的視覺效果。
  • Anime.js 用於輕量級補間,當 GSAP 過於繁重時。
  • CSS 用於簡單的重複圖案、裝飾、閃爍效果 — 無需 JavaScript 動畫開銷。
  • WAAPI 用於原生瀏覽器關鍵影格,不依賴 GSAP。
  • TypeGPU / WebGPU 用於 GPU 渲染的畫布(粒子、液體玻璃、自訂著色器)。

多個運行時可以在一個構圖中並存。每個運行時將其實例註冊在運行時特定的全域物件上,以便 HyperFrames 可以在一次傳遞中搜尋所有實例。

關鍵限制

先決條件:hyperframes-core → 一個暫停的時間軸 + 不可協商的規則(單一暫停時間軸,data-duration 決定長度,不使用 Math.random / Date.now / performance.now,沒有無限 repeat: -1 而未設定有限根 data-duration,沒有在頁面載入時對後續場景片段執行 gsap.set,沒有 display 或原始 visibility 補間,並且僅在時間軸完全建立後才註冊,包括當建置在非同步回呼(例如 document.fonts.ready)內執行時)。核心仍允許在明確的時間軸邊界使用 GSAP autoAlpha 和零持續時間的可見性設定。僅在非片段元素或片段內的包裝器上使用這些例外;框架擁有 .clip 生命週期。請勿在此重申完整合約。

在核心合約基礎上的動畫創作附加規則:

  • 預先計算的版面常數 — 永遠不要在補間時透過 getBoundingClientRect() 推導位置。補間時的 DOM 測量會因渲染器並行取樣而導致不同步;在構圖設定時計算一次座標並重複使用。
  • 空間運動僅使用 GSAP 變換別名(x、y、scale、rotation)。核心的白名單也允許對非空間屬性補間使用 opacity / color / backgroundColor / borderRadius — 但絕不能使用 width / height / top / left 進行版面變更。

腳本

node <SKILL_DIR>/scripts/animation-map.mjs <composition-dir> \
  --out <composition-dir>/.hyperframes/anim-map

讀取所有在 window.__timelines 上註冊的 GSAP 時間軸,列舉補間、取樣邊界框、計算旗標,輸出 animation-map.json。在創作後用它來審查編舞(空白區域、交錯一致性、生命週期警告)。

animation-map.mjs 首先從目前專案解析輔助套件,然後可以引導捆綁的 HyperFrames 套件版本。僅在 CLI/技能安裝外部執行此技能,且需要明確固定引導版本時,才設定 HYPERFRAMES_SKILL_PKG_VERSION=<版本>。

另請參閱

  • hyperframes-core — 構圖結構、資料屬性、子構圖、確定性渲染合約
  • hyperframes-creative — 調色盤、排版、敘事、節拍規劃(非動畫創意指導)
  • hyperframes-cli — npx hyperframes lint / check / snapshot / preview / render

Individual skills in this repo

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). 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`.

samyakiasonline-ctrl/hyperframe

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, timeline, history, clean, 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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, 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.

samyakiasonline-ctrl/hyperframe

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also 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).

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

samyakiasonline-ctrl/hyperframe

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

相關技能