Communitygithub.com

motion

モーショングラフィックスワークスペース(mg.json がプロジェクトルートにある)へのエントリポイント。L3・タイトル・アニメーションテキスト・ブランド変更・レンダリングを扱います。最初に読むスキルであり、他の motion-* スキルへルーティングします。

motion とは?

このスキルは、Remotion ベースの「Motion ワークスペース」全体の管理エントリポイントです。すべてのモーショングラフィックス作業(L3、タイトルカード、テキストアニメーション、ブランド変更、レンダリング)は、このスキルの SKILL.md を最初に読むことで、ワークスペースの構造やルールを理解し、適切なサブスキル(motion-brand, motion-project 等)に誘導されます。 主な特徴は、テンプレートがコードで定義され、ジョブ固有の値(テキスト、色、フォント)はすべて JSON で管理される「コードとデータの分離」です。これにより、テキストや色の変更は JSON 編集 + `pnpm mg render` で完結し、コード変更は不要です。ワークスペースはレイヤー構造(ハウス → クライアント → バリアント → プロジェクト → ショット)でトークンを継承し、一貫したデザインを保ちます。 対応プラットフォームは Remotion / Node.js 環境で、`mg` CLI が中心的なインターフェースです。このスキル自体はルールやルーティングテーブルを提供し、実際のブランド編集・プロジェクト作成・テンプレート開発・レンダリング・品質保証は各サブスキルが担当します。開発者はこの SKILL.md を読んだ後、やりたい作業に応じて適切な motion-* スキルに移動します。

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

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

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

ドキュメント

Motion ワークスペース

このワークスペースは、mg CLI(pnpm mg <コマンド>)を通じて Remotion で反復可能なモーショングラフィックスをレンダリングします。デザインはテンプレートとしてコードで記述され、ジョブ固有の値はすべて JSON に格納されます。テキスト、色、フォントの変更は JSON の編集と pnpm mg render だけで完結し、コードを変更する必要はありません。

ディレクトリ構成

mg.json                         ワークスペースの動画デフォルト(fps, サイズ)
brand/house.tokens.json         ハウストークン:ベースカラー、フォント、イージング、時間、セーフエリア
brand/fonts/  brand/logos/      ハウストークンが参照するファイル
clients/<client/>
  client.json                   表示名、オプションの動画オーバーライド
  brand/tokens.json             クライアントのオーバーライド(ハウスとディープマージ)
  brand/fonts/ brand/logos/
  brand/variants/<variant>/     名前付きの代替ルック:tokens.json、fonts/、logos/
  templates/<name>/index.tsx    クライアント専用テンプレート、ID "<client>/<name>"
  projects/<project>/
    project.json                { title?, extends?: "client"|"none", brand?: "<variant>", video?, preset? }
    tokens.json                 プロジェクト専用オーバーライド(オプション)
    tokens.lock.json            フリーズ時に存在:レンダリングはライブチェーンを無視
    fonts/ logos/ assets/       プロジェクトファイル;プロパティはアセットを "asset:<パス>" で参照
    shots/<shot>.props.json     { template, props, durationSeconds?, preset?, video? }
    renders/                    出力、git-ignored;manifest.json がバージョンを追跡

ツールキットコード(エンジン、ハウステンプレート、これらのスキル)は node_modules/motion-toolkit にあり、package.json で固定されています。そこで編集しないでください。ハウステンプレートの変更はツールキットリポジトリで行います。

ハウステンプレート

すべてのハウステンプレートには look プロパティがあります:minimal(クリーン、細いウェイト、ブラーライズ、パネルなし)、bold(太い大文字、単色ブロック、スプリングポップ)、corporate(パネル、アクセントバー、マスクリビール)。デフォルトの "brand" は look トークンを使用するため、クライアントは brand/tokens.json("look": "minimal")で一度スタイルを設定します。

ID用途
lower-third名前と役職のストラップ、オプションでロゴ
title-cardチャプターまたはセクションタイトル、オプションでキッカーとサブタイトル;オーバーレイまたは全画面
callout映像内のポイント(フレーム比率の x, y)からラベルへの線
end-cardエンディングカード:ロゴ、ヘッドライン、CTA、URL、0~2個のYouTubeエンドスクリーンスロット
kinetic-text引用文や声明を単語ごとに表示;*単語* で強調
logo-sting短いアニメーションロゴリビール(イントロ/アウトロ)
counterラベル付きで数字をカウントアップ(value、prefix、suffix、decimals)
social-handleプラットフォームアイコン+@ハンドルを隅に表示(YouTube、Instagram、TikTok、X、LinkedIn…)
typewriterタイプライターまたはキーボード音を伴ってテキストを1キーずつ入力(レンダリングのオーディオに反映)
corner-branding任意の隅に永続的なロゴバグ、オプションで LIVE などのタグ

pnpm mg new-shot … --template <ID> で、すべてのプロパティをデフォルト値で書き出します。各プロパティの意味は node_modules/motion-toolkit/templates/<ID>/index.tsx 内の .describe() テキストに記載されています。

トークンチェーン

ツールキット → ハウス → クライアント → バリアント(project.json の "brand" がある場合) → プロジェクト tokens.json → ショットプロパティ。ツールキット層はデフォルト(look、mono フォント、タイピング sounds)のみを提供します。オブジェクトはキーごとにマージされ、null は継承されたキーを削除し、最も具体的な層が優先されます。"extends": "none" はクライアントとバリアントをスキップします。フォント、ロゴ、サウンドファイルは、それらを持つ最も具体的な層の fonts/、logos/、sounds/ フォルダから検索されます。

ルール

  1. すべての表示値はショットプロパティまたはトークンから取得されます。テンプレート内にハードコードされた色、フォント、px単位のサイズ、タイミングは禁止です。
  2. プロジェクトはデータを保持し、コードは保持しません。新しいデザインはテンプレート、新しいジョブはショットファイルを含むプロジェクトです。
  3. 値を、それを所有する最も低い層に配置します:1ショット → ショットプロパティ;1プロジェクト → プロジェクト tokens.json;クライアントの複数プロジェクト → バリアント;クライアント全体 → クライアントトークン。
  4. tokens.lock.json を手動で編集しないでください。納品済みプロジェクトはフリーズされています。変更は mg rebrand(motion-render を参照)でのみ行います。
  5. JSON またはテンプレートを編集した後は、レンダリング前に必ず pnpm mg check を実行し、報告された問題を修正してください。
  6. すべての視覚的な変更は、完了報告前に motion-qa 手順で確認してください。
  7. mg rebrand --apply を実行する前、およびフリーズされたプロジェクトで使用されているクライアント/バリアントトークンを編集する前には、ユーザーに確認を取ってください。
  8. レンダリングまたは doctor チェックが失敗した場合は、コードを変更する前に pnpm mg doctor を実行してください。

ルーティング

タスク参照先
新しいクライアント、バリアント、ロゴ、フォント、カラーパレットmotion-brand
新しいプロジェクトまたはショットの作成;既存ショットのテキスト/色変更motion-project
新しいテンプレート、またはテンプレートのアニメーションの変更motion-template、次に motion-style
モーションの感触:イージング、タイミング、スタガー、セーフエリアmotion-style
レンダリング、プリセット、バージョン管理、納品、ブランド変更の適用motion-render
納品前の出力チェックmotion-qa

コマンド

pnpm mg templates                                  テンプレートID一覧
pnpm mg new-client|new-variant|new-project …
pnpm mg new-shot <client>/<project> <shot> --template <ID>   すべてのプロパティがデフォルトのショットファイル
pnpm mg new-template <client> <name>               スターターテンプレート
pnpm mg check [<client> | <client>/<project>]      レンダリングせずにすべて検証
pnpm mg render <client>/<project> [shot…]          未変更ショットはスキップ;--force、--preset
pnpm mg still <client>/<project> [shot…]           チェッカーボード上でPNGを確認(デフォルトですべてのショット)
pnpm mg studio <client>/<project>                 ライブプレビュー;Studioの「保存」でショットファイルを書き込み
pnpm mg deliver <client>/<project>                 レンダリング、検証、フリーズ、最終ファイルを deliver/<日付>/ にコピー
pnpm mg rebrand <client | client/project> [--apply]   納品済み作品へのブランド変更
pnpm mg freeze|unfreeze|diff <client>/<project>
pnpm mg doctor                                     環境、mg check、スモークレンダリング

Individual skills in this repo

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

関連スキル