Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

デザイン主導の短いモーショングラフィックを自律的に制作します。キネティックタイポグラフィ、統計カウントアップ、データ可視化チャート、ロゴスティング、ローワーサード、ソーシャルオーバーレイ、アニメーションマップ、アニメーションツイート/ニュース記事、UIアニメーションなど、動きそのものがメッセージとなる作品を生成します。

hyperframes-instruct とは?

このスキルは、10秒前後(最大約30秒)の、デザイン主導でナレーションのないモーショングラフィックを自律的に制作するためのエージェントワークフローです。`/hyperframes` をエントリーポートとし、ユーザーの意図に基づいて適切なカテゴリ(キネティックタイプ、統計、チャート、ロゴリビール、ローワーサード、マップ、ウェブページ、ニュース、ツイート、アセットフュージョン)に振り分けます。アセットファーストのアプローチを採用し、企画、素材調達、デザイン、ビルド、検証、承認、レンダリングの7つのフェーズで構成されます。各フェーズはサブエージェントが自律的に実行し、ユーザーは最終的なレンダリングの承認のみを行います。macOS Apple SiliconまたはLinux x64環境で動作し、Node.js、ffmpeg、HyperFrames CLIを必要とします。このスキルはClaude Code、Cursor、CodexなどのAIエージェント向けに設計されており、Figmaからのアセット読み込みや、メディア検索・生成機能もオプションでサポートしています。

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

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

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

ドキュメント

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

最初に、このスキルを最新の状態に保ってください — 実行前にユーザーに確認してください: npx hyperframes skills update motion-graphics。すべてが最新の場合は高速なno-opです。それ以外の場合は、このスキルと、それが依存するコアドメインスキルを、それらに依存する前に更新します。

figmaソース: 構築元のロゴ/アセット/アニメーションがfigma.comのURLからのものである場合は、最初に/figmaを実行してください — アセットのエクスポート、ブランドトークン、およびグラフィックがFigma Motionインポートである場合のMotion→GSAP変換 — その後、その出力からビルドします。Figmaを生のMCPツールで直接操作しないでください。それはSVGサニタイゼーション、.media/manifest.jsonlの来歴、およびブランドトークンのvar()バインディングをスキップするため、後でブランド変更があっても、完全な再インポートなしでは伝播できません。

motion-graphics — ディスパッチエントリ

正面玄関は/hyperframesです。 このスキルは、短く、デザイン主導で、ナレーションのないモーショングラフィック(動きがメッセージです。約10秒未満、ナレーションなし)を作成します。それより長いもの、ナレーションのあるもの、または複数シーンのもの、あるいは不確かな場合は — 最初に/hyperframesを読んでください。インテントレイヤーがすべてのルート決定を担当します。

このワークフローは設計上自律的です — せいぜい確認のための質問が1回(agents/director.md)あり、その後は中間レビューなしで検証までビルドを行います。インテントレイヤー(/hyperframes → references/intent-interview.md)は、ランシェイプの質問なしでここに直接ルーティングします。このような短い作品では、ストーリーボードやコンパニオンセッションはほとんど価値を追加しません。レンダリングは依然としてユーザーゲートです。チェックとプルーフスナップショットが合格した後、Studioプレビューを開き、../hyperframes/references/brief-contract.mdの標準的な「今レンダリングしますか、それとも何か変更しますか?」という質問をしてください。BRIEF.mdが存在する場合は、ディレクターの質問の前にそれを読んでください。

短いデザイン主導のモーショングラフィック。アセットファースト:ショットをデザインする前に、アセット戦略を決定し、実際の素材を入手し、それを中心にショットをデザインし、カタログ機能を再利用して構成します。すべてのアーティファクトはPROJECT_DIR = videos/<project-name>/(ステップ0で作成)に格納されます。以下のパスはすべて、このディレクトリからの相対パスです。

フェーズ実行主なアーティファクト詳細フロー
initBashhyperframes.jsonステップ0
planサブエージェント — 検索するか決定 + 分類 + アセット戦略shot-plan.json (ドラフト: カテゴリ, asset_needs クエリ, ブリーフ)agents/director.md (パート1)
source ◇Bash — media-use 解決 (asset_needsが空の場合はスキップ)assets/ + assets/index.mdphases/source/guide.md
designサブエージェント — 解決済みアセットを中心にショットをデザインshot-plan.json (最終: ブロック + レイアウト + モーション + 位置)agents/director.md (パート2)
buildサブエージェント — 再利用ファーストで構成compositions/index.htmlagents/builder.md
verifyBash — lint, check, プルーフスナップショット; 失敗時は修復snapshots/contact-sheet.jpgステップ5
approveプレビューを開き、レンダリングまたは変更を尋ね、回答を待つ明示的なレンダリング承認ステップ6
renderBash — hyperframes render (MP4, またはオーバーレイ用--format webm/mov)renders/video.mp4 または透過オーバーレイステップ6

◇ source は、選択されたカテゴリがアセットを宣言している場合にのみ実行されます。純粋なコード/テキストカテゴリ(例:kinetic-type、ほとんどのcharts/stat)はasset_needs: []を持ち、計画からデザインに直接スキップします。

カテゴリ — 検索判断による分割

planの最初の判断は:これには検索が必要か? です。この分岐により、カテゴリは2つのグループに分割されます。その後、特定のカテゴリが選択されます。検索駆動型の場合は、検索が返すコンテンツのタイプによって決定されます。各カテゴリは1つのcategories/<id>/module.md(計画+ビルドルール)を持ちます。共有モーション語彙はreferences/motion-vocabulary.md(→ hyperframes-animation ルール/ブループリント + レジストリブロック)にあります。

フォームカテゴリ — 検索なし。ユーザーがコンテンツを提供:

カテゴリ意図依存先
kinetic-typeインパクトのあるライン/引用/タイトル、モーションファーストのテキストcaption-* ブロック + アニメーションルール
stat単一のヒーロー数字/カウントアップ + リングapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsデータからの棒/折れ線/円/レース/%グラフdata-chart ブロック
logo-revealロゴスティング/ブランドロックアップ(ユーザーロゴ)logo-outro / rules/svg-path-draw
lower-thirds名前/タイトルバー、コールアウト、ソーシャルオーバーレイcaption-* + レジストリオーバーレイブロック
maps地理的モーション — 地域をハイライト、場所を接続、場所にズーム(ベクターレーン、またはベイクドベースマップレーン)us-map / world-map ファミリー + bake-basemap.mjs

検索駆動型カテゴリ — 最初に検索し、その後コンテンツタイプに応じてアニメーション化(RWAパス):

返されるコンテンツカテゴリアニメーション
ウェブページ/リンクwebpageウェブページ/UIアニメーション(スクロール、表示、カーソル、コールアウト)
ニュース記事news見出し表示 + ソースカード + キーファクトコールアウト
ツイートtweetアニメーションツイートカード
画像/エンティティasset-fusionアセットのジオメトリが_チャートになる_(RWA内因性フュージョン)

ビルド順序:一度に1つずつ、カバレッジファースト(ラフで構いません)。kinetic-typeはプロトタイプから移植。残りは以下に従います。

前提条件

macOS Apple Silicon または Linux x64。システムツール:brew install node ffmpeg。npx hyperframes doctor を一度実行。macOS GPUレンダリング:export PRODUCER_BROWSER_GPU_MODE=hardware。

オプションのキー(設定されていない場合のローカルフォールバック)— media-useを介してアセットをソース/生成するカテゴリでのみ必要:

キー用途フォールバック
GEMINI_API_KEY / GOOGLE_API_KEY画像生成(media-use 解決)生成をスキップ/検索のみ
(asset_scout / 検索プロバイダ)webpage/news/tweet + asset-fusion 実際のアセット検索カテゴリはアセットなしに劣化

フロー

ステップ 0 — 初期化

cwdはエージェントワークスペースのルートです。すべてのアーティファクトをPROJECT_DIR = videos/<project-name>/の下に書き込みます。<project-name>:ユーザーが与えたディレクトリを使用するか、意図から短いケバブケースの名前を使用します(<subject>-motion)。ワークスペースのベースネームやタイムスタンプは使用しないでください。

$PROJECT_DIR/hyperframes.json がない場合のみ:

PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=motion-graphics

init はインストールされているスキルをGitHub上の最新スキルと比較し、古いものがあればグローバルセットを更新します。

制約: ワークスペースルートで hyperframes init を決して実行しないでください。PROJECT_DIR 内に別の hyperframes/ をネストしないでください。すべてのBashコマンド(マスター+サブエージェント)は (cd "$PROJECT_DIR" && ...) サブシェルです — 裸の cd は絶対に使用しないでください。

ステップ 1 — 計画(サブエージェント:ディレクターパート1)

1つのサブエージェントをディスパッチします。プロンプトは、完全な agents/director.md + ## Dispatch context(SKILL_DIR / PROJECT_DIR / ユーザーのリクエスト / Schema: <SKILL_DIR>/references/shot-plan-ir.md)です。これにより、以下のことを行う必要があります:

  1. 決定:これには検索が必要か?(最初の分岐)
    • いいえ → フォームカテゴリ(kinetic-type / stat / charts / logo-reveal / lower-thirds / maps)を選択します。コンテンツはユーザーが提供します。asset_needs: []。
    • はい → 検索計画を asset_needs[] に出力します(news / web / tweet / image。2極クエリ)。特定の検索駆動型カテゴリ(webpage / news / tweet / asset-fusion)は、ステップ2で返されるコンテンツタイプによって確認され、ステップ3で確定されます。
  2. ドラフト shot-plan.json を書き込みます(エンベロープ + 選択されたフォームカテゴリ_または_検索インテント + asset_needs + 1段落のショットブリーフ)。スキーマ:references/shot-plan-ir.md。

検証:[ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing。

ステップ 2 — ソース ◇(Bash:media-use、条件付き)

shot-plan.json.asset_needs が空でない場合は、アセットを解決します(検索/生成/フェッチ → フリーズされたプロジェクトローカルパス + 台帳)。phases/source/guide.md を参照してください(media-use resolve をラップします。検索駆動型カテゴリは、news/web/tweet/image検索を使用します)。asset_needs が空の場合は、ステップ3にスキップします。

適切に劣化します:検索/プロバイダーが利用できない場合、カテゴリはアセットなしにフォールバックします(context.log に記録します)。

ステップ 3 — デザイン(サブエージェント:ディレクターパート2)

サブエージェントをディスパッチします(プロンプト = agents/director.md パート2 + 解決された assets/index.md を含むディスパッチコンテキスト(ステップ2が実行された場合)+ catalog-map.md)。利用可能なアセットを中心にショットをデザインします。カタログブロック + hyperframes-animation ルール/ブループリント、レイアウト、モーション、ビート、および(asset-fusion の場合)element_positions + スポイターパレットを選択します。shot-plan.json を確定します(content.block + content.customize + カテゴリごとのコンテンツ)。

ステップ 4 — ビルド(サブエージェント:ビルダー、再利用ファースト)

共有のモーション原則をビルダーのディスパッチコンテキストに含めます。charts と stat の場合は、データのモーションも含めます。ビルダーはタイムラインを作成する前にこれらのガイドを読みます。

サブエージェントをディスパッチします。プロンプト = 完全な agents/builder.md + ディスパッチコンテキスト(shot-plan.json、catalog-map.md、カテゴリの module.md、references/motion-vocabulary.md、references/builder-contract.md)。再利用ファースト:npx hyperframes add <block> + その場でカスタマイズ。ギャップ + アセットフュージョンアフォーダンスのみ手動で記述します。HFコントラクトに従って compositions/index.html を出力します(window.__timelines 上の一時停止されたGSAPタイムライン、class="clip" + 安定したID、tl.seek(0)、決定論的)。

ステップ 5 — 検証(Bash → 失敗時に修復サブエージェント)

(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-times>)

開始状態、シグネチャムーブ、および最終ホールドを示すプルーフタイムを選択します。続行する前に、生成されたコンタクトシートまたはスナップショットシートを検査します。lint、check、またはスナップショットが失敗した場合は、修復サブエージェント(agents/finalize.md)を1回のインプレース修正パスのためにディスパッチし、その後、失敗したゲートを再実行します。欠陥を隠すためにのみ純粋に固定の継続時間を変更しないでください。

ステップ 6 — 承認とレンダリング(Bash)

Studioを開き、1つの質問をします:「今レンダリングしますか、それとも何か変更しますか?」 修正後、同じゲートに戻ります:

(cd "$PROJECT_DIR" && npx hyperframes preview --background)

明示的なレンダリング応答があった場合のみレンダリングします:

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q high -o ./renders/video.mp4)
# 透明オーバーレイバリアント:--format webm (または mov)

出力が存在し、空でなく、意図された長さであることを確認します。最終的なハンドオフは、アーティファクト名、実際の長さ、コンポジションまたはフレームID、プルーフタイム、および検査されたコンタクトまたはスナップショットシートを示します。フラグは /hyperframes-cli → references/preview-render.md にあります。

再開テーブル

状態続行箇所
shot-plan.json なしステップ 1(計画)
shot-plan.json に asset_needs あり、assets/ なしステップ 2(ソース)
shot-plan.json 最終版あり、compositions/index.html なしステップ 3/4(デザイン+ビルド)
compositions/index.html 存在あり、プルーフスナップショットなしステップ 5(検証)
チェックとプルーフスナップショット合格、承認済みレンダリングなしステップ 6(承認)
承認済みレンダリング存在出力を検証し、報告

設計上の注意(メンテナー向け — 実行時はこれを読みません)

  • アセットファーストの比率

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

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.

関連スキル