op7418/guizang-product-video-skill
归藏 product video skill:复用真实产品组件和设计语言,用代码制作软件更新宣传片。包含分镜文案、原创配乐、动作音效与视频渲染,支持 Claude Code 和 Codex。
帰蔵 product video skill – AI支援によるプロモーションビデオ作成
概要 – Claude Code や Codex などのAIコーディングアシスタント向けの「スキル」(プラグイン)で、ソフトウェアリポジトリ(またはその最近の変更ログ)を短いプロモーションビデオに変換します。AIは構造化されたワークフローに従い、最も興味深い変更点を抽出し、製品独自のUIコンポーネントを再利用し、コピーを書き、音楽を作曲・合成し、効果音を追加し、GSAP/Three.jsですべてをアニメーション化し、最終的にMP4と完全に編集可能なビデオプロジェクトを出力します。
ターゲットユーザー
| ユーザー | メリット |
|---|---|
| プロダクト開発者:新バージョンをリリースしたばかりで、SNS、ニュースレター、ランディングページ用の迅速でブランドに沿ったデモビデオが必要な方。 | |
| マーケティングチーム:デザイナーやビデオ編集スタジオを雇うことなく、製品と全く同じ見た目のビデオを作成したい方。 | |
| AIコーディングツールユーザー (Claude Code, Codex, Vercel Skills):アシスタントに具体的で収益を生む機能を拡張したい方。 |
主な機能(READMEより)
- 変更ログマイニング – 最近のコミットやリリースノートをスキャンし、ユーザー向けの改善点を抽出して、分かりやすいセールスポイントに書き換えます。
- コンポーネントの再利用 – 対象リポジトリの実際のUIコンポーネントをマウントし、色、フォント、角丸、レイアウトなどを保持することで、ビデオにネイティブな感覚を与えます。
- スタイルモード – 3つのプリセット:
repo– 製品のビジュアル言語を完全に継承。default– 内蔵のCodePilot「ウォームホワイト/チャコール」スタイルを使用。hybrid– 実際のUIとカスタム外枠をミックス。
- ストーリーボード生成 – AIがショットのシーケンス(タイトル、機能のクローズアップ、フルワークスペース、詳細カット)を提案し、不足している詳細を尋ねます。
- アニメーションエンジン – GSAPがタイムラインを駆動し、Three.js / canvasが背景エフェクトを提供し、Playwrightが静止画フレームと最終ビデオをレンダリングします。
- オーディオパイプライン –
- 短い音楽トラックを生成(ユーザー提供ファイル、ローカルの音楽生成モデル、またはリポジトリ同梱のコード合成例から)。
- アクションごとの効果音(クリック、アラート、「ディン」という合図)を追加し、必要に応じて音楽を自動的にダッキングします。
- エクスポート – 以下を出力:
- アップロード可能なMP4。
- 完全なビデオプロジェクトフォルダ(編集可能なソース、タイムライン、アセット)。
- サムネイルやカバーアート用のキーフレーム。
- コンポーネントソース、オーディオライセンス、およびフォールバックレンダリング要素のマニフェスト。
実行方法
- Skills CLI経由でインストール(推奨):
npx skills add https://github.com/op7418/guizang-product-video-skill --skill guizang-product-video-skill - または手動でクローン:Codex (
~/.agents/skills) または Claude Code (~/.claude/skills) の適切なディレクトリに配置します。 - 初回実行時に以下をチェックします:
- Node ≥ 22 + npm
- Python ≥ 3.9
- FFmpeg/ffprobe
- Playwright Chromium (不足している場合は自動インストール)
- インストール後、AIアシスタントからスキルを呼び出します。例:
“用 guizang-product-video-skill,把这个项目最近三周的主要更新做成一支宣传片,横版 45-60 秒,中文。”
- アシスタントが必要なパラメータ(ターゲットバージョン範囲、ターゲット層、プラットフォーム、アスペクト比、言語、スタイル)を案内し、自動化パイプラインを実行します。
リポジトリの内容
LICENSE – AGPL-3.0 (メインコードとドキュメント)
COMMERCIAL_LICENSING.md – 商用ライセンスに関する連絡先
SKILL.md – AIツール向けのスキルの正式定義
agents/ – Codex表示用のメタデータ
references/ – デザイン語彙、ストーリーボードテンプレート、オーディオライセンス
scripts/ – 環境チェック、オーディオ合成、ミキシング、検証
assets/
starter/ – 最小限のReact + esbuild + Playwrightプロジェクト(「エンジン」)
fx-lab/ – 再利用可能な視覚効果サンプル(パーティクル、ストリームなど)
fallback/ – デフォルトのCodePilot UIコンポーネント (BSLライセンス)
audio/ – 2つの音楽トラック例 + 11の合成効果音
readme/ – READMEで使用されている画像
tests/ – パイプラインのユニットテストおよび統合テスト
リポジトリにはコアワークフロー用の GNU AGPL-3.0 ライセンスが含まれており、デフォルトのCodePilot UIアセットには個別のBusiness Source Licenseが適用されます。
制限事項と実用上の注意
- このスキルはワンクリックビデオジェネレーターではありません。AIが実際のコンポーネントをレンダリングするために、対象リポジトリ、依存関係、および実行可能なビルドへのアクセスが必要です。
- Reactベースのフロントエンドで最も効果を発揮します。他のフレームワークは
integration.config.mjsマッピングで統合可能ですが、追加のグルーコードが必要になる場合があります。 - デフォルトのCodePilotスタイルの商用利用はBSLを尊重する必要があります。独自のブランディングに置き換えることで、この制限を回避できます。
- ローカルの音楽生成モデルがない場合、オーディオ生成は事前に構築された小さな合成WAVファイルのセットにフォールバックします。
- 出力されたプロジェクトは完全に編集可能であるため、タイミングの微調整、アセットの置き換え、コード変更後の再レンダリングが可能です。
結論
guizang-product-video-skill は、製品固有の短いプロモーションビデオの作成をエンドツーエンドで自動化する実用的なオープンソースAIエージェントスキルです。コード駆動型のUIレンダリング、AIによるコピーライティング、プログラムによるオーディオ合成を組み合わせ、Claude CodeやCodexなどのAIコーディングアシスタントから使用することを目的としています。最近のソフトウェアリリースに向けて、迅速でブランドに沿ったデモビデオが必要な場合、このスキルは静的なテンプレートではなく、再現可能で編集可能なパイプラインを提供します。
リポジトリ最終更新: 2026年。AGPL-3.0ライセンス(商用ライセンスオプションあり)。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト