Communitygithub.com

motion-template

Remotionテンプレート(プロップスとトークンで駆動する再利用可能なアニメーショングラフィック)を作成・修正します。既存のテンプレートが合わない場合やテンプレートのアニメーションを変更する必要がある場合に使用します。

motion-template とは?

このスキルは、Remotionベースのアニメーションテンプレートを作成・修正するための包括的なガイドを提供します。テンプレートは、shotプロップスと解決済みトークンのみを読み取る再利用可能なデザインであり、`defineTemplate`を使用して定義されます。クライアント固有のテンプレートは`pnpm mg new-template`コマンドで生成され、ハウステンプレートは`templates/`ディレクトリに配置され、`templates/index.ts`に登録されます。スキルは、スキーマ定義(Zodを使用)、アニメーション(`useCurrentFrame`と`interpolate`/`spring`)、トークン解決(`color`、`font`、`motion`関数)、およびバリデーション(`check`関数、`mg check`コマンド)の契約を詳述します。また、参照クリップからのフレーム抽出、ルック(choreo、reveal、typo)の適用、テスト検証手順などの高度なトピックもカバーしています。このスキルは、開発者が一貫性のある予測可能なアニメーションテンプレートを作成し、プラットフォーム(CLI、Studio、レンダリング)間で正しく動作することを保証するのに役立ちます。

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

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

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

ドキュメント

テンプレート

テンプレートは再利用可能なデザインです。shotプロップスと解決済みトークンのみを読み取り、それ以外は読み取りません。タイミングやイージングを選択する前にmotion-styleを読んでください。Remotion APIの詳細については、インストールされているRemotionスキルを使用するか(npx remotion skills add)、https://www.remotion.dev/docs を参照してください。

配置場所

  • クライアント固有: pnpm mg new-template <client> <name>で開始します。これにより、clients/<client>/templates/<name>/index.tsxに動作するスターターが作成されます(IDは<client>/<name>)。このスターターは以下の契約に従います。デザインを置き換えてください。
  • ハウス(全クライアント): motion-toolkitリポジトリ内のtemplates/<name>/index.tsxに配置し、templates/index.tsに登録し、新しいツールキットバージョンでリリースします。node_modulesに書き込まないでください。

アニメーションコードを書く前に、スキーマ(ユーザーがエージェントなしで変更できるプロップス)を提案し、ユーザーと確認してください。

契約

import { interpolate, useCurrentFrame } from "remotion";
import { z } from "zod";
import { color, defineTemplate, font, motion, px, safeArea } from "motion-toolkit/engine";

const schema = z.object({
  headline: z.string().min(1).default("Headline"),
  holdSeconds: z.number().positive().default(3),
  accent: z.string().default("accent").describe("Color token name or #hex"),
});

export const template = defineTemplate({
  title: "Title card",
  schema,
  durationSeconds: ({ props, tokens }) => {
    const m = motion(tokens, 1);
    return m.seconds("enter") + props.holdSeconds + m.seconds("exit");
  },
  check: ({ props, tokens }) => {
    color(tokens, props.accent); // throws on unknown token names; runs in `mg check`
  },
  component: ({ props, tokens, video }) => {
    const frame = useCurrentFrame();
    const m = motion(tokens, video.fps);
    // ...
  },
});

要件:

  1. defineTemplateで構築されたtemplate(クライアントテンプレート)をエクスポートします。
  2. すべてのスキーマフィールドには。default()が必要で、新しいshotとStudioが有効な状態で開始されるようにします。Studioフォーム用に.describe()を追加します。
  3. 色はcolor(tokens, nameOrHex)、フォントはfont(tokens, role)、期間とイージングはmotion(tokens, fps)、safeArea(tokens, video)内の位置、サイズはpx(sizeAt1080, video)を使用します。
  4. useCurrentFrame()からinterpolate/springでのみアニメーションします。CSSトランジション、setTimeout、Date.now()、Math.random()は使用しないでください(代わりにremotionのrandom(seed)を使用)。レンダリングは毎回同一でなければなりません。
  5. テンプレートが全フレームでない限り、背景は透明のままにします。ローワーサードとオーバーレイはアルファ付きでレンダリングします。すべての要素は最後のフレームで消えている必要があります。
  6. 大きな失敗: テキストが収まらない場合やトークンが見つからない場合は、修正ヒントとともにErrorをスローします。エンジンのassertFits/wrapLinesを使用します。これらは読み込まれたフォントで測定し、オーバーフロー時にスローします。
  7. トークン(色、ロゴ、フォント、サウンド)を指定するプロップスは、checkRefsを使用してcheckで検証されるため、mg checkはレンダリング前にタイプミスをキャッチします。
  8. durationSecondsとcheckはNode(mg check)で実行され、フォントが読み込まれる前にも実行されます。そこでテキストを測定しないでください。
  9. 画像とロゴ: <Img src={staticFile(tokens.logos[name])} /> または staticFile(props.someAsset)。サウンド: <Html5Audio src={staticFile(file)} /> を <Sequence from={frame}> 内に配置。ファイルは tokens.sounds[name] から取得します。CLIがファイルをステージングします。

ルック

ハウステンプレート、およびそれらに一致させることを意図したクライアントテンプレートは、look: lookSchemaを受け取り、resolveLook(props.look, tokens)で解決します。3つのルックすべてで一貫性を保つために、共有ヘルパーから構築します(motion-styleを参照)。

  • choreo(tokens, look, fps) は、エントリ順の各要素に対して beat(frame, index, exitStart, steps) を提供します → { inP, outP }。choreoSeconds(...) は一致する期間を提供します。
  • reveal(look, beat, video) は要素のルックのエントランススタイルです(corporate の場合は overflow: hidden でラップします)。
  • typo(tokens, look, "display" | "title" | "body" | "label", size) はルックのタイプスタイルです。onColor(hex) はカラーブロック上で読みやすいテキストを選択します。cornerPlacement(corner, inset) はコーナーグラフィックを配置します。

実際の例として、node_modules/motion-toolkit/templates/title-card/index.tsx などのハウステンプレートを読んでください。

検証

  1. テストプロジェクトで pnpm mg new-shot <client>/<project> <shot> --template <client>/<name> を実行し、さらに2つ目のshotを最も長い現実的なテキストで実行します。
  2. pnpm mg check <client>/<project> を実行します。
  3. pnpm mg still <client>/<project> <shot> を実行してフレームを確認します。次に pnpm mg render を実行します。
  4. motion-qa に従います。

参照クリップからの作業

ユーザーが参照ビデオを提供する場合、デザインする前にフレームを抽出します。最初に renders/reference/ を作成します。バンドルされている ffmpeg はフィルターのない最小限のビルドであるため、フレームレートには -r を使用します。

pnpm mg ffmpeg -i reference.mp4 -r 10 renders/reference/f_%03d.png

フレームから、何が、どの順序で、各フェーズの長さ(10 fps でフレームをカウント)、そしてイージングの感触を説明します。その分析をユーザーと確認してから、トークンにマッピングします。期間は motion.durations に、カーブは motion.easings にマッピングします。

Individual skills in this repo

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

関連スキル