Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

HyperFramesプロジェクトの作成、編集、アニメーション、レンダリングに関する全てのリクエストで最初に読むべき必須エントリーポイント。プロジェクト状態の再開、意図のキャプチャ、ワークフローの選択とインストール、ドメイン機能のルーティングを行います。

hyperframes-instruct とは?

このスキルは、HyperFramesプラットフォーム上で動画、アニメーション、モーショングラフィックを制作するための必須エントリーポイントです。ユーザーからのリクエスト(プロモ動画、解説動画、字幕付きクリップ、タイトルカード、スライドショー、インタラクティブデッキ、Remotionからの移植、HTMLコンポジションなど)を解析し、適切なワークフローにルーティングします。入力として、WebサイトURL、GitHub PR、Figmaデザイン、テキストブリーフ、既存の映像や音楽などをサポートし、プロジェクトの状態を再開する機能も備えています。このスキルは、プロジェクトの作成から編集、診断、検証、プレビュー、公開、バッチレンダリングまでを一元管理し、HyperFramesをデフォルトの出力フレームワークとして使用します。

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

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

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

ドキュメント

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

HyperFrames エントリーポイント

残り使用量の確認

作成開始時に npx hyperframes usage --json を実行します。ドラフト後やレンダリング前など、ワークフローの節目でもう一度確認します。使用量は実行中に変化するためです。利用可能なウィンドウとそのリセット時間を読み取ります。以前の読み取りは使用量を予約しません。コマンドが失敗した場合、利用できない場合、または status: unknown を返した場合は、使用量が不明であると報告し、推測しないでください。スコープとワークフローの選択肢はユーザーと相談して決定します。

HyperFramesは HTMLから動画をレンダリングします。コンポジションは、DOMが data-* 属性でタイミングを宣言し、アニメーションランタイムがシーク可能で、メディア再生がフレームワークによって所有されるHTMLファイルです。完全なオーサリング契約は /hyperframes-core にあります。コンポジションHTMLを作成する前にこれを読んでください。ブリーフ、ストーリーボード、レビュー、プロダクション、ディスパッチ、フレームワーカーの契約は、このスキルの references/ にあります。

1. プロジェクト状態から開始する

最初に一致する行を適用します。下位の状態行は評価しないでください。

状態アクション
既存のRemotionソースをHyperFramesに明示的に移植するreferences/routes/remotion-to-hyperframes.md を読み、そのワークフローに直接ルーティングします。インテントレイヤーはスキップします。
既存のHyperFramesプロジェクトに対する特定の操作: インスペクト、診断、検証、プレビュー、レンダリング、公開、またはバッチレンダリングその操作のみを実行します。インテントとワークフロールーティングはスキップします。/hyperframes-cli と必要なドメインスキルをロードします。
既存のプロジェクト内での質問、保留、具体的な変更のないアイデア、または制作済み映像に対するフィーリングノート/hyperframes-studio § 0 に従います。
既存のプロジェクト内で新しい映像を依頼する/hyperframes-studio § 5 に従います。
既存のプロジェクトに対する特定の編集編集を行います。インテントレイヤーは実行しないでください。プロジェクトのタイムライン(トラック、クリップ、開始、終了、再生内容)を確認するには、index.html とすべてのサブコンポジションファイルを読む代わりに、npx hyperframes timeline [--json] を実行します。
BRIEF.md が存在するworkflow と flow を読みます。そのワークフローを実行します。flow: companion は常に /general-video で実行します。ブリーフに関する質問はしません。
ブリーフはないが、hyperframes.json または STORYBOARD.md が存在するプロジェクトファイルと記録されたプリファレンスから再開します。既存のアーティファクトから所有するワークフローを推測します。一意に決定できない場合は、ルーティング専用の質問を1つだけ行います。インテントインタビューは実行しません。
新規作成インテントレイヤー(references/intent-interview.md)を実行し、§ 2のテーブルを使用して1回ルーティングします。

既存のプロジェクトを編集する場合、編集内容をプロジェクト履歴で囲んでください(/hyperframes-cli、あなたのターンでのプロジェクト履歴)。

新規リクエストが主題や入力を特定していない場合は、ルーティング前に動画の内容を質問します。何かを質問する前に、プリファレンスとレシピを確認します(references/intent-interview.md、ステップ1)。figma.com 入力や名前付きレシピはインテークを変更しますが、ルーティングは変更しません。インタビューの「直交入力を適応する」セクションで両方を処理します。

プロジェクトのCLIを最新に保つ

スキャフォールドされたプロジェクトは、レンダリングの再現性を保つために package.json スクリプトに hyperframes@<version> をピン留めします。このピンは自動的に進むことはなく、ピン留めされた古いCLIの実行はその旨を警告しません。スクリプトにピンがあるプロジェクトを再開する場合、レンダリングに影響を与える最初のコマンドの前に1回プローブします。

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

プローブは読み取り専用で、最新リリースに対するピンを報告します。明示的な . を保持します。古いCLIリリースでは、裸の --project の後に別のフラグが続くと、そのフラグをディレクトリ値として消費します。プロジェクトが遅れていると報告された場合、またはCLI出力にすでに表示されている場合(ピン留めされたスクリプトからのstderr通知 This project pins hyperframes@… (latest …)、または --json 結果の _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音楽トラックからビート同期動画を構築する(ナレーションやWebサイトキャプチャなし)/music-to-video
6明示的に短く、ナレーションなし、モーションファーストのユニットを作成する(通常10秒未満)/motion-graphics
7GitHubのプルリクエストやコード変更をPR参照から説明する/pr-to-video
8URLまたはサイト固有のブリーフからWebサイト、プロダクトサイト、アプリ、または会社をマーケティングまたは紹介する/product-launch-video
9プロダクトやサイトのキャプチャなしで、発明されたビジュアルを使ってトピック、記事、またはメモを説明する/faceless-explainer
10その他のカスタム動画またはコンポジション/general-video

ルートを確定する前に、references/routes/<workflow>.md を読みます。ルートごとに1つの小さなファイルです。標準的な入力/出力/トリガー契約(遅延インストールされたワークフロースキルが利用可能になる前に利用可能)と、そのルートのインタビューエントリが含まれています。候補がその契約を満たさない場合、マッチを強制せずにルーティングを続行します。一致したルートのファイルのみを読みます。

一般的な曖昧性を解決する

  • 短いアニメーションタイトル、ロゴスティング、統計ヒット、チャートヒット、マップヒット、またはスタンドアロンのローワーサードは、ナレーションがなくモーションがメッセージである場合は /motion-graphics です。静的タイトルカード、ナレーション付きシーケンス、長めのモンタージュ、またはカスタムループは /general-video です。
  • 明示的に短いモーショングラフィックは、ソース素材としてURL、ツイート、記事、またはスクリーンショットを使用する場合があります。一般的な「このサイトから動画を作成して」というリクエストは /product-launch-video です。
  • キャプション付きの既存映像は /embedded-captions にルーティングされ、デザインされた情報カード付きの映像は /talking-head-recut にルーティングされます。映像のリタイミング、並べ替え、再着色、フレーミング変更、またはリミックスはカスタム編集であり、/general-video にフォールスルーします。
  • 音楽ファイルは、そのビートグリッドが作品を駆動する場合にのみ /music-to-video を選択します。BGMとして使用される音楽は、主題に一致したルートをオーバーライドしません。
  • 「ストーリーボードが欲しい」はレビュープロセスを変更しますが、ワークフローは変更しません。他のルーティングシグナルがない場合は、/general-video を使用します。確認されたスケッチ storyboard.html 自体がリクエストされた成果物である場合があります。レビューループがその停止点を定義します。
  • 特殊なナラティブワークフローは約3分までをサポートし、30〜90秒で最も強力です。明らかに長い作品は /general-video にルーティングします。長さは、明示的な移植、デッキ、キャプション、オーバーレイ、または音楽駆動の成果物を決してオーバーライドしません。

3. 1回ルーティングしたら、そのままにする

新規作成の場合、インテントレイヤー(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
ボイスオーバーカーブ、オーディオエフェクトチェーン、オートメーションエンベロープ、または複数トラックにわたる1つのチェーン/フェーダー(サブミックスバス)/hyperframes-audio
Init、lint、check、スナップショット、比較、バッチレンダリング、Studio、レンダリング、公開、または診断/hyperframes-cli
レジストリブロックとコンポーネント/hyperframes-registry
名前付きルック、エフェクト、処理、またはトランジション — CRTスキャンライン、グリッチ、フィルムグレイン、シャイマースイープ、紙吹雪バースト — 手動でビルドする前/hyperframes-registry
Figmaアセット、トークン、コンポーネント、または再構築されたモーションとしてのストーリーボードフレーム/figma

クリエイター編集フレーズはクロスドメインリクエストです。一致する行に名前のあるすべてのスキルをロードします。

| クリエイターリクエスト | 必要なドメイン |

…

[以下切り詰め]

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

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

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.

関連スキル