Claude Image Generation

Visual Sandbox スキルと Claude プラグイン

Visual Sandboxでメディアを生成するために AI エージェントが必要とするすべてのものを提供します。各モデルへのプロンプト方法を学習させるナレッジパックと、実行ツールを提供するプラグインです。

このリポジトリは、同時に 2 つの役割を果たします。

Claude Code プラグインです。 ルートにある .claude-plugin/ と .mcp.json により、スキル、4 つのスラッシュコマンド、ホスト型 MCP サーバーをまとめてインストールできます。

claude plugin marketplace add visualsandbox/skills
claude plugin install visual-sandbox@visual-sandbox

これにより、https://visualsandbox.com/mcp にある visual-sandbox MCP サーバーが追加されます。最初のツール呼び出しでブラウザーが開くので、Approve を押すと接続されます。コピーするトークンはありません。その後すぐに /image a red bicycle in the rain を実行できます。

vsb CLI 向けのスキルライブラリです。 各スキルは、エージェントのランタイムがスキルの適用タイミングを判断するために読み込む YAML フロントマターを含む、単一の SKILL.md（および任意の references/）で構成されます。CLI はそれらをバイナリに埋め込み、vsb setup は ~/.claude/skills/ に書き出します。

どちらの方法でも同じことができます。vsb のトランクスキルは実行方法は 2 つから始まり、MCP ツールを持つエージェントはMCP リファレンスへ、それ以外のすべてのユーザーは CLI へ案内します。

プラグインが追加するコマンド

コマンド	機能
/image <what to show>	モデルを選び、適切なプロンプトを作成して生成し、画像を表示します
/video <what happens>	まず料金を見積もり、承認を待ってから生成します
/models [filter]	料金を安い順に並べたカタログです
/balance	残りのクレジットと、直近 10 回の実行にかかった費用を確認します

MCP ツール

list_models、get_model、estimate_cost、generate、get_job、 list_jobs、list_voices、upload_media、list_sandbox_items、get_selection、 read_sandbox_docs、write_sandbox_doc、create_design、get_design、 update_design、move_layer、export_design、list_presets、get_preset、 get_balance、top_up、list_skills、get_skill — vsb コマンドごとに 1 つずつあります。プラグインを使わずに、サーバーだけを追加することもできます。

claude mcp add --transport http visual-sandbox https://visualsandbox.com/mcp

生成するたびに、接続中のアカウントに料金が請求されます。無料ではありません。

スキル

スキル	目的
vsb	vsb CLI の総合ガイド — 認証、実行、ステータス、プリセット、エージェントルール
vsb-image	適切な画像モデルを選び、効果的にプロンプトを作成します
vsb-video	動画を生成／編集します — 非同期処理とステータスのポーリング
vsb-audio	効果音、環境音、音声を生成します
vsb-vector	SVG を作成します — アイコンには Quiver、細部まで描き込むアートにはラスター画像を作成してから Recraft でベクター化します。色数は最初に確認します
vsb-design	キャンバス上の名前付きレイヤーにページ、画面、コード図をデザインし、HTML、React、SVG、PNG として無料でエクスポートします
vsb-presets	再現可能なモデル構成を実行、保存、上書き、共有します
vsb-nano-banana	Nano Banana ファミリー向けの効果的なプロンプト作成 — 編集モードのルール、テキスト描画、複数の参照画像のブレンド
vsb-image-prompting	すべての画像モデルに使える標準的なプロンプト作成ガイド — 人体の描写、参照画像を維持／無視するルール
vsb-image-iteration	生成品質を損なわずに画像を複数回編集します — プロンプトの積み重ね、コンタクトシート、トリミングと合成
vsb-ugc-people	UGC 風の一人用広告写真 — 9:16 の TikTok／Reels 向け、自撮り POV とトーキングヘッド形式
vsb-setup	MCP 経由のオンボーディング — 接続確認、最初の画像、最初の動画
vsb-ugc-ad	クリエイター風の 9:16 動画広告 — 台本、承認済みの最初のフレーム、その後に音声
vsb-product-photoshoot	1 枚の写真から商品写真を作成し、商品を同一に保ちます
vsb-ad-variations	1 つの広告から、A/B テスト用に変更を 1 つずつ加えた 3〜6 種類のバージョンを作成します
vsb-seedance	Seedance ファミリーを実行します — ティア、参照リスト、タスクごとに固定されたアスペクト比と長さ、価格の段階的な変化
vsb-seedance-prompting	Seedance 向けのプロンプト作成 — アセットの紐付け、ショットリスト、タイムスタンプ、編集、延長、テンプレート
vsb-p-video	最も低価格な動画モデル P-Video を実行します — 下書きの切り替え、料金、非同期処理とポーリング
vsb-p-video-prompting	P-Video 向けのプロンプト作成 — Pruna のスロット方式、トーキングアバターのナレーション
vsb-crop	クリップをトリミングするか、画面比率を変更します — ローカルの ffmpeg を使用、無料
vsb-cut	23 種類の名前付きフィルムトランジションから 1 つを使ってクリップを結合します — ローカルの ffmpeg を使用、無料
vsb-speed	スローモーション、逆再生、ブーメラン、フリーズフレーム、シームレスループ — ローカルの ffmpeg を使用、無料
vsb-timeline	長めの編集を作成します — ショットを順につなぎ、音声を下に重ね、タイトルを上に重ね、1 回でレンダリングします
vsb-subtitles	TikTok 風の単語ごとの字幕を動画に焼き付けます
vsb-download	TikTok／IG／YouTube の動画をダウンロードし、フレームグリッドで確認します
vsb-film	短編映画を最初から最後まで制作します — 台本、ショットリスト、全ショットで共通のキャスト、音声、編集、字幕

インストール

# One-shot install of the binary + default skill bundle + auth
curl -fsSL https://visualsandbox.com/install.sh | sh
vsb setup

vsb setup は、デフォルトのバンドル（vsb、vsb-presets、vsb-image、vsb-image-prompting、vsb-video、vsb-audio）を ~/.claude/skills/ に書き込み、Claude Code がすべてのプロジェクトで検出できるようにします。--project を指定すると、代わりに ./.claude/skills/ にインストールされます（コミット可能で、プロジェクトごとに管理され、git 経由で共有できます）。

# Skills only — skip auth (re-run after editing locally)
vsb setup --skills-only

# Pick individual skills
vsb skills install nano-banana
vsb skills install ugc-people --project

# Refresh installed skills to the latest version baked into the binary
vsb skills update

vsb を使用するエージェントは、インストール手順の全容を記載した cli-install.md に従ってください。PATH の問題、トークンの復旧、初回実行時の検証について説明しています。

予定：映像制作のピラミッド

上記の各スキルが答えるのは、モデルをうまく動かすにはどうすればよいか、という問いです。どのスキルも、何から始めるのか、つまり何を作るのか、どんなショットにすべきかには答えていません。

docs/film-pyramid.md では、アイデアから完成版のカットまで、モデルの上位に位置する6つのスキルを計画し、それらがどのように作業を引き継ぐかを説明しています。最初のスキルである vsb-film は、ワークフロー全体を担う1つのスキルとして構築されています。階層への分割は、まだ計画段階です。

構成

skills/
├── <name>/
│   ├── SKILL.md          # frontmatter + body
│   └── references/        # optional supporting docs
├── index.json             # sha256 + bytes per file (generated)

CLI での利用方法

vsb はビルド時にこれらのスキルをバイナリに直接埋め込みます。各リリースには skills/ のスナップショットが同梱され、index.json と照合して sha256 検証されます。vsb setup / vsb skills install は、ネットワーク接続を一切行わず、埋め込みバンドルから書き込みます。

パワーユーザーは、埋め込みコピーの代わりにライブレジストリを選択できます。

vsb skills install nano-banana --remote
# or for the whole session:
VSB_SKILLS_REMOTE=1 vsb setup --skills-only

リモートモードでは https://raw.githubusercontent.com/visualsandbox/skills/main/skills/ から取得し、~/.vsb/skills-cache/ にキャッシュして、ライブの index.json と照合して sha256 検証します。VSB_SKILLS_REF=v0.3 vsb setup --skills-only を使うと、タグ、ブランチ、または sha を指定できます。

コントリビューション

変更は skills/<name>/SKILL.md に反映します。ローカルで編集した後は、次を実行します。

bun run gen

これにより、新しい sha256 を含む skills/index.json が再生成されます。.github/workflows/index.yml の CI ワークフローも、main へのプッシュごとにインデックスを再生成するため、手動実行は主に PR を作成する前に差分を確認するためのものです。

ライセンス

プロプライエタリです。スキルを自身のエージェントにインストールし、Visual Sandbox とともに使用できます。詳細な条件については、LICENSE をご覧ください。