Communitygithub.com

ChatCut-Inc/agent-plugin

CodexがChatCutプラグイン(chatcut MCPサーバー)を使用して、モーショングラフィックのJSXアセットを追加、作成、手動編集、パッチ適用、配置する際に使用します。リファレンスブラウジング、インラインJSX直接作成、編集可能プロパティ、アセットバインディング、タイムライン配置、構成済み検証をカバーします。

agent-plugin とは?

このスキルは、ChatCut プラグイン環境でモーショングラフィック (MG) アセットを作成・編集するための完全なワークフローを提供します。主に Codex と chatcut MCP サーバーを介したインライン JSX 直接作成を対象としており、ChatCut Desktop や Web エディタのネイティブエージェント機能に切り替えてはなりません。スキルは、プロジェクトのデザインスタイルの参照・選択から、インスタンスのマッチング、フォントの選定、編集可能プロパティの定義、タイムライン配置、構成検証までを網羅します。また、エディタのキャンバスサイズや FPS、競合などのプロジェクト状態を事前に確認し、実際のショットや発話内容に基づいて構成、位置、サイズ、読了時間を決定することを重視しています。さらに、アセットの分割(背景メディアとグラフィックの分離)やフォントの使用可否確認など、実践的な開発ルールも含まれています。

対応~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/ChatCut-Inc/agent-plugin/tree/HEAD/claude/skills/create-motion-graphics

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

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

ドキュメント

モーショングラフィックの作成

プラグインホストとプロジェクト

chatcut MCP サーバーと、ユーザーのエディタ URL またはプラグインのプロジェクト結果から取得したプロジェクト ID を使用します。このプラグインは Web エディタ(ローカル開発 URL を含む)で動作します。Web プロジェクトに対して ChatCut Desktop を開いたり、chatcut_desktop を使用したりしないでください。chatcut ツールが利用できない場合は、接続障害を報告してください。エディタのネイティブエージェントを代わりに使用しないでください。

デザイン前に MG リファレンスを確認する

ビジュアルディレクションをブラウズして確認する

プロダクションでは、承認済みのプロジェクトスタイルまたはユーザーが提供したブランド/リファレンスを再利用します。完全な仕様がまだわからない場合は、manage_design_style get を使用します。ルーチンのテキスト/配置編集には、新しいスタイル選択やカタログの再スキャンは必要ありません。

新しいディレクションが必要な場合、またはユーザーが代替案をブラウズしたい場合は、browse_library references: {view: "style-overview"} から始めます。nextOffset に従って、すべての番号付きコンタクトシートを読み、complete になるまで続けます。これらには、公開済みでエージェント対応のスタイル代表例が含まれており、リンクされた既存のデザインスタイルも含まれます。list_presets は従来のカタログサブセットにすぎません。このビジュアル概要の代わりにはなりません。失敗したページは再試行し、不完全な概要は黙ってスキップせずに報告してください。

スピーチ主導の動画の場合、スタイルを絞り込む前に、話された内容を理解し、代表的なビデオフレームを検査します。コンテキスト内にすでにあるトランスクリプトとフレームの証拠を再利用します。トピック、配信トーン、画面上の言語、フッテージの色、被写体のフレーミング、背景をスタイルプレビューとともに考慮します。

ビジュアルディレクションがまだ合意されていない場合は、現在のコンテンツとフッテージに合う最大6つの異なる候補を絞り込み、それらの hero 部分を読みます。ホストの widget-forms スキルをロードし、実際の heroPreview.url 画像を短い名前とともに表示します。ツールが返す画像はエージェントのための証拠であり、ユーザー向けのピッカーではありません。テキストのみの選択では視覚的な違いを示せません。各選択肢をリファレンス ID にマッピングしたままにします。フォームの Other ブランチを使用して、選択肢を繰り返したり、別の「Show more」オプションを追加したりせずに、好みや別のバッチを処理します。新しいスタイルを適用して MG を作成する前に、選択を待ちます。ただし、ユーザーがすでにディレクションを選択しているか、スタイル選択を明示的に委任している場合は除きます。Other の回答は受け入れとは見なされません。

選択したスタイルを適用する

選択した代表例の summary、hero、members を読みます。その designStyleAction に従い、manage_design_style を使用します。

  • apply_preset: 返された presetId を直接使用します。参照メタデータを保存するためだけにプリセットをクローンまたは更新しないでください。
  • apply: 既存の保存済みユーザースタイルのために返された designStyleId を再利用します。
  • create: 独立したリファレンスのみ、新しいユーザー所有スタイルが必要です。選択されたリファレンスから、そのパレット、フォント、再利用可能なビジュアルルールを定義して保存します。リファレンスの文書化されたパレットを再利用します。ない場合は、代表画像から一貫性のあるパレットを導き出します。designSpec.referenceSources: [{id: "<reference ID>"}] と個別の heroPreview.url を thumbnailUrl と designSpec.images: [{role: "style reference", url: "<heroPreview.url>"}] の両方に保存します。applyToProject: true を使用します。配列をパッチするときは既存の画像を保持します。

適用後、get を呼び出して最新の完全な仕様とソース ID を取得します。前のスタイルのキャッシュされたルールを引き継がないでください。新しいスタイルの場合、パレット、フォント、ソース、カバー、リファレンス画像が保存されたことを確認します。ソース ID だけでは画像は保存されません。リファレンス画像は視覚的な証拠であり、埋め込むフッテージ/背景や複製するコピーの例ではありません。

実際の画面上のテキストに応じて、fontRecommendations["zh-Hans"] / .en を使用します。バイリンガルテキストやラテン数字も含みます。承認されたフォント計画を再利用します。空の言語グループは未解決です。リファレンスのタイポグラフィックな特性と見出し/本文の階層に一致させ、グリフカバレッジとランタイムの可用性を確認します。選択したファミリー/ロールを designSpec.fonts に保存し、言語、ウェイト、イタリック、必要な軸を styleGuide に保存します。クロススタイルのフォーム例はこの計画の代わりにはなりません。不足しているフォントをキュレーションする場合、または明示的にタイポグラフィを適応させる場合のみ、フォントマッチング を読んでください。中国語のマッチングは生成された中国語エフェクト画像から始まり、英字の字形からではありません。

インスタンスを必要な MG フォームにマッチさせる

話されたコンテンツとターゲットフレームを使用して、どの MG フォームが役立つかを決定します。リファレンスプレビューでそれらの選択を洗練させます。動画全体で確認されたビジュアルランゲージを維持し、必要な各フォームに適したインスタンスを見つけます。ユーザーが比較を求めない限り、自分でインスタンスを選択します。異なるフォームは異なるインスタンスを使用できます。繰り返し使用するコンポーネントは、検査済みのインスタンスを再利用できます。返された場合は nextReferenceSearch に従います。

  • 関連メンバーがある場合、kind: "instance", styleId: "<representative UUID>" をブラウズするか、関連するメンバー ID を読みます。
  • 必要なフォームに適合するメンバーがない場合、styleId、facets.style、スタイル名の用語を省略して、コンテンツ/フォームの query または facets.form でインスタンスライブラリ全体を検索します。他のフォームがすでに同じスタイルのマッチを持っていても関係ありません。
  • カバーコラージュを比較し、選択した ID を parts: ["summary", "hero"] で読みます。アニメーションには motion、実装には code を追加します。コードバックアップのリファレンスが templateInspection を返す場合、その読み取り専用コールを使用して保存されたプロパティスキーマ/デフォルトを取得します。JSX は値を宣言せずに props を読み取る場合があります。legacyTemplateRefs はテンプレート ID です。manage_template get はメタデータを読み取り、list_assets は MG プロパティを読み取ります。どちらもテンプレートを適用またはコピーしません。inspect_asset は現在のプロジェクトのメディア/MG 用であり、カタログソース ID 用ではありません。

インスタンスの構成、階層、間隔、リビール構造を、固定されたプロジェクトフォント、パレット、マテリアル、実際のショットに適応させます。より広範なフォーム検索でも適合がない場合は、スタイルボードを拡張し、その制限を明記します。関連する詳細読み取りをバッチで行います。1つのインスタンスを見つけても、関連のないフォームをカバーするわけではありません。分割されたレスポンスには pendingIds に従います。known には返されたバージョンとまだコンテキスト内にある部分のみが含まれる場合があります。各モーションシートは、実際のタイムスタンプにおける1つのデザインです。モンタージュは1つのレイアウトではなく、静止画像はアニメーションを確立しません。

新しい/実質的に再設計された話し手オーバーレイの場合は、オーバーレイ構成 を読んでください。結果に表示される materials からのみプロダクションファイルをインポートします。それらのプロジェクトアセット ID を使用します。ターゲットフッテージで構成された MG をレビューします。

オーサリング時にリファレンスを使用する

実装を借用する場合は、選択したインスタンスの code を読みます。または、manage_template list_assets でリンクされたテンプレートプロパティを読みます。プロジェクトスタイルを維持しながら、以下のコードワークフローでリファレンスとして使用します。

選択した画像も検査します。URL、ID、または検索結果だけでは、閲覧されたリファレンスとはなりません。外観については STYLE の証拠を、構造についてはクロススタイルの FORM の証拠を保持します。選択したリファレンスが失敗した場合は、再試行するか、検査されたと主張せずに欠落した証拠を報告します。

このスキルは、ChatCut プラグインタスクでモーショングラフィックアセットをインライン JSX として作成またはパッチする必要がある場合に使用します。組み込みの ChatCut エージェントには独自の motion-graphic-gen ワークフローがあります。このプラグインタスクからそれに切り替えないでください。

Codex プラグインのモーショングラフィックは直接作成されます。新しい JSX アセットには create_motion_graphic_from_code を、既存の MG JSX には edit_asset を使用します。このサーフェスは submit_motion_graphic を提供しません。リクエストを Gemini プロンプトや生成ブリーフに変換しないでください。直接作成ツールがない場合は、停止して利用できない ChatCut プラグインツールを報告してください。

モーショングラフィックのソースは chatcut MCP ツールを介してインラインで渡します。ツールが直接インライン JSX を受け入れる場合、コードを ChatCut リポジトリ、ai-working/、/tmp、ローカル HTTP サーバー、生成されたコードファイル、または推測されたアプリケーションパスにステージングしないでください。

中核原則

  • キャンバスサイズ、FPS、既存のビジュアルランゲージ、配置、またはタイムラインの競合がまだわからない場合は、プロジェクトの状態を検査します。
  • JSX を作成する前に、コード作成前に 必要な入力を特定します。
  • 利用可能なインラインコードアセットワークフローを通じて、モーショングラフィックアセットを作成または更新します。正確なペイロード形状には現在のツールスキーマを使用します。
  • 編集にタイムライン配置が必要な場合は、タイムライン編集ワークフローを通じてアセットを配置または移動します。
  • 構造的または視覚的な変更後、プロジェクトの状態を再読み取りし、表示されるフレームを確認します。

コード作成前に

JSX を作成する前に、この編集に必要な情報のみを特定します。

  • 配置: 開始時間、期間、既知の場合はターゲットレイヤー、およびグラフィックが構成する必要があるターゲットフレーム。
  • 編集における役割: このモーショングラフィックが動画で実行する仕事。
  • コンテンツ: 表示されなければならない正確なテキスト、数値、メディア、または視覚的事実。
  • タイミング: 内部モーションを音声、音楽、または視覚イベントに同期させる必要があるかどうか。
  • ビジュアルソース: ユーザー提供のスタイル、プロジェクトのデザインスタイル、ブランドの色/フォント、または承認済みの既存のモーショングラフィック。
  • 編集可能フィールド: どのテキスト、色、数値、ブール値、画像、またはビデオ値をプロパティにする必要があるか。

結果を実質的に変更する可能性のある、欠落している影響の大きい入力についてのみ質問してください。

ビジュアルシステムと配置

上記で確認された完全なデザインスタイルと検査済みリファレンスを使用します。新しいカスタムディレクションの場合は、バッチ処理の前に1つの構成結果を確立します。承認されたディレクションとルーチン修正には、スタイルの再確認は必要ありません。

各構成、位置、サイズ、読了時間を、実際のショットと発話スパンから選択します。共有のタイポグラフィ、パレット、マテリアル、モーションを維持しながら、リファレンスのフォームをコンテンツに適応させます。固定の左/右アンカーまたはカードコンテナは、構成がそれを必要とする場合にのみ適切です。

同じ情報構造を持つ意図的に繰り返されるコンポーネントには、項目ごとのプロパティを持つアセットを再利用します。新しい構造には、独自のインスタンスリファレンスと構成が必要です。オーバーレイの境界はグラフィックをしっかりと囲む必要があります。タイムラインの寸法は、フレームにまたがって表示されるデザインにのみ使用します。

アセットの期間と内部ビートを、配置されたタイムラインスパンに一致させます。タイミングが実質的に変更された場合は、未完了のアニメーションを切り詰める代わりに MG を更新します。バッチの場合は、構成された確定フレームを並べてレビューし、競合、可読性、意図しない繰り返しを修正してから、完了を報告します。

編集可能なプロパティ

ユーザーに表示される可能性が高く、変更される可能性のある値を編集可能なプロパティとして公開します。

  • 表示テキスト、主要色、アクセント色、主要な数値はプロパティにする必要があります。
  • フォントの選択は、ユーザーが合理的に変更する可能性がある場合は font プロパティにする必要があります。
  • 画像とビデオのソースは image / video プロパティにする必要があります。
  • コードキーはプロパティスキーマキーと正確に一致する必要があります。
  • 値を item.props から読み取ります。ユーザーが後で合理的に変更したい可能性のある表示コンテンツをハードコードしないでください。
  • 項目レベルのプロパティオーバーライドは、同じビューアタスク、情報構造、視覚形式を持つ意図的に繰り返されるコンポーネントにのみ使用します。それらのいずれかが異なる場合は、別の MG アセットを作成し、代わりにパレット、タイプ、モーションロジックを共有します。

プロパティエントリは、安定したキー、ユーザー向けラベル、タイプ、デフォルト値を宣言する必要があります。サポートされるプロパティタイプには、text、number、color、boolean、select、font、image、video が含まれます。

フォント

モーショングラフィックは、ChatCut のレンダラーが利用できるフォントを使用する必要があります。これにより、プレビューとローカルエクスポートの一貫性が保たれます。STKaiti、PingFang SC、Microsoft YaHei、Arial、Helvetica、Comic Sans MS、system-ui、-apple-system、または一般的な CSS ファミリーなどのマシン固有のシステムフォントを主要なレンダリングフォントとして依存しないでください。可用性はマシン間で異なり、フォールバックが発生する可能性があります。

フォントを選択または置換する場合、search_fonts を呼び出し、返された正規のファミリー名をそのまま fontFamily 値と一致する font プロパティ defaultValue として使用します。カタログによって返された Google フォントまたはプロジェクトカスタムフォントを使用します。要求されたマシン固有のフォントがカタログにない場合は、一貫したローカルレンダリングが保証できないことを説明し、同様の雰囲気を持つサポートされている代替フォントを検索し、ユーザーが明示的にフォントフォールバックを受け入れない限りそれを使用します。

アセットと構成

1つのリファレンスインスタンスが、複数のタイムラインアイテムからなる完全な構成を記述する場合があります。これは1つの自己完結型 MG アセットを意味するわけではありません。リファレンススクリーンショット、プロダクションマテリアル、現在のプロジェクトのフッテージを区別してください。

デフォルトでは、デザインが通常のメディアとグラフィックを組み合わせる場合、個別のアイテムを使用します。

  • 再利用可能なペーパー/テクスチャ/背景: 構成の背後にある画像またはビデオアイテム。
  • 現在のプロジェクトの写真、商品画像、またはフッテージ: それ自身のメディアアイテム。エージェントが選択/置換、トリミング、配置、サポートされているエフェクトの適用を行います。ユーザーが手動でレイヤーを組み立てることは想定されていません。
  • タイポグラフィ、シェイプ、アニメーション装飾: 透明な MG アイテム。メディアがそれらの間にある必要がある場合は、背景の装飾を前景のテキストから分割します。

オーサリング前に、レイヤー順序、ターゲットメディア矩形、開始/期間、エントランスタイミングを計画します。MG のブリーフ/コードスコープで、どのレイヤーが MG の外部にすでに存在するかを明記し、リファレンスの写真やペーパーが再生成されないようにします。白黒/カラー/グレインを、誤って前景テキストに影響を与えずに、意図したメディアアイテムに適用します。実際の再生/エクスポートサーフェスでのエフェクトサポートを確認します。レイヤーを分割するだけでは、Web/Desktop のパリティを証明できません。

  1. browse_assets から現在のプロジェクト内のアセットを再利用します。出力に必要なプロダクションファイルのみをマイアセットにインポートします。asset-import をロードし、その import_media セッション/アップロードヘルパーを使用します。プロジェクトメディアを登録しても、公開リソースライブラリに公開されるわけではありません。
  2. 通常のプロダクションメディアは edit_item を通じて配置し、返された現在のプロジェクトアセット ID を使用します。エージェントは、リファレンスの人物、コピー、データを現在のタスクのコンテンツに置き換える処理を担当します。リファレンスの完成したフレームからコピー/値を派生させないでください。リファレンスは構造と構成のためのものです。
  3. 場所を示すものまたはメディアプレースホルダーを作成しないでください。実際のフッテージとプロダクションアセットを使用します。

タイムライン配置と編集

既存のレイヤーの開始時間、期間、ターゲットを編集するには、edit_item を使用します。MG を特定の時間に配置するには、place_motion_graphic を使用します。動画全体の再構成を避けながら、結果のフレームを近似するために、矛盾を解決してからツールを呼び出します。

テキストレイヤーは、編集可能なテキストコンテンツとプロパティを持つ単一のアイテムとしてレンダリングされます。編集のために下位のテキスト行を個別のレイヤーに分割しないでください。

検証

グラフィックが意図したとおりに表示されていることを確認してください。 最終フレームを検査して、次のことを確認します。

  • すべてのテキストが存在し、読みやすく、正しい(話されたコンテンツに一致する)こと。
  • 色が選択されたパレットに従っていること。フォントが正しいこと。
  • タイミングが予想どおりであること。
  • 構成が、その下にあるフッテージと適切に調和していること。
  • 1人以上の話し手のオーバーレイが互いにオーバーラップしたり、重要なビジュアルを覆い隠したりしないこと。
  • アニメーションがスムーズにループまたは完了すること。
  • 編集可能なプロパティが必要に応じて公開されていること。

最終チェックの前に、get_composed_frame や関連する読み取り操作を使用して、構成されたフレームを実際に検査してください。

よくある間違い

  • リファレンス画像に依存し、実際のフッテージでテストしない。
  • 最初のインスタンス候補のみを検査する。
  • 画面に収まらない長いテキストを切り詰めない。
  • ユーザーに選択肢を提示せずにスタイルを適用する。
  • フェイルオーバーとしてネイティブエディタ MG に切り替える。
  • モーショングラフィックのプロパティを宣言しない。
  • プロジェクトアセットの代わりに URL を使用する。
  • タイムライン配置なしで MG を作成する。
  • 話された内容に合わせて内部タイミングを調整しない。
  • 構成されたフレームを検査しない。

Individual skills in this repo

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

関連スキル