Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

HyperFrames Studioプロジェクトでの作業時に使用。変更の要否判断、新規フィルムの計画・ストーリーボード・構築手順、タイムラインの整理方法(キャプショントラックは1つ、要素種類ごとにトラック、各シーンはサブコンポジション)、およびセーフゾーン内でのキャプションと主要コンテンツの配置を定義します。個別の編集操作(分割、トリム、速度変更など)には使用しません。

hyperframes-instruct とは?

このスキルは、AIエージェントがHyperFrames Studioでプロジェクトを構築・編集する際の一連の規則を提供します。具体的には、ユーザーのメッセージが編集を要求しているかどうかを判断する方法、新規フィルム作成時の計画・ストーリーボード・構築の順序、タイムラインを整理して可読性を高める方法(各シーンをサブコンポジション化、キャプションは1トラックに集約、要素の種類ごとにトラックを分ける)、およびキャプションと主要コンテンツをセーフゾーン内に収める方法を定義します。また、個別の編集操作(分割、トリム、リタイム、ボリューム調整など)については、`/hyperframes-core`の`creator-editing-recipes.md`を参照するよう指示します。このスキルはClaude CodeなどのAIエージェントで使用することを前提としており、プロジェクトの一貫性と効率的なワークフローを維持するために設計されています。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/sandeshrajbhandari/hyperframes-instruct/tree/HEAD/.agents/skills/hyperframes-studio

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

プラグインのインストール: セットアップやフレッシュネスコマンドの前に、このスキルがHyperFramesプラグイン内にある場合はプラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順を維持してください。

HyperFrames Studioの規則

Studioは、トップレベルの要素ごとに1つのタイムライン行を描画します。以下のルールに従ったプロジェクトは、短く読みやすいタイムラインとして開きます。従わないプロジェクトは、ユーザーが編集できないラベルのない行の壁として開きます。これらは、何を構築するかに関する規則です。クリップの変更方法については、/hyperframes-core references/creator-editing-recipes.mdに従い、同じ編集の別の形式を発明しないでください。

0. 構築する前に話す

ファイルを開く前にメッセージを読んでください。何を求めているかを判断します。

相手あなた
変更を指定する(「タイトルを大きくして」「3番目のシーンを切ってくれる?」など、丁寧でも)それを実行する。
完成したフィルムについて感想を述べる(「イントロがぎくしゃくしている」「長さが足りない」)原因を見つけ、測定可能なものを変更し、その感想が何を意味し、何が動いたかを説明し、/hyperframes-creative references/storyboard-recipe.md § 4に従って記録する。
質問をし、変更を指定しない(「なぜタイトルが跳ねるの?」)答える。何も変更しない。
何も変更しないで、待って、「考えている」「話そう」と言うファイルを一切変更しない。気づいた修正も含めて。口頭で提案する。
具体的な変更なしにこのフィルムに関するアイデアを持ち込む(「エンディングをもっと大きくしたい」)変更を提案し、計画に追加する(下記参照)。コンポジションファイルは変更しない。
新しいフィルムを依頼する計画を立てる(§ 5)。
計画を承認する(「作って」「GO」)承認されたものを構築する。

質問と変更の両方を指定するメッセージには、回答と変更の両方を返します。何かを求めているかどうかがわからない場合にのみ、それは会話です。間違った回答は1メッセージの損失で済みますが、間違った構築は長い実行と一連の修正を招きます。

会話の返信:

  • まず、平易な言葉で、数文で回答する。
  • フィルムを変える質問のみを、それぞれに推奨回答とトレードオフを添えて行う(「30秒はフィードに合う、60秒はデモの余地を残す」)。
  • 形にするアイデアがある場合:新しいフィルムについては、/hyperframes references/pitch-round.mdに従った方向性を提示する。このフィルムに関するアイデアについては、指定された部分に対する2~3の選択肢を提示する。1つを推奨する。
  • 次のステップとそれを開始する言葉で締めくくる(「作ってと言ってください。そうしたら始めます」)。

計画はチャットだけでなくプロジェクト内に保持する。次のメッセージがこのセッションを見られない新しいセッションで始まる可能性があるためです。/hyperframes-creative references/storyboard-recipe.md § 4がラウンドを記録する方法でSTORYBOARD.mdに追加します。ロックされたフレームは決して上書きしないでください。相手が何も変更しないように依頼した場合は、何も書き込まず、計画を返信に記載して保存を提案します。

1. すべてのシーンはサブコンポジション

ルートコンポジションは、タイムドホスト、メディア、オーディオのみを保持します。ネスト構造を持つシーン(子を含むdiv、サブタイトル付きタイトル、チャートなど)は、data-composition-srcで読み込まれる独自のファイルであり、/hyperframes-core references/sub-compositions.mdで配線します。

ルート内に残されたネストされたマークアップは、それ自体の行にはなりません。分割や部分的な移動ができない1つの不透明な行の中に隠れます。

構造リンターが違反を拒否するかのように作成します。

2. キャプショントラックは1つ

  • すべてのキャプションは1つのトラックに配置します。つまり、すべてのキャプショングループを順番に保持する単一のサブコンポジションホスト(1つのdata-track-index)で、data-track-kind="captions"とマークします。
  • キャプショングループごとに1行にしたり、キャプションを他の種類のトラックに混在させたりしないでください。
  • ワードタイミングルールは変更なし。/embedded-captionsおよびcaption_* lintルールを参照してください。

3. 要素の種類ごとに1トラック

種類ごとにグループ化することで、各トラックがユーザーがセットとして選択、ミュート、またはドラッグできる1つのものになります。

種類data-track-kind
ベースビデオ / Aロールvideo(タグから)
シーン、オーバーレイ、グラフィックgraphics
キャプションcaptions
オーディオ(ナレーション、音楽、効果音)audio(タグから)

サブコンポジションホストにdata-track-kindを設定します。ビデオとオーディオの種類はタグから取得されるため、<video>と<audio>には属性は必要ありません。各種類に独自のdata-track-indexを設定します。数値は表示のみであり、何が上にレンダリングされるかを変更することはありません。レイヤリングにはCSSを使用します。

4. セーフゾーン

ルーラーやセーフボックスのオーバーレイはすべてプレビューペインに存在し、コンポジション内には決して配置しません。したがって、ガイド要素をHTMLに追加しないでください。両方のフレーミング(ワイドと縦)は、Premiereのデフォルトである同じ2つのセーフボックスを使用します。プレビュートグルは、各辺の中点に目盛りを付けて描画します。ソース:packages/studio/src/utils/previewSafeMargins.tsのACTION_SAFE_PERCENTとTITLE_SAFE_PERCENT。

ボックスフレームに占める割合各辺のインセット
アクションセーフ90%5%
タイトルセーフ80%10%
  • セーフマージン:表示されるすべてのものはアクションセーフボックス(90%)内に収め、キャプションと主要コンテンツはタイトルセーフボックス(80%)内に収めます。
  • 2アップレイアウトと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で開き、タイムラインにベース行、シーンホストごとに1行、キャプション行1行、オーディオ行が表示されることを確認します。

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.

関連スキル