Communitygithub.com

HyperFrames 入口點

對於任何影片、動畫或動態圖形創建、編輯、渲染請求,都必須先閱讀此文件。它會恢復專案狀態、捕獲意圖、選擇並安裝工作流程,以及路由領域能力。

HyperFrames 入口點 是什麼?

HyperFrames 是一個將影片從 HTML 渲染出來的框架。此技能(名為 hyperframe 的入口點)是所有影片創建、編輯和渲染請求的強制性起點。它能根據請求類型(例如:新的創作、現有專案的編輯、從 Remotion 移植)自動恢復專案狀態、捕獲使用者意圖,並路由到正確的工作流程(例如:幻燈片、音樂轉影片、無臉解說等)。它支援多種輸入,包括網站 URL、GitHub PR、Figma 設計、純文字或簡報,以及現有的素材或音樂。此技能的核心職責是確保在執行任何特定領域技能(如 hyperframes-core、hyperframes-animation)之前,檢查使用配額、保持專案 CLI 最新,並根據明確的規則表解決常見的歧義。它最終會產生一個 BRIEF.md 文件,作為後續工作流程的唯一路由工件。

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

在你喜歡的 AI 中提問

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

說明文件

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

HyperFrames 入口點 是做什麼的?

檢查剩餘使用量

在開始創作時,執行 npx hyperframes usage --json。在工作流程的里程碑處再次檢查,例如在草稿完成後、渲染之前,因為使用量在運行期間會發生變化。閱讀可用的時間窗口及其重置時間;之前的讀取並不會保留配額。如果命令失敗、不可用或返回 status: unknown,請報告使用量未知,並且不要猜測。保持範圍和工作流程選擇與使用者溝通。

HyperFrames 從 HTML 渲染影片 — 一個合成就是一個 HTML 檔案,其 DOM 使用 data-* 屬性宣告時間,其動畫執行時是可以搜尋的,並且其媒體播放由框架擁有。完整的創作合約位於 /hyperframes-core;在編寫合成 HTML 之前請先閱讀它。簡報、分鏡腳本、審查、製作、排程和影格工作者合約位於此技能的 references/ 中。

1. 從專案狀態開始

應用第一個匹配的行;不要評估較低狀態的行:

狀態動作
將現有 Remotion 原始碼明確移植到 HyperFrames閱讀 references/routes/remotion-to-hyperframes.md,然後直接路由到該工作流程。跳過意圖層。
對現有 HyperFrames 專案的特定操作:檢查、診斷、驗證、預覽、渲染、發佈或批次渲染僅執行該操作。跳過意圖和工作流程路由;載入 /hyperframes-cli 和任何所需的領域技能。
對現有專案中的已建構影片提出問題、暫停、沒有具體變更的想法或感覺筆記遵循 /hyperframes-studio § 0。
在現有專案中要求一個新的影片遵循 /hyperframes-studio § 5。
對現有專案進行特定編輯進行編輯。不要執行意圖層。要了解專案時間軸上的內容(軌道、片段、開始、結束、播放內容),請執行 npx hyperframes timeline [--json],而不是讀取 index.html 和每個子合成檔案。
存在 BRIEF.md讀取 workflow 和 flow。執行該工作流程;flow: companion 始終在 /general-video 中執行。不要問任何簡報問題。
沒有簡報,但存在 hyperframes.json 或 STORYBOARD.md從專案檔案和記錄的偏好設定恢復。從現有工件推斷擁有的工作流程。如果無法唯一確定,問一個僅用於路由的問題;不要執行意圖面試。
全新創作執行意圖層 — references/intent-interview.md — 然後使用 § 2 的表格路由一次。

當你編輯現有專案時,請將你的編輯與專案歷史記錄(/hyperframes-cli,在你回合中的 Project history)括起來。

如果一個新的請求沒有指明主題或輸入,請在路由之前詢問影片的內容。在詢問任何問題之前,先檢查偏好設定和配方(references/intent-interview.md,步驟 1)。一個 figma.com 輸入或命名的配方會改變攝取方式,而不是路由 — 面試的「適應正交輸入」部分處理這兩者。

保持專案的 CLI 為最新

一個已建立基礎的專案會在其 package.json 腳本中固定 hyperframes@<version>,以便渲染保持可重複性;該固定版本永遠不會自行更新,並且執行舊版 CLI 的固定版本時不會列印任何警告。當恢復一個腳本帶有固定版本的專案時,請在第一次影響渲染的命令之前探查一次:

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

該探查是唯讀的,並報告固定版本與最新版本的比較;請保留明確的 . — 在舊版 CLI 上,裸的 --project 後面跟著另一個標誌會將該標誌作為其目錄值。當它報告專案落後時 — 或者任何 CLI 輸出已經顯示(在固定版本腳本的 --json 結果中,stderr 通知 This project pins hyperframes@… (latest …) 或 _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為現有的人頭說話、訪談或播客素材添加設計的圖形疊加層,而不改變素材/talking-head-recut
5根據音樂曲目構建節拍同步的影片,沒有旁白或網站捕獲/music-to-video
6創建一個明確簡短、無旁白、以動作為主的單元,通常少於 10 秒/motion-graphics
7從 PR 參考解釋 GitHub 拉取請求或程式碼更改/pr-to-video
8從 URL 或特定網站的簡報行銷或展示一個網站、產品網站、應用程式或公司/product-launch-video
9用發明的視覺效果解釋一個主題、文章或筆記,沒有產品或網站捕獲/faceless-explainer
10任何其他自訂影片或合成/general-video

在最終確定路由之前,請閱讀 references/routes/<workflow>.md — 每個路由一個小檔案:規範的輸入/輸出/觸發合約(在懶加載的工作流程技能可用之前)加上該路由的面試條目。如果候選路由不滿足其合約,請繼續路由而不是強制匹配。僅讀取匹配路由的檔案。

解決常見的歧義

  • 一個簡短的動畫標題、標誌閃現、統計數據命中、圖表命中、地圖命中或獨立的下三分之一,當它沒有旁白且動畫是訊息本身時,是 /motion-graphics。靜態標題卡、有旁白的序列、較長的蒙太奇或自訂循環是 /general-video。
  • 一個明確簡短的動態圖形可能使用 URL、推文、文章或螢幕截圖作為素材。一個通用的「從這個網站製作一個影片」請求是 /product-launch-video。
  • 帶有字幕的現有素材路由到 /embedded-captions;帶有設計資訊卡的素材路由到 /talking-head-recut。重新計時、重新排序、重新著色、重新構圖或重新混合素材是自訂編輯,會落入 /general-video。
  • 一個音樂檔案只有在它的節奏網格驅動作品時才選擇 /music-to-video。用作背景音樂的音樂不會覆蓋由主題匹配的路由。
  • 「我想要一個分鏡腳本」改變的是審查過程,而不是工作流程。如果沒有其他路由信號,使用 /general-video。一個已確認的草圖 storyboard.html 本身可能就是請求的交付物;審查循環定義了那個停止點。
  • 專業的敘事工作流程支持最多約 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
一個命名的外觀、效果、處理或轉場 — CRT 掃描線、故障、膠片顆粒、閃爍掃描、五彩紙屑爆發 — 在手工構建它之前/hyperframes-registry
Figma 資源、令牌、元件或作為重建動作的分鏡腳本影格/figma

創作者編輯短語是跨領域請求。載入匹配行中命名的每個技能:

創作者請求所需領域

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

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

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.

相關技能