Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

用於在 Studio 中與他人協作 HyperFrames 專案:判斷是否要進行修改、規劃新影片、以及遵循時間軸配置慣例。

hyperframes-instruct 是什麼?

此技能定義了與使用者在 HyperFrames Studio 中協作時的完整工作流程。它首先要求你仔細閱讀使用者的訊息,判斷其意圖是請求修改、提出問題,還是單純討論想法。對於明確的修改請求,你應直接執行;對於模糊的想法或問題,你應提供答案和計畫,而非直接修改檔案。技能詳細說明了時間軸的組織慣例,包括每個場景都應是一個子合成、所有字幕集中在同一軌道、以及每個軌道只包含一種元素類型。這些慣例確保時間軸簡潔易讀,並防止使用者無法編輯的混亂布局。此外,技能涵蓋了安全區域(動作安全框和標題安全框)的正確實現方式,以及從簡報到建置的完整新影片製作流程。它支援 Claude Code、HyperFrames Studio 等平台,幫助 AI 代理以結構化、可預測的方式與使用者協作,避免不必要的修改並確保專案遵循最佳實務。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/sandeshrajbhandari/hyperframes-instruct/tree/HEAD/.agents/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 中的方向;對於與此影片相關的想法,針對提及的部分提供兩到三個選項。推薦其中一個。
  • 以下一步驟和啟動該步驟的指令結尾(如「說『開始建置』我就開始」)。

將計畫保留在專案中,而非僅在對話中:下一則訊息可能開啟一個新的工作階段,無法看到本次對話。將計畫加入 STORYBOARD.md,方式如同 /hyperframes-creative references/storyboard-recipe.md § 4 記錄一輪意見回饋;切勿覆寫已鎖定的影格。如果使用者要求你完全不要修改任何東西,則什麼都不要寫:將計畫放在回覆中,並提供儲存的選項。

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

根合成僅包含計時的主機、媒體和音訊。任何具有巢狀結構的場景(包含子元素的 div、附有字幕的標題、圖表)都應該是其獨立的檔案,透過 data-composition-src 載入,相關接線方式請見 /hyperframes-core references/sub-compositions.md。

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

請像有一個結構檢查器會拒絕任何違規一樣來進行創作。

2. 單一字幕軌道

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

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 11 individual skills — each has its own dedicated page.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

相關技能