Communitygithub.com

Remotion Shorts スキル

エージェントが「Remotion Shorts スキル」を使ってショート動画の計画、作成、編集を行い、最終的に完成した動画を出力する方法を示します。手順は、0. セットアップ(マシンごとに一度)、1. 必要な情報の確認(一度のメッセージで、既知のことはスキップ)を通ります。新しいタスクでこの技術が必要なときに使用します。

Remotion Shorts スキル とは?

このスキルは、AIエージェントがRemotionを使用して短尺動画(ショート)を自動生成するためのワークフローを提供します。エージェントは、シーンのJSONファイルを記述するだけで、Remotionプロジェクトが自動的にレイアウト、タイミング調整、レンダリングを行い、MP4動画、カバー画像、レビューシートを出力します。対応プラットフォームはTikTok、Instagram Reels、YouTube Shortsで、WoopSocial APIを通じた投稿までを自動化できます。 主な特徴として、エージェントは複雑なRemotionコードを書く必要がなく、定義済みのテンプレートに従ってスクリプト(各画面のテキスト、順序、速度)に集中できます。スキルはシーンの検証(テキスト長、可読性、時間超過の警告)を含み、品質を保証します。セットアップは一度のみ必要で、Node 20以上が必要です。 このスキルは、開発者やコンテンツクリエイターが反復的な動画編集作業を自動化し、一貫性のある高品質なショート動画を効率的に量産するのに役立ちます。特に、データに基づく情報動画やリスト形式のコンテンツに最適で、各動画が一つのメッセージを伝えることに重点を置いています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SadiTLM/agentic-reels-studio/tree/HEAD/skills/remotion-shorts-skill

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

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

ドキュメント

Remotion Shorts スキル は何をしますか?

あなたはショート動画をシーンのJSONファイルとして作成します。バンドルされたRemotionプロジェクトがテキストをレイアウトし、各シーンを読む速度に合わせてタイミングを調整し、アプリのボタンで覆われない領域内にテキストを収め、レビューシート、カバー、MP4をレンダリングします。ユーザーはWoopSocialでそれを投稿できます。

動画ごとにRemotionコードを書く必要はありません。テンプレートは固定されており、テスト済みです。あなたの仕事はスクリプト、つまり各画面に表示する内容、順序、速さです。

0. セットアップ(マシンごとに一度)

Node 20以上が必要です。node -v で確認してください。ない場合は、ユーザーを https://nodejs.org に誘導してください。RemotionはmacOS 15以降、Windows x64、glibc 2.35+(Ubuntu 22.04、Debian 12以降)のLinuxをサポートしています。

node <skill-dir>/scripts/setup.mjs remotion-shorts

これにより、プロジェクトが ./remotion-shorts にコピーされ、固定されたパッケージ(約260 MB)がインストールされ、Remotionがレンダリングに使用するヘッドレスブラウザ(100~150 MB)がダウンロードされます。初回は1~3分かかります。スキルが更新された後にもう一度実行してください。テンプレートファイルが更新され(ユーザーが変更したファイルは .bak として保持されます)、スクリプト、アセット、出力には一切触れません。

ライセンス。 Remotionは個人および3人以下の企業は無料です。4人以上の企業はRemotionの企業ライセンスが必要であり、スクリプトからのレンダリングは自動化とみなされます(remotion.pro/license)。より大規模な企業向けにレンダリングする場合は、最初のレンダリング前に、一度だけ明確にユーザーに伝えてください。

1. 必要な情報を確認する(一度のメッセージで、既知のことはスキップ)

  • 素材。 トピック、記事、URL、メモ、データ、チェンジログ、リスト。あなたは、参照可能な事実のみを記述します。ユーザーがソースなしでトピックを指定した場合、一次ソース(公式統計、ドキュメント、製品自身のチェンジログなど)を見つけて、その名前を挙げてください。
  • 誰に向けたものか、そして唯一のポイント。 一つのショート動画は一つのことだけを伝えます。
  • 見た目。 テーマ(ink、paper、volt、ocean、clean)、またはユーザーのブランドカラー、そしてエンド画面用のハンドル。
  • オーディオ。 組み込みの効果音はデフォルトでオン(フックにヒット音、各カットにウィッシュ音、ハイライトにポップ音、カウントアップにチック音)。これらはこのテンプレート用に作られており、すべてのアプリで安全です。音楽は、ユーザーが使用権限を持つファイルからのみ使用可能(無料ライブラリが3つのアプリすべてで安全でない理由については、references/writing-shorts.md を参照)。
  • 投稿先。 TikTok、Reels、Shorts、またはすべて。

2. スクリプトを書く

セッションの最初のスクリプトの前に references/writing-shorts.md を読んでください。短いバージョン:

  • シーン1はフック であり、約10語以内で成果を述べます:数字、主張、またはリストの約束(「5つの無料ツールで...を置き換える」など)。フレーム0から完全に画面に表示されます。フックに数字がある場合は、それを big に入れて、最初に目が留まるようにします。
  • シーンごとに一つのアイデア。 シーンはビートであり、段落ではありません。統計シーンは一つの数字とその意味を伝えます。リスト項目はカウントダウンまたはカウントアップします。どちらかをフックで指定します。
  • すべてのシーンに実際の情報を。 新しい情報が一切ないテンプレート化されたテキスト動画は、YouTubeでは不自然なコンテンツ、Instagramではオリジナルでないコンテンツと呼ばれます。決して引き伸ばさないでください。
  • 数字は正確で、出典が明らかであること。 出典を footer に入れてください(「データ:USGS」)。異なる主張になるように数字を丸めないでください。
  • 一つのアクションで終わる か、フックに戻るようなセリフで終わり、ループが連続的に感じられるようにします。「ご視聴ありがとうございました」は不要です。
  • 長さ: 目標は15~45秒。59秒を超えるとレンダラーが警告します。

プロジェクトフォルダ内に short.json を書きます。完全なフォーマット、すべてのシーンタイプとオプションは references/short-json.md にあります。最小限のスクリプト:

{
  "theme": "ink",
  "footer": "データ: USGS",
  "handle": "@あなたのハンドル",
  "scenes": [
    { "type": "hook", "big": "2.5%", "text": "地球の水のうち淡水はわずか" },
    { "type": "stat", "value": "96.5", "suffix": "%", "label": "は海水" },
    { "type": "stat", "value": "68.7", "suffix": "%", "label": "淡水のうち氷河と氷床が占める割合", "highlight": "氷河と氷床" },
    { "type": "end", "text": "雑談ネタに保存", "highlight": "保存" }
  ]
}

3. 動画をレンダリングする前に確認する

cd remotion-shorts
node render.mjs short.json --stills

数秒で、計画(シーンごとの秒数とフォントサイズ)が表示され、以下が書き出されます:

  • out/short/sheet.jpg:すべてのシーンの最終フレーム(画面に表示されるすべてのもの)。安全領域が細い破線でマークされています(テキストはその内側に収まる必要があります)。
  • out/short/cuts.jpg:フレーム0と各カット前後のフレーム。モーションを確認します。
  • out/short/cover.jpg:フックが表示された状態(Reelsのカバーとしてアップロードします)。
  • out/short/report.json:タイミング、改行、警告。

両方のシートを開いて確認してください。 各シーンがスマートフォンサイズで読めるか、それぞれが一つのことを言っているか、ハイライトが重要な単語に当たっているか、窮屈に見えるものがないか、順序が正しいか、フレーム0にフック全体が表示されているかを確認してください。JSONを修正し、投稿できる状態になるまで --stills を再実行してください。

警告があると動画レンダリングが停止します(終了コード2):テキストが1画面に収まらない、フックが長すぎる、テキストにないハイライトがある、読むには速すぎるシーンがある、ペースが0.85~1.25の範囲外、ショート動画が59秒を超えている。スクリプトを修正してください。ユーザーが警告を確認し、それでも問題ないと判断した場合にのみ --force を使用してください。一部の問題は --force でも上書きできないエラーです。例えば、どんなサイズでも画面に対して広すぎる単語などは、テキストが画面からはみ出す原因となります。

4. レンダリング

node render.mjs short.json

out/short/short.mp4 を出力:1080x1920、30 fps、H.264、yuv420p、AAC(音楽がない場合は無音トラック)。TikTok、Reels、Shortsのすべてで受け入れられます。30秒のショート動画は、最近のラップトップで約1分でレンダリングされます。8 GBのメモリを搭載したマシンでは、一度に2フレームをレンダリングします。レンダリングがメモリ不足で強制終了された場合は、--concurrency 1 を指定して再実行してください。

表示する前に、3つのフレーム(開始、中間、終了)をキャプチャして確認するか、クライアントが可能であれば再生して確認してください。その後、ユーザーにカバー、シート、MP4のパスを表示します。

複数のアカウント: 同じファイルを複数のアカウントに投稿しないでください。アカウントごとにバリエーション(異なるフック、テーマ、シーン順序など)を作成し、それぞれ独自のJSONとして保存し、2つのアカウントがほぼ重複したコンテンツを投稿しないようにしてください。

5. 投稿(WoopSocial、確認付き)

references/woopsocial.md を読んでください。簡単に言うと:

  1. social_accounts_list でアカウントを見つけます(必要に応じて最初に接続します)。
  2. TikTokの場合は、social_accounts_get_platform_inputs でアカウントのプライバシーオプションと許可される最長動画時間を取得します。ユーザーがプライバシーを選択します。デフォルトはありません。
  3. アップロード:media_uploads_create_session を report.json の正確なバイトサイズで使用し、レスポンスを session.json として保存し、node upload.mjs session.json out/short/short.mp4 を実行し、次に media_uploads_complete_session をステータスが READY になるまで実行します。
  4. プラットフォームごとにキャプションを書きます(TikTokとReels:動画に追加する一文と3~5個の具体的なハッシュタグ。YouTube:100文字未満のタイトルと説明文)。プラットフォームごとにテキストを変えるには contentOverride を使用します。
  5. posts_validate を実行し、その後ユーザーに次の内容を表示します:アカウント、プラットフォームごとのキャプション、プライバシー、タイムゾーン付きのスケジュール時間、カバー。明確な同意を待ちます。その後、posts_create と posts_get を実行します。

開示フィールド:ショート動画がユーザー自身の製品を宣伝する場合は、TikTokで isYourBrand: true を設定します。isAiGeneratedContent は、リアルなAI画像、動画、音声の場合のみ必要です(キネティックテキストには不要)。YouTubeの madeForKids は法的な宣言です。推測せずに必ずユーザーに確認してください。

6. 報告

次の内容を表示します:MP4のパス、長さ、シート、投稿先(posts_get からのリンク)またはスケジュール、そしてできなかったこと。ビュー数や結果をでっち上げないでください。後で social_account_posts_list で読み取り、収集した日付を報告してください。

見た目の編集

  • ブランドカラー:theme をオブジェクト(bg、fg、accent、accentText、font、uppercase)として渡します。テキストのコントラストは7:1以上に保ちます。背景に対するアクセントカラーも確認してください。
  • シーンの背後に写真や動画:シーンごとに image、ショート全体に background を使用します。テーマカラーの下で暗くなり、テキストが読みやすくなります。ユーザーが所有しているかライセンスを持つファイルを使用し、ライセンスで求められる場合はキャプションでクレジットを記載します。
  • バンドルされたフォント:Anton(凝縮、大文字、派手)、Poppins、Inter。すべてOFLライセンスです。
  • テンプレート自体を変更するには、src/Short.tsx を編集し、npm run studio でプレビューします。

エッジケース

  • 数字の出典がない場合: 使用しないでください。不足しているものを伝えてください。
  • 収まらないテキスト: シーンを分割してください。フォントを最小サイズより小さくしないでください(レンダラーは小さくしません)。
  • 右から左、CJKテキスト、または絵文字: バンドルされたフォントはこれらをカバーしておらず、空のボックスとして表示される可能性があります。その旨を伝え、それらを除外してください(絵文字はキャプションに入れることができます)。
  • ユーザーがトレンドのサウンドを希望する場合: API投稿では追加できません。postMode: MEDIA_UPLOAD を指定してTikTokに投稿し、ユーザーのTikTok受信トレイに保存し、アプリ内で完了できるようにします。
  • Linuxでレンダリングが失敗する ライブラリ不足の場合:references/platform-specs.md にリストされているパッケージをインストールしてください。
  • Windows: プロパティは常にJSONファイルで渡し、コマンドラインにインラインで記述しないでください。

品質基準

完了と見なす前に、以下すべてに合格している必要があります:

  • フレーム0にフック全体が表示されている(cuts.jpgを確認)。約10語以下で、成果を述べている。
  • 各シーンは一つのことを言っている。14語を超えるシーンはない。
  • すべての数字が出典と一致している。出典が画面またはキャプションに表示されている。
  • 警告がない、またはユーザーが警告を確認し --force を選択した。
  • 両方のシートを確認済み:破線の安全ラインの外側にテキストがない、ハイライトが正しい単語に当たっている。
  • 15~59秒。
  • アカウントごとに異なるバージョン。
  • 投稿前にユーザーが確認した。

関連スキル