Communitygithub.com

HyperFrame Studio の規約

HyperFrames Studio で人物と共同作業する際に使用します。変更を依頼しているかどうかの判断から、新規フィルムの計画、ストーリーボード、ビルド順序、タイムラインのレイアウト方法、セーフゾーンまでをカバーします。個別の編集操作(分割、トリミング、リタイムなど)には使用しません。

HyperFrame Studio の規約 とは?

このスキルは、HyperFrames Studio プロジェクトにおいて、人間の開発者やクリエイターと AI エージェントが効果的に共同作業するための、明確なルールとワークフローを定義します。まず、ユーザーのメッセージが実際に編集を要求しているのか、それとも質問やアイデアの段階なのかを正確に判断する「話してから作る」原則を重視します。次に、タイムラインを整理するための具体的な規則(各シーンをサブコンポジションにする、キャプションは 1 トラックにまとめる、トラックは要素の種類ごとに分ける)を定め、プロジェクトが常に可読性が高く編集しやすい状態を保つようにします。また、アクションセーフやタイトルセーフなどのセーフゾーンの定義とルールを提供し、最終的な出力品質を向上させます。さらに、新規フィルム作成のための計画(ブリーフ、方向性、ストーリーボード、ビルド、レビュー)の段階的なプロセスを定義し、製品ローンチに特化したベストプラクティス(実写映像の使用、一貫した世界観、カーソルやスクロールコンテンツの扱いなど)も含みます。主な対象プラットフォームは HyperFrames Studio ですが、関連するリファレンス (`/hyperframes-core` など) と連携して動作します。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/samyakiasonline-ctrl/hyperframe/tree/HEAD/.claude/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 つのトラックに配置されます。つまり、すべてのキャプショングループを順番に保持する、data-track-kind="captions" とマークされた単一のサブコンポジションホスト(1 つの data-track-index)です。
  • キャプショングループごとに 1 行にしたり、キャプションを別の種類のトラックに混在させたりしないでください。
  • ワードタイミングルールは変更されません。/embedded-captions および caption_* リントルールを参照してください。

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 を近似しないでください。コンテキストとして表示されるサードパーティツール(チャットアプリ、エディター)は、キャプチャから忠実に再構築します。
  • 1 つの世界。 同じウィンドウまたはキャンバスがビートを超えて継続します。すべてのカットをスクラブします。永続するものはジャンプしてはいけません。
  • カーソルとスクロールコンテンツ。 カーソル、またはウィンドウ自体がスクロールアウトするコンテンツは、フレーム内でフェードアウトするのではなく、ウィンドウまたはフレームの端から出ていきます。要素とテキストの入れ替えは、ワークフローに cut-catalog.md がある場合はそれに従います。
  • コマンドまたはアドレスでクローズし、まだ動いている映像にロゴを配置します。
  • すべてのバージョンでランタイムを明記します。 ターゲットを超えて実行するかどうかは、あなたではなく相手の判断です。

作業の確認

hyperframes check(リントを実行します)を実行し、すべての指摘を修正します。次に、Studio でプロジェクトを開き、タイムラインにベース行、シーンホストごとに 1 行、1 つのキャプション行、およびオーディオ行が表示されることを確認します。

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.

関連スキル