editing-videos について
エージェント向けの動画編集スキルで、企画からレビュー、公開までの編集指針を提供します。共通の編集原則に動画形式別のレシピを組み合わせ、ライセンス情報付きの効果音とグラフィックも収録しています。
主な機能
- 01動画形式別の編集レシピ
- 02テンポ、カット、文字、音声、色の指針
- 03レビューと書き出しのチェックリスト
- 04CC0の効果音とグラフィック素材
- 05メディアを含まない検索可能なミーム一覧
活用シーン
- 01対象と配信先に合わせた編集計画
- 02テンポ、字幕、音声、色の確認
- 03長尺動画から縦型クリップを作成
- 04ナレーション付き画面チュートリアルの制作
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ kmilo93sd/ agent-video-editor --skill editing-videosインストール後、Claude Code で/editing-videosを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
evals/evals.jsongraphics/build-preview.mjscatalog.jsoncheck.mjsLICENSES.mdpreview.htmlsearch.mjsgraphics/arrows/arrow-curved.htmlarrow-curved.svgarrow-hand-drawn.htmlarrow-hand-drawn.svgarrow-straight.htmlarrow-straight.svggraphics/callouts/callout-box.htmltooltip.htmlgraphics/cta/subscribe-prompt.htmlgraphics/focus/cursor-click-ripple.htmlcursor.svgspotlight-dim.htmlgraphics/highlights/box-highlight.htmlcircle-hand-drawn.htmlcircle-hand-drawn.svgring-highlight.htmlgraphics/layouts/before-after-split.htmlend-screen.htmlgraphics/overlays/film-grain.htmllight-leak.htmlgraphics/progress/countdown.htmlprogress-bar.htmlstep-counter.html詳細
動画編集
このスキルでは、いつカットするか、ショットや字幕をどれくらいの長さにするか、音楽の音量をどれくらいにするか、グラフィックが役立つ場面と邪魔になる場面など、編集者の判断基準を示します。それぞれの数値の出典を、公式(プラットフォームまたはベンダーのドキュメント)、研究、クリエイター(公開データのない実践例)、社内基準(実際の編集をレビューして得た知見)のいずれかで示します。次の2つのレイヤーで構成されています。
- 基本事項(このファイル、
references/、review-checklist.md):あらゆる動画やツールに適用できる技術。 - レシピ(
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)。
厳守ルール(あらゆる動画、あらゆるツールに適用)
- すべてのカットには理由があります:不要な間を取り除く、情報を切り替える、または動作に合わせるためです。言葉の途中では決してカットしません。
- 約束した内容を早い段階で届けます。 タイトルとサムネイルで約束した内容を、最初の数秒で見せるか、言葉で伝えます。その前にロゴのイントロや挨拶を入れません。
- 声をほかの音と競わせません。 BGMは声より18~25 dB小さくし、声に合わせて音量を下げます。効果音も声より小さくし、重要な言葉に重ねません。すべての無音部分にルームトーンを入れます。
- 納品先に合わせて一度だけマスタリングします:YouTubeは統合ラウドネス-14 LUFS、最大トゥルーピーク≤ -1 dBTP、ポッドキャスト配信は-16 LKFS ± 1です。推測ではなく、測定します。
- グラフィックを空のまま表示しません。 対応する言葉の最大0.5秒前に表示し、1秒以内に内容を入れます。各要素は、声で名前が挙げられてから≤ 0.6秒以内に表示します [house]。
- テキストは読み終えるまで表示します:
max(1.5 s; words × 0.33 s + 0.5 s)。字幕は1行≤ 42文字、最大2行、各行を20フレーム以上表示します。 - ズームやパンチインは、発言内容に意味がある場合に限って使います。鮮明にし、カットをまたいで使いません。
- ショットの見た目をそろえます:同じシーン内では露出、ホワイトバランス、音量レベルを統一します。
- ライセンス済みのメディアのみ使用します:CC0、YouTube オーディオ ライブラリ、または商用利用を許可する書面によるライセンスを使用します。NCは不可、「YouTubeで見つけたもの」も不可です。ライブラリに新しい音源を追加する場合は、証拠を
library/LICENSES.mdに残します。グラフィックはgraphics/(CC0)から使用するか、ライセンスを記録します。ライセンスなしで著作権保護対象のミーム画像、映像、音声を使用しません。代わりにジョークを再現します(memes/README.md)。 - 数値をでっち上げません。 数値を裏付ける情報源がない場合はそのことを明示し、内容に基づいて判断します。
- 承認なしでレンダリングや公開を行いません。また、レシピのチェックリストと
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/TikTok | 2~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.md | YouTubeによる視聴維持率の測定方法;種類別のフック;オープンループ;チャプター;終了画面と締めくくり |
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.md | NLEでの編集スキルの適用(EDL、マーカー、キャプション、指示)、ffmpeg、Remotion、HyperFrames |
review-checklist.md | あらゆる動画に使えるレビュー:数値、目視、聴感による確認と公開前チェック |
recipes/talking-head.md | トーキングヘッド動画のレシピとチェックリスト |
recipes/vlog.md | Vlogのレシピとチェックリスト |
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.md | HyperFramesでのチュートリアル編集:各ステップのスキル、コントラクトのルール、ジェネレーターとそのチェック、落とし穴、レビューループ |
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 |