Communitygithub.com

ビデオチェック

レンダリング後の動画をプロのようにチェックし、問題を特定・修正します。ファイルの測定、映像・音声の欠陥検出、フレームシートの作成、レビューアによる問題指摘、最大3ラウンドの修正を行います。

ビデオチェック とは?

このスキルは、動画編集後に書き出されたファイルを、他の誰も見る前にプロの編集者がチェックするように徹底的に検証・修正するためのものです。主な機能として、FFmpegを使ったファイルサイズ・フレームレート・ピクセルフォーマット・長さの測定、黒/白フレーム、静止画、1フレームのグリッチ、スタッター、ループの異常などの映像欠陥検出、ラウドネス、クリッピング、無音区間、音声の早期終了などの音声問題の検出を行います。また、スマートフォンサイズで字幕安全領域がマークされたフレームシートを作成し、編集計画を知らないレビューアが問題を時間指定で指摘します。ワークフローは「測定→P0修正→フレームシートレビュー→修正→再チェック」のサイクルで、最大3ラウンドまで行います。ローカルファイルに対して動作し、動画の書き出し後や「動画を送る前にチェックして」と言われた時に使用します。他の人の動画を解析する用途(video-breakdown)や、未編集の素材を評価する用途には使いません。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/EditAtlas/skills/tree/HEAD/skills/video-check

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

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

ドキュメント

ビデオチェック:レンダリングの問題を誰よりも先に見つける

これは video-check 0.2.3 です。

ユーザーは、プロの編集者が書き出しをチェックするようにチェックされた動画と、測定内容、確認した項目、修正した項目、誰もチェックしなかった項目を簡潔に記した REVIEW.md を受け取ります。

以下の3つのことは常に当てはまります。

  • 最初に測定し、その後で目視する。 フレームだけを見ているモデルは、無変化の領域や1フレームのグリッチを見逃します。FFmpeg は見逃しません。目視する前に check.py を実行し、動画が「問題なさそうに見えた」という理由でスキップしてはいけません。
  • 作成者は最悪のレビューアです。 各ショットが何を示すべきか知っているため、絵ではなく計画を見てしまいます。あなたの計画を知らない人にフレームシートを確認してもらいましょう(ステップ3)。
  • あなたは音を聴けません。 スクリプトはラウドネス、ピーク、無音を測定します。音楽が合っているか、効果音が正しいか、話し言葉が明瞭かは、人間が聴く必要があります。その都度、その旨を伝えてください。

入力がない場合

レンダリングされたファイルがこのマシンにある必要があります。ユーザーが動画を口頭で説明するだけ、またはプラットフォームへのリンクを提供する場合は、ファイルを要求してください。TikTok、YouTube、Instagram からはダウンロードしないでください。自分で動画を作成した場合は、サイズ、フレームレート、長さ、ラウドネスターゲット、意図的な静止画やフラッシュといった計画も把握しています。ユーザーが自身の編集を持ち込む場合は、用途(プラットフォーム、長さ)を尋ね、その他は後述のデフォルト値を使用してください。

ワークフロー

  1. 測定する。 計画をスクリプトに渡して、欠陥と選択を区別させる:

    python scripts/check.py final.mp4 --out work/check1 --loudness -14
    

    自分で動画を作成した場合、またはユーザーから計画を聞いた場合、それを追加します:例 --expect 1080x1920 --fps 30 --duration 32 --holds 28.5-32 --flashes 12.4。サイズ、フレームレート、長さをプラットフォームから推測しないでください:誰も1080pを要求していない960x540のファイルはサイズ欠陥ではありません。計画がない場合は --expect を省略してください。--holds は意図的な静止画(エンドカード、静止したタイトル)をリストします。--flashes は計画された1フレームのフラッシュやディップをリストします。--loop はループ用の作品に使用します。--audio none は無音の作品に使用します。オンライン動画は約-14 LUFSにノーマライズされています。ポッドキャストには-16、放送には-23を使用してください。結果は P0/P1/P2 t=… code: what -> fix として出力され、check.json、overview_NN.png、findings.png が書き出されます。references/reading-the-checks.md は各チェックが捕捉するものと見逃すものを説明しています。

  2. P0は今すぐ修正する。 サイズ違い、フレームレート違い、長さ違い、音声があるべきところにない、クリッピング:これらはレンダリングミスであり、好みの問題ではありません。コマンドを修正し、再度レンダリングし、誰かが見る前にステップ1を再実行してください。ラウドネス、クリッピング、トゥルーピークについては、編集プロジェクトがあればミックスを修正します(音楽、最も大きい音を下げる)。完成したファイルしかない場合は、python scripts/fix_sound.py in.mp4 out.mp4 --loudness -14 を実行します。これによりピークを制限し、2パスでノーマライズし、映像をそのままコピーして、ターゲットの±0.2 LU以内、-1.5 dBTP未満に収めます。シングルパスの loudnorm はピークターゲットを外し、単純なリミッターはミックスを静かにしたままにします。フィルタを何度も手動で調整しないでください。

  3. 新鮮な目で見る。 すべての概要シートと findings.png を Read ツールで開きます。次に、あなたの計画を知らない別の人にチェックを依頼します:

    • サブエージェントを起動できる場合は、シート、プラットフォーム、動画の目的についての一文だけを渡します。計画、コード、意図は渡さないでください。references/review-guide.md のブリーフを使用します。
    • できない場合は自分で見ますが、計画は覆い隠します:各シートを他人のように説明し、1フレームにつき一文で、判断する前に説明します。REVIEW.md に「one context」と書きます。

    各問題は t=12.4s · 画面上の位置 · 問題内容 → 修正方法 と書き、P0(壊れている、読めない)、P1(視聴者が気づく)、P2(微調整)に分類します。10段階評価は付けません。評価は修正点を見つけられません。references/review-guide.md のリストを確認します。このリストには、テンプレートや機械が作ったように見える編集の兆候(スライド風の進行バーやステップカウンター、すべてのラインが同じように表示される、プラットフォームボタンの下のテキスト、空の最初のフレーム、誰も指定していない数字)が含まれています。

  4. 最悪の3つを修正し、再チェックする。 P0と最も悪いP1を3つ取ります。それぞれについて、レンダリングされたファイルではなく、編集リストまたはコマンドを変更します。修正方法を知らない場合は、search_techniques で目的の結果(例「音楽をスピーチに合わせて下げる」「カットで音声をフェードアウトする」)を検索し、get_technique でプロンプトを取得します。レンダリング後、--before work/check1/check.json --out work/check2 を指定してステップ1を再実行します。修正された項目、まだ残っている項目、新たに発生した項目がリストされ、before_after.png が描画されます。変更したフレームを確認します。

  5. 3ラウンドで停止する。 3ラウンド目でもP0が残っている、または大きな変更が必要な場合は、ループせずにユーザーに残っている問題とその理由を伝えます。ユーザーの判断が必要な問題(別の曲、存在しないショットなど)は質問としてユーザーに投げかけます。

成果物

最初に、バージョンチェック。 EditAtlas MCP が接続されている場合、get_skill を名前なしで呼び出します。video-check が 0.2.3 より上をリストしている場合、返信の最初の行に新しいバージョンが存在することとその更新方法(Claude Codeの場合:/plugin、次に Marketplaces、editatlas-skills、Update marketplace;それ以外の場合:get_skill に name video-check で手順が表示されます)を記述します。MCP がない場合はスキップします。

動画の隣に、ユーザーの言語で REVIEW.md を書き、references/review-guide.md のテンプレートを使用します:

  • 1行での判定:準備完了(残っている問題なし)、注意事項付き準備完了(注意事項には残っているすべての所見を列挙し、残っている各P1は編集プロジェクトなど、あなたが持っていないものが必要な場合)、または準備未完了(P0がまだある、またはあなたが修正可能なP1がある)。
  • スクリプトが測定した内容(サイズ、フレームレート、長さ、ラウドネス、トゥルーピーク、1分あたりのカット数)と各ラウンドで修正された所見。
  • 各ラウンドで残っている所見とその時間、および check.py が出力したパターン(例「0.4秒から12フレームごとに1回;11.7秒から14.9秒までは2~6フレームごとに1回」)、単なるカウントだけではありません。
  • レビューアが確認した内容、別のレビューアか one context かの別。
  • まだ人間が必要なもの:ミックスと音楽の選択の聴取、画面上のスペルと名前、リップシンク、実機電話での色、およびあなたが修正できなかったものすべて。誰も音を聴いていないという文を、平易な言葉で、ユーザーの言語でのみ記載してください。

最後のラウンドの before_after.png をユーザーに見せます。動画に「エラーがない」と書かないでください。代わりに何をチェックしたかを書いてください。

リファレンス

  • references/reading-the-checks.md:各測定値、そのしきい値、捕捉するものと見逃すもの、既知の動画での結果。所見が間違っているように見える場合、または --holds を設定する前に読んでください。
  • references/review-guide.md:レビューアへのブリーフ、兆候のリスト、問題のフォーマット、REVIEW.md のテンプレート。ステップ3で読んでください。

Individual skills in this repo

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

EditAtlas/sound-design

Sound-design a finished video with real sound effects from the EditAtlas library (2,278 described sounds, public, downloadable from GitHub with SHA-256 checks). Finds the moments in the picture, lets you look at them as frame sheets, picks sounds by description and measured numbers, places each on its exact frame at a level set by its role, keeps or replaces the film's own music and voice, renders a new MP4 plus a separate SFX WAV, and checks the result in numbers (sync, pace, holes, loudness, m

video-breakdown

Break down a reference video shot by shot and name what it does, so the person can make one like it. Measures cuts and transitions (dissolve, dip, wipe, shape, iris, push, zoom, flash), camera moves (crash zoom, push in, shake, speed change), text and graphics coming on screen and their timing (in, hold, out), each text's colours (gradient stops, outline, glow) and free lookalike fonts, the look, pacing, the beat and sound hits; you look at the frame sheets, then look up each element in EditAtlas and write a report with technique names, links, sounds and a recipe. Use it when someone shares a video they like and asks what effect, transition or edit is in it, how it was made, or how to remake it; says "video này dùng hiệu ứng gì", "phân tích video mẫu", "làm sao để edit giống video này", "hiệu ứng chuyển cảnh này tên gì", "reverse engineer this edit", "what transition is this". Works on a local file. Not for downloading videos from TikTok or YouTube, telling filmed from AI footage,...

関連スキル