Communitygithub.com

flutter-demo-reel

FlutterアプリをSNS向けのループするプロモーションビデオ(16:9・9:16、60fps)に変換します。macOS用Flutterアプリとして<app>/demo内に構築し、flutter_scene(Flutter GPU)による3Dレイヤー、2Dパーティクル&タイトルキット、サウンドトラックに同期したカット、H.264 / ProResへのオフライン書き出しを備えています。プロモ、デモリール、トレーラー、ティーザー、ローンチビデオ、SNS動画、Flutterアプリのアニメーションショーケースをユーザーが依頼したときに使用します。

flutter-demo-reel とは?

Flutter demo reelは、Flutterアプリのプロモーション動画(デモリール)を、そのアプリ専用のmacOS用Flutterアプリとして生成するためのスキルです。このスキルは、アプリの実際のスクリーン、アート、フォント、コンテンツを活用し、flutter_scene(Metal上のGPU)による3Dレイヤー、2Dパーティクル&タイトルキット、およびサウンドトラックに同期したカットを組み合わせます。すべてのフレームは時刻 `t` の純粋関数として計算されるため、シークレット、チャンク書き出し、モーションブラー、シームレスループが可能です。ワークフローは、インタビュー、サウンドトラック分析、スクリプト作成、scaffold、セクションごとの構築(3Dフレーム・2Dレイヤー)、確認、そしてH.264(MP4)とProResへの書き出しという段階を踏みます。Claude Code、Cursor、Codexなどのプラットフォームで動作し、開発者は高品質なプロモーションビデオを簡単かつ再現性高く作成できます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/vlidholt/flutter-skills/tree/HEAD/skills/flutter-demo-reel

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

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

ドキュメント

Flutter デモリール

Flutterアプリの短いループプロモーション動画を、そのアプリ専用のmacOS用Flutterアプリとして <flutter app>/demo に構築し、フレームごとにオフラインレンダリングしてエンコードします。 リールはアプリの実際の画面、アート、フォント、コンテンツを使用し、flutter_scene(Metal上のFlutter GPU)による3Dレイヤー、 2Dパーティクル&タイトルキット、音楽に同期したカットを備えています。

以下のパスは、このスキルが含まれるフォルダ(このSKILL.mdが置かれているフォルダ)からの相対パスです。 Claude Codeでは、そのフォルダは ${CLAUDE_SKILL_DIR} です。

基本ルール

  • アプリを決して変更しないでください。 必要なもの(アート、フォント、スクリーンショット、コンテンツデータ、テーマカラー)は demo/ にコピーしてください。scaffoldは demo/** を親パッケージのアナライザの除外対象に追加するだけです。
  • すべてのフレームは t の純粋関数です。 フレーム間の状態、Random()、クロック、シミュレーションは禁止:閉じた形式のモーション、シード付き乱数を使用します。これにより、シーク、チャンク書き出し、モーションブラー、シームレスループが可能になります。ショットを書く前に references/kit.md を読んでください。
  • プロジェクトの音声ルール(AGENTS.md、CLAUDE.md など)に従ってください。 アプリが決して使わない単語、製品の自称、トーン。
  • 構築前に同意を得てください。 ユーザーにインタビューし、承認されるスクリプトを書いてください。
  • macOSのみ。 Flutter(macOSデスクトップ対応)、ffmpeg(brew install ffmpeg)、Python 3(Pillow:コンタクトシート、numpy:音声解析)が必要です。

ワークフロー

1. インタビュー

始める前に、各項目にデフォルトを提示してユーザーが素早く回答できるように質問してください。

  1. 長さとループ(デフォルト30秒、シームレスループ)、フォーマット(ランドスケープ1920x1080、ポートレート1080x1920(Reels、TikTok、Shorts向け))、60fps。
  2. サウンドトラック:ファイル(歌詞あり?)またはなし、権利の所有者。
  3. メッセージ:表示する3~5項目、コールトゥアクション(URL、ストアバッジ)、主張する点(無料?評価?カウント?)。
  4. 見た目とトーン:派手さの度合い、アプリのブランド、参考資料。
  5. 実際の画面:どれか、アプリを実行してキャプチャしてよいか(テストアカウント、シードデータ)。架空の雰囲気ショットも?
  6. 画面上のテキスト:キーワードのみ(デフォルト)か完全なキャプションか、製品名のスペル、避けるべき単語。
  7. 特別なもの:イースターエッグ、キャラクター、絶対に表示してはいけないもの。

2. アプリを調査する

アプリのテーマ(色、フォント)、アセット(ロゴ、キャラクター、アイコン)、コンテンツ(実際の名前、数値、表示するデータ)、メイン画面を読み取ります。特徴的な点をメモします。スクリーンショットを計画してキャプチャするか、ユーザーに依頼します(references/craft.md の「実際のスクリーンショット」を参照)。

3. サウンドトラックを分析する

python3 scripts/analyze_audio.py <track>

テンポ、ビート位相、セクション、ボーカルラインを名前付きキューに変換します(references/audio-sync.md を参照)。サウンドトラックがない場合でも、テンポを選び、そのグリッドに合わせてカットします。

4. スクリプトを書く

各ショットについて、音楽または歌詞、ランドスケープ画像、ポートレート画像、画面上のテキストを記したタイムテーブルを作成します(テンプレートは references/craft.md にあります)。フック、ドロップ、エンドカード、ループの継ぎ目をマークします。ユーザーの承認を得て、ゴーサインが出るまで繰り返します。

5. スキャフォールド

zsh scripts/scaffold.sh <flutter app dir>

このスキルの scripts/ フォルダへのフルパスを指定して実行します(どのディレクトリからでも動作します)。

  • <app>/demo を flutter create --platforms macos で作成します。
  • flutter_scene、vector_math、audioplayers を追加し、flutter_scene:init を実行します。
  • Flutter GPU を有効化(FLTEnableFlutterGPU)、アプリサンドボックスを無効化(書き出し時にffmpegを実行するため)。
  • assets/template/ からスターターキットをコピー、art/、art/screens/、audio/、fonts/ を作成、out/ を無視します。
  • 親パッケージのアナライザから demo/** を除外します。

pub workspaces 内でも機能し(デモはスタンドアロンパッケージのまま)、既存のフォルダを上書きしません。

次に設定します。

  • lib/core/timeline.dart:kDuration、kBpm、kBeatPhase、Cue。
  • lib/core/format.dart:アプリのテーマからの Palette、Fonts(フォントファイルを demo/fonts/ にコピーし、pubspec.yaml で宣言)。
  • アセット:art/(pubspec.yaml でサブフォルダをリスト)、audio/track.wav(48kHz PCM)。

一度ビルドして、サンプルのスチルをレンダリングし、設定が機能することを確認します。

cd <app>/demo && flutter build macos --profile && tool/run.sh stills "0.3,2.3,9" both

6. リールを構築する

lib/shots/example.dart をスクリプトの各パートごとのセクションに置き換え、Director.sections にリストし、Director._hits でカメラヒットを設定します。セクションごとに作業します。

  1. キット(references/kit.md)と flutter_scene(references/flutter-scene.md)を使用してセクション(3Dフレーム、その上下の2Dレイヤー)を書きます。
  2. flutter build macos --profile を実行し、セクションのキーモーメントでスチルを両方のフォーマットでレンダリングします:tool/run.sh stills "t1,t2,..." both。
  3. フォーマットごとに1つのコンタクトシートを作成し、詳細が重要な箇所はシングルスチルを拡大して検査します: python3 tool/sheet.py out/l.png 4 480 out/stills/landscape_*.png。画像を表示できない場合は、どのスチルを確認すべきか、何を探すべきかをユーザーに伝えます。修正して繰り返します。

書き出す前に、references/craft.md のレビューチェックリスト全体をリールに対して実行します。ユーザーはプレビューアプリで音楽とともに視聴できます(open build/macos/Build/Products/Profile/*.app)。スチルではタイミングを確認できません。

7. 書き出し

tool/export.sh draft both     # 1倍、モーションブラーなし:クイック全体チェック
tool/export.sh final both     # 2倍スーパーサンプル、4サンプルモーションブラー

最終書き出しは、30秒の場合、フォーマットあたり約10~15分かかります。環境が許せばバックグラウンドで実行し、ポーリングはしないでください。その後、ffprobe でファイルを確認します:フレーム数が kDuration * kFps であること、長さが正しいこと、オーディオストリームがあること。MP4から数フレームを抽出します(最終フレームとフレーム0(ループの継ぎ目)を含む)。

8. 納品と反復

ユーザーにパス(アップロード用は demo/out/final/<format>.mp4、編集用は <format>_master.mov ProRes)、ファイルサイズ、確認すべき点を伝えます。フィードバックを期待します。references/craft.md に典型的な修正例があります:テキストの表示時間が短すぎる、テキストが隠れている、不要な字幕、アウトラインの継ぎ目、ハードな光線、同じに見えるアイテム群、ポートレートの文言。再レンダリング前にすべてのフィードバックをラウンドで修正します。

ファイル

  • references/kit.md:スターターキットのアーキテクチャとAPI。
  • references/flutter-scene.md:flutter_sceneのセットアップ、見た目、オフラインの注意点。
  • references/audio-sync.md:トラックからのテンポ、位相、歌詞、キュー。
  • references/craft.md:スクリプトテンプレート、テキストルール、エフェクトレシピ、スクリーンショット、レビューチェックリスト。
  • scripts/scaffold.sh:デモアプリを作成します。
  • scripts/analyze_audio.py:テンポ、ビート位相、バーあたりのラウドネス、オンセット。
  • assets/template/:scaffoldがコピーするスターターキット。

関連スキル