mcpField
E
editing-videos

editing-videos

github.com/kmilo93sdクリエイティブ・メディア670 回インストール4 週間前に更新
リポジトリ

editing-videos について

エージェント向けの動画編集スキルで、企画からレビュー、公開までの編集指針を提供します。共通の編集原則に動画形式別のレシピを組み合わせ、ライセンス情報付きの効果音とグラフィックも収録しています。

主な機能

  1. 01動画形式別の編集レシピ
  2. 02テンポ、カット、文字、音声、色の指針
  3. 03レビューと書き出しのチェックリスト
  4. 04CC0の効果音とグラフィック素材
  5. 05メディアを含まない検索可能なミーム一覧

活用シーン

  1. 01対象と配信先に合わせた編集計画
  2. 02テンポ、字幕、音声、色の確認
  3. 03長尺動画から縦型クリップを作成
  4. 04ナレーション付き画面チュートリアルの制作

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/kmilo93sd/agent-video-editor --skill editing-videos

インストール後、Claude Code で/editing-videosを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

evals/
evals.json
graphics/
build-preview.mjs
catalog.json
check.mjs
LICENSES.md
preview.html
search.mjs
graphics/arrows/
arrow-curved.html
arrow-curved.svg
arrow-hand-drawn.html
arrow-hand-drawn.svg
arrow-straight.html
arrow-straight.svg
graphics/callouts/
callout-box.html
tooltip.html
graphics/cta/
subscribe-prompt.html
graphics/focus/
cursor-click-ripple.html
cursor.svg
spotlight-dim.html
graphics/highlights/
box-highlight.html
circle-hand-drawn.html
circle-hand-drawn.svg
ring-highlight.html
graphics/layouts/
before-after-split.html
end-screen.html
graphics/overlays/
film-grain.html
light-leak.html
graphics/progress/
countdown.html
progress-bar.html
step-counter.html

詳細

動画編集

このスキルでは、いつカットするか、ショットや字幕をどれくらいの長さにするか、音楽の音量をどれくらいにするか、グラフィックが役立つ場面と邪魔になる場面など、編集者の判断基準を示します。それぞれの数値の出典を、公式(プラットフォームまたはベンダーのドキュメント)、研究、クリエイター(公開データのない実践例)、社内基準(実際の編集をレビューして得た知見)のいずれかで示します。次の2つのレイヤーで構成されています。

  1. 基本事項(このファイル、references/、review-checklist.md):あらゆる動画やツールに適用できる技術。
  2. レシピ(recipes/):動画の種類ごとに異なる点。該当するものだけを読み込みます。

このスキルはツールに取って代わるものではありません。仕組み(ファイル形式、API、レンダラーの仕様)については、ツール独自のドキュメントやスキルが優先されます。編集に関する判断については、このスキルが優先されます。references/tools.md では、それぞれのツールに編集技術を適用する方法を説明しています。

プロセス

#手順内容参照先
1概要の確認動画の種類、対象視聴者、プラットフォームとフォーマット(16:9 または 9:16)、長さ、使用できるツールを確認します。レシピを選びます下記の「レシピを選ぶ」
2ストーリー伝える内容(タイトルとサムネイルのアイデア)と、最初の数秒でそれを届けるフックを考えます。セクションやチャプターも決めますreferences/hook-and-retention.md
3組み立て最適なテイクを選んで順番に並べ、不要な間をカットします。まだ細部の仕上げはしませんreferences/pacing-and-cuts.md、レシピ
4リズム動画の種類に合ったショットの長さ、JカットとLカット、ジャンプカット、Bロール、パンチインを調整しますreferences/pacing-and-cuts.md
5グラフィックとテキスト説明に役立つ場面だけグラフィックを使います。テキストを音声に合わせ、字幕を追加しますreferences/graphics-and-text.md、graphics/、memes/
6音声セリフのノイズを除去し、ルームトーンを整え、声の下に音楽を敷き、効果音を加えてから、マスター音源を仕上げますreferences/audio-and-sfx.md、library/
7カラー露出、ホワイトバランス、ショット間の色を合わせます。ルックの調整はその後に行いますreferences/color.md
8レビューレシピのチェックリスト、次に基本チェックリストの順に確認します。フレームを見て、ヘッドフォンで音声を確認しますreview-checklist.md
9書き出し本人の承認を得てから、フォーマットとマスター音源のラウドネスを設定し、ファイルを確認しますreferences/audio-and-sfx.md、references/tools.md
10公開タイトル、サムネイル、説明、チャプター、字幕、クレジットを用意しますreferences/thumbnail-title-description.md、references/licenses.md

エージェントが編集ツールを操作できない場合でも、ステップ1~8については判断を行い、編集決定リスト、マーカーリスト、字幕ファイル、数値を含む指示を作成します(references/tools.md)。

厳守ルール(あらゆる動画、あらゆるツールに適用)

  1. すべてのカットには理由があります:不要な間を取り除く、情報を切り替える、または動作に合わせるためです。言葉の途中では決してカットしません。
  2. 約束した内容を早い段階で届けます。 タイトルとサムネイルで約束した内容を、最初の数秒で見せるか、言葉で伝えます。その前にロゴのイントロや挨拶を入れません。
  3. 声をほかの音と競わせません。 BGMは声より18~25 dB小さくし、声に合わせて音量を下げます。効果音も声より小さくし、重要な言葉に重ねません。すべての無音部分にルームトーンを入れます。
  4. 納品先に合わせて一度だけマスタリングします:YouTubeは統合ラウドネス-14 LUFS、最大トゥルーピーク≤ -1 dBTP、ポッドキャスト配信は-16 LKFS ± 1です。推測ではなく、測定します。
  5. グラフィックを空のまま表示しません。 対応する言葉の最大0.5秒前に表示し、1秒以内に内容を入れます。各要素は、声で名前が挙げられてから≤ 0.6秒以内に表示します [house]。
  6. テキストは読み終えるまで表示します:max(1.5 s; words × 0.33 s + 0.5 s)。字幕は1行≤ 42文字、最大2行、各行を20フレーム以上表示します。
  7. ズームやパンチインは、発言内容に意味がある場合に限って使います。鮮明にし、カットをまたいで使いません。
  8. ショットの見た目をそろえます:同じシーン内では露出、ホワイトバランス、音量レベルを統一します。
  9. ライセンス済みのメディアのみ使用します:CC0、YouTube オーディオ ライブラリ、または商用利用を許可する書面によるライセンスを使用します。NCは不可、「YouTubeで見つけたもの」も不可です。ライブラリに新しい音源を追加する場合は、証拠をlibrary/LICENSES.mdに残します。グラフィックはgraphics/(CC0)から使用するか、ライセンスを記録します。ライセンスなしで著作権保護対象のミーム画像、映像、音声を使用しません。代わりにジョークを再現します(memes/README.md)。
  10. 数値をでっち上げません。 数値を裏付ける情報源がない場合はそのことを明示し、内容に基づいて判断します。
  11. 承認なしでレンダリングや公開を行いません。また、レシピのチェックリストとreview-checklist.mdに合格していないカットは提示しません。

レシピを選ぶ

動画の種類レシピコアに追加される内容
カメラに向かって話す一人の人物recipes/talking-head.mdフィラーの削除、ジャンプカットの緩和、パンチイン、発言内容に合わせたBロール
一日、旅行、イベントrecipes/vlog.mdストーリーの発見、コールドオープン、シーケンス、風やロケーション音声、カメラ間の調整
複数のカメラを使った会話recipes/podcast-to-youtube.md同期、アングルの切り替え、オープンマイク、ポッドキャスト用マスター、トピックごとのチャプター
長尺動画から切り出した縦型クリップrecipes/shorts-from-long-form.md場面の選択、9:16へのリフレーミング、焼き込み字幕、ループ
ナレーション付きソフトウェアチュートリアル(画面録画)recipes/narrated-screen-tutorial.md画面を主役にすること、適正な再生速度、デモデータ、合成音声、チャプターカード、テスト済みテンプレート(Playwright、ElevenLabs、HyperFrames)
その他(解説、エッセイ、レビューなど)なしコアを使用します。ペーシング表には種類ごとの行があります。最も近いレシピを参考にしてください。

ペーシングの概要

各数値の出典を含む完全な表は、references/pacing-and-cuts.mdにあります。

種類映像の変化フレーズ間の無音
トーキングヘッド2~5秒ごと(クリエイター)200~400 ms(クリエイター)
Vlogイベントに応じて変更。映画ではショットの平均は約4~5秒(研究)自然に保ち、ルームトーンを入れる
解説最初の変化を25~35秒で入れ、その後は2~3分ごと(クリエイター)200~400 ms(クリエイター)
画面チュートリアル操作の変化に合わせて変更。ショットは5秒以上(house)0.4秒以上(house)
ポッドキャスト/インタビュー話者の交代やリアクションに合わせて変更。頻度の情報源なし自然な間を残す
ショート/Reel/TikTok2~3秒ごとに変更。5~7秒ごとに新しい要素を入れる(クリエイター)200~300 ms(クリエイター)

オーディオの概要

  • マスター:YouTube 向けには -14 LUFS、≤ -1 dBTP にします。48 kHz の AAC をアップロードします。
  • 音楽は音声より 18~25 dB 小さくし、誰かが話している間は 6~12 dB 下げます。
  • 効果音は音声より 12~24 dB 小さくし、画面上のイベントごとに 1 つ使います。トランジェントはイベントの 2~4 フレーム前に配置します。
  • 測定レベルに基づくゲイン:gain = 10^((voice_lufs - under_voice - sound_lufs)/20)。上限は 1 です。

CC0 サウンドライブラリ

library/ には、LUFS とトゥルーピークを測定済みの CC0 ファイルが 128 個含まれています。内訳は、効果音 113 個(モノラル WAV、48 kHz、 -22 LUFS)と音楽トラック 15 個(ステレオ MP3、48 kHz、-16 LUFS)です。カテゴリは、トランジション 18、クリック 12、表示 12、通知 11、成功 7、エラー 5、タイピング 9、インパクト 5、スティンガー 14、オフィス 17、環境音 3、音楽 15 です。 以下のパスは、このスキルのフォルダーからの相対パスです(例:~/.claude/skills/editing-videos/)。

node library/search.mjs                          # categories
node library/search.mjs --category transition
node library/search.mjs whoosh --paths           # paths to copy
node library/search.mjs pop --voice -17          # with the gain for a voice at -17 LUFS

--voice を指定すると、効果音は音声より 15 dB、音楽は 20 dB、環境音は 30 dB 小さくなります。ファイルを動画プロジェクトにコピーしてください。プロジェクト外のファイルを参照しないでください。ライセンスとソースについては、library/LICENSES.md と references/licenses.md を参照してください。サウンドを追加したら、node library/verify.mjs を実行します。

グラフィックスキット(CC0)

graphics/ には、HyperFrames 用のすぐに使えるグラフィックスが 26 個あります。矢印、円とハイライトリング、下線と手描き線、スポットライト、カーソルクリックの波紋、吹き出しとツールチップ、ローワーサード、キーボードキーのチップ、ステップカウンター、プログレスバー、カウントダウン、チェックマークとバツ印、ビフォー/アフターの分割、チャプターカード、エンド画面のレイアウト、光漏れと粒子のオーバーレイ、汎用の「いいね・チャンネル登録」プロンプトが含まれます。それぞれは HTML スニペット(図形には SVG も付属)で、時間指定された .clip、--gfx-* カスタムプロパティによる色とサイズ、コンポジションのタイムラインにシーク可能なトゥイーンを追加する gfx.<name>(tl, el, opts) 関数を備えています。アンカー at は対象を示す単語に合わせてください。各アセットの長さと使用を避けるべき状況は catalog.json に記載されています。

node graphics/search.mjs                         # categories
node graphics/search.mjs --category arrows
node graphics/search.mjs shortcut --paths        # paths to copy

すべてのアニメーションは graphics/preview.html で確認できます。追加したら、node graphics/build-preview.mjs と node graphics/check.mjs を実行します。

ミーム

memes/catalog.json は、メディアを含まない 59 種類のミームとミーム形式のリファレンスです。それぞれの意味、チュートリアルで適する場面、画面に表示する時間、graphics/ での再現方法、オリジナルの権利者、Content ID のリスクが記載されています。ジョークを再現するか、オリジナルの使用許諾を得てください。ミームの音楽は決して使用しないでください。まず memes/README.md を読んでください。

node memes/search.mjs fail --risk low

索引

ファイル内容
references/pacing-and-cuts.md動画の種類別のペース配分表と出典;カットの目的;ショットの長さ;JカットとLカット;ジャンプカット;Bロール;トランジション;セグメント分け
references/hook-and-retention.mdYouTubeによる視聴維持率の測定方法;種類別のフック;オープンループ;チャプター;終了画面と締めくくり
references/graphics-and-text.mdグラフィックを使うタイミング;表示位置を固定し、空のままにしないこと;テキストの表示時間;キャプションと字幕;ズームとパンチイン;表示アニメーション;セーフゾーン;読みやすさ
references/audio-and-sfx.md目標レベル;ダイアログのノイズ除去;ルームトーン;音楽とダッキング;ゲインの計算;効果音;マスタリング
references/color.md作業の順序;出発点としてのLUT;ショット間の色合わせ;SDRおよびHDRでの納品
references/thumbnail-title-description.mdサムネイルの仕様と実践方法、A/Bテスト、タイトル、説明文、ハッシュタグ、チャプター
references/licenses.md収益化チャンネル向けの音楽、効果音、映像素材の提供元;フェアユース;Content ID
references/tools.mdNLEでの編集スキルの適用(EDL、マーカー、キャプション、指示)、ffmpeg、Remotion、HyperFrames
review-checklist.mdあらゆる動画に使えるレビュー:数値、目視、聴感による確認と公開前チェック
recipes/talking-head.mdトーキングヘッド動画のレシピとチェックリスト
recipes/vlog.mdVlogのレシピとチェックリスト
recipes/podcast-to-youtube.mdポッドキャストとインタビュー(マルチカメラ)のレシピとチェックリスト
recipes/shorts-from-long-form.md長尺動画から作る縦型クリップ:レシピとチェックリスト
recipes/narrated-screen-tutorial.mdナレーション付き画面チュートリアルのレシピ、基本ルール、工程、チェックリスト
recipes/narrated-screen-tutorial/voice.mdチュートリアルの台本と合成音声:音声上の頭字語(スペイン語ナレーション)、ElevenLabs、チャプターごとのLUFS、whisper
recipes/narrated-screen-tutorial/hyperframes-generator.mdHyperFramesでのチュートリアル編集:各ステップのスキル、コントラクトのルール、ジェネレーターとそのチェック、落とし穴、レビューループ
recipes/narrated-screen-tutorial/templates/このパイプライン用のテスト済みテンプレート。それぞれに --help があります
library/CC0サウンド:catalog.json、search.mjs、verify.mjs、LICENSES.md、sfx/、music/、tools/synthesize.py
graphics/CC0 HyperFramesグラフィック:catalog.json、search.mjs、preview.html、check.mjs、LICENSES.md、カテゴリごとのフォルダー
memes/メディアファイルを含まないミームのリファレンス:README.md(最初に読む)、catalog.json、search.mjs

コメント