Communitygithub.com

product-promo-from-repo

リポジトリ内のソースコードからソフトウェア製品のプロモーション・ローンチビデオ(ストーリーライン、ショット単位の仕様、MiniMaxナレーション、コードで合成されたオリジナル楽曲、フロントエンド/バックエンドコードからHTMLで再描画された製品画面)を生成します。

product-promo-from-repo とは?

このスキルは、Gitリポジトリ内のソースコードから直接、ソフトウェア製品のプロモーション動画(30〜45秒)を完全に生成するための包括的なガイドです。製品のコードから正しいブランチを特定し、ナビゲーションやタスクフロー、バックエンドデータなどの事実を収集することで、動画内のすべての主張が実際のコードに基づいていることを保証します。複数のストーリーライン案を `STORYLINES.md` に提案し、ユーザーが選択します。動画の音声は MiniMax TTS API を使用して生成し、各ショットの長さに合わせたタイミング調整が可能です。製品画面はアプリケーションを実行せずに、コンポーネント、CSS、バックエンドデータからHTMLで再描画されるため、常に最新のコードベースを反映します。また、`scripts/score.py` を使用してコードでオリジナル楽曲を合成し、動画のクライマックスやロゴ表示に合わせたビートを設定できます。最後に、`SPEC.md` と `REVIEW.md` を作成して、ショットの仕様、制約、品質保証を文書化します。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/rayest/ai-video-skills/tree/HEAD/skills/product-promo-from-repo

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

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

ドキュメント

リポジトリからのプロモーション動画生成

1人の視聴者が製品内で1つの実際のタスクを実行する様子を、コードからの実際のラベル、ナレーション、オリジナル楽曲とともに映した30〜45秒の動画です。このスキルは、コードから正しい製品情報を取得し、ストーリー、音声、音楽、そして再描画された画面をカバーします。レンダリングエンジンは指定しません。ユーザーと相談の上選択してください(無料ツールを推奨)。

1. 正しいコードを読む

  • 何かを読む前に、git fetch --all を実行し、各ブランチを比較します(各ブランチに対して git log -1 origin/<b>)。デフォルトブランチは古くなっている可能性があります。main が初期コミットのまま、製品がリネームされて dev で再構築されている可能性があります。間違ったブランチでストーリーラインを構築すると、丸々1ラウンド無駄になります。ユーザーが名前や機能が変更されたと言った場合は、それを信じてそのブランチを見つけてください(git grep -c <新しい名前> origin/<b>)。
  • 印象ではなく事実を収集します:ナビゲーション(製品自体の機能マップ)、メインタスクフローのページコンポーネント、バックエンドシードデータ内のカタログ名、実際の制限や数値(最大長、「推定秒数 = 文字数 ÷ 4.5」のような計算式)。動画内のすべての主張は、これらのいずれかに遡れる必要があります。
  • リポジトリからロゴとサムネイル/アイコンを assets/ にコピーします。ロゴに古いブランドテキストが含まれていないことを確認します。

2. ストーリーラインを作成し、そこで止まる

3つのストーリーラインを STORYLINES.md に書き(それぞれ:1行の前提、時間付きビートリスト、各継ぎ目を繋ぐトランジション)、ユーザーが選択するのを待ちます。複数ステップの製品で最も効果的だったストーリーライン:1つのオブジェクトが製品のステップを通過する(見つけた投稿 → トピックカード → スクリプト → 完成動画)、カーソルで掴むことで開始されます。あなたの推奨を最初に置きます。

前提を1行で述べます:長さ30〜40秒、1920×1080、音楽+効果、ナレーションあり/なし、画面上の製品データはデモデータ。

3. ナレーション(MiniMax)

要求された場合のみ。$MINIMAX_API_KEY または ~/.minimax_key の最初の行をキーとして使用します。決して表示しないでください。

  1. 各ビートにつき1行の短いスクリプトを voice/script.json に作成します([{"id", "text"}])。1秒あたり約4.5文字、35〜40秒で約120〜140文字。行は原因と結果であり、スローガンではありません。画面にはキーワードを表示し、読み上げられる文をそのまま表示しないでください。
  2. ユーザーに行、音声ID、モデルを表示し、承認を得ます。各呼び出しは課金されます。python3 -I scripts/tts_minimax.py voice --dry-run で文字数と推定時間を表示します。
  3. 一度生成します:python3 -I scripts/tts_minimax.py voice [--voice ID] → vo-<id>.mp3 と durations.json。1行だけ再生成するには --only id を使用します。
  4. 音声が時計の役割を果たします:durations.json からシーンを配置します(各行はシーンの開始から約0.15〜0.25秒後に始まり、シーンの長さは行+0.3〜0.6秒)。

4. 製品画面:コードから再描画

スクリーンショットのためにアプリを実行したりバックエンドをモックしたりせずに、コンポーネント、CSS、バックエンドデータからHTMLで画面を再構築します。最初の製品シーンの前に references/ui-redraw.md を読んでください。

デモデータには「演示データ · 虚构」とラベルを付けます。古い製品名やロゴを表示したり、コードに存在しないボタンを発明したりしないでください。

5. 音楽と効果音

  • scripts/score.py は、バーのグリッドがクライマックスにダウンビートを置き、ロゴヒットがその後ちょうど整数の拍数になるように設計されたオリジナルトラックを合成します(numpy + scipyが必要): score.py assets/bgm/score.wav --total 38.5 --bpm 104 --hook-end 4.6 --reveal 9.8 --build 24.2 --payoff 27.0 --claim 31.6 --logo-beats 13 --logo-beats は、payoff + beats × 60/bpm がエンドカードのマークの位置と一致するように選択します。
  • 効果音は無料ソースから(クリック、ウィッシュ、ポップ、タイピング、ライザー、インパクト、スパークル)。目に見える原因ごとに1つの音。

6. 仕様とレビュー

  • シーンの前に SPEC.md を書きます:GOAL、OUTPUT、TIME、VOICE、DATA、LOOK、OBJECTS、MOTION、SHOTS(時間付き)、BANNED、QAフレーム。
  • すべてのビートと継ぎ目を確認します:動きの方向が反転する継ぎ目(右から出て行くオブジェクトは次のシーンでは右から入る)、着地前にフェードする要素、ヒーローフレームの空の半分を修正します。
  • REVIEW.md を書きます:クリエイティブな判断、測定したものと目視のみで確認したもの、最も弱いショット。
  • 最終オーディオ:約 -16〜-14 LUFS、トゥルーピーク ≤ -1 dBTP、クリッピングなし。音は聞いたのではなく測定したと明記します。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル