Communitygithub.com

editar-video

ffmpeg を使用したプロフェッショナルレベルのリアルビデオ編集——色補正(正規化→バランス→シーン調整→ルック)、彩度、コントラスト、BT.709 合法レベル、肌色、iPhone HLG→SDR、カット、J/L カット、レイヤー、テキスト、字幕、LUT .cube、ズーム/手ブレ補正、ラウドネス、Reels/TikTok 向け出力。色は計測(スコープとシーンごとの数値)で判断し、「見た目」ではありません。編集前後のシートを数値付きで提供します。

editar-video とは?

このスキルは、ffmpeg と Python スクリプトを使用した、計測ベースのプロフェッショナルビデオ編集を提供します。Claude Code を含む主要な AI エージェントで動作し、すべての編集判断を客観的な数値(スコープ、パーセンタイル、肌の色相など)で行います。 主な機能: - シーンごとの診断:波形、パレード RGB、ベクタースコープ、ヒストグラムを自動生成 - フルカラーグレーディングパイプライン:正規化、ホワイトバランス、シーン調整、ルック適用 - iPhone HLG→SDR の正確な変換を含む HDR 処理 - メトリクス駆動の編集:シーン比較ツールで数値の改善を可視化 - プロフェッショナルな編集機能:J/L カット、テキスト、字幕、LUT 生成、動き - プラットフォーム別出力(Reels/TikTok)の安全エリア、ラウドネス、フォーマット 「映像を編集して」「色を直して」「シーンを合わせて」「肌の色がおかしい」「LUT を適用して」「映像をプロっぽくして」といった指示に対応。このスキルは、従来の「目で見て合わせる」やり方とは異なり、すべての調整を測定値で検証するため、一貫性と再現性が保証されます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/arthurmkt/arthur-portfolio-mkt/tree/main/design/editar-video

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

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

ドキュメント

計測に基づくビデオ編集

原則: 色は計測で判断します。私が提案するすべての色変更には、その動機となった数値(スコープ、パーセンタイル、肌の角度)と変更後の数値が付随します。このスキルのすべてのルールには出典が明記されており、出典がないものは [出典なし] と表示され、ルールとして扱われません。

明示的な制限: 私はフレームと数値を確認できますが、動画を再生して視聴することはできません。リズム、カットの感触、ルックの好みは依頼者の判断に委ねられます。 納品時には、必ず依頼者にスマートフォンで確認するようお願いします。

必要条件: ffmpeg と ffprobe(バージョン 8.1.2 でテスト済み、R61 には libvidstab が必要)、Python 3.10+ に numpy と Pillow(pip install numpy pillow)。

ファイル

ファイル用途
scripts/escopos.pyシーンごとの診断:スコープシート(波形、パレード RGB、肌色ライン付きベクタースコープ、ヒストグラム)+ 警告と出典を含む diagnostico.md/json
scripts/comparar.pyシーンごとの編集前後比較:シート、1080p の split_cenaN.png、数値の表、解決済み/新規の警告
scripts/graduar.py補正計画(JSON)を信号順、RGB 16 ビットで適用;--previa で編集前後の静止フレームを生成
scripts/gerar_lut.py承認された補正を .cube(33/65)に変換(Premiere/Resolve/CapCut 用)、PSNR で検証
scripts/montar.pyカットリスト(JSON)に基づき、ストレートカット、J カット、L カットでセグメントを編集
scripts/receitas.py出典付きの 38 の ffmpeg レシピ;testar clipe.mp4 で全て実行;md で referencias/receitas-ffmpeg.md を生成
referencias/cor-fluxo.md信号順序、コントラスト、カーブ、彩度、16 ビット精度
referencias/niveis-e-escopos.mdBT.709、EBU R103 v3.0、各スコープの読み方、スクリプトによる計測方法
referencias/pele.md肌色ライン、クロマ範囲、症状→原因→修正
referencias/hdr-hlg.mdiPhone HLG→SDR、BT.2408 レベル、計測ベースのチェーン
referencias/corte.mdMurch(6 つのルール、まばたき)、アクションカット、J/L カット、オーディオ編集、同期
referencias/plataformas.mdMeta と TikTok:フォーマット、セーフエリア、長さ、公式/非公式の情報
referencias/receitas-ffmpeg.mdグループ別の 38 レシピ(入力、診断、色、ルック、カット、レイヤー、動き、仕上げ、オーディオ、出力)

ワークフォルダ:作品ごとに 1 フォルダ(例:editar-video/<プロジェクト>/<作品>/):生データ、計画、プレビュー、シート、最終成果物をまとめて管理。

以下のコマンドでは、~/.claude/skills/editar-video がスキルのインストール先です。別の場所にインストールした場合は適宜調整してください。


ステップ 0 — 入力(ゲートなし)

python ~/.claude/skills/editar-video/scripts/receitas.py mostrar R01   # ファイルで実行

何よりも先に、ffprobe の数値で以下を判断:

  • color_transfer=arib-std-b67(HLG)または smpte2084(PQ)→ 最初に SDR に変換(referencias/hdr-hlg.md、R03)。タグを変更するだけでは不十分。
  • r_frame_rate ≠ avg_frame_rate → 可変フレームレート:カット前に R02 を実行(Meta は固定フレームレートを要求、Ads Guide)。
  • color_range=pc → 変換前にコンテンツが本当に 0–255 範囲かを確認(R04)。signalstats はレンジタグを無視。
  • AI 生成ファイル、スクリーンレコーディング:タグなしまたはフルレンジで来ることが多い。仮定せずに計測。

ステップ 1 — 計測に基づく診断(ゲート 1)

python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 -o diag            # SDR
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 -o diag --sdr      # HLG:トーンマップ後に計測
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 --pele 0.35,0.15,0.3,0.25   # 顔の領域

VER → 拡大 → 確認 の方法でシートを読む:フレーム、各スコープ、数値の順。以下を表示:

  1. シート(folha_escopos.png)とシーンごとのテーブル;
  2. 計測された事実を 1 行ずつ、ルールと出典と共に:「シーン 2:ハイライト R 98.6 / G 90.0 / B 80.2 → ハイライトに暖色優位、壁が白なら(Adobe、パレード RGB)」;
  3. 計測からわからないこと(例:暖色が意図的かどうか)。

自動肌マスク(Chai & Ngan)は木、ベージュ、オレンジをピックアップします。顔が小さい場合や同色のオブジェクトがある場合は、--pele で顔領域を指定します。

ゲート 1: 依頼者が問題点と意図を確認します。依頼者が希望する色味の偏りは修正しません。

ステップ 2 — 補正計画とプレビュー(ゲート 2)

plano.json を記述(フォーマットは graduar.py の先頭に記載)。各操作には、計測された理由を `

Individual skills in this repo

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

関連スキル