Communitygithub.com

Alexander-Kz/video-layer-skill

プロダクションレベルのマルチエージェントClaude Codeスキル – ナレーションMP3から完全なホワイトボード解説YouTube動画を生成します。ディスク上のブリーフ+SHA256検証、ゲート付き2ウェーブ生成、ビジョンレビューループを備えています。

video-layer-skill とは?

このスキルは、Claude Code上で動作するプロダクションレベルのマルチエージェントシステムで、ナレーションのMP3ファイルを入力として、完全なホワイトボードスタイルのYouTube解説動画を自動生成します。主な特徴として、ディスク上に保存されたブリーフ(指示書)のSHA256ハッシュによる整合性検証、2段階のゲート付き生成プロセス(1ウェーブ目で大まかな構造を作成し、2ウェーブ目で詳細を洗練)、そしてビジョンモデルを用いたフレームごとのレビューループを備えており、品質を保証します。開発ツールやエージェントワークフローに精通したユーザーにとって、手動の動画編集作業を大幅に削減し、一貫性のある高品質な解説動画を効率的に量産できる点が大きな利点です。Claude Codeのエージェント機能を最大限に活用し、ファイルシステム操作や外部API呼び出し、ビジョンベースの品質チェックなどを連携させて動作します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add Alexander-Kz/video-layer-skill

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

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

ドキュメント

video-layer-skill は何をしますか?

プロダクションレベルのマルチエージェントClaude Codeスキル – ナレーションMP3から完全なホワイトボード解説YouTube動画を生成します。ディスク上のブリーフ+SHA256検証、ゲート付き2ウェーブ生成、ビジョンレビューループを備えています。

概要

このスキルは、Claude Codeのエージェント機能を活用し、以下のプロセスで動画を自動生成します。

  1. ブリーフの読み込みと検証: ディスク上に保存されたブリーフ(Markdown形式)を読み込み、そのSHA256ハッシュを検証して改ざんや破損がないことを確認します。
  2. 2ウェーブ生成:
    • ウェーブ1: ブリーフに基づき、動画の大まかな構造(セクション、遷移、キーポイント)を生成します。
    • ウェーブ2: ウェーブ1の出力を基に、詳細なフレーム、アニメーション指示、テキスト配置などを洗練します。各ウェーブ間にはゲート(品質チェック)が設けられており、条件を満たさない場合は再生成が行われます。
  3. ビジョンレビューループ: 生成された各フレームをVisionモデル(例: Claude 3.5 Sonnetのビジョン機能)でレビューし、描画内容の正確さ、テキストの可読性、視覚的な一貫性をチェックします。問題があれば修正指示を出し、再度生成します。このループは品質が基準を満たすまで繰り返されます。
  4. 最終出力: すべてのレビューを通過したフレーム群を、動画ファイル(例: MP4)にレンダリングします。

必要条件

  • Claude Codeがインストールされ、使用可能であること。
  • 以下の環境変数が設定されていること(必要な場合):
    • VIDEO_OUTPUT_DIR: 出力動画の保存先ディレクトリ
    • BRIEF_FILE_PATH: ブリーフファイルのパス
    • SHA256_CHECKSUM: ブリーフファイルの期待されるSHA256チェックサム

使用方法

  1. 必要な環境変数を設定します。
  2. ナレーションMP3ファイルを所定の場所に配置します。
  3. ブリーフファイルを作成し、SHA256チェックサムを計算します。
  4. Claude Codeを起動し、以下のコマンドを実行します:
claude ./path/to/skill/directory --skill

または、スキルがインストールされている場合は:

claude --skill Alexander-Kz/video-layer-skill
  1. プロンプトに従い、必要な情報(例: MP3ファイルのパス、ブリーフのパス)を入力します。

ファイル構成

video-layer-skill/
├── SKILL.md          # このファイル
├── scripts/
│   ├── verify_brief.sh  # ブリーフのSHA256検証スクリプト
│   └── render_video.sh  # 動画レンダリングスクリプト
├── prompts/
│   ├── wave1_prompt.md  # ウェーブ1用プロンプト
│   └── wave2_prompt.md  # ウェーブ2用プロンプト
└── config/
    └── settings.json # 設定ファイル

トラブルシューティング

  • ブリーフ検証エラー: SHA256_CHECKSUM 環境変数が正しく設定されているか確認してください。ブリーフファイルが変更されていないかも確認してください。
  • レンダリングに失敗する: 出力ディレクトリに書き込み権限があることを確認し、必要なコーデックがインストールされているか確認してください。
  • ビジョンレビューで不合格になる: ブリーフの指示をより具体的にし、生成されるフレームの品質を向上させてください。

ライセンス

このスキルはMITライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

関連スキル