プラグインインストール: セットアップまたはフレッシュネスコマンドの前に、このスキルが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で作成)に格納されます。以下のパスはすべて、このディレクトリからの相対パスです。
| フェーズ | 実行 | 主なアーティファクト | 詳細フロー |
|---|---|---|---|
| init | Bash | hyperframes.json | ステップ0 |
| plan | サブエージェント — 検索するか決定 + 分類 + アセット戦略 | shot-plan.json (ドラフト: カテゴリ, asset_needs クエリ, ブリーフ) | agents/director.md (パート1) |
| source ◇ | Bash — media-use 解決 (asset_needsが空の場合はスキップ) | assets/ + assets/index.md | phases/source/guide.md |
| design | サブエージェント — 解決済みアセットを中心にショットをデザイン | shot-plan.json (最終: ブロック + レイアウト + モーション + 位置) | agents/director.md (パート2) |
| build | サブエージェント — 再利用ファーストで構成 | compositions/index.html | agents/builder.md |
| verify | Bash — lint, check, プルーフスナップショット; 失敗時は修復 | snapshots/contact-sheet.jpg | ステップ5 |
| approve | プレビューを開き、レンダリングまたは変更を尋ね、回答を待つ | 明示的なレンダリング承認 | ステップ6 |
| render | Bash — 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)です。これにより、以下のことを行う必要があります:
- 決定:これには検索が必要か?(最初の分岐)
- いいえ → フォームカテゴリ(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で確定されます。
- いいえ → フォームカテゴリ(kinetic-type / stat / charts / logo-reveal / lower-thirds / maps)を選択します。コンテンツはユーザーが提供します。
- ドラフト
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(承認) |
| 承認済みレンダリング存在 | 出力を検証し、報告 |
設計上の注意(メンテナー向け — 実行時はこれを読みません)
- アセットファーストの比率