Communitygithub.com

motion-render

モーショングラフィックスのレンダリング、納品、ブランド変更を実行します。プリセット、出力バージョン管理、検証・フリーズ・最終ファイルコピーを含む納品ワークフロー、および納品済みプロジェクトへのブランド変更適用をサポートします。

motion-render とは?

このスキルは、モーショングラフィックス(MG)プロジェクトのレンダリング、納品、およびブランド変更(リブランド)を効率的に行うためのツールです。主にCLIコマンド(pnpm mg)を介して操作し、プロジェクトの検証、様々なプリセット(オーバーレイ、配信用、WebMアルファ)でのレンダリング、変更の追跡とバージョン管理、納品時の検証・フリーズ・ファイルコピーを自動化します。特に、納品済みプロジェクトに対してクライアントのブランド変更(カラーパレット、フォント、ロゴなど)を安全に適用する「リブランド」機能が特徴で、事前プレビュー、選択的適用、フリーズ状態の維持が可能です。Claude CodeやCursorなどのAIエージェント向けに設計されており、開発者やプロジェクトマネージャーが手動で行っていた煩雑なワークフローを自動化し、ヒューマンエラーを削減します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ryodeushii/motion-graphics/tree/HEAD/skills/motion-render

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

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

ドキュメント

レンダリングと納品

最初に pnpm mg check <client>/<project> を実行してください。問題が報告されない場合のみレンダリングを行います。

レンダリング

pnpm mg render <client>/<project>            すべてのショット
pnpm mg render <client>/<project> lt-ceo     特定のショット
pnpm mg render <client>/<project> --force    変更がなくても再レンダリング

出力先: renders/<shot>_v<NNN>.<ext>。ピクセルに変更があったレンダリングは次のバージョン番号を取得し、古いバージョンは保持されます。renders/manifest.json は、ピクセルに影響を与えるすべての要素(プロパティ、解決済みトークン、フォント/ロゴ/アセットの内容、プリセット、ツールキットバージョン、クライアントテンプレートコード)のハッシュを記録します。変更のないショットはスキップされます。

プリセット

プリセットファイル用途
overlay (デフォルト)アルファチャンネル付き ProRes 4444 .movResolve/Premiere/FCP で映像上に重ねるローワーサードやタイトル
delivery透明部分が黒の H.264 .mp4レビューリンク、フルフレームグラフィックス
webm-alphaアルファチャンネル付き VP9 .webmWeb プレーヤー(ほとんどのエディターは WebM アルファを無視)

プリセットはショット単位("preset")、プロジェクト単位(project.json)、または実行時(--preset)に設定できます。

納品

ユーザーがプロジェクトを引き渡す(またはグラフィックスが確定したと言った)場合:

pnpm mg deliver <client>/<project> [shot…]

変更があったものをレンダリングし、すべてのファイルを検証(overlay/webm-alpha のアルファ、フレームサイズ、fps)し、プロジェクトをフリーズし、最終ファイルを deliver/<YYYY-MM-DD>/<shot>.<ext> にコピーします。検証に失敗した場合、何もフリーズまたはコピーされません。報告された問題を修正して再実行してください。ユーザーに deliver/ フォルダのパスを伝えてください。

フリーズとは:後日、社内編集、クライアント編集、バリアント編集があっても、このプロジェクトのレンダリングは変更されないことを意味します。

ブランド変更の適用

ユーザーがクライアントまたはバリアントのトークン(新しい色、フォント、ロゴ)を変更した後:

  1. プレビュー: pnpm mg rebrand <client>(または1つのプロジェクトの場合は <client>/<project>)。これは何も変更せず、プロジェクトごとに、現在のブランドが何を変更するかを一覧表示します。"extends": "none" のプロジェクトはスキップされます。
  2. リストをユーザーに表示し、どれを更新するか尋ねます:すべて、一部のプロジェクト、またはなし(新しい作業のみ)。
  3. 選択されたものを適用: pnpm mg rebrand <client> --apply またはプロジェクトごとに pnpm mg rebrand <client>/<project> --apply。フリーズされたプロジェクトは現在のブランドに再ロックされ、リストにあるすべてのプロジェクトは新しいバージョンに再レンダリングされます。古いバージョンは renders/ に残ります。
  4. 新しいレンダリングに対して motion-qa を実行します。ユーザーが再び引き渡すプロジェクトについては、pnpm mg deliver を実行して deliver/ を更新します。

リブランドを実行しないことも有効な回答です。フリーズされたプロジェクトは納品時の外観を維持し、フリーズされていないプロジェクトのみが次回のレンダリング時にブランドに従います。

その他のブランドコマンド:

  • pnpm mg diff <client>/<project>:プロジェクトのロック(フリーズ時)または前回のレンダリング(非フリーズ時)からの差異を表示します。
  • 前回のレンダリングからブランドが変更された非フリーズプロジェクトのレンダリングでは、変更内容を含む警告が表示されます。
  • フリーズされたプロジェクトのプロジェクト専用トークン編集:tokens.json を編集し、pnpm mg rebrand <client>/<project> --apply を実行します。

障害対応

  • プロパティ、トークン、フォント、テキスト幅を指定するエラーは、検証に起因します。テンプレートではなくJSONを修正してください。pnpm mg check ですべてを一度にリスト表示できます。
  • ブラウザ起動、ライブラリ不足、コーデックまたはパスエラー:pnpm mg doctor を実行してください。

Individual skills in this repo

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

関連スキル