reel-editor

リールエディター

生のトーキングヘッド動画を、ブランドイメージに沿った完成度の高い縦型リールに仕上げます。色、フォント、キャプションのスタイル、サウンド、CTA など、ブランドに関する選択はすべて、その人のブランドファイルから取得し、このスキルに組み込まれたデフォルトは使いません。編集作業はあなたが行い、本人には本人が決めるべきことだけを決めてもらいます。

まず最初に：ブランドファイルはありますか？

REELS_HOME が設定されていない場合、ワークスペースは ~/reels/ です。

• ~/reels/brand.md がない → まず references/setup-interview.md のセットアップインタビューを実施します。相手が「適当にやって」と言っても、ブランドファイルなしで動画を編集してはいけません。インタビューは 5 分で終わり、このスキルの要となるものです。
• ブランドファイルがある → brand.md と brand.json をすべて読み込んでから、次に進みます。

ツールの確認（一台につき一度）

bash scripts/doctor.sh を実行すると、ffmpeg、Node、HyperFrames のスキル、および（ブランドファイルで CapCut が指定されている場合は）CapCut コネクターを確認します。編集を始める前に、指摘された問題をすべて修正してください。インストール手順はリポジトリの README にあります。

編集手順

リールごとに専用フォルダーを作成します：~/reels/<yyyy-mm-dd>-<short-name>/。元の動画をコピーして配置し、オリジナルは決して編集しないでください。

1. 文字起こし - python3 scripts/transcribe.py <clip> transcript.json。~/.config/reels/.env に ELEVENLABS_API_KEY があれば ElevenLabs Scribe を使用します（単語ごとのタイミングが正確で、字幕が単語に合わせて表示されます）。なければローカルの Whisper を使用します（無料ですが、タイミングが約 0.3 秒ずれることがあります）。
2. 音声を整える - bash scripts/clean_audio.sh <clip> voice.wav（背景ノイズがある場合は --denoise を追加します）。Instagram と TikTok が求める音量である -14 LUFS を目標にします。
3. 確認（判断は本人に委ねます） - カットする箇所（繰り返し、言い直し、話の脱線）、削除するフィラー、最後に移動する CTA、60 秒未満にする目標、グラフィックの計画を提案します。カットする前に本人の承認を待ってください。 ここが最も重視されるステップです。 カットを提案する前に、冒頭と末尾を確認してください： 最初と最後の 4 秒について、0.5 秒ごとにフレームを取得します。言葉が重なっていても、カメラのセットアップ（床や庭に向ける、カメラを反転させる、スマートフォンに手を伸ばす）はカットします。画角が安定し、冒頭にふさわしい言葉が始まる最初のフレームから開始します。
   • メインの方法：Reel Review ページ。 まず、このセッションで Artifact と ArtifactData ツールが利用できるか確認します（遅延読み込みの場合はツール検索から読み込みます）。利用できる場合は、references/review.md に従います。本人がカットする単語をタップし、リアルタイムのラフカットを再生して、グラフィック、字幕、音声、色を確認してから、「build preview」と伝えます。インポート手順で edl.json と edit.json が書き込まれるため、ステップ 4 のカットとステップ 5.4 のレンダリングに進みます。
   • 代替方法：チャットで確認 します。これらのツールがない場合（古い Claude Code や他のアプリなど）に使用します。まず、文字起こしを番号付きの行で表示し（形式は references/rough-cut.md）、次にステップ 5 のカードリストを表示します。
4. テンポを整えてから、カットと速度調整 - 承認された行をもとに edl.json を作成し、python3 scripts/tighten.py <folder> を実行します。ブランドの "pacing" の指定（デフォルトは natural、ほかに tight、fast。プリセットは scripts/pacing.py にあります）に従って、残す行の中のフィラーを削除し、間を短くします。これらを一つずつ承認してもらう必要はありません。次に python3 scripts/cut.py <folder> を実行します。速度は同じプリセットから適用しますが、brand.json に "speed" が設定されている場合はそちらを使います。聴いて確認し、master.mp4 の文字起こしを再作成して、つなぎ目で単語が途切れていないことを確認します。
5. グラフィックと字幕：テンプレートを埋め、デザインはしないでください。 ここでの役割はデザイナーではなく編集者です。見た目はブランドファイルからすでに構成されています。
   1. python3 scripts/transcribe.py master.mp4 master_transcript.json
   2. python3 scripts/auto_edit.py <folder> → edit.json の下書きを作成します（指定された字幕モードとパンチインを適用）。
   3. edit.json を一度に編集します。各文の重要な単語ひとつに "accent": true を設定し、brand.json の "graphics" の指定に応じた密度でカードを追加します。minimal は約 8～12 秒ごと、balanced（デフォルト）は 4～6 秒ごと、busy は 2～4 秒ごとです。見せるものがない行にはカードを追加しません。間を埋めるためだけに、数字をすべて図表にしたり、ツールをすべてスクリーンショットにしたりしないでください。カードの種類とフィールドは scripts/build_reel.py のヘッダーにあります。HyperFrames のカタログにある動き（カルーセル、図表、カウンター、通知、カーソル、フォローカード）は references/motions.md にあります。すべてのカードは、その行で述べている内容を正確に示す必要があります。
      • フックタイトル： 1 行あたり最大約 10 文字、2～3 行（"still / uploading / screenshots?"）にして、大きく表示できるようにします。縁取りを付けるテキストはこれだけです。
      • カルーセル： brand.json に "require_carousel": true がある場合、すべてのリールにカルーセルを 1 つ含めます（motion カード、carousel-* という名前、スクリーンショットや本人のアセットから取得した images を使用）。合う行がなければ本人に確認します。本人が不要と答えた場合は "no_carousel_ok": true を設定します。
      • スクリーンショット： 行で言及されているツールやサイトについて、bash scripts/screenshot.sh <url> shots/<name>.png を実行します。終了コード 2 はサイトにブロックされたことを示します。その場合はツールのマーケティングページを試すか、本人にスクリーンショットを依頼します。空白のものは絶対に使わないでください。
      • 種類を組み合わせます。ウェブサイトの画像、色のブロック、リストカード（リキッドグラスには "glass": true）、本人のアセットからのステッカー、大きな見せ場には follow カード、数字に言及する場合はカウンターや図表を使います。
   4. 下書きには REEL_PREVIEW=1 bash scripts/render.sh <folder> を実行します（1080p、低優先度）。本人の承認後、bash scripts/render.sh <folder> --final を実行します（解像度は brand.json の指定に従います。CapCut 経由の場合は --capcut を追加します）。→ final.mp4 と各ステージの所要時間が生成されます。 ここで構成用 HTML を手書きしたり、ほかの HyperFrames ワークフローを使用したりしないでください。 時間がかかり、ブランドテンプレートも反映されません。テンプレートにない効果（例：頭の後ろに文字を表示する効果）を本人が明示的に求めた場合に限り、時間がかかることを伝えたうえで、その効果だけに hyperframes スキルを使用します。
6. 品質確認 - python3 scripts/qa.py <folder> を実行します（音量、ファイルサイズ、長さ、欠落した単語を確認）。その後、すべてのカードでフレームを取得して、フレーム内に文字が収まり、背景の上でも読みやすく、ブランドに合っているかを確認します。合格するまで edit.json を修正し、render.sh を再実行します。
7. 納品 - bash scripts/deliver.sh <final.mp4> "<clear name>" → 本人の納品フォルダーに、アップロード可能な MP4 を保存します。
8. CapCut（brand.json に "capcut": true がある場合のみ） - 編集可能な CapCut の下書きを作成し、リンクを渡します。references/capcut.md。 何が変わったのか、耳で何を確認すべきか（カット、名前、ブランド用語の正しい綴り）を伝えます。

ブランドのルールを優先します

ブランドファイルの内容と好みが食い違う場合は、ブランドファイルを優先します。編集時に修正された内容（「いいえ、キャプションには絶対に縁取りを付けないでください」など）は、次回の編集で正しく反映できるよう、すぐに brand.md の「Rules」に追加します。

よくある間違い

間違い	代わりにすること
ブランドファイルがないまま編集する	セットアップのヒアリングを実施します
Whisper の単語タイミングに盲目的に合わせてカットする	つなぎ目を確認し、単語と単語の間の無音部分にカット位置を調整します
内容を説明するのではなく、飾るだけのグラフィック	カードには、該当するセリフの内容をそのまま表示します
ブランドファイルで禁止されているフォントをキャプションに使う	手順 5 の前に brand.md の「Rules」を読み直します
CapCut がどこでも使えると言う	使えるとは限りません（capcut.md を参照）。MP4 の方法なら常に使えます
QA の不合格を基準を下げて解決する	編集を修正して、QA を再実行します