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より)

  1. 変更ログマイニング – 最近のコミットやリリースノートをスキャンし、ユーザー向けの改善点を抽出して、分かりやすいセールスポイントに書き換えます。
  2. コンポーネントの再利用 – 対象リポジトリの実際のUIコンポーネントをマウントし、色、フォント、角丸、レイアウトなどを保持することで、ビデオにネイティブな感覚を与えます。
  3. スタイルモード – 3つのプリセット:
    • repo – 製品のビジュアル言語を完全に継承。
    • default – 内蔵のCodePilot「ウォームホワイト/チャコール」スタイルを使用。
    • hybrid – 実際のUIとカスタム外枠をミックス。
  4. ストーリーボード生成 – AIがショットのシーケンス(タイトル、機能のクローズアップ、フルワークスペース、詳細カット)を提案し、不足している詳細を尋ねます。
  5. アニメーションエンジン – GSAPがタイムラインを駆動し、Three.js / canvasが背景エフェクトを提供し、Playwrightが静止画フレームと最終ビデオをレンダリングします。
  6. オーディオパイプライン –
    • 短い音楽トラックを生成(ユーザー提供ファイル、ローカルの音楽生成モデル、またはリポジトリ同梱のコード合成例から)。
    • アクションごとの効果音(クリック、アラート、「ディン」という合図)を追加し、必要に応じて音楽を自動的にダッキングします。
  7. エクスポート – 以下を出力:
    • アップロード可能なMP4。
    • 完全なビデオプロジェクトフォルダ(編集可能なソース、タイムライン、アセット)。
    • サムネイルやカバーアート用のキーフレーム。
    • コンポーネントソース、オーディオライセンス、およびフォールバックレンダリング要素のマニフェスト。

実行方法

  1. Skills CLI経由でインストール(推奨):
    npx skills add https://github.com/op7418/guizang-product-video-skill --skill guizang-product-video-skill
    
  2. または手動でクローン:Codex (~/.agents/skills) または Claude Code (~/.claude/skills) の適切なディレクトリに配置します。
  3. 初回実行時に以下をチェックします:
    • Node ≥ 22 + npm
    • Python ≥ 3.9
    • FFmpeg/ffprobe
    • Playwright Chromium (不足している場合は自動インストール)
  4. インストール後、AIアシスタントからスキルを呼び出します。例:

    “用 guizang-product-video-skill,把这个项目最近三周的主要更新做成一支宣传片,横版 45-60 秒,中文。”

  5. アシスタントが必要なパラメータ(ターゲットバージョン範囲、ターゲット層、プラットフォーム、アスペクト比、言語、スタイル)を案内し、自動化パイプラインを実行します。

リポジトリの内容

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ライセンス(商用ライセンスオプションあり)。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト