Communitygithub.com

shutckin/aivfx-content-kit

HyperFramesエンジン(HTMLシーンを動画にレンダリング)上でモーショングラフィックスを作成します。名前のテロップ、チャプター、数字、Shorts/Reelsのフック、エンドカード、タイトルなどをAIVFXスタジオレイヤーで制作。ブランド(色、フォント、モーション、時間)は1つのファイルに集約され、動画はシーンロールのブリーフで構成、モーションは自然言語で指定され、エージェントがフッテージ上のドラフトとアルファチャンネル付きの最終ProRes 4444をレンダリングします。タイミングルール、9:16・16:9のセーフゾーン、リント・黒フレームチェック、納品チェックリスト、ブランドファイルチェッカーを備えています。

aivfx-content-kit とは?

このスキルは、HyperFramesエンジンをベースにしたモーショングラフィックススタジオです。HTMLシーンを動画にレンダリングし、名前テロップ、チャプターカード、数字表示、Shorts/Reelsフック、エンドカード、タイトルなど、動画制作に必要なグラフィックスを体系的に生成します。ブランド設定(色、フォント、モーション、余白)は1つのbrand.jsonファイルに集約され、動画はシーンロールのブリーフ(scenes.json)で構成されるため、一貫性が保たれます。エージェントはブリーフから自動的にHyperFramesのコンポジションを生成し、ドラフトレンダリング(MP4)とアルファチャンネル付きの最終レンダリング(ProRes 4444)を実行。さらに、ffmpegを使用したフッテージ上のプレビュー、黒フレーム検出、コントラスト・フォントサイズのチェックなど、品質管理機能も内蔵。Claude CodeやCursor、CodexなどのAIエージェントプラットフォームで動作し、動画編集のワークフロー全体を効率化します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shutckin/aivfx-content-kit/tree/HEAD/skills/motion-graphics

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

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

ドキュメント

動画用モーショングラフィックス

指示は日本語で記述されています。ユーザーの言語で応答してください。

なぜ必要なのか

テロップやグラフィックを1つずつ「目視」で作成すると、3つ目にはバラバラになります。あるテロップは下から0.5秒で入り、別のものは横から1秒、フォントは2ポイント大きく、アクセントカラーも異なります。視聴者は言葉にしませんが、動画は他人の作品を寄せ集めたように見えます。

このモーションスタジオはHyperFramesをベースに構築されており、スタジオはそれを自社のファクトリーに拡張しています。ブランドに関する決定は1回だけ行われ、ファイルに記録されます。動画はシーンロールのブリーフで記述され、エージェントがブリーフをコンポジションに変換してレンダリングします。新しいテロップは、たとえ別のエージェントが1ヶ月後に作成しても、他のものと統一されます。

動作環境

ツール役割入出力
HyperFramesエンジン:シーンはHTMLコンポジション、動画にレンダリング、独自チェック機能HTML, CSS, GSAPタイムライン → MP4, WebM, またはアルファ付きMOV ProRes 4444
Claude Code(または類似品)エージェントがブリーフからシーンを組み立てるブリーフ + ブランドファイル → コンポジション、レンダリング、チェック
ブランドファイル色、フォント、モーション、余白を一元管理brand.json → 各シーンの数値
ffmpegフッテージ上のドラフト、フレームリスト、黒フレーム検出アルファ付きシーン + 動画フレーム → プレビューとフレームリスト
ProRes 4444編集用の透明背景の最終出力アルファチャンネル付きMOV
DaVinci Resolve(または類似:Premiere、Final Cut)編集、グラフィックを動画の上に配置フッテージの上のトラックにMOV ProRes

エージェントは計画、ブリーフ、コンポジションを作成し、チェックを実行します。所有者は計画とドラフトを承認します。テキスト(名前、数字)は所有者またはクライアントが提供します。

HyperFrames はHeyGenのオープンソースエンジンです:https://hyperframes.heygen.com。 コンポジションは、時間用の data-* 属性、アニメーション用のGSAPタイムライン、スタイル用のCSSを持つHTMLファイルです。Node.js 22以降とffmpegが必要です。

HyperFramesが提供するものスタジオが追加したもの
トラックとシーンタイミングを持つHTMLコンポジションブランドファイル:色、フォント、モーション、余白;レンダリング前にブランドルールを出力
hyperframes init、ブラウザスタジオでのpreview各コンポジションを手動で作成する代わりに、シーンロールによる動画ブリーフ
hyperframes render:MP4、WebM、透明背景付きMOV ProRes 4444(--format mov)、--quality draftロールとテンプレートのライブラリ:ロールは特定ブランドのテンプレートに変換され、1つのブリーフで任意のブランドスタイルを適用可能
hyperframes lint、check、validate:マークアップとタイムラインのエラー、ブラウザエラー、欠落ファイル、テキストのコントラスト黒背景ではなく実際のフッテージ上のドラフトとコンタクトシート
hyperframes add:レジストリからの既製ブロックとエフェクトドラフトと最終出力の黒フレーム比較、黒フレーム検出
hyperframes doctor:環境チェックcheck_brand.py:最初のシーンの前にブランドファイルをチェック
--docker:異なるマシンでも同一結果コンポジションに埋め込まれたローカルフォントとローカルGSAP、シーン別のファイル名

以下の原則は、コードを動画に変換する他のエンジンにも適用できます。

いつ使用するか

動画内のグラフィック(スピーカー名、チャプター、数字、エンドカード)、Shorts/Reelsのフック、編集用の透明オーバーレイ、グラフィック用の新しいブランド。

独自のストーリーを持つ10〜25秒のフルスクリーンプロモーション動画には使用しないでください。音楽のテンポに合わせたストーリーボード、動画ごとに1つの独自コンポジションが必要であり、シーンロールは邪魔になります。動画のストーリーボードは shot-list、記事の表紙は article-cover、生成フレームのスタイルは film-look が担当します。

3つのファイルで1つの大きなファイルの代わりに

  1. ブランドファイル brand.json:色、フォント、テキストサイズ、モーションディクショナリ、ロールの持続時間、余白、セーフゾーン。ブランドごとに1つ、変更は稀です。架空のブランドと各フィールドのコメント付きサンプル:templates/brand.example.json。
  2. 動画ブリーフ scenes.json:ロール別のシーンリスト。意味とテキストのみ、色もモーションの数値もありません。サンプル:templates/scenes.example.json。
  3. ロールテンプレート:各ロールに1つのHyperFramesコンポジションで、ブランドとシーンを読み込んで数値を代入します。独自テンプレートは自分で作成しますが、ロールごとに少量の作業です。良い出発点:hyperframes init と hyperframes add によるレジストリの既製ブロック。

最も重要なルール:1つのシーンにのみ必要な色、フォント、または速度がブランドに記録されていない場合、それは警告です。ブランドに追加するか、破棄するかのどちらかです。「ここだけ」の調整こそがシステムを崩す原因です。新しいタイプが必要な場合:共通テンプレートを1つのプロジェクト用に変更するのではなく、新しいテンプレートを作成します。

ブランドファイルの設定方法

  1. templates/brand.example.json をプロジェクトに brand.json としてコピーします。
  2. ブランドのウェブサイトやガイドラインから色を取得します。ガイドラインがない場合:所有者に背景、メインテキスト、アクセントを尋ねます。クライアントの代わりにブランドカラーを考案しないでください。
  3. 各色に1つの値を割り当てます:背景、テキスト、2行目、アクセント。色の目的を説明できない場合、その色は不要です。アクティブカラーは最大5つまで。
  4. フォント:見出しと数字用に1つ、キャプション用に1つ、または1つで全てをカバー。サンセリフまたはセリフのみ。等幅フォントやピクセルフォントは、数字、日付、ラベルを含めどこでも使用しません。数字は幅が均等なサンセリフで設定:CSSで font-variant-numeric: tabular-nums を使用。カウンターが跳ねなくなります。
  5. フォントはコンポジションに埋め込みます(プロジェクトのファイルとして、またはCSSに直接)。インターネット上のフォントはレンダリング時に読み込めない可能性があり、フレームがシステムフォントで出力されます。GSAPも同様にローカルに保持し、ネットワーク読み込みはレンダリング中に失敗する可能性があります。
  6. rules にブランドの制限を言葉で記録します:アクセントの使用方法、新しい色の導入の可否、事実の出典。エージェントは各ビルド前にこれらを読み取ります。そうしないと、セッション間で失われます。
  7. チェックを実行します:
python3 scripts/check_brand.py brand.json

スクリプトは必須フィールド、16進数以外の色、テキストと背景のコントラストが4.5:1未満、等幅フォントやピクセルフォント、1080フレームで28ピクセル未満のテキスト、妥当な範囲外の持続時間、プラットフォームのインターフェースをカバーしないセーフゾーンをチェックします。違反がある場合、終了コード1を返します。

シーンロール

テンプレートではなくロールを記述します。ロールはシーンの目的を示し、テンプレートはブランドが選択します。ブランドを変更すると、ブリーフを書き換えることなく、同じロールが別のスタイルで構築されます。

ロール目的フィールド背景持続時間
hookShortsの最初の1〜3秒、視聴者を引き留めるtitle(3〜6語)、subtitle(任意)独自、フルフレーム2〜3秒
nameフレーム内の発言者title(名前)、subtitle(肩書き)透明3〜5秒
chapter意味ブロックの切り替えlabel(番号)、title独自または透明2.5〜4秒
number覚えておくべき1つの数字value、unit、note透明3〜4秒
endcard最後:名前、サイト、次のアクションtitle、meta、ロゴ独自、フルフレーム4〜6秒

短い事実、コーナーノート、区切り文字付きリストもロールになることがあります(fact、note、list)。同じタスクが2回目に発生したときに新しいロールを作成します。1つのシーンだけのためではありません。

フレーム内の位置 at:bl、br、tl、tr、left、right、center。 名前テロップはほとんどの場合、スピーカーの視線と反対側の左下に配置します。

テキストはブリーフからのみ取得します。名前、肩書き、数字、アドレスは創作しません。データがない場合は尋ねます。テロップの姓の間違いはすべての視聴者に見えます。

言葉でモーションを指定

シーン内のモーションは、プログラマーではなく監督のように記述します:

アクセントラインが左から描かれ、その後に名前が上がり、役職が続いて現れます;保持;全てが1つの動きで下に消えます

エージェントはこれをブランドの数値とGSAPトゥイーンに変換します:「上がる」は motion.travel_px の移動、motion.enter_sec の時間、減速 ease_enter、「続いて」は stagger_sec の待機時間、「消える」は exit_sec です。説明に必要な単語がない場合は、ブランドのデフォルトを使用し、速度を考案しないでください。

  • 1シーンに1つのアイデア。 シーンが2つのことを伝える場合、それは2つのシーンです。
  • まず最終フレーム、次にモーション。 すべてが配置された瞬間のシーンをデザインし、その後で入場と退場を追加します。これにより、レンダリング前にオーバーラップを確認できます。
  • 入場は退場より遅く。 出現は減速、退場は加速で約2倍速く。視聴者は入場を追い、退場は必要ありません。
  • 動画全体で1つの方向。 下から入り、同じ軸で下または上に消えます。方向の混乱は編集ミスとして認識されます。
  • シーン内で2つ以上のテクニックを使用しない。 移動とフェードで十分です。回転、バウンス、ぼかしを同時に使用すると、エンジンのデモリールのようになります。
  • 短い距離、要素は順番に。 30〜60ピクセルの移動は高級に見え、画面半分の移動は安っぽく見えます。ライン、次に名前、次にキャプション。
  • フックは単語ごとに、文字ごとではありません。 文字ごとは遅く、読みにくくなります。
  • 最後は静止 して3〜4秒保持します。そうしないと読む時間がありません。
  • コードにランダム性を含めない。 乱数や現在時刻は、レンダリングごとに異なる画像を生成します。ばらつきは要素番号から計算式で取得します。

タイミングとスマートフォンでの可読性

  • テキストは完全に表示された後、少なくとも min_hold_sec 秒間静止して保持されます。
  • 読む時間:1単語あたり約0.3秒+入場時間。6単語のテロップは3秒未満では不十分です。
  • 適度なテキストサイズ。画面全体の巨大な見出しは叫んでいるように見えます。
  • 短辺1080ピクセル:見出し64〜110、キャプションは40以上、ラベルは28以上。スマートフォンではこれより小さいと読めません。
  • 1行は25〜30文字以内。長い場合は意味で分割し、幅で分割しないでください。
  • フッテージ上のテキストには常に背景、影、または暗転を使用。コントラスト4.5:1は空の背景ではなく、その背景に対して計算します。
  • アクセントは1つの単語または1つのラインに。アクセントで塗りつぶされた段落は読めません。
  • シーンのタイムラインはそのスロット全体を埋める必要があります。最後にシーン全体の長さの空のトゥイーンを追加します。そうしないとHyperFramesがシーンを早期に非表示にし、動画に黒フレームが表示されます。

セーフゾーン

プラットフォームは画面の一部をインターフェースで覆います。短辺1080のフレームの数値。最新のプラットフォームのスクリーンショットで再確認してください。

9:16(1080x1920、Shorts、Reels、TikTok): 上部約250ピクセル(ニックネーム、ボタン)、下部約400ピクセル(キャプション、音楽、進行状況)、右側約140ピクセル(いいね、コメント)、左側約60ピクセル。フックと重要なテキストは中央の帯に配置。縦向きの名前テロップは通常より高く配置します。

16:9(1920x1080、YouTube、横長編集): 両側約96ピクセル、上部54ピクセル、下部約96ピクセル。最後の5〜20秒でYouTubeはエンドカードを配置するため、エンドカードはそのスペースを考慮して作成します。

ゾーンはブランドファイルに保存され、シーンはドラフトフレームにフレームを重ねてチェックします。

レンダリング

  • ドラフト: hyperframes render --quality draft、最終よりもはるかに高速。すべてのチェックに使用し、最終レンダリングは1回のみ。
  • 通常の動画(MP4、H.264): フック、最終カード、およびフルフレームで表示されるすべてのもの。アルファはファイルを重くするだけです。
  • 編集用の透明背景: フッテージ上のテロップ、チャプター、数字。HyperFramesはDaVinci Resolve、Premiere、Final Cut用にアルファ付きMOV ProRes 4444(--format mov)をレンダリングし、ウェブ用にはアルファ付きWebM(--format webm)を提供します。MP4はアルファを保存しません。編集用のフルフレームグラフィックスはffmpegでProRes 422 HQに変換でき、軽量です。
  • グラデーションのバンディング対策:軽いノイズ(texture.grain)とProResマスター。
  • PNGでのフレームキャプチャを有効にしない(--video-frame-format png):スタジオのチェックでは、暗い部分が黒くつぶれる可能性があります。
  • ファイル名はシーンごとにラテン文字で:name-01-sokolova.mov。

最終レンダリング前のフッテージ上のドラフト

黒い背景ではすべてが正常に見えます。問題は実際の画像でのみ明らかになります:テロップが顔を覆う、白いテキストが窓に消えるなど。

  1. 透明背景でドラフト品質のシーンをレンダリング。
  2. ffmpegがそれらを実際の動画のフレームまたはクリップに重ね(ブリーフの preview_bg:ファイル、動画、またはフレームフォルダ、シーンに順番に割り当てられます)、1つのプレビューに結合。
  3. コンタクトシート:各シーンの開始、中間、終了を1つの画像に。
  4. 目視確認と、番号付きシーンリストを所有者に見せて、一言で回答を得る。lintを通過してもデザインが機能するとは限りません。

チェック

  • 新しいテンプレートごと、表示前に hyperframes lint。hyperframes check(lint、ブラウザエラー、配置、テキストコントラストを1回で実行)、hyperframes doctor(レンダリングがクラッシュする場合)。Lintは実際のバグをキャッチします:開始時に透明度がゼロの全画面レイヤーは最初のフレームを露出オーバーにします;translate(-50%,-50%) による中央揃えが y のトゥイーンと組み合わさると最後にずれるため、flexラッパーで中央揃えにします。
  • ドラフトと最終出力の黒フレーム検出:ffmpegがフレームの明るさを抽出、完全に黒いフレームは欠落したシーンまたはフリーズした動画を示します。コンポジション内の各動画には固有の id が必要です。そうしないとフレームがフリーズします。
  • ドラフトと最終出力の黒フレーム比較:黒くつぶれたピクセルの割合が増加しないことを確認。

作業手順

  1. ブランド:brand.json はありますか?ない場合は作成し、スクリプトでチェック。
  2. 計画:ロール、テキスト、フォーマット、持続時間を含む番号付きシーンリスト。動画ではなく計画を表示:
ブランド:Fjord Lab、16:9、テロップはアルファ

01. name / bl / アルファ:「マリア・ソコロワ」・「音響エンジニア」、4秒
02. chapter / アルファ:「第2章」・「私たちが静寂を書く方法」、3秒
03. number / right / アルファ:48時間・「1つのエピソードの録音」、3.5秒
04. endcard / MP4:「Fjord Lab」・fjordlab.example、5秒
  1. 承認された計画に基づいて scenes.json ブリーフを作成。
  2. ロールごとにコンポジションを作成、hyperframes lint を実行。
  3. フッテージ上のドラフト、コンタクトシート、黒フレーム検出、表示。
  4. 修正は言葉で(「3番目を短く」「名前を大きく」)ブリーフに反映、共通のもの(「すべてのテロップを遅く」)はブランドに反映。
  5. 最終レンダリング、透明シーンはProRes 4444、ドラフトとの比較、編集用フォルダにファイルを出力。

よくある間違い

  • シーン内に直接色や速度を記述。 5つの動画後、プロジェクトに5つの異なるアクセントが存在します。視覚的なものはすべてブランドのみに。
  • フラットな背景でのグラフィック評価。 テロップは「完璧に見える」が…

...

Individual skills in this repo

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

shutckin/aivfx-content-kit

Runs a client AI video for a concept studio from brief to delivery. Takes the brief and real product photos, writes a synopsis, builds character and location sheets with 3 options each, a 16:9 approval deck, stills in waves, one prompt for the whole video, client revisions as a list, assembly and a delivery checklist. Core rule: the client approves the preproduction package before the first video frame, and the approved character and location sheets go as references into every generation. Use when a brief arrives for an advertising or product AI video. Triggers: 'client AI video', 'preproduction package', 'character sheet', 'location sheet'. Not for articles or covers (use blog-article and article-cover). Triggers (RU): «вот бриф», «новый клиент», «концепт студия», «препродакшн-пакет», «лист персонажа», «лист локации», «презентация клиенту», «правки от клиента», «готовим сдачу».

shutckin/aivfx-content-kit

Packages YouTube videos and Shorts: a pack of 3-4 thumbnail variants of one idea for choice and A/B testing, title and thumbnail as one unit, one idea per image, face and emotion, a large object, text up to 3-4 words or none, readable on a small phone screen. Works from own frames and screenshots plus references, generates or refines the frame with models (Nano Banana, Seedream, GPT-Image, Higgsfield and others) with the film-look style and logos in one pass, keeps a consistent channel series, checks the file with a script (size, weight, name), reviews the small view by eye on a contact sheet and shows options to the owner before upload. Triggers: 'YouTube thumbnail', 'video packaging', 'thumbnail A/B test', 'Shorts cover', 'title and thumbnail'. Triggers (RU): «сделай превью», «обложку для ролика», «обложку для YouTube», «упакуй ролик», «варианты для A/B-теста», «заголовок и превью», «обложку для Shorts», «серия превью для канала».

関連スキル