Communitygithub.com

carrusel-motion

Instagram用のカルーセルを作成します。各スライドは短い動画(1080×1350、60fps)で、一見静止したデザインですが、スムーズにアニメーションします(テキストが行ごとに現れたり、線が描かれたり、カウンターやボタンなど)。「動くカルーセル」「アニメーションスライド」「Instagram用アニメーションポスト」がリクエストされた場合や、静止画スライドをマイクロアニメーション付きの動画に変換する場合に使用します。各スライドはRemotionでミュートMP4として生成され、ループが途切れずにつながるよう、開始と終了のフェードを持ちます。

carrusel-motion とは?

このスキルは、Instagramカルーセル広告用に、各スライドが約5秒の短い動画(1080×1350、60fps、ミュート)である一連のスライドを生成するためのものです。各動画は、一見静的なデザインに見えますが、微細な動き(テキストの行ごとの出現、線のアニメーション、カウンター、ボタンのホバーなど)を含み、視覚的に魅力的で、ユーザーを引き付けます。このスキルは、Claude Codeや類似のAIエージェントで使用するために設計されており、Node.jsとRemotionライブラリを活用して、プロフェッショナルな結果を提供します。ワークフローには、ユーザーが提供した静的スライドの画像やテキストからコンテンツを抽出し、各カルーセルに独自のスタイルを選択し(テンプレートのガイドラインに従いつつ)、Remotionプロジェクトをセットアップし、各スライドを構築し、最終的にレンダリングする前に複数のフレームを検査して、テキストの重なり、はみ出し、およびトランジションの滑らかさを確認することが含まれます。出力は各スライドごとに1つのMP4ファイルになります。主なルールとしては、すべてのスライドに開始と終了のフェードを持たせてループをシームレスにし、最初のスライド(カバー)はフレーム0で完全に表示されている必要がある(Instagramのプレビューが空白にならないように)、アニメーションはtransformとopacityのみを使用し、フィルターや背景のノイズは避ける、ロゴやブランド素材はユーザー提供のもののみを使用する、などがあります。

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

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

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

ドキュメント

動くカルーセル(Remotion)

Instagramカルーセルの各スライドが約5秒の動画で、一見すると静的なデザインに見えますが、内部ではスムーズに動きます。「静かだけど息づいている」というコントラストが、スワイプを促します。

使用するタイミング

  • Instagram用にアニメーションされた、または「動く」カルーセル/ポスト/スライドがリクエストされた場合
  • 静的なスライド画像(PNG)が提供され、アニメーション版が欲しい場合
  • テーマやテキストのみが提供され、ゼロからアニメーションカルーセルを作成する場合

ナレーション付きの全画面動画(9:16、音声あり)がリクエストされた場合、このスキルは適切ではありません。

必要なもの

  • Node.js 18以上。ffmpegやサービスのAPIキーは不要です。
  • ユーザーがロゴやマスコットを持っている場合:透明なPNG(または白背景のPNG。スクリプト scripts/preparar-brand.py が背景を除去します。PythonとPillowが必要です)。
  • ロゴや画像は、プロジェクトフォルダ内のファイルとして存在する必要があります。 チャットに貼り付けられた画像はファイルではありません。Claudeはそれを表示できますが、プロジェクトにコピーすることはできません。ユーザーがロゴを貼り付けた場合は、public/brand/ に保存するよう依頼してください。
  • Remotionのライセンス:個人および最大3名までのチームは無料。大企業はライセンスが必要です(https://www.remotion.dev/docs/license の最新条件を確認)。ユーザーが企業に所属していると思われる場合は、その旨を伝えてください。

ワークフロー

  1. コンテンツを理解する。 スライドの画像がある場合は、それらを読み(画像なので表示して確認)、テキストをそのまま書き起こします。必要に応じて短くしたり分割したりできますが(例:1行に孤立した単語ができないようにするなど)、意味を変えたりデータを捏造したりしないでください。
  2. このカルーセル独自のスタイルを選ぶ(referencias/variedad-de-estilo.md を参照)。楽だからといって別のカルーセルのスタイルをコピーしないでください。ユーザーがアイデンティティ(例:「黒背景に白テキスト」)を持っている場合はそれを尊重し、他の軸(構成、アニメーション要素)で変化をつけてください。
  3. プロジェクトをセットアップする。 既存のプロジェクトがない場合、このスキルの plantilla/ フォルダをユーザーの作業ディレクトリにコピーし、npm install を実行してください。テンプレートには基本ルールが記載された CLAUDE.md が含まれています。ユーザーがブランド情報を記入できるように手伝ってください(そうすれば毎回同じことを繰り返す必要がありません)。既存のプロジェクトがある場合は、src/carousels/<slug>/ に新しいカルーセルを追加し、src/carousels/index.tsx に登録してください。
  4. 各スライドを構築する plantilla/src/carousels/ejemplo/style.tsx のブロック(Block, Title, Body, Eyebrow, GhostNumber, Cta, Header, Footer)を使用します。1スライド = 1コンポジション <slug>-01、<slug>-02……
  5. レンダリング前に実際のフレームを確認する: npx remotion still src/index.ts <slug>-01 salida.png --frame=200 を4つのタイミング(開始時 ~フレーム10、静止時 ~200、終了時 ~285、そして最後の299)で実行し、各画像を確認します。テキストの途切れ、重なり、マージン、および最終フレームが(固定のヘッダーとフッターを除いて)空であることを確認します。
  6. 各スライドのMP4をレンダリングする(以下のコマンドを参照)。ファイルのリストを提供します。
  7. 確認していないことを正直に伝える: フレームは確認したが動きは確認していないこと、Instagramへのアップロードはテストしていないこと。

フォーマット(譲れない条件)

  • 1080 × 1350(4:5)、300フレーム、60fps(5秒)、音声なし(--muted)。
  • 左右のマージン80px。端に重要なものを配置しないこと(Instagramのプロフィールグリッドは4:5を3:4にトリミングするため、片側約34pxが失われます。80pxのマージンがあれば何も失われません)。
  • カバー(スライド1)— 必須:開始フェードなし。 すべてのコンテンツ(タイトル、テキスト、マスコット)はフレーム0で表示され、適切な位置にある必要があります。Instagramのプレビュー/サムネイルはこのフレームを使用するため、カバーが空から始まると投稿は真っ白になります。これは enterAt を非常に負の値(テンプレートでは COVER = -200)に設定することで実現します。その後は通常通り動きます。定期的な微小な動きと、他のスライドと同じ終了フェードを持ちます。変更されるのは開始部分のみで、残りのプロセスは同じです。他のスライド(2…N)は空から開始し、空で終了します。確認:カバーの --frame=0 は決して空になってはいけません。
  • 出力:out/carruseles/<slug>/<slug>_01.mp4、_02.mp4……

スライドごとのレンダリングコマンド:

npx remotion render src/index.ts <slug>-01 out/carruseles/<slug>/<slug>_01.mp4 --codec=h264 --crf=16 --pixel-format=yuv420p --image-format=png --muted

また、node scripts/render-carrusel.mjs <slug> <スライド数> を使用すると、すべてを一度にレンダリングできます。

滑らかさのルール(モバイルで「カクつき」を防ぐもの)

詳細は referencias/fluidez.md を参照。まとめ:

  • 60fps とスムーズなカーブ(easeOutCubic、easeInOutCubic)、開始時間約0.6秒。急激な指数カーブは避ける:急に始まり、微小なステップを引きずります。
  • 各スライドに開始フェードと終了フェード。すべてのコンテンツは最終フレームで非表示になり、動画が繰り返される際に途切れなくつながるようにします。常にフレーム299を確認する: インラインスタイルでコンテナの不透明度が上書きされると(例:opacity: undefined)、表示されたままになる可能性があります。
  • transform と opacity のみアニメーション化。フィルター(ぼかし、ディスプレイスメント)は禁止、背景に粒子/ノイズも禁止:Instagramが再圧縮するとちらつきます。影やグローはベイクド(固定)し、アニメーション化しないでください。
  • キャラクターやイラストをアニメーション化する場合:アセットはSVGまたは高解像度PNG、一貫した線の太さ、常にプロポーションを保ったスケーリング、微妙なスカッシュ&ストレッチ(±2-3%)。plantilla/src/motion.ts には、一時的なイベント用のヘルパー(bell、hold、wobble、win)があり、これらは静止状態から始まり静止状態で終わります。
  • ヘッダーとフッターは固定:動くものが少ないほど、より滑らかに感じられます。
  • アンビエントな動きは周期的(持続時間と同じ周期の loop 関数)にして、ループが連続的になるようにします。
  • すべて決定論的:Math.random やタイマーは使わず、すべてフレームの関数として記述します。

コンテンツとブランドのルール

  • 他社のロゴをコピーしないでください。 ユーザーが提供したロゴ/マスコットのみを public/brand/ で使用します。
  • 数字、価格、主張を捏造しないでください:ユーザーが提供したものを使用します。
  • ユーザーが指定したビジュアルアイデンティティ(色、背景、フォント)を尊重し、その範囲内でバリエーションを加えます。

スキルのファイル

  • plantilla/ — 最小限で機能的なRemotionプロジェクト。3スライドのサンプルカルーセルが含まれます。
  • referencias/fluidez.md — モバイルで滑らかな動きを実現する理由と方法。
  • referencias/variedad-de-estilo.md — 各カルーセルに独自の外観を持たせるための軸。
  • referencias/qa-checklist.md — 納品前のチェックリスト。
  • plantilla/CLAUDE.md — プロジェクトのルール。ユーザーのブランド情報を記入するためのもの。
  • plantilla/scripts/preparar-brand.py — ロゴをトリミングし、マスコットの白背景を除去します。

関連スキル