Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

汎用的なHyperFrames動画コンポジションの作成・編集を行います。専用ワークフローが適合しない場合や、BRIEF.mdでflow: companionが設定されている場合に使用します。長尺・マルチシーン作品、ブランドリール、モンタージュ、静的ループ、タイトルカード、フッテージリミックス、自由形式のビルドに対応します。

hyperframes-instruct とは?

このスキルは、HyperFramesエコシステム内で汎用的な動画コンポジションを作成・編集するための、包括的な手順を提供します。専用のワークフローが存在しない場合や、ユーザーが共同制作(companion)フローを選択した場合に使用します。主な機能として、メディアやFigmaデザインからのアセット読み込み、プロジェクト状態の管理(新規作成、既存プロジェクトの編集、BRIEF.mdに基づくハンドオフ)、自動運転(automation)と共同制作(companion)フローの両方に対応したワークフロー制御、ハードカットやトランジションなどのシーン編集、そしてCRTスキャンラインやグリッチエフェクトなどの視覚効果の適用が含まれます。このスキルは、HyperFramesエコシステムの一部として動作し、`npx hyperframes` CLIツールを使用して、プロジェクトの初期化、スキル更新、利用状況の確認、カタログ検索などを実行します。共同制作フローでは、ユーザーの創造性を最大限に引き出す「天井治療(ceiling treatment)」アプローチを採用し、単なる作業請負ではなく、ディレクターとして最高品質の作品を提案します。

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

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

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

ドキュメント

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

汎用動画

ワークフローが直前に読んだ場合を除き、最初にnpx hyperframes usage --jsonを実行し、その後、ドラフト作成後やレンダリング前などのマイルストーンで再度確認します。利用可能なウィンドウとリセット時間を読み取ります。利用状況が不明な場合は、割り当てを推測せずにその旨を伝え、ユーザーとスコープとワークフローの選択肢を検討します。

このワークフローに依存する前に、以下を実行します。

npx hyperframes skills update general-video

no-opが成功した場合は、スキルが最新であることを意味します。メモリから続行する代わりに、更新失敗を表面化します。

1. 横断的ソースアダプターの適用

  • メディア: オーディオ、画像、アイコン、ロゴ、ボイス、グレーディング、LUT、処理/エフェクト、キャプション、またはメディア操作のニーズがある場合は、/media-useをロードし、../media-use/references/resolve.md(解決、採用、再利用)と../media-use/references/setup-providers.md(プロバイダー、認証)に従ってください。曖昧なフッテージフィードバックと名前付きスタイルは、編集前に../media-use/references/media-treatments.mdを使用します。CSS/SVG/不透明度でサポートされているメディアエフェクトを即興で作成しないでください。最初の認証済みプロバイダーアクションの前に、npx hyperframes auth statusを実行し、その出力をそのまま中継します。サインアウトしている場合は、../hyperframes/references/brief-contract.mdのゲートを適用します。協調的(collaborative)の場合は、サインインまたは明示的なオフラインの選択を待ちます。自律的(autonomous)の場合は、ステータスを伝え、利用可能なオフラインプロバイダーを通じて続行します。必要な機能を満たすオフラインプロバイダーがない場合は、ブロッカーを表面化します。ローカル採用のみでは、認証ゲートは必要ありません。
  • Figma: 入力がfigma.comのURLである場合は、最初に/figmaを実行します。エクスポートされたアセット、トークン、コンポーネント、またはストーリーボードフレームからビルドします。生のFigmaコネクター呼び出しは、SVGサニタイゼーション、メディアプロvenance、およびブランドトークンバインディングをスキップするため、使用しないでください。

これらのアダプターは、/hyperframesによって選択されたワークフローを変更しません。

2. プロジェクト状態から開始

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

状態アクション
特定の編集編集を行い、既存のプロジェクト決定を保持してから、影響を受けるチェックを再実行します。探索を再開しないでください。
BRIEF.mdが存在するそれを読みます。workflowが別のワークフローを指定し、flowがcompanionでない場合は、ハンドオフします。ブリーフに関する質問はしません。
ブリーフはないが、hyperframes.jsonまたはSTORYBOARD.mdが存在するファイルと記録された設定から再開します。既知の事実からのみBRIEF.mdをバックフィルします。
新規作成/hyperframesとそのインテントレイヤーを実行します。workflow: general-videoまたはflow: companionの場合のみ、ここに戻ります。

新しいプロジェクトの場合は、ブリーフからケバブケースのディレクトリ名を選択し、ブリーフを書く前にスキャフォールドします。

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video

次に、../hyperframes/references/brief-format.mdを使用して、プロジェクトルートにBRIEF.mdを記述します。既存のプロジェクトでは、ルートはhyperframes.jsonを含むディレクトリです。ブリーフ形式で指定された、確認済みの設定ベースのフィールドのみを記録し、node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>を使用します。推測されたデフォルトは決して記録しないでください。ここで<MEDIA_DIR>はインストールされた/media-useスキルディレクトリで、<PROJECT_ROOT>はhyperframes.jsonを含むディレクトリです。インテントレイヤーがレシピを採用した場合は、今すぐnode <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name>で適用し、再度質問しないでください。

3. 実行形状の解釈

../hyperframes/references/brief-contract.mdからの正規の用語のみを使用します。

フィールド意味効果
flow誰が主導するかautomation: ルートを選択して実行します。companion: 会話で共同作成します。
storyboardビルド前に計画、スケッチ、レビューするかyes: 計画とスケッチレビュー(storyboard.html)を実行します。no: それなしでビルドします。
派生modeチェックポイントゲートの動作方法ブリーフコントラクトに従います。ユーザーにモードの名前を尋ねないでください。

これらの状態の同義語を発明しないでください。進行中の「とにかくビルドして」というシグナルは、インテントレイヤーによって処理され、flow: automation、storyboard: noとして到着します。

  • flow: automationの場合は、ルートを選択し、最初の進捗更新で一文で述べてください。
  • 特定の編集の場合は、新しいルートを発明せずに編集を行ってください。

既存のフッテージのハードカット、トリム、スプライス、または並べ替えの場合は、同じビデオソースを複数のクリップ要素に複製します。各コピーで、data-media-startとdata-durationでソース範囲を設定し、次にdata-startで作成者の配置/順序を設定します。各ビデオセグメントはそのサウンドを保持します。サウンドはクリップに残るため(data-has-audio="true")、ビデオをカットするとそのサウンドもカットされます。/hyperframes-coreがこの時間編集を所有します。ズーム、パンチ、パン、クロップ、マスク、または内部ラッパー上のclip-pathなどの視覚プロパティアニメーションには、/hyperframes-keyframesのみを使用してください。 ../hyperframes-core/references/creator-editing-recipes.mdから完全なコントラクトをコピーします。

共同制作フロー

flow: companionの場合:

  • BRIEF.mdを読み、受け入れられた## Assetsと## Customizationsをプロジェクトアーティファクトと調整します。まだ保留中の受け入れられた作業を完了します。完了した作業はそのままにします。受け入れられた機能を新規であるかのように再度提供しないでください。
  • 請負業者ではなく、ディレクターとして到着します。 共同制作を選択したユーザーは、関与と品質を選択しました。正直な応答は、防御できる最小のバージョンではなく、デザインできる最高のバージョンです。最初の計画は天井治療です。ストーリーアーク(最も近いジャンルレンズを借用 — メニュー§ ジャンルレンズ)、デザイン仕様、各シーンのモーション処理(§ 5の計画規律により名前で引用)、トランジション、オーディオアイデンティティ — 音楽とサウンドマーク、または意図的な無音、ユーザーの素材の配置、そしてデザインされたオープンとクローズです。各レイヤーが一文で何を追加するかを述べ、高価なもの(レンダリング時間、サインイン、課金)にフラグを立てます。ユーザーは治療を削減します。承認ごとに組み立てる必要はありません。
  • 天井はコンセプトに属し、ツールボックスに属しません。 すべてのレイヤーはブリーフのメッセージに役立たなければなりません。あらゆるビデオを同じように飾る処理は装飾です。クラフトは天井に上昇します。コンテンツは要求されたものを超えて成長することはありません(§ 6)。
  • チェックポイント間では、../hyperframes/references/capability-menu.mdは双方向に機能します。トリガーリストとして: ユーザーがその入力を言及したとき、またはビルドがそのニーズに達したときに、関連する機能を提供します。各パスのアップグレードチャネルとして: 計画、スケッチ、またはビルドのチェックポイントは、ユーザーが見ている素材を指す1つまたは2つのトレースされたオファーを運ぶことがあります(「シーン3の統計はカウントアップ処理を望んでいます」)。提供する前にそれを読みます。完全なカタログをダンプしないでください。
  • ユーザーが機能を受け入れた後、そのアーティファクトを生成し、すぐに一致するBRIEF.mdボディセクションに決定を記録します。ユーザーが明示的に変更した場合にのみ、フロントマターフィールドを書き換え、確認された設定を記録します。
  • 同じストーリーボード、検証、最終プレビュー、およびレンダリング承認ゲートを維持します。共同制作は誰が操縦するかを変更しますが、品質が要求するものを変更しません。

4. 各ステージの前に必要な知識をロードする

これらの読み取りは、条件が一致する場合に必須です。

条件アクション前に読むもの
任意のコンポジションHTMLまたはシーンレイアウト/hyperframes-core; レイアウトコントラクトにはreferences/determinism-rules.mdを使用
任意の非自明な作成または視覚的処理/hyperframes-creative → references/house-style.md および references/video-composition.md
任意のモーション、アニメーション、またはシーントランジション/hyperframes-animation; ルーティングに従って、一致するルール、アダプター、ブループリント、またはトランジションリファレンスへ
storyboard: yes../hyperframes/references/storyboard-format.md および ../hyperframes/references/review-loop.md
ナレーション、BGM、SFX、キャプション、グレーディング、または変換を含む任意のメディアアセットまたは操作/media-use; フレームワーク再生と配置については、/hyperframes-core → references/variables-and-media.mdも読む
マルチシーンアセンブリ../hyperframes/references/production-loop.md
flow: companion、最初の計画の前/hyperframes-creative → references/story-spine.md および references/house-style.md; 最も近いジャンルレンズと完全な../hyperframes/references/capability-menu.md — 天井治療はこれらからデザインされ、想起されません
共同制作機能オファー、キャプチャ、ビートグリッド、生成ビデオ、マップ、公開、またはクロスワークフロー機能../hyperframes/references/capability-menu.md
デザイン仕様が存在する、最終承認前/hyperframes-creative → references/design-adherence.md

これらの読み取りを記憶に置き換えないでください。プログレッシブディスクロージャーは、一致するリファレンスが実際にロードされた場合にのみコンテキストを節約します。

5. コンポジションの実行

この依存関係順序を使用します。入力がない場合のみステージをスキップします。

  1. 計画. ビューアーアーク、構造、リズム、および時間ドライバーを記述します。短い単一シーンには1つのファイルを使用します。3つ以上のハードシーンカットまたは再利用されるシーンには、サブコンポジションを使用します。ナレーションアークについては/hyperframes-creative → references/story-spine.md、リズムについてはreferences/beat-direction.md、構造については/hyperframes-core → references/composition-patterns.mdを読みます。オープンエンドのマルチシーンブリーフの場合は、/hyperframes-creative → references/prompt-expansion.mdを通じてプロンプトを展開します。マルチシーン計画は各シーンの形状を引用します。/hyperframes-animation → blueprints-index.mdからのブループリントID(適合する場合)、または適合しない場合はrules-index.mdから構成する名前付きルール — モーション名はこれらのインデックスから取得し、決して発明しません。ストーリーの真実がどのシーンが存在するかを決定し、引用がそれらを飾ります。名前付きのルックを自分でビルドする前に、ライブカタログを検索してください: ブリーフが名前を挙げるすべてのルック、エフェクト、処理、トランジション(「CRTスキャンライン」、「グリッチ」、「フィルムグレイン」、「シャイマースイープ」、「コンフェッティバースト」)について、npx hyperframes catalog --query "<ルックを平易な英語で>" --jsonを実行し、計画がそのルックのビルド方法を命名する前に上位の結果を読んでください。この検索には何もインストールする必要はありません: プロジェクト、事前のadd、アカウントは不要です。任意のディレクトリからホストされたレジストリ全体(約400ブロックとコンポーネント)をランク付けするため、ユーザーがビルド途中で尋ねるルックにも適用されます。計画が名前を挙げたブロックはステージ3でインストールされます。検索しても適合するものが何も返ってこなかった場合にのみ、ルックを手書きしてください。マルチシーン計画はディスパッチアーティファクトとしても記録されます。STORYBOARD.md内のシーンごとに1つの## Frame Nブロック — status: outline、宣言されたsrc:、ブループリント/ルールの引用、

…

[翻訳のために切り捨てられました]

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

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

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.

関連スキル