Communitygithub.com

reel

ReelStudio を使用して、Instagram リール、TikTok、YouTube ショートなどの短尺縦型動画をローカルで作成します。Codex がスクリプト作成、シーンの計画とコーディング、フレームの確認を行い、OpenRouter が音声、画像、ワードタイムスタンプを生成し、Remotion が MP4 にレンダリングします。

reel とは?

ReelStudio は、トピックやスクリプトから高品質な短尺縦型動画をローカルに作成するための AI エージェントスキルです。このスキルにより、Claude Code や Cursor、Codex などの AI コーディングエージェントは、ユーザーが「リールを作って」「ショート動画を」「縦型動画を」「このトピックで動画を作って」などと依頼したときに、脚本作成、シーン設計、キャプションのコーディング、フレームの品質確認といった、AI エージェントにしかできないクリエイティブな作業を行います。画像生成や音声合成、レンダリングといった負荷の高い処理は OpenRouter や Remotion に任せ、`reelstudio` コマンドを介して連携します。 対応しているプラットフォームは、Instagram リール、TikTok、YouTube ショートです。動作には macOS 上の Node.js、Remotion、ffmpeg、OpenRouter API キーが必要で、ネットワークアクセスが必須です。スクリプト作成からレンダリングまでのワークフローを各コマンドで分割して実行でき、設定やレンダリングに数分かかる場合があります。AI エージェントはユーザーと対話しながらスクリプトを承認し、ブランドやルック(視覚スタイル)を適用して、一貫性のあるシリーズ動画を制作します。

対応✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/luke30001/reelstudio-codex/tree/HEAD/plugins/reelstudio/skills/reel

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

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

ドキュメント

ReelStudio: トピックを入力、リールを出力

あなたはプロデューサーであり、クルーでもあります。あなただけができること(脚本執筆、演出、シーンのコーディング、フレームの判断)を行い、あなたにはできないこと(音声、画像、タイムスタンプ、レンダリング)は reelstudio コマンドを実行してください。

reelstudio <command>     # = $RS 以下の通り; ランチャーは ~/.local/bin にあり、~/ReelStudio/engine/bin/rs.mjs を実行

以下 $RS は reelstudio を意味します。reelstudio が PATH にない場合は、node ~/ReelStudio/engine/bin/rs.mjs(初回セットアップ後)または node <プラグインルート>/engine/bin/rs.mjs(プラグインルートはこの SKILL.md の2つ上のフォルダです)を使用してください。エンジンは OpenRouter を呼び出し、ffmpeg とヘッドレス Chrome(Remotion)を実行するため、ネットワークアクセスが必要であり、~/ReelStudio に書き込む必要があります。サンドボックスが reelstudio コマンドをブロックする場合は、回避策ではなく、昇格されたアクセス許可を要求してください。各コマンドは個別に実行してください(cd … && チェーンやパイプは禁止)。setup、frames、render は数分かかることがあります。

すべては ~/ReelStudio/ 内にあります: reels/<name>/、brands/*.json、looks/<id>/look.json(+ マスコット画像と参照画像)、.env(OpenRouter キー)、config.json(オプションのモデルオーバーライド)。ユーザーは Codex Web アプリからすべてを操作することもできます: node <プラグインルート>/app-codex/server.mjs(http://127.0.0.1:4749; プロデューサーとして codex exec を実行します)。

0. 初回

$RS setup を実行します(エンジンをコピーし、Remotion を一度インストールし、default ブランドを作成します)。OpenRouter キーがないと報告された場合、音声と画像は実行できません。その場合は処理を停止し、ユーザー自身で設定するように伝えてください(ユーザー自身のターミナルで: reelstudio key、または OPENROUTER_API_KEY=... を ~/ReelStudio/.env に設定)。チャットにキーを貼り付けるようユーザーに依頼しないでください。プラグインを更新した後は、$RS setup を再実行してください(ランチャーは最新のインストール済みプラグインバージョンを選択します)。

1. ブリーフ

トピック(またはユーザーのスクリプト)、ブランド($RS list でブランドとルックを表示)、言語、目標の長さ(デフォルト 25~40 秒)を取得します。プレミアムな編集品質(1つの世界を滑らかにカメラズーム、セリフ体の見出し、赤いピル、クリーンなカード)を得るには、editoriale ルックのブランド(または歴史や実写写真を使った真実のストーリーには cronaca ルック、ブランド storia)と、手順 5b のズームフォーマットを使用してください。どのトピックでも機能します。~/ReelStudio/brands/<brand>.json を読み、その tone に従ってください。

ルックがクリエイティブの軸です。 すべてのブランドは ~/ReelStudio/looks/<id>/look.json のルックを指しています。何かを書く前にそれを読み、その bible(レイアウトルール、マスコットの使用方法、避けるべきこと)に従ってください。色、フォント、キャプションスタイル、背景は自動的に適用されます。imageStyle と参照画像はすべての rs image 呼び出しに自動的に追加されるため、ブランド内のすべての画像は1つのスタイルを共有します。ブランドのすべてのリールは、同じシリーズの一部のように見える必要があります。

2. スクリプトとストーリーボード

$RS new "<topic>" --brand <brand> はリール名を出力します。reels/<name>/reel.json を記述します:

{"title": "...", "brand": "default", "scenes": [
  {"id": "hook", "voiceover": "...", "visual": "画面に表示されるもの", "hold": 0.2}
]}

スクリプトのルール:

  • 最初の2秒以内にフック: 驚くべき主張、数字、または質問。「Ciao a tutti」や「In questo video」は禁止。
  • 5~9シーン、各シーン1つのアイデア、各シーン6~20語のナレーション。短い話し言葉の文。話し言葉どおりに数字を書いてください(「4」ではなく「quattro」)。TTS は書かれたとおりに読むためです。
  • 事実は真実でなければなりません。数字が確かでない場合は、省略してください。
  • ペイオフで終わり、その後に短い CTA シーン(フォロー、保存、コメント)を配置します。CTA は常に 専用のクリーンな画面 を取得します: <EndScreen title="…" sub="…" actions={['Salva', 'Segui']} />(世界/写真を覆う不透明なブランド背景、ルックにマスコットがある場合はマスコット、ブランドハンドルピル)。CTA を写真、世界、または他のシーンのビジュアルの上に重ねないでください。
  • id は短く、安定したスラッグです。シーンの voiceover を変更すると、そのシーンのみが再音声化されます。

ユーザーにスクリプト(ナレーション行のみ)を表示し、音声に費用をかける前に OK を待ちます。ただし、ユーザーが直接進むように指示した場合は除きます。

3. 音声とタイミング

$RS voice <name>: OpenRouter を介して Gemini 3.8 Flash TTS(音声 Charon: TTS アリーナで #1、ネイティブなイタリア語音声)でシーンごとに1つの MP3 を生成し、Nemotron 文字起こしから単語タイムスタンプを取得し、timeline.json(シーンごとおよび単語ごとに30 fps のフレーム)を書き込みます。ブランドの voice.instructions がトーンとペースを調整します(リールの言語で記述してください。例: 「tono da documentario, ritmo deciso」)。オプション: --scene id1,id2(一部のシーンをやり直す)、--voice <name>(Gemini: Charon, Kore, Puck, Aoede, Fenrir, Leda, Orus, Zephyr…)、--tier eleven(ElevenLabs v4: 最も表現力豊かで、[excited] [whispers] [pause] タグを理解しますが、既成の音声は英語話者向けです)、--tier native(Microsoft MAI-Voice-2.1、真の it-IT 音声 Luca/Rosa、より低速で間が多い)、--tier budget、--local(ロボット的な macOS ドラフト音声: ユーザーが無料のドラフトを明示的に要求した場合のみ使用。決してフォールバックとして使用しないでください: voice がネットワークまたはキーの問題で失敗した場合は、ネットワークアクセスを有効にして同じコマンドを再実行するなどして修正してください。render はとにかくドラフト音声のシーンを拒否します)。すべてのクリップは自動的に研磨されます: 両端の無音部分が除去され、0.65 秒を超えるポーズのみが短縮されます(通常の呼吸の間はそのまま残ります。そうしないと音声が息切れしているように聞こえます)、穏やかな EQ とレベル調整(--raw-voice でスキップ)。未加工のテイクは assets/vo/raw/ に保持され、voice <reel> --repolish は新しいテイクに費用をかけずに研磨をやり直します。レンダリングはミックスを −14 LUFS にします。シーンは 0.2 秒の hold で連続します。意図的な劇的なビートには hold を上げてください(0.5~0.8)。音声インストラクションには自然なペースの注意書きが含まれます。ブランド音声で "pace": "free" を設定すると、それを削除できます。--speed が 1.3 を超えると、落ち着いた音声でも息切れしているように聞こえ始めます。音声の多いリールには 1.2~1.3 をお勧めします。ナレーションは、独立したキャプションではなく、次のシーンに流れるように接続された文として記述してください。ブランドはモデルごとに音声を固定できます: "voice": {"voices": {"google/gemini-3.8-flash-tts": "Kore"}}。

4. ビジュアル素材: 各ショットに最適なものを選択

何も強制されません。ショットごとに、最も見栄えが良く、正直な素材を選び、自由に混在させてください。有料画像の上限をユーザーに確認してください(デフォルト ≤ 4)。

  • 実際の写真(歴史、ニュース、実際の場所、人々、存在する物体): $RS photo <name> search "<英語のクエリ、年、場所>" は、Wikimedia Commons(パブリックドメイン、CC0、CC BY/BY-SA)からのフリーライセンスの結果をリストし、frames/photos-sheet.png(1行あたり4枚、リスト順)を書き込みます。それを確認し、選択してから、$RS photo <name> get <n> <imgname> → assets/img/<imgname>.jpg(最大 3000 px)で、作成者/ライセンスが assets/credits.json に保存されます。常にクレジットを表示してください(<Credit file="img/x.jpg" /> または <Photo … credit>)。被写体が実際に存在した場合は、AI 画像よりも実際の写真を優先してください。AI 画像を決して歴史的な写真として提示しないでください。
  • AI 画像(イラスト、コンセプト、再構築、カメラが捉えなかったシーン): $RS image <name> <imgname> "<プロンプト>" をルックのアートディレクションと参照とともに使用します。
    • --world: Nano Banana 2.1 を 4K(3072×5504、約 $0.12)で: カメラの世界や大きなプリントとして十分な大きさの画像。約 2.8 倍のズームまでシャープさを維持。
    • --res 2K|4K と --model bytedance-seed/seedream-4.5(4K、$0.04、より高密度なディテール)またはそれをサポートする他のモデル。--aspect 1:1|3:4|16:9 は非縦型プリント用。
    • デフォルト(MAI-Image-2.7、約 800 px、約 $0.035)および --hero(GPT Image 2.6 Sunburst、最高のディテール、約 860 px、約 $0.15~0.21): 小さなカードや挿入のみに使用し、深いズームや全画面背景には決して使用しないでください。
    • --mascot、--ref img/other.png(連続性)、--no-style。被写体と構図を説明してください。ルックがスタイルを処理します。常に「vertical composition, no text」(または適切なアスペクト)を追加してください。生成するすべての画像を確認してください(画像ビューアツール、view_image で PNG を開きます)。
  • ベクター(SVG/React): 画像よりもクリーンな場合: チャート、数字、地図と図、タイムライン、アイコン($RS icon <name> <lucide-name…>)、UI、ラベル。注意深く構築してください: 一貫したストローク幅、ルックのパレットのみ、ソフトなシャドウとグラデーション、十分な余白。粗略な形状で物体やシーンを偽装しないでください。描画が必要な場合は AI 画像を使用し、存在した場合は写真を使用してください。
  • 解像度ルール: 画面上では、画像はそのピクセル幅よりも大きく表示されてはなりません(ズーム × ワールド幅 ≤ PNG 幅)。rs frames は、これに違反した場合にぼやけを表示します。

5. シーンを構築する: reels/<name>/src/Reel.tsx

@rs からコンポーネントを構成します(ソース: ~/ReelStudio/engine/src/lib/index.tsx、詳細が必要なときに読んでください):

import React from 'react';
import {Reel, Title, BigStat, Bullets, Quote, Compare, Icon, Card, CTA, ImageBG, Mascot, CoverFrame, BrandBG, ReelProps} from '@rs';

export default (p: ReelProps) => (
  <Reel {...p}
    scenes={{
      hook: <><Title kicker="Psicologia" text="Il tuo cervello *ama* le liste" /><Mascot pos="peek" /></>,
      stat: <BigStat value={4} prefix="≈" label="elementi nella *memoria di lavoro*" />,
      why:  <Bullets title="Perché funzionano" items={['Divide il problema', 'Riduce lo *sforzo*']} />,
      cta:  <CTA text="Altri trucchi sul *cervello*" />,
    }}
    backgrounds={{ hook: <ImageBG src="img/brain.png" /> }}
  />
);

// オプション: カバー画像。アニメーションはここですでにレンダリングされています。
export const Cover = (p: ReelProps) => (
  <CoverFrame brand={p.brand}><BrandBG /><Title text="Il tuo cervello *ama* le liste" /><Mascot pos="peek" /></CoverFrame>
);
  • reel.json のすべてのシーン id には、scenes 内に対応するエントリが必要です。*word* はその単語をアクセントカラーで表示します。
  • コンポーネント: Title、Kicker、BigStat(カウントアップ)、Bullets(シーン全体にわたって時間指定で表示、または at=[frames] で timeline.json のワードフレームに同期)、Quote、Compare(2列)、Icon(大きな絵文字)、Card(フレーム付き画像)、CTA、ImageBG(フルブリードの Ken Burns 効果)、BrandBG(ルックの背景: 紙、グラデーション、またはベタ塗り。デフォルトの背景です)、Mascot(ルックのマスコット: pos="peek" は右端からスライドイン、"corner" はコンテンツエリアの右下に配置、"center" は大きなヒーロー画像。src="img/pose.png" は生成されたポーズを使用します)。オーバーレイは自動です: カラオケキャプション、プログレスバー、ハンドル。captions={false} および類似のプロップでオフにします。
  • 画面上のテキストはナレーションを 補完 します。キャプションがすでにそれを実行しているため、一字一句繰り返さないでください。シーンごとに 2~7 語に抑えてください。
  • カスタムビジュアルも問題ありません: @rs から useF()、useScene()、useBrand()、interpolate、spring、fitFont、Stage を使用して、独自の React コンポーネントを src/ に記述してください。すべて決定論的に保ってください(Math.random や Date は使用しない)。
  • セーフゾーン(1080×1920): Stage 内の y=200 から y=1180 の間のコンテンツ。キャプションは y≈1250~1450 に配置されます。Instagram が UI を配置する y=1500 より下には重要なものは何もありません。
  • レイアウトを変化させてください: 同じコンポーネントを 3 シーン続けて使用しないでください。

5b. ズームフォーマット(プレミアム編集品質)

editoriale ルック(クリーンな解説)または cronaca ルック(歴史、経済、実際の写真を使った真実のストーリー)を使用して、あらゆるトピックでトップクラスの解説品質を実現する方法: 1つの大きな世界、その上を滑らかに動きズームする1つのカメラ、ハードカットは一切なし。 ルックの bible を読み、それに従ってください。世界は、実際の写真、4K AI 画像、ベクターピースを任意に組み合わせて構成できます(手順 4)。

import React from 'react';
import {Reel, ReelProps, Headline, Pill, StatCard, Badge, ChartCard, Source, Credit, Grain, At, WorldGround, WorldImage, EndScreen, CoverFrame, AbsoluteFill, useBrand, useReveal} from '@rs';

const W: [number, number] = [3240, 6300];
// 紙のテーブルに配置されたプリント、カメラが移動できるように互いに離して配置(`rs photo` からの写真、幅 3000 px)
const P = {crowd: {x: 1050, y: 1600, w: 1600, h: 1186, r: -2}, line: {x: 2200, y: 5050, w: 1500, h: 1206, r: 1.5}};
const world = (
  <>
    <WorldGround w={W[0]} h={W[1]} pattern="lines" step={64} />
    {Object.entries(P).map(([k, p]) => <WorldImage key={k} src={`img/${k}.jpg`} x={p.x} y={p.y} w={p.w} h={p.h} rotate={p.r} radius={6} grade="bw" />)}
    {/* 博物館スタイルのラベル、プリント間の赤い糸、AI 4K 画像や SVG ピースもここに配置可能 */}
  </>
);
const OVER = {x: 1620, y: 3250, zoom: 0.34};
const Dim = () => { const b = useBrand(); const o = useReveal(0, 16); return <AbsoluteFill style={{background: b.colors.bg1, opacity: 0.82 * o}} />; };

export default (p: ReelProps) => (
  <Reel {...p} world={world} worldSize={W} overlay={<Grain amount={0.14} />}
    camera={{
      hook: OVER,                                                                  // テーブル全体の概要
      crowd: [{x: 1050, y: 1850, zoom: 0.62}, {x: 1170, y: 1720, zoom: 0.95, at: 0.42, move: 40}], // 飛び込み、その後ディテールにダイブ
      chart: {x: 1620, y: 4400, zoom: 0.42},                                       // ズームアウト、世界を暗くし、データを表示
      line: {x: 2200, y: 5280, zoom: 0.64},
      cta: OVER,
    }}
    scenes={{
      hook: <Headline title={'Il Giovedì nero\ndi Wall Street'} pill="−11% in poche ore" />,
      crowd: <><StatCard value={12.9} decimals={1} suffix=" mln" label="azioni scambiate: *un record*" y={900} w={680} delay={150} /><Credit file="img/crowd.jpg" y={1165} /></>,
      chart: <><Dim /><ChartCard type="line" data={[381, 199, 294, 41]} labels={['set 1929', '', '', 'lug 1932']} title="Dow Jones, 1929–1932" x={540} y={720} w={940} h={640} /><Badge value="−89%" label="dal massimo" x={540} y={1150} color="#B3261E" delay={150} /><Source text="Fonte: S&P Dow Jones Indices" y={1215} /></>,
      line: <><StatCard value={25} suffix="%" label="disoccupati negli USA nel 1933" y={880} w={720} /><Credit file="img/line.jpg" y={1170} /></>,
      cta: <EndScreen title={"Storie che hanno\ncambiato l'economia"} sub="Ogni settimana una crisi, spiegata" actions={['Salva', 'Segui']} />,  // 専用画面、決して世界の上に重ねない
    }}
  />
);
export const Cover = (p: ReelProps) => (
  <CoverFrame brand={p.brand} world={world} worldSize={W} shot={{x: 1050, y: 1900, zoom: 0.62}}>
    <Headline title={...} />
  </CoverFrame>
);

6. 画像の信憑性

ReelStudio は画像の責任ある使用を実施します:

  • 実際の写真と AI 画像を混在させる場合、クレジットは写真にのみ表示されます。
  • 歴史的な主張は、実際の写真(利用可能な場合)または明確に「再構築」とラベル付けされた AI 画像によって常に裏付けられる必要があります。
  • reels/<name>/reel.json の各シーンには、"imagePolicy": "photo"(実際の写真のみ)または "ai"(AI 画像のみ)を設定できます。editoriale ルックはデフォルトで photo を優先します。
  • 実際の写真には常に <Credit> コンポーネントを使用し、AI 画像には <Photo> コンポーネントを使用します。ReelStudio は、適切なクレジットなしで実際の写真が使用された場合、レンダリングをブロックします。

7. フレームの確認

$RS frames <name>: 全シーンを埋め込んだ1つの HTML ファイル(frames/frames.html)を出力します。すべてのフレームを調べてください。 ローカルブラウザで開き(画像ビューアツールは使わないでください)、スクロールして各フレームを確認します。何が間違っているかを説明し、rs コンポーネントまたは React の props を変更して修正してください。画像をマークアップに置き換えたり、誤字を直したり、色やフォントを修正したり、レイアウトを完全に変えたりできます。rs frames は画像がぼやけているかどうかを検出し、もしそうなら画像の解像度(--hero, --world, --res 4K でアップグレード)または camera のズームレベルを変更する方法を提案します。画像を変更するたびに、再度 rs frames を実行することで確認できます(再レンダリングする必要はありません。rs image だけです)。

8. レンダリング

$RS render <name>: remotion render を呼び出し、reels/<name>/out/<name>.mp4 を生成します(1080×1920、H.264、約40秒で 50~120 MB)。現在の scene と title でデフォルトのサムネイルを設定します。

共通ワークフロー

話題の解説 (3分)

$RS new "Perché l'inflazione non scende" --brand editoriale
# スクリプトを書き、reel.json に保存
$RS voice editoriale
$RS frames editoriale
# 画像を生成。1枚目の写真、2枚目の AI 画像、3枚目の世界
$RS image editoriale world --world "[プロンプト]"
$RS frames editoriale
$RS render editoriale

写真+声のドキュメンタリー (2分)

$RS new "L'assedio di Leningrado" --brand storia
# スクリプトを書く
$RS photo storia search "Siege of Leningrad 1943"
$RS photo storia get 2 bread.jpg
$RS voice storia --scene 1,2 --voice Kore
$RS frames storia
$RS render storia

5分の商品リール(写真マットなし)

$RS new "Scarpe da running" --brand default
$RS voice default --tier eleven
$RS image default shoe1 "Scarpa da running bianca e blu, isolata su sfondo grigio chiaro, illuminazione da studio, dettaglio della suola"
$RS image default shoe2 "Primo piano del tessuto traspirante della scarpa da running, texture"
$RS frames default
$RS render default

ブランド管理

  • $RS list: ブランドとルックを一覧表示します。
  • $RS brand <name> --look <look>: 新しいブランドを作成します。
  • $RS brand <name> --tone "descrizione del tono di voce": ブランドのトーンを設定します。
  • $RS brand <name> --voice "voices": {...}: ブランドの音声設定を構成します。

トラブルシューティング

  • reelstudio が見つかりません: node ~/ReelStudio/engine/bin/rs.mjs を使用するか、$RS setup を再実行します。
  • 音声が失敗します: OpenRouter キーが ~/ReelStudio/.env に設定されていることを確認します。$RS key でテストします。
  • 画像がぼやけています: --world または --res 4K で解像度を上げます。rs frames で画像がぼやけているかどうかを確認します。
  • レンダリングが遅い: Remotion がレンダリングしています。初めての実行は遅くなります。render コマンドを中断しないでください。
  • ドラフト音声が使用されました: render はローカル音声のシーンを拒否します。--local を削除し、$RS voice <name> を再実行します。
  • サンドボックスがコマンドをブロックします: reelstudio に昇格されたアクセス許可を要求します。回避策は使用しないでください。

ベストプラクティス

  • スクリプトを最初に: 画像や音声の費用が発生する前にユーザーに承認を得ます。
  • 一貫したルック: すべてのリールで同じルックとブランドを使用します。
  • 実際の写真を優先: 利用可能な場合は、AI 画像よりも実際の写真を使用し、常にクレジットを表示します。
  • レイアウトを変化させる: 同じコンポーネントを連続して使用しないでください。
  • セーフゾーンを尊重: 重要なものを画面の下部に配置しないでください。
  • 画像を確認: 各画像を個別に確認します。rs frames でぼやけをチェックします。
  • CTA は専用画面: CTA を世界または写真のオーバーレイとして表示しないでください。

関連スキル