/long-form
source ──tighten──▶ tight take ──build──▶ edited.mp4 + .srt + .chapters.txt + .sheet.jpg
(pauses cut, ├ plain stretches: punch-ins on the cuts, captions, chapter cards
words remapped) └ moments: explainer / split-screen / ... rendered and spliced in
初回使用
このスキルのフォルダは、Claude Code が読み込むときの「ベースディレクトリ」です。
SKILL_DIR="<base directory of this skill>" # Claude Code が "Base directory for this skill" として表示したパス
KIT=$(python3 -c 'import os,sys;print(os.path.realpath(os.path.join(sys.argv[1],"..","..","kit")))' "$SKILL_DIR")
PY="$KIT/.venv/bin/python"; [ -x "$PY" ] || bash "$KIT/setup.sh" --cutout
GROQ_API_KEY を設定する必要があります(長い動画は10分単位で文字起こし)。ffmpeg と Node.js が必要です。
ステップ
- プローブ
"$PY" "$KIT/reel.py" probe <video>: サイズ、長さ、autoが選択するフォーマット(横長 = 水平 1920x1080、それ以外は垂直 1080x1920)を表示します。ユーザーが別の形状を希望する場合のみ確認します(横長ソースを垂直にクロップすると中央が切り取られます)。 - タイトニング(生録音に推奨、既に編集済みの映像ではスキップ):
"$PY" "$KIT/longform.py" tighten <video> [--max-gap 0.45] [--pad 0.12] [--cut-fillers]文字起こしを行い、すべての単語を保持し、--max-gapより長い各ポーズを約2 × --padに短縮し、<video>.tight.mp4と<video>.tight.transcript.json(新しいタイムライン上の単語と、各結合位置を示すcuts)を出力します。以降はタイトファイルを使用します。--cut-fillersは「あー」「えー」も削除します。 - 読み取り
"$PY" "$KIT/reel.py" words <video>は、1行に1文とその時刻(タイトニングを行った場合はタイトタイムライン上)を表示します。長い動画は--start/--endで分割して読み取ります。次の点に注意:- チャプター: トピックが変わる箇所(10〜20分の動画で4〜10個、それぞれ2〜5語のタイトル)
- 2〜6個の モーメント: 4〜10秒間の、具体的で視覚的なポイントを示す区間(比較、手順、数値、ランキング、小さなストーリー)。間隔を空けて配置し、動画の大部分は通常のテイクのままにします。
- フレーミング
"$PY" "$KIT/reel.py" frame <video> <t> frame.jpgで確認: 顔の中心(face、パンチインに使用)、およびモーメントに必要な目の高さと顔のX座標(eye_y、face_x、video_top...)を記録します。 - スペック 動画の隣に
<video>.long-form.jsonを作成します(以下参照)。パスはスペックファイルからの相対パスです。 - ビルド
"$PY" "$SKILL_DIR/build.py" <spec.json>。モーメントが最初にレンダリングされ(それぞれ約20〜40秒、キャッシュされます)、その後タイムラインが並列にセグメントエンコードされます。15分の1080p動画は、ffmpeg の1〜2パス分程度の時間がかかります。 - チェック
<out>.sheet.jpg(12フレーム、赤 = プレイヤーまたはリールUIで隠れる部分)を確認し、各モーメントの結合点と1つのチャプターカードを動画内でスポットチェックします。スペックを修正して再ビルドすると、変更のないモーメントは再利用されます。 - 成果物の引き渡し mp4、
.srt(焼き付けていても、検索可能なキャプションとしてYouTubeにアップロード)、および.chapters.txt(説明文に貼り付け)を提供します。
スペック
{
"video": "episode.tight.mp4",
"format": "auto",
"out": "episode.edited.mp4",
"face": [880, 400],
"punch_ins": {"every": "cut", "scale": 1.12, "min_hold": 2.5},
"zooms": [{"start": 312.4, "end": 318.0, "scale": 1.25}],
"captions": {"keys": ["carousel", "viral"], "karaoke": false},
"chapters": [
{"at": 0, "title": "Why carousels win"},
{"at": "the second thing", "title": "Finding a viral post"}
],
"moments": [
{"skill": "explainer", "start": 61.2, "end": 67.0,
"title": "Steal what *works*", "eye_y": 400, "face_x": 880,
"visual": {"type": "list", "items": [{"text": "Find a *viral* post", "at": "find"}, {"text": "Recreate it", "at": "recreate"}]}},
{"skill": "split-screen", "start": 140.0, "end": 147.5, "face_x": 880, "zoom": 1.2,
"badge": "Step 2", "headline": "Pick *one*", "visual": {"type": "image", "src": "screens/app.png"}}
],
"loudness": -14
}
video: タイトファイルまたは生ファイル。start/end(オプション)で一部のみ使用できます。format:auto、horizontalまたはvertical。face:[x, y]キャンバス上の顔の位置。すべてのズームの中心。デフォルトは中央やや上。punch_ins: プレーンショットとscale(1.08〜1.18)の間を、"cut"(タイトニング済みトランスクリプトが必要、ジャンプカットを隠します)、"sentence"、またはN秒ごと(数値)に交互に表示します。min_hold(秒)でズームのちらつきを防止。省略するとパンチインなし。zooms: パンチインに加えて、特定のスケールで明示的にホールドします。強調したいセリフに控えめに使用。captions: 焼き付けキャプション: Inter ExtraBold、白色でソフトシャドウ、keysはアクセントピル。karaoke: trueで言われていない単語を暗くします。yとsizeで移動・サイズ変更。falseで焼き付けキャプションをオフ(.srtは出力されます)。モーメント内ではモーメント独自のキャプションが優先されます。chapters:atは秒数または発言された単語("pricing"、"pricing#2"、"pricing-0.5")。各チャプターにカード(アクセント番号タイル+タイトル)が約3秒表示されます。1つに"card": false、または全体に"chapter_cards": falseを設定すると、.chapters.txtのエントリのみ残ります。最初のチャプターが0にない場合、「イントロ」行(intro_title)が追加されます。moments:skill+start/end(秒数または単語)+そのスキル固有のフィールド(各SKILL.mdの説明通り、記述前に読んでください)。フォーマット、動画、トランスクリプトは自動入力されます。モーメントは重複できません。カットアウトスキル(explainer、behind-the-person)はフレームあたり約0.1秒追加されます。loudness: 最終ミックスをこのLUFSにノーマライズ(-14はYouTube向け)。省略すると録音時の音量を維持。keep_work: true でエンコード済みセグメントを.work/に保持。
センス
- テイクが主役です。キャプションとパンチインが動画全体を支え、モーメントはスパイス(多くとも1〜3分に1つ)。
- 各モーメントはその直下の文を正確に視覚化し、その文のキーワードに合わせて着地し、ユーザーの実際の画像、スクリーンショット、数値を使用します。結果を捏造しないでください。
- チャプタータイトルは短く具体的に(「価格設定」「3ステップのセットアップ」)、クリックベイトは避けてください。
- 横型: キャプションとカードは安全領域内に収めてください(シートで表示)。YouTubeのプログレスバーは一時停止時に下部120pxを覆います。
- 縦型長尺はリールと同じ領域を使用します。キャプションはy=1380付近に配置してください。