edit-image

画像を編集

Nano Banana Pro（gemini-3-pro-image）を使用して画像を編集します。

使用する場面

ユーザーから次のような依頼があった場合に、このスキルを使用します。

• 画像の一部を編集する（インペインティング）
• 画像の境界を越えて拡張する（アウトペインティング）
• 画像内のオブジェクトや領域を置き換える
• 既存の画像に要素を追加する
• 既存の画像を別の形式やプラットフォーム（ソーシャルメディア、OG、Twitterカード）向けに調整する

仕組み

Gemini のマルチモーダル機能を使用し、自然言語で画像を理解して編集します。モデルは元画像と、希望する編集内容を説明するテキストプロンプトを受け取り、変更を適用した新しい画像を生成します。

セマンティックマスキング：正確なピクセルマスクを用意する代わりに、プロンプトで変更内容を説明します。モデルが文脈を理解し、特定の領域を対象にできます。

オプションのマスク画像：マスク画像（白＝編集する領域）を視覚的なヒントとして指定することもできますが、必須ではありません。多くの場合、内容を文章で説明するプロンプトのほうが効果的です。

使用方法

bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/edit-image/scripts/edit.ts <input-image> "edit prompt" [options]

オプション

• --mask <path> - オプションのマスク画像（白＝編集する領域、黒＝保持する領域）
• --mode <inpaint|outpaint> - 編集モード
• --format <png|jpeg|webp> - 出力形式
• --size <1K|2K|4K|WxH> - 出力サイズ。openai では正確な WxH も指定できます（例：3840x1280）。
• --aspect <ratio> - 出力アスペクト比。openai では 1:3 から 3:1 までの任意の W:H を指定できます。--size WxH と併用しないでください。
• --quality <low|medium|high|xhigh|max|auto> - openai 専用（デフォルトは auto）。
• --jpeg-quality <n> - gemini 専用：JPEG 品質（1～100）
• --negative <prompt> - 編集で避ける内容
• --count <n> - バリエーションの数
• --seed <n> - ランダムシード
• --output <path> - 出力先のパス
• --transparent - 透明な PNG を出力（OpenAI では background=transparent を指定。Gemini も対応）
• --provider <name> - gemini または openai。省略すると自動で選択します。
• --model <id> - OpenAI Image 2.5 のバリアント：flare / gpt-image-2.5-flare（デフォルト）または sunburst / gpt-image-2.5-sunburst。プロバイダーを openai に設定します。

例

# Simple edit with descriptive prompt (no mask needed)
bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/edit-image/scripts/edit.ts photo.jpg "change the background to a beach sunset"

# Edit with mask for precise control
bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/edit-image/scripts/edit.ts photo.jpg "add a sunset sky" --mask sky_mask.png --mode inpaint

# Outpaint to extend image
bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/edit-image/scripts/edit.ts photo.jpg "extend the landscape" --mode outpaint

# Edit with negative prompt
bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/edit-image/scripts/edit.ts portrait.png "fix the teeth to look natural" --negative "gap in teeth, missing teeth"

# Replace object with multiple variations
bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/edit-image/scripts/edit.ts scene.jpg "replace the car with a bicycle" --count 3

コンテキストの管理

生成された画像をコンテキストに読み戻さないでください。 スクリプトはファイルパスのみを出力します。結果はユーザーに目視で確認してもらってください。プログラムで確認する場合は、コンテキストウィンドウが大きな非圧縮画像データで埋まらないよう、まず画像を最適化してください（optimize-images スキルを使用）。

プロンプトのヒント

• 具体的にする：「見栄えをよくする」よりも、「空だけをゴールデンアワーの光に変える」のほうが効果的です。
• 保持する内容を説明する：ツールは自動的に「ほかはすべてそのままにする」を追加しますが、より具体的に指定することもできます。
• ネガティブプロンプトを使う：--negative "blurry, distorted" を指定すると、望ましくないアーティファクトを避けやすくなります。
• 繰り返し試す：--count 2 で複数のバリエーションを生成し、最適なものを選びます。

モデルとプロバイダー

デフォルトのプロバイダーは gemini（gemini-3-pro-image、Nano Banana Pro）です。会話形式やセマンティック編集、スタイルの一貫した編集、専用のネガティブプロンプト、複数画像の合成に最適です。Vertex AI の認証情報は不要です。

マスクを使ったインペインティング、複数画像の合成（--mask、複数の --input）、および指定時の透明な PNG 出力（--transparent → background=transparent）には、--provider openai（または --model flare|sunburst）を指定して Image 2.5（デフォルトは gpt-image-2.5-flare、オプションは gpt-image-2.5-sunburst）を使用します。Image 2.5 には専用のネガティブプロンプトパラメーターもアウトペイントモードもありません。そのため、--negative と --mode は Gemini に割り当てられます（自動ルーティング）。スタイルタイルは Gemini のみで使用できます。

プロバイダーを決定したら、対応するガイドに従ってプロンプトを調整します。 providers/prompts/edit.gemini.md または providers/prompts/edit.openai.md。

モデルのライブ検証日：2026 年 9 月（gemini-3-pro-image、gpt-image-2.5-flare、gpt-image-2.5-sunburst）。より新しい世代が存在する場合は、作業を中止し、b-open-io/gemskills への PR を提案してください。