Communitygithub.com

reel-from-raw (生動画からリール生成)

生のインターン動画(ヒングリッシュまたは英語、縦9:16)を、Remotion を使って編集済みの Instagram リールに変換します。無音カット、ズームイン、3D タイトル、ターミナルパネル、ライトリーク、効果音、フォローカードなどを含みます。

reel-from-raw (生動画からリール生成) とは?

このスキルは、ユーザーが提供する未編集のインターン動画を、プロフェッショナルな Instagram リールに自動編集するための Remotion ベースのツールです。ヒングリッシュまたは英語の縦9:16動画を入力として受け付け、Remotion のコンポーネントを組み合わせて、無音部分のカット、パンチインズーム、3D タイトル、ターミナルパネル、ライトリーク、効果音、フォローカードなどを自動生成します。macOS、Linux、Windows WSL で動作し、OpenCode プラグインも用意されています。ワークフローは、プロジェクト作成、文字起こし、無音カット、ビートシート作成、ビルド、タイプチェック、ビジュアルチェック、サウンドチェック、プレビュー、レンダリングの10ステップで構成され、各ステップは専用スクリプトで実行されます。効果音はライブラリコンポーネントに組み込まれており、音量調整や特定の音の変更など、よくあるリクエストに対応したレシピも提供されています。スキルは、新規プロジェクト作成後もユーザーが編集を依頼する際に呼び出され、リールのスタイルは既存の2つのリール(Linux Day 1, Day 2)に準拠します。

対応✓Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/pawantekchandani/reel-from-raw/tree/HEAD/skills/reel-from-raw

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

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

ドキュメント

生動画からリール

実績あり:Linux Day 2 と Linux Day 1(効果音付き)の2本のリール。 library/Reel.tsx は Day 1 のリールです。そのパターンをコピーしてください。新しいスタイルを発明しないでください。

macOS および Linux / Windows WSL で動作します。セットアップ:リポジトリの README.md を参照してください。

必須ルール

  1. すべてのオーバーレイは work/words.txt の秒数を基準にタイミングを合わせます。時間を推測しないでください。
  2. src/(ライブラリ)内のコンポーネントのみを使用します。ライブラリコンポーネンがビートに合わない場合にのみ、新しいコンポーネントを追加します。
  3. 顔ははっきり見えるようにします。セーフゾーン(1080x1920):
    • 上部のタグとタイトル:y 90~400。
    • 顔と首:y 約450~1350。ここには、全画面タイトルカード(最大3秒)以外何も配置しません。
    • その他はすべて首の下(シャツの一番上のボタン)に配置:y 1360~1880。 Panel は BELOW_NECK(1360)から始まります。 fit を使用して縦長のパネルをスケーリングし、1880 までに収めます。
    • 新しい動画ごとにネックラインを見つける:y グリッド付きのフレームを取得して確認します。 ui.tsx の BELOW_NECK を更新します。
  4. ユーザーがチャットで要求しない限り、動画全体をレンダリングしないでください。 scripts/stills.sh を使用して確認します。フックが RENDER_OK=1 なしでの remotion render をブロックします。
  5. ユーザーに確認せずに何もダウンロード(モデル、フォント、音楽、サウンドパック)しないでください。
  6. デバッグする前に、reference/known-problems.md を読んでください。
  7. OpenCode では、プラグイン ~/.config/opencode/plugins/reel-from-raw が Claude フック(レンダリングブロック、タイプチェック、スチルリマインダー)と同じ処理を行います。シート画像は read ツールで開いてください。モデルが画像を見られない場合は、ユーザーにシートを確認するよう依頼してください。

スコープルール(厳守)

  1. ユーザーが依頼したことだけを行います。リクエストに必要なファイルと値のみを変更します。
  2. チェック(タイプチェック、スチルチェック、フックまたはプラグインからのリマインダー)は、あくまでチェックです。このファイルまたは reference/style-spec.md のルールに違反するものだけを修正します。チェックが原因で、スタイルの変更、コンポーネントの追加、シーンの追加、テキスト、タイミング、音量の変更は絶対に行わないでください。
  3. 他に変更すべき点があると思われる場合は、1行でユーザーに伝えてください。変更しないでください。
  4. 動画を編集中に ~/.claude/skills/reel-from-raw/(このスキル)を編集しないでください。動画プロジェクトのみを編集します。
  5. 作成したテストファイル(例:src/__probe.ts)は、終了前に削除する必要があります。

ワークフロー(新しい動画)

各ステップを実行します。各スクリプトは、成功時に OK: を出力します。 ERROR が発生した場合は停止して修正します。

#ステップコマンド / アクション
1プロジェクト作成bash ~/.claude/skills/reel-from-raw/scripts/new-project.sh <dir> <raw.mp4> (例:~/Coding/motion-videos/<name>)。ライブラリ、サウンドファイル、フックをコピーし、npm パッケージをインストールします(または $REEL_SEED からクローンします)。
2文字起こしbash ~/.claude/skills/reel-from-raw/scripts/transcribe.sh <dir> hi (英語のみの場合は en を使用)。その後、reference/glossary.md を使用して聞き間違いを修正します。
3無音カットpython3 ~/.claude/skills/reel-from-raw/scripts/cuts.py <dir>。 --start/--end を使用して、誤った開始や末尾を削除します。
4ビートシートreference/beat-sheet-prompt.md に従います。 work/beats.md を記述します。ユーザーが計画を承認したい場合に表示します。
5ビルドsrc/Reel.tsx は Day 1 のリールです。ビートシートからこれを書き換えます。 Root.tsx で、id(例:LinuxDay3)と実際の handle を設定します。リールで使用しないシーンコンポーネントを削除します。 At ヘルパーと r() ヘルパーは保持します。
6型チェック自動:編集のたびにフックが tsc --noEmit を実行します。報告されたすべてのエラーを修正します。
7ビジュアルチェックbash ~/.claude/skills/reel-from-raw/scripts/stills.sh <dir> auto を実行し、すべての out/stills/sheet*.jpg を読み取ります。ビートフレームも確認します:stills.sh <dir> 120,450,...。 reference/style-spec.md と照らし合わせて確認します。修正して繰り返します。
8サウンドチェック効果音はコンポーネントに付属しています(「効果音」を参照)。 public/sfx/typing.wav と public/sfx/pop.wav が存在することを確認します。ユーザーが要求しない限り、表以外の音を追加しないでください。
9プレビュープロジェクト内で npx remotion studio --no-open --port <free> を実行する launch.json エントリを追加します。ユーザーに URL http://localhost:<port> を提供します。ユーザーはそこで音声を聴きます。
10レンダリング(リクエストがあった場合のみ)RENDER_OK=1 npx remotion render <Id> out/<name>.mp4 --gl=angle(バックグラウンドで実行、90秒で約3〜5分)。

効果音

src/sfx.tsx にすべての効果音が格納されています。 SFX は音の一覧です。 <Sfx src at volume frames name> は、現在のシーケンス内の at フレームで1つの音を再生します。

SFX のキーソースインターネット要否
whoosh, ding, click, switch, whip@remotion/sfx (remotion.media 上のファイル)はい(Studio とレンダリング用)
poppublic/sfx/pop.wav (コードで生成)いいえ
typingpublic/sfx/typing.wav (scripts/make-typing-sound.py で生成)いいえ

ライブラリコンポーネントはすでにこれらの音を再生します。手動で追加する必要はありません。

タイミングファイル(プロジェクト内)音音量
フックタイトル / サブチップscenes/Intro.tsx (Hook)whoosh / whip0.54 / 0.48
日付タイトルカードscenes/Intro.tsx (DayTitle)whoosh / ding0.6 / 0.36
コマンドリストチップscenes/Intro.tsx (CommandList)チップごとに pop0.36
コマンドタグ / コマンド名scenes/Commands.tsx (CommandTag)whoosh / switch0.54 / 0.48
メモパッド行scenes/Commands.tsx (NoteCard)行ごとに typing0.6
下部パネル表示ui.tsx (Panel)pop0.48
ターミナルコマンド入力ui.tsx (Terminal)コマンド行ごとに typing0.6
ライトリークReel.tsxwhoosh0.48
完了バッジ / フォロークリックscenes/Outro.tsx (DayDone, FollowCard)ding / click0.48 / 0.72
volume のない <Sfx>sfx.tsx(デフォルト)-0.42

音量は 0(無音)から 1(最大)です。すべての音を声より小さく保ってください。

よくあるリクエスト(正確なレシピ)

ユーザーの依頼正確な手順
「すべての効果音を N% 上げて/下げて」<Sfx 行のすべての volume={x} と、sfx.tsx のデフォルト値に (1 ± N/100) を掛けます。小数点第2位に丸めます。 CutVideo.tsx には触れないでください(それが音声です)。変更前後に grep -rn "<Sfx" src を実行し、変更された値を表示します。
「キーボード/タイピングの音量だけを変更して」src={SFX.typing} の行のみを変更します(ui.tsx の Terminal と scenes/Commands.tsx の NoteCard)。
「特定の音 X だけを変更して」上の表でその行を見つけます。その volume のみを変更します。
「キーボードの音が弱い / 新しい音を作って」python3 ~/.claude/skills/reel-from-raw/scripts/make-typing-sound.py <project>/public/sfx/typing.wav。最初に古いファイルのコピーを保管してください。ユーザーが異なる感触を要求した場合にのみ、スクリプト内の数値を編集します。
「音を削除して」該当する <Sfx .../> 行を削除します。
「レンダリング前にどこで聴ける?」Studio(ステップ9)。再生または Space キーを押します。Studio は編集を保存するたびに自動的にリロードします。
「自分でレンダリングするには?」ターミナル: cd <project> && npx remotion render <Id> out/<name>.mp4 --gl=angle。Studio UI:レンダーボタン(タイムライン上部のバーの右端)→ Video タブ → Output name を設定 → Render video。進捗は Jobs タブに表示されます。OpenGL 設定はすでに angle です。
「レンダリングして」ステップ10、RENDER_OK=1 を使用。その後、出力ファイルのフルパスを提供します。
「ハンドルを変更して」Root.tsx の defaultProps.handle。

タイミングの仕組み

  • src/timeline.ts:CUTS(削除された生の秒数)、out(sec) は、生の秒数を出力フレームにマッピングします。
  • <At from={rawSec} to={rawSec} name="..."> は、その発話範囲のブロックを表示します。
  • r(t0, t) は、ブロック内のフレーム遅延を提供し、「t で単語が発話されたときにこれをポップさせる」ために使用します。
  • CutVideo は、セグメントごとにズーム 1.0 / 1.14 を交互に繰り返します(カットごとのパンチイン)。これ以上ズームを追加しないでください。

ライブラリマップ

ファイルエクスポート用途
theme.tsDISPLAY(Anton)、SANS(Inter)、MONO、色 C、extrude()すべてのテキストと色。新しいフォントや色は追加しない。
sfx.tsxSFX、Sfx効果音(上記参照)
ui.tsxPop、useIn、useOut、BELOW_NECK、Panel、TermFrame、Terminalスプリングポップイン、下半分のパネル、タイプライター風ターミナル
scenes/Intro.tsxHook({title, sub, subAt})、DailyStep({children})、DayTitle({day})、CommandList({commands, line, lineAt})、LightLeakオープニング、セクション遷移
scenes/Commands.tsxCommandTag({n, total, name, nameAt, meaning, meaningAt, color})、FolderPath、FileGrid、MoveSwap、NoteCardセクションごとに1つのトピック:上部にタグ、Panel 内にビジュアル
scenes/Commands.tsx(Day 2、ハードコードされたテキスト)IdCard、OwnerSwap、PhoneApps、Snapshot、TopView、PdfSearch再利用する前にテキストの props を追加
scenes/Outro.tsxDayDone({day})、NextDay({day, commands, at})、FollowCard({handle})エンディング(NextDay はオプション)
Reel.tsxReelDay 1 リール全体。構造の例として使用。

テキストを変更する際は、サイズ、色、アニメーションを維持してください。

関連スキル