Communitygithub.com

モーショングラフィックス — ディスパッチエントリ

短い、デザイン主導のモーショングラフィック(キネティックタイポグラフィ、数値カウントアップ、チャート/データ可視化、ロゴスティング、ブランドロックアップ、ローワーサード、コールアウト、ソーシャルオーバーレイ、アニメーションヘッドライン/ツイート/ニュースアイテム、モーションポスター、またはページハイライト)を作成します。通常10秒未満、最大約30秒で、ナレーションやナレーションアークはありません。

モーショングラフィックス — ディスパッチエントリ とは?

このスキルは、デザイン主導でナレーションのない短いモーショングラフィック動画(主に10秒未満、最大約30秒)を作成するためのものです。メッセージ自体が動きによって伝えられるような作品(キネティックタイポグラフィ、数値カウントアップ、チャート/データ可視化、ロゴスティング、ブランドロックアップ、ローワーサード、ソーシャルオーバーレイ、アニメーションヘッドライン/ツイート/ニュースアイテム、モーションポスター、キャプチャしたページのハイライトなど)に最適です。MP4または透明オーバーレイとしてレンダリングできます。長尺、複数シーン、ナレーション付き、ブランドリール、ナレーション付きウェブサイト動画、トピック解説、製品プロモーション、PR動画、既存映像へのキャプション追加などには使用しないでください。Unsureの場合は、`/hyperframes`を参照してください。 このスキルは、アセットファーストのアプローチを採用しています。まずアセット戦略を決定し実際の素材を入手してから、それに基づいてショットを設計し、カタログ機能を再利用して構成します。フローは、初期化(Bash)、計画(サブエージェント)、ソーシング(Bash、必要な場合)、設計(サブエージェント)、構築(サブエージェント、再利用優先)、レンダリング(Bash)、検証(Bash)、そしてレポートで構成されます。このスキルは、Cursor、Codex、Claude CodeなどのAIエージェントプラットフォームで使用するために設計されています。

対応~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/MatheusEdson/RepoSkillLaxtro/tree/HEAD/skills/HyperFrames/motion-graphics

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

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

ドキュメント

モーショングラフィックス — ディスパッチエントリ は何をしますか?

ステップ0の前にルートを確認してください。 このスキルは、短く、デザイン主導で、ナレーションのないモーショングラフィック(動きがメッセージであり、約10秒未満、音声なし)を作成します。長尺、複数シーン、またはナレーション付きの作品 → /general-videoへ。ウェブサイトのナレーション付き動画 → /website-to-videoへ。トピック解説 → /faceless-explainerへ。製品プロモーション → /product-launch-videoへ。既存映像へのキャプション追加 → /embedded-captionsへ。対象外: ライブ/レンダリング時のデータ、またはキャプチャできない映像。動画ファーストかナレーション付きか不明な場合?最初に /hyperframes を読んでください。

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

フェーズ実行主要成果物詳細フロー
initBashhyperframes.jsonステップ0
planサブエージェント — 検索の必要性を判断 + 分類 + アセット戦略shot-plan.json(ドラフト: カテゴリ、asset_needs クエリ、ブリーフ)agents/director.md(パート1)
source ◇Bash — メディア利用解決(asset_needs が空の場合はスキップ)assets/ + assets/index.mdphases/source/guide.md
designサブエージェント — 解決済みアセットを中心としたショット設計shot-plan.json(最終版: ブロック + レイアウト + モーション + 位置)agents/director.md(パート2)
buildサブエージェント — 再利用優先の構成compositions/index.htmlagents/builder.md
renderBash — hyperframes render(MP4、またはオーバーレイの場合は --format webm/mov)renders/video.mp4ステップ5
verifyBash — lint / inspect -> 失敗時に修復サブエージェント(その場で修正)agents/finalize.md

◇ 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-* + レジストリオーバーレイブロック

検索駆動カテゴリ — 最初に検索し、コンテンツのタイプに応じてアニメーション化(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。

オプションキー(未設定の場合はローカルフォールバック)— メディア利用を介してアセットをソーシング/生成するカテゴリでのみ必要:

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

フロー

ステップ 0 — 初期化

カレントワーキングディレクトリはエージェントワークスペースルート。すべての成果物を 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 --skip-skills --example=blank

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

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

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

  1. 判断: これには検索が必要か?(最初の分岐)
    • いいえ → フォームカテゴリ(kinetic-type / stat / charts / logo-reveal / lower-thirds)を選択。コンテンツはユーザー提供。asset_needs: []。
    • はい → 検索計画を asset_needs[] に出力(ニュース / ウェブ / ツイート / 画像。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: メディア利用、条件付き)

shot-plan.json.asset_needs が空でない場合、アセットを解決します(検索 / 生成 / フェッチ → 凍結されたプロジェクトローカルパス + 台帳)。phases/source/guide.md を参照(media-use resolve をラップ。検索駆動カテゴリはニュース/ウェブ/ツイート/画像検索を使用)。asset_needs が空の場合、ステップ3にスキップします。

# 説明用 — phases/source/guide.md を参照
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)

優雅に劣化: 検索/プロバイダーが利用できない場合、カテゴリはアセットフリーにフォールバックします(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 — 構築(サブエージェント: ビルダー、再利用優先)

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

ステップ 5 — レンダリング(Bash)

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

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

(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)

exit 0 → 完了。lint/inspectエラー時は、修復サブエージェント(agents/finalize.md: スナップショットQA + 1回のその場修正パス + 再レンダリング)をディスパッチします。修復中に固定された期間を変更しないでください。

レポート + オプションのプレビュー

最終出力(renders/video.mp4、または .webm / .mov オーバーレイバリアント)+ 期間を報告します。実行中にプレビューを開かないでください。 リクエストがあった場合のみ提供し、最終ファイルを提供できるようにレンダリング後に開始します:

(cd "$PROJECT_DIR" && npx hyperframes preview)   # Studio UI; 共有可能なリンクの場合は `npx hyperframes play`

フラグは 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 が存在し、renders/video.mp4 がないステップ5(レンダリング)+ ステップ6
renders/video.mp4 が存在するレポート + 停止

設計ノート(メンテナー向け — 実行時はこれは読みません)

  • アセットファーストの根拠: ソーシングはフロントロードされ、ショット設計に情報を提供します(RWAフロー: 分析 → 検索 → レビュー → 構成)。検索駆動カテゴリ(webpage/news/tweet)と asset-fusion はどちらもメディア利用検索(ニュース/ウェブ/ツイート/画像)に依存しており、これはメディア利用の文書化されたRWA系統です。
  • 再利用優先: エコシステム内でのLLM生成テンプレートの類似物は、「カタログブロック + hyperframes-animation ルールを構成する」です。HFの一時停止されたGSAPタイムラインは、Remotionの useCurrentFrame に相当します。
  • カテゴリモジュール契約: 1つの categories/<id>/module.md(計画 + ビルド)、references/motion-vocabulary.md を共有(+ オプションの評価)。カテゴリの追加 = フォルダをドロップ + agents/director.md にその分類子行を登録 + catalog-map.md にその行を追加。フェーズパイプラインは変更されません。
  • ディレクトリ構造:
    videos/<project-name>/
      hyperframes.json  context.log
      shot-plan.json            # IR(ディレクター出力)
      assets/  assets/index.md  # メディア利用出力(ソーシングされた場合)
      compositions/index.html   # ビルダー出力
      renders/video.mp4
    
  • 登録: hyperframes ルーター内 — 「デザイン主導の短いモーショングラフィック」インテント + ワークフロー説明を追加。/general-video からモーショングラフィックスのトリガーを切り出す。逆の「使用しない」エッジを追加。motion-graphics-genre.md §5-7を参照。

関連スキル