Communitygithub.com

samyakiasonline-ctrl/hyperframe

用於在 Studio 中與他人協作 HyperFrames 專案:判斷訊息是否要求變更、規劃新影片、正確安排時間軸,並遵循 HyperFrames 慣例。

hyperframe 是什麼?

這是一個針對 HyperFrames Studio 協作流程的 AI 技能。它的核心功能是幫助 AI 代理(如 Claude Code)正確解讀人類訊息:區分「要求修改」、「提問」、「單純討論」或「請求新影片」,並據此決定是否編輯專案檔案。技能詳細定義了 Studio 的時間軸慣例——每個場景必須是子合成、字幕集中在一條軌道、每種元素類型一條軌道——以確保時間軸簡潔可編輯。此外,它涵蓋了安全區域(動作安全框 90%、標題安全框 80%)的應用規則,以及從 Brief、方向、分鏡到建置的完整流程,特別針對產品發布影片的實拍畫面、游標與滾動內容、以及最終片尾的處理方式。此技能支援 HyperFrames 生態系,並與 `/hyperframes-core`、`/hyperframes-creative` 等參考文件協同工作。

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

在你喜歡的 AI 中提問

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

說明文件

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

HyperFrames Studio 慣例

Studio 會為每個頂層元素繪製一條時間軸軌道。遵循下列規則的專案會以簡短、可讀的時間軸開啟;不遵循的專案則會以一堆無法編輯的未標籤軌道開啟。以下是關於建置內容的慣例。關於如何修改剪輯,請遵循 /hyperframes-core 的 references/creator-editing-recipes.md,切勿自行發明不同的編輯方式。

0. 先討論再建置

在開啟檔案之前,先閱讀訊息。判斷對方要求什麼:

對方你
指名了某項變更,無論語氣多客氣(例如「把標題放大」、「可以剪掉第三幕嗎?」)直接執行。
對已建置的影片提供感受性意見(例如「開頭感覺很卡」、「長度似乎不夠」)找出原因,改變可測量的部分,說明該意見的含義以及你做了什麼調整,並按照 /hyperframes-creative 的 references/storyboard-recipe.md 第 4 節記錄。
提出問題但未指名任何變更(例如「為什麼標題會跳動?」)回答問題。不修改任何東西。
說不要修改任何東西、先暫停、「只是在想」、「我們討論一下」不修改任何檔案,即使是你注意到的錯誤也不要改。用語言提出建議。
針對這部影片提出一個想法但無具體變更(例如「我希望結局更有氣勢」)提出變更方案並將其加入計畫(請見下文)。不要修改任何合成檔案。
要求一部新影片規劃(第 5 節)。
批准一個計畫(例如「建置吧」、「開始做」)按照批准的內容進行建置。

一條同時提出問題和變更的訊息,會同時得到回答和變更。只有在無法判斷對方是否要求任何東西時,才屬於對話:一個錯誤的回答只浪費一條訊息;一個錯誤的建置則會浪費長時間執行和一輪意見回饋。

對話回覆:

  • 首先用簡短的幾句話,以平實的語言回答。
  • 只問那些答案會改變影片的問題,每個問題附上建議答案及其取捨(例如「30 秒適合資訊流;60 秒則為示範留下空間」)。
  • 當需要構思一個想法時:對於新影片,請參考 /hyperframes 的 references/pitch-round.md 提供方向;對於關於這部影片的想法,請針對所指名的部分提供兩到三個選項。推薦其中一個。
  • 最後說明下一步以及啟動該步驟的關鍵字(例如「說『建置』我就開始」)。

將計畫保留在專案中,而不僅僅是對話記錄中:下一條訊息可能開啟一個無法看到當前對話記錄的新工作階段。按照 /hyperframes-creative 的 references/storyboard-recipe.md 第 4 節記錄一輪意見的方式,將計畫新增到 STORYBOARD.md;絕不要覆蓋已鎖定的影格。如果對方要求你完全不要修改任何東西,則什麼都不要寫:在回覆中提出計畫,並詢問是否要將其儲存下來。

1. 每個場景都是一個子合成

根合成只包含計時主機、媒體和音訊。任何具有巢狀結構的場景(包含子元素的 div、包含副標題的標題、圖表)都應使用自己的檔案,並透過 data-composition-src 載入,接線方式請參考 /hyperframes-core 的 references/sub-compositions.md。

留在根合成內的巢狀標記不會成為獨立的軌道。它會隱藏在一個不透明的軌道內,無法逐部分修剪或移動。

編寫時應假設有一個結構檢查工具會拒絕任何違反規定的情況。

2. 一條字幕軌道

  • 所有字幕都位於同一條軌道上:一個單一的子合成主機(一個 data-track-index),標記為 data-track-kind="captions",按順序承載所有字幕組。
  • 切勿為每個字幕組使用一條軌道,也不要將字幕與其他類型混合在同一條軌道上。
  • 字詞時間規則不變:請參考 /embedded-captions 和 caption_* 的 lint 規則。

3. 每種元素類型一條軌道

按類型分組,以便每一行都是一個完整的元素,使用者可以將其作為一組進行選取、靜音或拖曳。

類型data-track-kind
基礎影片 / A-rollvideo(來自標籤)
場景、疊加層、圖形graphics
字幕captions
音訊(旁白、音樂、音效)audio(來自標籤)

將 data-track-kind 放在子合成主機上。影片和音訊類型來自標籤,因此 <video> 和 <audio> 不需要屬性。為每個類型指定各自的 data-track-index;該數字僅供顯示,不會改變渲染的圖層順序。使用 CSS 進行圖層管理。

4. 安全區域

任何參考線或安全框疊加層都位於預覽窗格中,絕不在合成內部,因此請勿在 HTML 中添加輔助元素。

兩種畫面比例(寬螢幕和直立)都使用相同的兩個安全框,即 Premiere 的預設值。預覽切換開關會繪製它們,並在每條邊的中點加上刻度。來源:packages/studio/src/utils/previewSafeMargins.ts 中的 ACTION_SAFE_PERCENT 和 TITLE_SAFE_PERCENT。

方框佔畫面比例每邊內縮比例
動作安全框90%5%
標題安全框80%10%
  • 安全邊距:所有可見內容都應位於動作安全框(90%)內,字幕和關鍵內容則應位於標題安全框(80%)內。
  • 雙欄和 50/50 佈局應確保每一半的內容都位於標題安全框內。

5. 新影片:規劃、分鏡、建置

hyperframes-launches 的影片是按照以下順序製作的。每個步驟都有負責人;請遵循此順序,不要在此重述。

步驟負責人
1. 簡報/hyperframes 的 references/intent-interview.md。在現有專案中,只有針對同一部影片的後續工作才保留:新版本或剪輯版,同樣的工作流程和畫面比例。詢問其必答問題,跳過 hyperframes init,絕不覆蓋 BRIEF.md 或 STORYBOARD.md,為每個檔案新增一個新的日期章節,並在回覆中說明。具有不同工作流程或畫面比例的影片應啟動一個新專案,並在回覆中說明。
2. 方向/hyperframes 的 references/pitch-round.md
3. 分鏡/hyperframes-creative 的 references/storyboard-recipe.md
4. 建置簡報所指派的工作流程(/hyperframes 第 2 節)及其自身的參考文件
5. 意見/hyperframes 的 references/review-loop.md

以下是發布影片的附加規則,適用於產品發布。當工作流程選擇的故事弧線有不同規定時,以故事弧線為準。

  • 發布產品的實拍畫面。 在簡報中要求對方提供螢幕錄影,除非工作流程本身會自動擷取(例如透過 URL 擷取網站),並用一個帶有標籤的佔位符保留其位置,直到取得錄影為止。切勿模擬已發布產品的 UI。作為背景顯示的第三方工具(例如聊天應用程式、編輯器)應根據擷取內容忠實重建。
  • 同一個世界。 同一視窗或畫布在各個節拍之間應保持連續。檢查每一個剪輯點:任何持續存在的元素都不得跳動。
  • 游標與滾動內容。 游標或視窗本身滾動出去的內容,應通過視窗或影格邊緣離開,而不是在畫面中間淡出。元素和文字切換應遵循工作流程中包含的 cut-catalog.md。
  • 以指令或網址作為結尾, 並將標誌落在仍在移動的影片上。
  • 在每個版本中聲明執行時間。 是否超出目標長度由對方決定,而非由你決定。

檢查你的工作

執行 hyperframes check(它會執行 lint)並修正所有發現的問題。然後在 Studio 中開啟專案,確認時間軸顯示了一條基礎軌道、每條場景主機一條軌道、一條字幕軌道以及音訊軌道。

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

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

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.

相關技能