Communitygithub.com

reels-templates

フッテージ、写真、または簡単な指示から9:16のReels / TikTok広告をワンショットで作成します。このスキルにバンドルされた15の既製Remotionテンプレート(ソーシャルネイティブフォーマットと広告フォーマット)を使用します。

reels-templates とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)が9:16の縦型ショート動画(Reels、TikTok広告など)をワンショットで生成・編集するための強力なツールキットです。15種類のデータ駆動型Remotionテンプレートがバンドルされており、テキストメッセージ風のストーリー、メモアプリ風リスト、検索バー、ロック画面通知、ポラロイド風フォトダンプ、ランキング、投票ステッカーといったソーシャルネイティブフォーマットと、ビートカット編集、UGC風キャプション、リスティクル、ビフォーアフター、商品スライドショー、レビュー、コメント返信、セールプロモーションといった広告フォーマットをカバーしています。ユーザーが「リールを作って」「このフッテージでTikTok広告を」「ワンショット動画を」「複数の言語でレンダリングして」と依頼すると、このスキルが指示に基づいてテンプレート選択、ジョブファイルの構築、静止画チェック、レンダリングまでを自律的に実行します。新しいテンプレートを追加する機能も備えており、ブランドの好みや言語設定に応じてテキストスタイル、フォント、アクセントカラー、音楽を柔軟にカスタマイズできます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/du-nguyen-IT007/remotion-reels-skills/tree/HEAD/skills/reels-templates

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

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

ドキュメント

Reels テンプレート

このスキルには、assets/reels-kit/ に15のデータ駆動型Remotionテンプレート(1080x1920、60 fps)が同梱されています。動画は1つのJSONジョブファイルで定義します。テンプレートを選び、そのプロパティを設定し、レンダリングするだけです。通常のジョブではReactコードを書く必要はありません。

以下 reels/ で始まるパスは、このスキルフォルダ内ではなく、ワーキングフォルダ内を示します。ジョブのためにスキルフォルダ内のファイルを編集しないでください。

無人実行。 このスキルは自律エージェント向けに作られています。リクエスター はジョブを開始した人(オーケストレーションエージェント、パイプライン、または人間)です。このファイルのルールに従ってすべての決定を下し、手順の承認を求めるために停止しないでください。解決できないブロッカー(ツールの欠如、メディアの欠落や読み取り不能、レンダリングの継続的な失敗)が発生した場合にのみ停止し、それを報告してください。すべてのジョブはレポート(セクション4)で終了します。

0. ワークスペースのセットアップ

プロジェクトごとに、最初のジョブの前に一度だけ実行します。

  1. ツールを確認します:Node.js 18以降(node -v)、および ffmpeg と ffprobe がPATHに存在することを確認します。不足しているものがあれば、停止してブロッカーとして報告してください。システムソフトウェアを自分でインストールしないでください。
  2. ワーキングフォルダに既に reels/render.mjs がある場合は、そのワークスペースを使用してセクション1に進みます。
  3. それ以外の場合は、このスキルの assets/reels-kit/ フォルダをワーキングフォルダの reels/ にコピーし(例:cp -R <skill-dir>/assets/reels-kit reels)、その後 reels/ 内で npm install を実行します。
  4. reels/public/(メディア)フォルダと reels/jobs/_local/(スクラッチジョブ)フォルダを作成します。ワーキングフォルダがgitリポジトリの場合は、reels/node_modules/、reels/public/、reels/out/、reels/exports/、reels/jobs/_local/ をその .gitignore に追加します。

ワークスペースには、render.mjs(ジョブのレンダリング)、clean.mjs(ディスク容量の解放、セクション6参照)、src/(テンプレートと共有キット)、jobs/examples/(テンプレートごとに1つのサンプルジョブ)、public/<name>/(各ジョブの入力メディア)、out/stills/(QA用静止画)、exports/<name>/(各ジョブの完成動画)が含まれます。

プリファレンス

このリポジトリには誰の好みも保持されていません。テキストスタイル、フォント、アクセントカラー、コピーのトーン、言語、使用する音楽、どのフォーマットを優先するかは、リクエスターの指示と、あなたが既にブランドについて知っていることから決定され、テンプレートやこのファイルに書き込まれた値から決定されることは決してありません。指示に好みが明記されている場合は、ジョブファイルに適用します。明記されていない場合は、テンプレートのデフォルト値を使用し、レポートにその旨を記載します。個人やブランドの好みをテンプレート、サンプルジョブ、またはこのスキルに書き込まないでください。

1. テンプレートの選択

動画が誰かが投稿したもののように感じられるべき場合は、ソーシャルネイティブセットから始めます。フッテージ自体が動画を牽引する場合は、広告セットを使用します。

ソーシャルネイティブ(視聴者が既に知っているインターフェースがフックになります)

テンプレート使用するケース必要なもの
ChatStoryテキストメッセージのスレッドとして語られるストーリー、その後に商品の紹介メッセージ(+ 送る商品写真)、ペイオフクリップ
NotesListメモアプリのリストが自動でタイプされる:「失敗したギフト vs 彼女が気に入ったもの」タイトル + 1〜7行、ペイオフクリップ
SearchHook顧客の質問が検索バーに入力され、フッテージがそれに答えるクエリ(+ サジェスト)、1つ以上のクリップ
NotificationStackロック画面が注文、メッセージ、レビューで埋まる:社会的証明とFOMO1〜6件の通知、背景、ペイオフクリップ
PolaroidDump手書きキャプション付きのスクラップブック風フォトダンプ2〜8枚の写真
Rankingブラインドランキング:アイテムが番号付きリストにドロップイン、#1が最後各アイテムに2〜6クリップ、ラベル、ランク
PollStickerフッテージ上のストーリー投票:2つの選択肢、タップ、結果質問、パーセント付きの2つの選択肢、クリップ

広告フォーマット(フッテージが先、テキストはその上)

テンプレート使用するケース必要なもの
BeatCutAdフッテージからカットされた商品広告のデフォルト:複数のショット、フック、CTA1つ以上のビデオクリップ
UgcCaptions人物がカメラに向かって話す;単語ごとのキャプション発話を含む1クリップ + 単語のタイミング
Listicle「3つの理由」、ヒント、機能、手順各ポイントに2〜7クリップ
BeforeAfter変形または比較(mode: wipe または split)2クリップまたは写真
ProductSlideshow商品写真のみ、または簡単なカタログ;オプションの価格ステッカー2枚以上の写真またはクリップ
Testimonial社会的証明:星付きのレビューカード1背景クリップ + レビューテキスト
CommentReply異議やFAQへの回答;コメントバブルがフック1つ以上のクリップ + コメント
OfferPromoセール、割引コード、期限1つ以上のクリップ + オファー

指示がこれらのどれにも当てはまらない場合は、セクション7を参照してください。テンプレートを本来の用途とは異なる形に無理に適合させないでください。

公式のRemotionスキル(remotion-best-practices、別途 npx skills add remotion-dev/skills --skill remotion-best-practices でインストール)は、Remotionコードを記述する際のリファレンスです。インストールされていない場合は、代わりにRemotionドキュメント(https://www.remotion.dev/docs)を使用してください。このリポジトリで動画を作成する場合、このスキルが異なる点ではこちらが優先されます。新しいプロジェクトやコンポジションを作成する代わりにジョブファイルを構築し、Studioを開く代わりに静止画を確認し、静止画が合格したら、指示を待たずに render.mjs でレンダリングします。

2. ジョブの構築

  1. ジョブ名を選択します(小文字、数字、- を使用。例:xmas-ornament)。これはジョブファイルの name、入力フォルダ reels/public/<name>/、出力フォルダ reels/exports/<name>/ になります。このジョブで使用するファイルのみを reels/public/<name>/ にコピーし、元のファイルは元の場所に残します。レポートに各入力の出所、および public/ 内のコピーが唯一のコピーであるかどうか(ダウンロードまたは生成されたファイル)を記載します。各 src は <name>/<file> として記述します。各ファイルの長さを ffprobe で確認します。メディアは決してコミットされません。public/ はgitで無視されるため、サンプルジョブ内のパス(footage.mp4、music.m4a、demo/…)は、実際のファイルを配置するまでのプレースホルダーです。
  2. テキストを配置する前にフッテージを確認します。ショットごとにフレームを抽出し(ffmpeg -ss <t> -i <file> -frames:v 1)、商品がどこにあるかを確認します。
  3. reels/jobs/examples/<Template>.json を読みます。そのテンプレートが受け取るすべてのプロパティがリストされています。それを reels/jobs/<job>.json にコピーして編集します。gitの管理外にしておきたいジョブには reels/jobs/_local/ を使用します。

ジョブファイル:

{ "template": "BeatCutAd", "name": "xmas-ornament", "lang": "en",
  "props": { },
  "i18n": { "ja": { "hook": { "lines": ["…", "…"] }, "cta": { "lines": ["…"], "button": "…" } } } }

i18n.<lang> は props にマージされるため、翻訳された文字列のみを保持します。オブジェクトの配列はアイテムごとにマージされます(null はベースアイテムを保持します)。文字列の配列は置き換えられます。

すべてのテンプレートが共有するプロパティ:

  • hook: { lines (1-3), band, size, duration }。0秒から表示、デフォルト2.2秒。
  • cta: { lines, button, band, size, duration }。最後の duration 秒間表示、デフォルト2.5秒。他のキャプションはCTAが始まると終了します。
  • music: { src, volume }。最後にフェードアウトします。音声がある場合は約0.15を使用します。
  • brand: { accent (hex), font: poppins | montserrat | anton, textStyle: outline | box | caption }。outline(デフォルト)と box は派手な広告スタイルです。caption はネイティブなアプリ内キャプションの外観です。白い文頭大文字のテキストが1つの暗い角丸ボックス内に表示され、バンドの上部からフェードインします。一人称のストーリーラインとして、最大30文字の2行で記述します。
  • クリップ: { src, start (ソース内の秒数), duration (画面上の秒数), speed, focus (center | top | bottom | "50% 30%"), transition (cut | flash | zoom | whip | focus) }。transition はそのクリップがどのように現れるかを定義します。

クリップはシミュレートされたカメラも受け取ります。zoom(1-2.5、focus ポイントを維持したズームイン)、tilt(度、-15〜15、ダッチアングル)、push(0-0.6、クリップが到着する際にカメラが短いブラーと共に突入し、その後安定します)。

ジョブが省略したプロパティはオフになります。例が示していても、hook のないジョブにはフックはありません。

src は public/ 内のパスまたはhttps URLです。.jpg/.png/.webp は再生の代わりにスローパンイン(ゆっくりとしたズームイン)になります。

3. ルール

  • セーフゾーン。 すべてのテキストは x 140-940、y 288-1248 に収まります。テンプレートは3つのバンドを通じてこれを強制します:top(y 288-600)、middle(600-930)、lower(930-1248)。選択するのはバンドのみです。
  • 指示がない限り、テキストを商品の上に配置しないでください。 抽出したフレームから各バンドを選択します。すべてのバンドがショット内の商品を覆う場合は、テキストの duration を短くするか、ショットを変更します。
  • 短い行。 テキストは800ピクセルに収まるように縮小されるため、長い行は小さくなります。1行あたりラテン文字22文字、日本語12文字を目指します。1つの単語を *アスタリスク* で囲むと、アクセントカラーで色付けされます。
  • クリップの長さ。 start + duration * speed がソースの終わりを超えてはいけません。動画の長さはクリップの長さの合計です(BeforeAfter は duration を使用、Testimonial はレビューとCTAの合計)。
  • 音楽に合わせてカットする 音楽がある場合:クリップの長さがビートの位置に合うようにします。
  • フォント。 ラテン語、ベトナム語(montserrat または anton、およびすべてのインターフェースカード)、日本語が動作します。韓国語、タイ語、アラビア語などは、最初に reels/src/lib/kit.tsx にフォントを追加する必要があります。

少数の静的なクリップ、多くのアングル。 フッテージが1つまたは2つの固定ショットで、指示が高速なマルチアングル編集(ショールームツアーやトレンドダンスのカット)である場合、BeatCutAd を使用し、各ソースを異なる focus、zoom、tilt、push で複数回再利用します。ワイドショット(zoom 約1.02)で開き、ビートごとに1つの詳細(テキスト、キャラクター、名前、手、裾)を表示し、tilt の符号を交互に変え、768ピクセルのソースでは zoom を1.7以下に保ち、ワイドで終了します。cut トランジションを使用します。pushがトランジションです。これによりフッテージのフレーミングが変わりますが、実際の新しいカメラアングルを作成することはできません。

テンプレートに関する注意事項:

  • ChatStory、NotesList、NotificationStack:インターフェースが最初に再生され、その後 clips(ペイオフ)がフラッシュインし、それらの上にCTAが表示されます。これらの長さは、インターフェース部分とクリップの合計です。hook は省略します。カードがセーフゾーンを埋めます。background はカードの背後にある暗いメディアです。
  • ChatStory:メッセージは読む時間によってペースが決まります。at(秒)はビートを強制する場合にのみ設定します。メッセージは text の代わりに、またはそれに加えて、image(商品写真)を持つことができます。
  • NotesList:check: true は行がタイプされた後にチェックマークを付け、highlight: true は行をマークします。商品行は最後に配置します。
  • SearchHook:pick は選択されるサジェストです。クエリは34文字未満に保ちます。
  • NotificationStack:icon は1つの絵文字、color はそのタイルの色です。now と date は言語ごとに翻訳します。
  • PolaroidDump:正方形に近い写真が最も効果的です。title は手書きです。キャプションは20文字未満に保ちます。クリップはありません。写真自体が動画です。
  • Ranking:items は記述された順序で再生されるため、最低ランクを最初に、ランク1を最後に記述します。ラベルは20文字未満に保ちます。
  • PollSticker:percent の値はあなたが設定します。指示に実際の数字がある場合はそれを使用し、架空の数字を調査データとして提示しないでください。
  • これらのインターフェース内のコピーは、人々がテキストを送信したり投稿したりする方法で記述します。小文字でも構いません。短い行、人が使う場所に絵文字を使用します。それらの中の名前、メッセージ、レビューは、指示が実際のものを提供しない限り例示であり、実際の人物に帰属させないでください。
  • UgcCaptions:words は { text, start, end } で、出力タイムライン上の秒単位です。単語のタイムスタンプが付いた文字起こしから取得します。タイミングを推測しないでください。keepAudio はデフォルトでtrueです。wordsPerPage: 1 を使用すると、「単語」は短いフレーズになる場合があります。
  • CommentReply と OfferPromo:hook は省略します。バブルまたは見出しが既にトップバンドを使用しています。
  • OfferPromo:CTAはデフォルトでローバーバンドになります。Testimonial:CTAバンドを middle に設定します。
  • ProductSlideshow:badge は2行にするために \n を受け入れます。badgeBand で配置します。

4. 確認、そしてレンダリング

以下を reels/ から実行します。

node render.mjs jobs/<job>.json --still=1,6,12 --guides   # セーフゾーンバンドが上に描画されます
node render.mjs jobs/<job>.json --still=1,6,12 --lang=en,ja
node render.mjs jobs/<job>.json                           # すべての言語 -> exports/<name>/

静止画は半分のサイズで out/stills/ に出力されます。それらを開いて確認します。テキストが商品の上にないこと、何もクリップされていないこと、各言語が収まっていることを確認します。フック内、中間のキャプション、CTAの静止画時間を選択します。_GUIDES という名前のファイルは確認用のみです。結果として提供しないでください。

静止画が合格した後にのみ動画をレンダリングします。静止画が不合格の場合は、ジョブを修正して再度確認します。3回不合格となった場合は、ブロッカーとして報告します。レンダリングでは、各ファイルのパスと長さが1行で出力されます。指示がない限り、動画を公開またはアップロードしないでください。

すべてのジョブは、リクエスターへのレポートで終了します。レポートには以下が含まれます。

  • 出力パスと長さ。
  • 使用したテンプレートと、指示が明確でなかった場合に使用したデフォルト値。
  • 各入力の出所、および public/ に唯一のコピーがあるかどうか。
  • セクション6のクリーンアップで削除したものと、解放された容量。

5. Instagramサイズ

レンダリングは約16 Mbpsです。アップロード用に圧縮するには:

ffmpeg -i in.mp4 -c:v libx264 -crf 20 -maxrate 10M -bufsize 20M -c:a aac -ar 48000 -b:a 192k -movflags +faststart out.mp4

6. メディアとディスク容量

メディアはディスクを消費します。入力(public/<name>/ にコピーされたフッテージ、写真、音楽)と出力(exports/<name>/ 内の動画、15秒で言語あたり約30 MB)はどちらも同じ名前のジョブに属します。クリーンアップはジョブごとに機能するため、この状態を維持してください。その他はすべてスクラッチです。out/ 内のQA静止画、およびRemotionがOSの一時フォルダに書き込む一時バンドル(それぞれ public/ の完全なコピーを保持します。render.mjs は自身のものを削除しますが、クラッシュした実行やStudioは残す可能性があります)。node_modules/.cache 内のwebpackキャッシュは数百MBに成長します。node_modules/(ヘッドレスブラウザを含め約1.3 GB)は一度きりのコストです。ジョブを再レンダリングすると、同じ名前のファイルが上書きされるため、1つのジョブの繰り返しレンダリングが蓄積されることはありません。

reels/clean.mjs がない場合(ワークスペースが古いキットから作成された場合)、最初にこのスキルの assets/reels-kit/ から clean.mjs と render.mjs を reels/ にコピーします。

レンダリング中は決して実行せず、reels/ から以下を実行します:

node clean.mjs --auto --keep=<N>

Node clean.mjs --auto は、保持するジョブ数(--keep、デフォルト3)を除いてすべてのジョブの出力を削除し、out/ 内のすべてのQA静止画をクリアし、OSの一時フォルダ内の古いRemotionバンドルのクリーンアップを試みます。webpackキャッシュは削除しません。解放された容量がレポートに表示されます。

7. 新しいテンプレートの追加

このスキルは拡張可能です。新しいテンプレートを追加するには、assets/reels-kit/ を更新する必要があります。追加は、このスキルのコードリポジトリ内でのみ行ってください。その方法は以下の通りです。

  1. src/reels/ に、templates/ 内の既存のテンプレートに従ってReactコンポーネントを作成します。
  2. テンプレートのコンポジションを src/Root.tsx に登録します。
  3. スキルにテンプレートキーをマッピングするエントリを src/lib/kit.tsx の templateRegistry に追加します。
  4. jobs/examples/ にサンプルジョブを追加します。
  5. このファイル内のテーブルを更新します。

新しいテンプレートは、既存のテンプレートと同様のプロパティ構造に従い、セーフゾーンルールを尊重する必要があります。

関連スキル