video-setup

動画のセットアップ

一度だけ、10分で完了します。最後には、クリエイターは次の状態になります。

• ほかのスキルから呼び出すツールがインストールされ、確認済みです。
• video-agent/voice.md：本人がどんな人で、どのように話し、何を信じ、何を証明できるのかがまとめられています。すべてのスクリプトはこれに基づいて作成されます。
• 編集スタジオの準備が整い、最初の編集をすぐに始められます。
• Claude が毎回確認を求めなくても ffmpeg、yt-dlp、Remotion を実行できるよう、権限ルールが設定されています。
• 希望する場合は、Treg を通じてアカウントが接続されます（監査と公開）。翻訳と画像生成に使うキーも設定されます。

実行方法

• クリエイターが使う言語で話してください。簡単な言葉を使い、専門用語は避けます。
• 1回のメッセージにつき質問は1つにしてください。選択肢を提示できる場合は、推奨する選択肢を最初に示してください。
• 本人について、決して事実を捏造しないでください。把握していない事実は質問するか、{{placeholder}} にしてください。

1. ツール

確認を実行し、ツールごとに1行で表示します（✓ バージョン、または ✗ 不足）：

node -v
ffmpeg -version
yt-dlp --version
deno --version
git --version

ツール	使用するもの	macOS	Windows	Linux
Node 18+	video-edit（Remotion）	brew install node	winget install OpenJS.NodeJS.LTS	nodejs.org またはパッケージマネージャー
ffmpeg	video-edit、video-steal、long-to-short-videos、video-translate、video-publish	brew install ffmpeg	winget install Gyan.FFmpeg	sudo apt install ffmpeg
yt-dlp	video-viral、video-steal、long-to-short-videos、動画からの voice.md 作成	brew install yt-dlp	winget install yt-dlp.yt-dlp	pipx install "yt-dlp[default]"
deno	YouTube での yt-dlp（JavaScript ランタイムが必要です）	yt-dlp に付属	winget install DenoLand.Deno	curl -fsSL https://deno.land/install.sh | sh
git、ビルドツール	video-edit（Remotion テンプレートの取得、whisper.cpp のビルド）	xcode-select --install	winget install Git.Git	sudo apt install git build-essential
Codex（任意）	codex-images	npm i -g @openai/codex を実行後、codex login	同じ	同じ

不足しているツールのコマンドを提示し、実行してもらいます（実行してほしいと言われた場合は、こちらで実行します）。スクリプト作成のみのユーザー（video-script、video-viral）に必要なのは yt-dlp と deno だけです。Codex が必要なのは /codex-images のみで、ChatGPT プランも必要です。画像を希望しない場合は省略してください。

• Windows：winget の実行後、ターミナル（および Claude Code）を閉じて開き直してください。そうしないと、新しいコマンドが見つかりません。
• YouTube の仕様は頻繁に変わります。ブラウザーでは再生できるリンクで yt-dlp が失敗する場合は、まず更新してください（brew upgrade yt-dlp、winget upgrade yt-dlp.yt-dlp、pipx upgrade yt-dlp）。

2. フォルダー

現在のプロジェクトのルートに作成します：

video-agent/
├── voice.md      who they are and how they talk (step 4)
├── swipe.md      hooks that worked in their niche (video-viral)
├── audit.md      what works on their own Instagram (video-audit)
├── log.md        one line per script written, so nothing repeats
├── scripts/      one file per week (video-script)
├── takes/        raw recordings (phone, camera, webcam, screen)
├── edits/        one folder per edited video (video-edit): final.mp4, post.md, cover.jpg, published.md
├── repurpose/    one plan per long video (long-to-short-videos)
├── images/       generated images not tied to a video (codex-images)
├── studio/       the Remotion project (step 3)
├── .env          their API keys, never shared (step 6)
└── .tmp/         scratch files, deleted after each run

log.md の先頭は # Script log、swipe.md の先頭は # Swipe file にします。

プロジェクトが git を使用している場合は、.gitignore に次の行を追加してください（動画は容量が大きいため、テキストファイルは追跡対象のままにします）：

video-agent/takes/
video-agent/edits/**/*.mp4
video-agent/studio/public/
video-agent/studio/out/
video-agent/studio/node_modules/
video-agent/studio/whisper.cpp/
video-agent/.tmp/
video-agent/.env

video-agent/.env にはキーが保存されます。残りの手順を省略する場合でも、必ず除外してください。

3. スタジオ

編集スタジオ（Remotion、字幕用の whisper.cpp、音声モデル）のセットアップには5～15分、約2 GB が必要です。次のどちらにするか尋ねてください。今すぐ（近いうちに編集する予定なら推奨。最初の編集をすぐに始められます）、または後で（video-edit の初回実行時にセットアップします）。

今すぐの場合：video-edit のステップ2（「The studio」）を実行します。Short と Wide のコンポジション、および npx tsc --noEmit のチェックも含めます。開始前に、ダウンロードするものとそのサイズを伝えてください。対象は video-edit、long-to-short-videos、video-translate のみです。スクリプト作成のみのユーザーは省略してください。

4. voice.md

まず、ファイル冒頭にある2つの設定を確認します。録音する言語とブランドカラー（字幕やカードのアクセントカラー。デフォルトは #FFD400 で、どんな映像でも見やすい黄色です）です。次に、残りの項目をどのように埋めるか尋ねます。

1. 動画をもとに作成する場合（過去に投稿したことがある場合におすすめです）：本人が出演する最高の動画のリンクを3〜5本（YouTube、Shorts、TikTok、Instagram reels）教えてもらいます。文字起こしを取得します（<lang> は言語コードです：en、fr、es）。

   yt-dlp --skip-download --write-auto-subs --write-subs --sub-langs "<lang>.*" --sub-format vtt -o "video-agent/.tmp/%(id)s.%(ext)s" "<url>"
   

   文字起こしを読んで、実際に話している内容からテンプレートを埋めます。本人が実際に使うフレーズ、話すペース（発話時間1分あたりの単語数）、繰り返し使う言葉、話の始め方や締め方を確認します。そのうえで、文字起こしだけでは分からないこと（立場、根拠、触れてはいけない話題、視聴者への呼びかけ）だけを尋ねます。その後、video-agent/.tmp/ を削除します。 YouTubeのリンクなら、ほぼ必ず文字起こしを取得できます。TikTokでは取得できることもありますが、Instagramではほとんど取得できません。その場合はYouTubeのリンクを尋ねるか、インタビューに切り替えます。
2. インタビューをもとに作成する場合：テンプレートの質問を、分かりやすい言葉で一つずつ尋ねます（「あなたの分野で、ほとんどの人が間違っていると思うことは何ですか？」など）。

どちらの場合も、AI ツールを使う前に本人が書いた短い文章を3つ貼り付けてもらいます（キャプション、メッセージ、メールなど）。これらを「実際のサンプル」に追加し、スクリプトに本人のリズムを学習させます。

references/voice-template.md をもとに video-agent/voice.md を作成します。次に、内容を5行で本人に読み上げ、間違っているところがないか尋ねます。ボイスファイルは完成することがありません。いつでも /video-setup voice を実行して更新できると伝えます。

5. 権限

ほかのスキルでは、同じいくつかのコマンドを何度も実行します。このプロジェクトで事前に許可しておきます。ルールを提示して確認を取り、.claude/settings.json に統合します。ファイルが存在しない場合は作成します。すでにあるキーやルールはすべて保持し、絶対に削除しないでください。

{
  "permissions": {
    "allow": [
      "Bash(yt-dlp *)",
      "Bash(ffmpeg *)",
      "Bash(ffprobe *)",
      "Bash(npx remotion *)",
      "Bash(node sub.mjs *)"
    ]
  }
}

• これらだけを設定します。Bash(*)、Bash(rm *)、Bash(curl *)、またはインタープリター全体を対象にするルール（Bash(node *)、Bash(python *)）は追加しないでください。
• 共有の settings.json にあるルールは、フォルダーが信頼されると適用されます。このプロジェクトを git で管理し、ルールを共有したくないクリエイターは、代わりに .claude/settings.local.json を使用できます（同じ形式の個人用ファイルです）。
• 各スキルでは、そのスキルの実行中に有効となる allowed-tools にコマンドも記載されています。これらのルールは、それ以外のすべてのターンに適用されます。

6. アカウントとキー（任意）

3つの項目があります。それぞれ、必要なスキルを使いたい場合にのみ設定します。一度にまとめてメッセージで尋ねます。

用途	内容	費用
/video-audit と /video-publish	Tregに、本人のInstagram、TikTok、YouTubeを接続します	本人のアカウントで使う場合は無料
/video-translate（および任意で /video-steal の音楽レベルと効果音）	ElevenLabs API キー	ElevenLabsのプランに準じます
/codex-images	ChatGPTアカウントでCodexにログインします	ChatGPTのプランに準じます

ElevenLabs：elevenlabs.io/app/settings/api-keys でキーを作成し、本人が video-agent/.env に ELEVENLABS_API_KEY=... として貼り付けます（空のファイルを作成して、本人が開けるようにします）。チャットでキーを尋ねてはいけません。出力せずにキーが設定されていることを確認します：grep -c ELEVENLABS_API_KEY video-agent/.env。

Codex：codex --version を実行し、その後、本人に codex login を実行してもらいます（ブラウザーで「Sign in with ChatGPT」を選択します）。

Treg

yt-dlp は YouTube の情報を無料で取得できます。TikTok と Instagram はスクリプトから数値を取得できないようにしており、クリエイター本人の統計情報はログインの内側にあり、投稿にはアカウントが必要です。Treg はそのギャップを埋めます。本人のアカウントは一度接続すれば利用でき（統計情報の取得と投稿は無料）、他のクリエイターの公開数値は 1 回あたり約 $0.001 です。新しく認証されたアカウントには、初回に $1.00 分のクレジットが付与され、数百回の呼び出しに使えます。

接続方法は 2 つあります。

• CLI。macOS と Linux に対応しています。uv（推奨。適切な Python を取得します）、または Python 3.12 か 3.13 と pipx もしくは pip が必要です。Windows 用インストーラーはありません。

  curl -fsSL https://treg.to/install.sh | sh
  treg login
  

  treg login を実行するとブラウザーが開きます（GitHub、Google、またはメールのコードを使用）。
• MCP。どの OS でも使え、インストールは不要です。claude mcp add --transport http treg https://treg.to/mcp/ を実行し、続いて /mcp でサインインします。以下の treg catalog search、catalog get、call、balance はそれぞれ、MCP ツールの catalog_search、catalog_get、call、balance として使えます。

本人のアカウント（接続には CLI が必要です）。--capability post は、本人の統計情報を読み取り、投稿する権限を求めます。投稿する際には、動画ごとに本人の承認が必要です。

treg connections connect --provider instagram --capability post
treg connections connect --provider tiktok --capability post
treg connections connect --provider youtube --capability post
treg connections ls

connect を実行すると、各プラットフォーム独自のログイン画面が開きます。そこで本人が承認します。投稿するプラットフォームだけを接続してください。Instagram ではプロアカウント（クリエイターまたはビジネス）が必要です。アプリで無料で切り替えられます：プロフィール → メニュー → アカウントの種類とツール。Treg は stderr にヒントを出力します。JSON を読み取るときは 2>/dev/null を追加してください。

Instagram を接続したら、その直後に /video-audit を提案してください。本人にとって効果のあるものを確認するのに最適な、最初のステップです。

Treg のすべての呼び出しの手順。すべてのスキルで適用されるルールです。

1. treg catalog search "<what you want to do>"：ベンダー名ではなく、やりたい作業を説明します（「再生回数付きで TikTok アカウントの動画を一覧表示する」など）。
2. treg catalog get <id>：パラメーターと料金を確認します。呼び出しの前に料金を伝えてください。本人が接続したアカウントは無料と表示されます。
3. treg call <id> --query key=value を実行します。呼び出しに失敗しても課金されません。treg balance で残高を確認できます。402 エラーは残高がないことを意味します。

権限：無料の読み取り専用コマンドだけを追加し、有料の treg call は毎回、必ず先に確認を求めるようにします。

"Bash(treg catalog *)",
"Bash(treg balance)",
"Bash(treg connections ls)"

7. 仕上げ

準備できた項目（✓ またはスキップ）を 1 行ずつ示し、次の手順を案内します。

1. /video-audit：本人の Instagram で効果のあるものを確認します（audit.md に記録）。
2. /video-viral：本人のニッチで効果のあるものを確認します（swipe.md に記録。月 1 回）。
3. /video-script：今週のスクリプトを作成します。フックを先にし、人間味のある内容にします。
4. 撮影：スマートフォン、カメラ、またはウェブカメラで、スクリプトごとに 1 テイク撮影し、video-agent/takes/<slug>.mp4 に保存します。
5. /video-edit：短い動画（縦向き）または YouTube 用のフル動画（横向き）を編集します。
6. /video-steal：好きなクリエイターのリールを、video-edit で使えるスタイルにします。
7. /long-to-short-videos：長い動画から完成したショート動画を作成します。
8. /video-translate：別の言語で、本人の声に合わせたテイクを作成します。
9. /codex-images：サムネイルとカバーを作成します。
10. /video-publish：YouTube、Instagram、TikTok に投稿します。

後で

/video-setup <part> で、各パートに直接移動できます：tools、studio、voice（voice.md の再作成または更新）、permissions、treg、keys。