Communitygithub.com

編集納品QA

最終ビデオ編集の納品前検証を行います。エージェントがレンダリングされたMP4/MOV/WebMを検査し、再生時間・解像度・フレームレート・オーディオを確認、コンタクトシートの生成またはレビュー、タイムラインCSVの分析、カット密度・ソース混合のチェック、FX統合とまとまりの確認、テキストとビートの同期検証、弱いフレームや誤ったプレースホルダーの発見を行い、ビート同期されたソーシャル編集の公開準備が整っているかを判断します。

編集納品QA とは?

「編集納品QA」は、ビデオ編集が最終納品前に必要なすべての品質基準を満たしているかを検証するAIエージェントスキルです。このスキルは、レンダリングされたビデオファイル(MP4/MOV/WebM)の技術仕様(再生時間、解像度、フレームレート、コーデック、オーディオ有無)をプローブし、コンタクトシートを生成・レビューして意図しない空フレームやウォーターマークを検出します。また、タイムラインCSVを解析してセグメント数、平均/最小/最大セグメント長、ソース混合率、カテゴリ混合率、優先ヒット使用率を評価し、ビート同期されたモンタージュのカット密度やテキストとビートの同期オフセット(100ms未満であること)も検証します。さらに、合成エフェクトのまとまり(シールのように浮いていないか)、ループ編集のシームレスさ、スマートフォン表示での品質もチェックします。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントプラットフォームで使用でき、自動化されたQAスクリプト(scripts/qa_video_edit.py)と連携してJSON/Markdownレポートを生成しますが、自動化は人間による目視検査を補完するものであり、最終的な判断は人間のレビューと組み合わせる必要があります。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BusyBee3333/viral-video-edit-skills/tree/main/skills/edit-delivery-qa

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

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

ドキュメント

編集納品QA は何をしますか?

概要

このスキルは、ビデオ編集を完成品として提出する前に使用します。期待される出力は、簡潔なQAレポート(技術仕様、タイムラインの健全性、視覚的レビューコメント、および納品前に必要な修正点)です。

必須チェック

  1. 最終レンダリングをプローブする:
    • 再生時間
    • 解像度
    • フレームレート
    • ビデオコーデック
    • オーディオストリームの有無
    • 配信コンテナ
  2. コンタクトシートがまだ存在しない場合は生成する。
  3. コンタクトシートをレビューする:
    • 意図的でアクティブなフレームであること
    • 意図的でない限り、タイトルカード/インタビュー/空白フレームがないこと
    • ウォーターマークやストックプレビューのオーバーレイがないこと
    • クロップ後も被写体/アクションが判読可能であること
    • アクセントが意図的であり、ランダムな埋め草ではないこと
  4. タイムラインCSVが利用可能な場合は検査する:
    • セグメント数
    • 平均/最小/最大セグメント長
    • ソース混合
    • 種類/カテゴリ混合
    • 優先ヒット使用率
  5. 結果をターゲットフォーマットとクリエイティブブリーフと比較する。
  6. 編集が「準備完了」、「小幅な修正が必要」、または「再レンダリングが必要」のいずれかを判定する。

ビート同期モンタージュのターゲット

密度の高いソーシャルモンタージュカットの場合:

  • 再生時間: 通常 30-40秒。
  • 縦型: 1080x1920、横型: 1920x1080。
  • フレームレート: 最低 30fps。
  • 35秒の高エネルギーモンタージュの場合、映像が対応できれば 70-90 セグメントが適切。
  • 平均セグメント長: 約 0.35-0.50秒。
  • オーディオは存在し、クリーンであること。
  • コンタクトシートは、ほぼアクティブで意図的な映像を示すこと。

統合FX & クラフトチェック(2026年7月追加)

エフェクトやテキストレイヤーを含む編集では、必須チェックに以下を追加する:

  • まとまり / シールチェック: 合成要素が、シーン内のオブジェクトではなく、トラッキングされていないシールのように見えないか? いずれかのセグメントが別のビデオへのカットアウェイに見えないか? 1つのショットが共通のグレードを破っていないか(自然なショットの中で1つだけ異なるルック)? いずれかが「はい」= 修正 — これらは最も頻度の高いリジェクト原因です。
  • テキスト同期チェック: フックラインがビートに合わせて配置されるべき場合、テキスト表示フレームとオーディオアクセントの間の実際のオフセットを測定する。 |オフセット| > 100ms = 再レンダリング。
  • ループチェック: 終端を先頭に再生し直す。ループシーム編集は不可視でなければならない。
  • スマートフォンスケールチェック: フルサイズとスマートフォンスケールの両方で検査する。QAレポートと共に、規定のタイムスタンプ(例: 15秒の作品の1/4/8/12/14秒)および後半フレームのスポットチェックでレビューフレームを保存する。
  • 安価なプルーフ段階(フルビルドの前、後ではない): フル/VFXレンダリングにコミットする前に、最初の3〜5秒の低解像度スケルトンをレンダリングし、スクロール速度で視聴する — このゲートではキル基準は安価ですが、VFX後は高価になります。
  • QuickTime納品: Appleプレイヤーでレビューが行われる場合、QuickTime互換の.movも生成し、個別にQAする。
  • 公開されるものについては、5つの独立したゲートを実行する: 技術、視覚、ナラティブ、オリジナリティ/権利、プラットフォームパッケージ。自動QAは通常速度でのレンダリング視聴をサポートしますが、決して置き換えるものではありません。粒状感は問題ありません(視聴者は好みます)。ブロックノイズ、バンディング、アップスケールブラー、ウォーターマーク、ボーダーが実際のペナルティです。

失敗パターン

以下の場合は編集を修正に回す:

  • オーディオストリームがない、またはオーディオの抜粋が間違っている
  • アスペクト比が間違っている、または意図しないクロップ
  • 空フレーム、タイトルカード、インタビュー、ストックウォーターマーク、または価格オーバーレイ
  • 縦型クロップによってアクションが隠れている
  • メインプレミスを置き換える、弱い群衆/レーザー/自然のインサートが多すぎる
  • 優先的なミュージカルヒットが低モーションの映像で使われている
  • タイムラインCSVと最終レンダリングが実質的に一致しない

スクリプト

最終ビデオに対して scripts/qa_video_edit.py を実行します。利用可能な場合は --timeline と --contact-sheet を追加します:

python3 scripts/qa_video_edit.py final.mp4 --timeline final_timeline.csv --contact-sheet final_contact_sheet.jpg --out final_qa

このスクリプトはJSONとMarkdownを出力します。--make-contact-sheet が設定されている場合、FFmpegを使用してコンタクトシートを作成することもできます。

人間によるレビュー

スクリプトは仕様とタイムラインの問題を検出しますが、視聴やフレームの検査を置き換えるものではありません。常に自動QAと少なくともコンタクトシートレビューを組み合わせ、編集がハイステークスまたは視覚的に密度が高い場合には最終レンダリングを視聴してください。

Conteto Machino標準については、references/edit-qa-standard.md を参照してください。

オプションのリファレンス:

  • references/qa-thresholds.md: 編集タイプ別の適応可能なしきい値。
  • references/example-prompts.md: 再利用可能な最終QAプロンプト。
  • references/gui-vision.md: ビジュアルQAおよびデリバリーパネルの製品ビジョン。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

beat-synced-montage-builder

Build beat-synced social video montages from song-analysis outputs and source footage. Use when an agent needs to assemble, plan, or revise a music-timed edit; map footage to beats/onsets/cut markers; create vertical or landscape montage timelines; integrate audio-reactive FX into shots; mix gameplay, crowd, concert, nature, menu, or other accent footage; generate timeline CSVs, contact sheets, and edit briefs; or adapt the Conteto Machino / Smash Mash workflow for another song or footage library.

generated-media-sourcing

Generate or plan media assets for beat-synced edits when real footage is missing or the user asks for generated visuals - AI video (Gemini/Veo/Flow), AI images, or procedural audio-reactive GPU renders (tunnels, portals, kaleidoscopes, starbursts, mandalas, title pieces via Python+moderngl GLSL). Use with beat-synced-montage-builder when a montage needs generated clips, stills, or procedural audio-reactive elements instead of, or alongside, sourced footage.

song-edit-analysis

Analyze songs and audio files for beat-synced video editing, clip timing, energy mapping, viral window selection, onset-locked cut grids, footage selection, and agent-readable edit briefs. Use when an agent needs to inspect an MP3/WAV/M4A/audio track, estimate tempo and beat grids, identify sections, produce cut markers, pick the best 15-30s window of a song for short-form video, or guide a human or another agent in choosing footage that matches musical energy.

viral-video-edits

End-to-end system for making S-tier beat-synced short-form music video edits — song analysis, viral window selection, footage sourcing with shot-level QA, hook writing, onset-locked cutting, integrated audio-reactive FX (person mattes, procedural GLSL renderers, cinematic grade), and delivery QA. Use this whenever the user asks to make a video edit, music video, reel, TikTok/Shorts/vertical video, beat-synced montage, lyric/hook video, audio-reactive visual, tunnel/portal/kaleidoscope render, or to promote a song with video content — even if they don

関連スキル