Remocn Studio ハンドオフ
Remocn Studio (https://remocn.studio) は macOS および Linux 向けのデスクトップアプリです。Remotion プロジェクトをライブプレビューし、ユーザーが手動で要素を調整して mp4 にエクスポートできます。認識できるフォルダのみを開くため、プロジェクトは Prepare を一度実行すれば、その後はいつでも Open できます。
ヘルパースクリプトは ${CLAUDE_SKILL_DIR}/scripts/studio.mjs です (Claude Code 外部では、このファイルの隣にある scripts/studio.mjs)。必要なのは Node だけで、コマンドごとに1つの JSON オブジェクトを出力します。Remotion プロジェクトのルートから実行するか、ルートを最初の引数として渡します。
Prepare
node "${CLAUDE_SKILL_DIR}/scripts/studio.mjs" init <project-root> --name "<ビデオ名またはプロダクト名>"
実行内容とユーザーに伝えること:
.remocn/project.json(Studio のプロジェクトマニフェスト: 新しいprojectId、revision: 0、ブランドなし) が存在しない場合に書き込みます。既存のマニフェストには絶対に触れません。そのprojectIdは Studio におけるプロジェクトのアイデンティティです。- Studio のスキャンを
src/videos/registry.tsxに (存在しない場合) 配置し、エントリポイントでregisterRoot(withVideos(Root))としてルートをラップします。以降、src/videos/<slug>/index.tsxでmetaをエクスポートするすべてのファイルは、Remotion Studio と Remocn Studio の両方で id<slug>のコンポジションになります。ユーザー自身のRoot.tsxのコンポジションは引き続き動作します。
すでに存在するプロジェクトで実行する場合は、事前にユーザーに確認を取ってください。エントリポイントを編集し (1つのインポートと1つのラップ)、2つのファイルを追加します。
結果が ok: false でエントリポイントに関する理由を示している場合、エントリポイントがインポート後に registerRoot(Root) を正確に1回だけ呼び出していません。手動でラップしてください。結果の specifier (エントリポイントからの相対パス、例: remotion/index.ts の場合 ../src/videos/registry) を使って import { withVideos } from "<registry.specifier>"; を追加し、呼び出しを registerRoot(withVideos(Root)) に変更します。それが不可能な場合は、その理由をユーザーに説明してください。
その後、npx remotion compositions ですべてのビデオスラッグが一覧表示されることを確認します。
Open
ユーザーが Studio でプロジェクトを開くことに同意した後にのみ:
node "${CLAUDE_SKILL_DIR}/scripts/studio.mjs" open <project-root>
結果の message をユーザーに伝えます。action によって:
deep-link: Studio がプロジェクトを開き、確認ダイアログを表示します。他にすることはありません。launched: Studio は起動していますが、どのフォルダを開くかをまだ指定できません。ユーザーに Open Folder (macOS では ⌘O、Linux では Ctrl+O) を選択し、プロジェクトのルートを選ぶよう指示し、パスを伝えてください。not-installed: ダウンロードリンク (https://remocn.studio) と、インストール後に行う同じ Open Folder の手順を伝えてください。unsupported-platform: Studio はこの OS では動作しません。ビデオは引き続きnpx remotion studioでプレビューし、npx remotion render <slug>でレンダリングできます。
結果にマニフェストがないと表示された場合は、先に Prepare を実行してください。
何も開かずに Studio がインストールされているかどうかを確認するには、detect コマンドを実行します。
禁止事項
.remocn/project.jsonを手動で作成したり、別のプロジェクトからコピーしたりしないでください。同じprojectIdを持つ2つのプロジェクトは Studio で衝突し、2つ目は拒否されます。- ビデオを
src/videos/<slug>/から移動しないでください。Studio はビデオをフォルダ名で識別します。 - claude.ai や ChatGPT では、ローカルプロジェクトを引き継ぐことはできません。このプラグインを使用するコーディングエージェント (Claude Code、Codex) または Remocn Studio の独自テンプレートをユーザーに案内してください。