Communitygithub.com

ドキュメンタリーリアリズム(Doc Real)

ドキュメンタリーリアリズムの映像編集スタイル:レターボックスフレーム、フィルムグレード、小文字の小さな字幕、ロケーションタグ。ミニドキュメンタリー、創業者ストーリー、旅行、インタビュー、ブランドフィルムに最適です。video-studio-coreエンジン(文字起こし、自動カット、モーショングラフィックス、サウンド、グレーディング)で生クリップを完成された9:16編集に仕上げます。

ドキュメンタリーリアリズム(Doc Real) とは?

Doc Real は、ドキュメンタリー映画のようなリアリズムを追求した UI エージェント向け映像編集スタイルです。このスキルは、生の人物インタビューや日常風景のクリップを、映画的な語り口を持つ完成度の高い縦型動画(9:16)に変換します。主な特徴として、レターボックス枠、フィルムグレード処理、グレイン、スロープッシュといった映画的演出に加え、小文字の中央揃え字幕と冒頭に表示されるロケーション/チャプタータグが含まれます。core エンジン(video-studio-core)が自動で文字起こしからカット、モーショングラフィックス、サウンド調整、カラーグレーディングまでを実行。ユーザーはコマンドラインからスタイルとタイトルを指定するだけで、後は自動化されたワークフローに任せられます。さらに、出力前に `plan.json` の調整(フックの書き換え、キーワード修正、誤認識の修正)を行うことで、完成度を高めることができます。ミニドキュメンタリー、起業家ストーリー、旅映像、インタビュー、ブランドフィルムなどに最適です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Viprasol-Tech/claude-video-editing-skills/tree/HEAD/plugins/video-studio/skills/doc-real

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

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

ドキュメント

Doc Real(ドキュメンタリーリアリズム)

ドキュメンタリーリアリズム:レターボックスフレーム、フィルムグレード、小文字の小さな字幕、ロケーションタグ。

  • 最適な用途: ミニドキュメンタリー、創業者ストーリー、旅行、インタビュー、ブランドフィルム
  • カテゴリ: トーキングヘッドリール
  • デフォルトフォーマット: 9:16(--format 9:16 | 1:1 | 4:5 | 16:9 で変更可能)
  • カメラ映像の必要性: はい、生のトーキングクリップが必要
  • 話者の背後にテキスト: なし

始める前に

このスタイルは video-studio-core スキル上で動作します。このスキルと同じスキルフォルダにインストールされている必要があります。

  • CORE = このフォルダの隣にある video-studio-core フォルダ(例:~/.claude/skills/video-studio-core)
  • STYLE = このスキルのフォルダ(theme.json と theme.css を保持)
  • 初めて実行するマシンでは:python CORE/scripts/check_env.py を実行し、報告された問題を修正してください。
  • CORE がない場合は、ユーザーに同じパックから video-studio-core をインストールするよう伝えてください。

編集を実行する

python CORE/scripts/run.py clip.mp4 --style STYLE --work edit-doc-real --stop-after plan --title "場所, 時間"
# 下記の説明に従って edit-*/plan.json を微調整し、静止画を確認:
python CORE/scripts/render.py edit-doc-real/plan.json --frames 1,3,6,9
python CORE/scripts/render.py edit-doc-real/plan.json
python CORE/scripts/finish.py edit-doc-real/plan.json

contact_sheet.png を開いて、フルレンダリングの前に確認してください。最終的な動画はワークフォルダ内の final.mp4 です。 追加サイズが必要な場合は finish.py で --formats 1:1,16:9 を使用してください。プランに "music": {"src": "track.mp3", "volume": 0.12} を追加して音楽をつけます。

見た目

  • レターボックスバー、フィルムグレード、グレイン、スロープッシュ。字幕は小さく、小文字、白、中央下部に配置。
  • 最初の3秒間に小さなロケーションまたはチャプタータグを左上に表示。ズーム、絵文字、効果音はなし。

プランを微調整する

make_plan.py によるドラフトは自動生成です。これを良いものにしてください:

  • words.json を読み、フック(最初の2〜3秒)を短く具体的な約束に書き換えてください。
  • 弱い自動選択キーワードを、意味を伝える単語(数字、結果、名前、対比)に置き換えてください。
  • words 配列内の聞き間違えた単語を修正してください(時間はそのまま保持)。
  • --title で場所/コンテキストを指定してください(例:'julana, haryana — 6:40 am')。
  • 長尺動画には、クラス dr-chapter を付けた titlecard チャプター区切りを追加してください。
  • 要素の種類とフィールドについては CORE/references/plan-schema.md を参照してください。

納品前に確認すること

  • コンタクトシート:テキストが読みやすいか、何も切れていないか、意図していない限り顔に何も重なっていないか、セーフゾーンが守られているか(9:16:テキストは高さの10%〜85%の間に配置)。
  • タイミング:オーバーレイは話し言葉と同時に表示され、遅れて表示されないこと。
  • ffprobe で最終ファイルを確認:正しいサイズ、長さ、オーディオ。
  • カットした秒数、ルックが追加した要素、ファイルの場所をユーザーに伝えてください。

見た目を変更する

色とフォントは theme.json(vars、fontsUrl)と theme.css にあります。1回限りの変更の場合は、スキルファイルではなく plan.json(theme.vars、要素 style)を編集してください。

リクエスト例

  • 「ドキュメンタリースタイルで編集して。」
  • 「私のストーリーをNetflixのドキュメンタリーのようにして。」
  • 「ロケーションタグ付きの映画的ドキュメンタリールックで。」

Individual skills in this repo

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

関連スキル