Communitygithub.com

samyakiasonline-ctrl/hyperframe

用於HyperFrames合成需要推入、推拉、縮放、重新構圖、Ken Burns效果、鏡頭移動、視覺匹配/銜接拋接,或其他可搜尋安全的2D/3D關鍵幀;也用於GSAP、CSS關鍵幀、Anime.js、WAAPI、FLIP、路徑、遮罩、SVG形變/繪製、文字拖尾、3D景深或`hyperframes keyframes`診斷。不適用於廣泛場景策略、品牌設計、素材搜尋、字幕或一般影片規劃。

hyperframe 是什麼?

這個技能,`samyakiasonline-ctrl/hyperframe`,是HyperFrames系統中用於精確製作視覺動畫和關鍵幀的核心工具。它專注於處理可搜尋安全的2D和3D關鍵幀,實現推拉鏡頭、縮放、Ken Burns效果、視覺匹配銜接等複雜鏡頭動作。技能支援多種動畫引擎,包括GSAP、CSS關鍵幀、Anime.js和WAAPI,並涵蓋路徑動畫、遮罩、SVG形變、文字動畫和3D景深等進階技術。它與HyperFrames的其他組件(如`hyperframes-core`和`hyperframes-animation`)協作,明確將視覺動畫與時間線剪輯分離,確保動畫的可預測性和可重複性。通過提供詳細的執行規則、程式碼範本和CLI診斷工具,這個技能幫助開發者創建可靠、高品質的動畫效果,適用於Web開發、影片製作和互動設計等領域。

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

在你喜歡的 AI 中提問

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

說明文件

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

HyperFrames 關鍵幀

關鍵幀是一種姿態合約:可見狀態、連續主體身份、可搜尋安全的執行時間、經過驗證的像素。

使用 hyperframes-animation 處理廣泛場景腳本。使用 hyperframes-cli 查閱完整命令文檔。僅在選擇實作機制(而非視覺風格)時,才使用 references/keyframe-patterns.md。

創作者編輯邊界

關鍵幀掌管視覺動畫,而非片段組裝。來源範圍的硬切、修剪、拼接和重新排序屬於 /hyperframes-core:為每個保留的範圍創作一個媒體元素,使用 data-start 和 data-duration 放置它,並使用 data-media-start 選擇其來源偏移量。相鄰範圍形成硬切。交叉淡入淡出則在不同軌道上使用重疊片段,加上視覺不透明度關鍵幀;音訊淡入淡出則使用 /hyperframes-audio。

創作者要求真實機制
推入 / 推拉在片段內部的非計時視覺/裁切包裝器上,對 scale 加上 x/y 或百分比平移進行關鍵幀設定。使用 set/short tween 實現硬推入,使用 tween 實現平滑移動。
平滑多狀態縮放或重新構圖保持一個主體包裝器存活,並將多個縮放/重新構圖狀態編寫為一個姿態階梯,每個區段有其自身的緩動。
平移、重新構圖或 Ken Burns 鏡頭移動對包裝器平移加上縮放進行動畫。幾何形狀是明確創作的;這不是臉部追蹤或自動語義重新構圖。
連鎖鏡頭移動在一個已註冊的可搜尋安全時間軸上,串聯標記的變換節拍。
匹配剪輯或甩鏡/hyperframes-animation 掌管視覺交接;/hyperframes-registry 提供基本元素;關鍵幀保留創作的幾何形狀、方向和速度。沒有自動匹配幀發現。
裁切與遮罩重新構圖在內部視覺包裝器上對 clip-path 或遮罩進行插值,以進行裁切/重新構圖,而不改變來源時間。多邊形關鍵幀可以形成多邊形/遮罩過渡。
定向擦拭剪輯或光圈/揭示剪輯在重疊的視覺片段之間對遮罩/裁切邊界進行動畫設定;/hyperframes-animation 掌管交接編排。
分割畫面交接將兩個視覺片段保持在核心放置的位置,然後對其內部裁切/遮罩包裝器和分隔線幾何形狀進行關鍵幀設定。
恆定來源速度重映射/hyperframes-core 掌管標準化的 data-playback-rate(0.1..10),以實現渲染安全的畫面和音調保持的聲音。對整個媒體元素而言是恆定的。
來源速度坡道在 <video>/<audio> 的 data-automation 中使用 rate 通道(t 為片段秒數,v 為 0.1..10,對數插值);它會覆蓋恆定速率。
凍結 / 保持視覺姿態、最終來源幀或完成的子合成可以保持。不支援任意中間來源凍結;先預處理一個靜止/衍生的區段,將其作為自己的片段放置,然後使用另一個來源範圍繼續。

同時編輯圖像和聲音時,載入 /hyperframes-core、此技能用於視覺動畫,以及 /hyperframes-audio 用於淡入淡出、交叉淡入淡出、音量自動化、閃避/雕刻或對已放置軌道施加效果。

視覺過渡或裁切處理並非時間性的來源修剪或拼接。/hyperframes-core 掌管時間線、片段時間和來源範圍;關鍵幀僅對這些片段內部的包裝器進行可見的交接或裁切動畫。對於可複製的圖像/聲音組合腳本,請使用 /hyperframes-core → references/creator-editing-recipes.md。

步驟

  1. 識別動畫主體、可見狀態、最終狀態和執行時間。
  2. 選擇能證明提示意圖的最小機制。僅在機制不明確時閱讀 references/keyframe-patterns.md。
  3. 在宣告的執行時間內創作可搜尋安全的關鍵幀。僅在建置完成後註冊執行時間實例;在 document.fonts.ready 內部進行建置是可以的。
  4. 使用 hyperframes check(執行 lint)、hyperframes keyframes、一個專注的 --shot 以及在證明時間點的快照進行驗證。
  5. 如果證明失敗,修正來源關鍵幀,並在渲染前重新執行最小的失敗診斷。

合約

  • 為移動的主體命名。
  • 列出證明預期動作所需的姿態,包括最終狀態。
  • 對可見通道進行關鍵幀設定,而非隱藏的輔助狀態。
  • 當連續性重要時,保持物件身份。
  • 僅當預期動作是取代或溶解時,才使用交叉淡入淡出。
  • 將可讀或語義狀態保持足夠長的時間以便觀察。
  • 最終幀是動畫的一部分,並非清理動作。
  • 除非要求,否則不要重置到靜止狀態。
  • 除非要求,否則不要以黑色結束。
  • 如果編輯起始場景,除非要求重新設計,否則保留佈局、文案、資源、顏色和最終狀態。

執行時間規則

GSAP:

  • 在頁面載入時或 document.fonts.ready 內部進行建置,且僅在建置完成後註冊
  • 使用 gsap.timeline({ paused: true })
  • 註冊為 window.__timelines[compositionId]
  • 註冊鍵必須匹配 data-composition-id
  • 對於渲染關鍵的動作,不要呼叫 tl.play()
  • 保持重複次數為有限值

CSS 關鍵幀:

  • 有限的持續時間和迭代次數
  • 確定性的延遲
  • animation-fill-mode: both
  • 當時間屬於某個片段時,使用 data-start

Anime.js:

  • 同步創建
  • autoplay: false
  • 有限的持續時間和循環次數
  • 將每個實例推入 window.__hfAnime

WAAPI:

  • 有限的 duration
  • fill: "both"
  • 確定性的構建
  • 文字表面不列出 WAAPI;使用 --shot(它會搜尋 WAAPI)和快照進行驗證

絕不用於渲染關鍵的動作:

  • Date.now()
  • performance.now()
  • 未設定種子的 Math.random()
  • 懸停/滾動觸發器
  • 計時器
  • 在其非同步建置完成之前註冊的時間軸
  • 未註冊的 requestAnimationFrame
  • 無限循環

GSAP 骨架

const root = document.querySelector("[data-composition-id]");
const compositionId = root.dataset.compositionId;
const tl = gsap.timeline({ paused: true });

tl.addLabel("state-a", 0);
tl.to(".subject", {
  keyframes: [
    { x: 0, opacity: 1, duration: 0.2 },
    { x: 120, opacity: 1, duration: 0.4, ease: "power2.out" },
    { x: 100, opacity: 1, duration: 0.2, ease: "power2.inOut" },
  ],
  ease: "none",
});

window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;

使用標籤來表示語義狀態。使用位置參數而非鏈式延遲。對於稍後觸及相同屬性的 from()/fromTo() tween,使用 immediateRender: false。

關鍵幀形式

  • 陣列關鍵幀:帶有每步持續時間/緩動的姿態階梯。
  • 百分比關鍵幀:單個 tween 內部的精確時間。
  • 屬性陣列:緊湊的多停止點變化。
  • 當每個停止點帶有其自身的緩動時,在父級上使用 ease: "none"。
  • 當每個區段應共享相同感覺時使用 easeEach。

不要從範例中複製數值距離或時間。從實際合成的幾何形狀和持續時間中推導它們。

對於在兩個方塊之間移動的單一主體,偏好一個連續的變換 tween 或 FLIP。僅當觀眾應該感受到不同節拍時,才將 x/y/scale 分割成多個帶緩動的關鍵幀;每個區段都會改變速度,可能被解讀為卡頓。

通道

偏好合成器/視覺通道:x/y/z、xPercent/yPercent、scale、rotationX/Y/Z、skew、transformOrigin、svgOrigin、opacity、autoAlpha、clip-path、遮罩、CSS 變數、SVG 路徑/虛線值、攝影機變換、著色器 Uniform。

避免佈局/生命週期通道:top/left/right/bottom、width/height、margin/padding、display、visibility、晚期的 DOM 創建、執行主體動作的輔助覆蓋層。

對於可見度變化,在已註冊的可搜尋 GSAP 時間軸上使用 autoAlpha,或在明確邊界處使用零持續時間的 tl.set()。僅針對非裁切元素或片段內部的包裝器;絕不要針對 .clip 本身。絕不要對原始 visibility 進行持續時間 tween,也絕不要對 display 進行 tween。

機制選擇

選擇能證明提示意圖的最小機制:

需求機制
相同主體改變方塊或層級共享元素 / FLIP
主體沿可視路線移動路徑旅行
筆畫增長或描繪筆畫繪製
形狀變成另一個形狀形狀插值
揭示邊界是可見的clip、遮罩或著色器 uniform
許多具有順序的項目移動交錯 / 索引延遲
文字本身移動行、單詞、字元或帶狀細分
表面彎曲、拉伸或裁切父/子反向變換
UI 具有狀態明確狀態機
場景具有深度DOM 3D、Three.js 或 WebGL 攝影機/物件關鍵幀

機制可以組合,但每個都必須釐清想法。裝飾不是證明。

時間

  • 僅在它能釐清原因或方向時使用預期動作。
  • 加速離開靜止。
  • 峰值證明應無誤地展示機制。
  • 跟隨動作體現能量和方向。
  • 僅在主體感覺有彈性或觸感時使用過衝。
  • 恆速路徑旅行通常需要 ease: "none"。
  • 離散的 UI 狀態通常需要銳利的 ease-out。
  • 重複元素需要有序偏移,而非相同時間。
  • 最終鎖定需要比過渡姿態更長的保持。
  • 平滑意味著同一主體上的連續速度。
  • 不要重疊寫入相同變換屬性的 tween,除非重疊是有意且經過驗證的。
  • 避免在同一個英雄表面也在縮放或移動時,對大範圍的 clip-path/遮罩變化進行動畫;在主移動穩定後使用嵌套揭示。

文字

保持行框、字間距、可讀性和最終佈局。如果文字內部移動,移動字形或遮罩帶狀區塊,而不僅僅是文字周圍的裝飾。對可讀的幀進行快照。

SVG

對於筆畫增長,偏好 DrawSVGPlugin,然後是 stroke-dasharray/stroke-dashoffset。對於形狀插值,偏好 MorphSVGPlugin;必要時將基本形狀轉換為路徑,並將複雜輪廓分割成較簡單的部分。

3D

單純的縮放是虛假的景深。在穩定的父級上使用 perspective、transform-style: preserve-3d、z 軸移動、旋轉、攝影機/世界運動、遮擋以及物件交叉時的圖層順序。

使用一個或兩個能揭露深度關係的診斷角度。如果角度證明未顯示深度交叉,改進 z/攝影機/遮擋。

Canvas / WebGL

透過確定性狀態對攝影機位置、攝影機目標、物件變換、材質不透明度、著色器 Uniform 和後處理強度進行關鍵幀設定。從 HyperFrames 時間渲染。使用 --ghost,因為標記方塊無法看到內部 Canvas 運動。

CLI 證明

npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<file>" --ghost --angle <angle>
npx hyperframes snapshot . --at <times>

為真正的動畫主體選擇 <selector>。為第一幀、證明姿態、最終減去保持以及精確最終時刻選擇 <times>。僅在必須證明景深時選擇 <angle>。

工具證明
keyframes目標、明確停止點、路徑、軌跡、組合的父/子運動、CSS 停止點、Anime 註冊
--shot鬼影、路徑形狀、時間間隔、DOM 3D 投影、專注的選擇器證明
--layout strip原地運動、重疊、接觸、微妙的縮放/不透明度、文字波浪
--ghostcanvas、WebGL、著色器運動、渲染的 3D
snapshot --at遮罩

…

[因翻譯而被截斷]

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

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.

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

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.

相關技能