mcpField
N
nanobanana-skill

nanobanana-skill

github.com/feiskyerクリエイティブ・メディア248120 回インストール5 週間前に更新
リポジトリ

nanobanana-skill について

nanobanana-skillは、Gemini画像モデルで画像の生成、編集、合成を行うスキルです。テキストや参照画像からビジュアルを作成でき、Google Search groundingと思考サマリーが標準で有効です。モデル、解像度、出力ファイルはCLIで指定できます。

主な機能

  1. 01テキストから画像を生成
  2. 02参照画像の編集・合成
  3. 03Google Search grounding
  4. 04テキストとメタデータの保存
  5. 05モデル・解像度・思考レベルの指定

活用シーン

  1. 01商品パッケージや広告画像の作成
  2. 02商品写真をECサイトのメイン画像に合成
  3. 03最新情報に基づく編集イラストの作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/feiskyer/codex-settings --skill nanobanana-skill

インストール後、Claude Code で/nanobanana-skillを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

nanobanana.py
requirements.txt
agents/
openai.yaml
tests/
test_nanobanana.py

詳細

Nanobanana 画像スキル

付属の nanobanana.py を使って、Gemini 画像モデルで画像を生成または編集します。デフォルトでは Nano Banana 2（gemini-3.1-flash-image-preview）を対象とし、思考の要約とGoogle 検索によるグラウンディングを有効にしています。これらのデフォルト設定が、汎用的な画像プロンプトではなくこのスキルを使う主な理由です。

要件

  1. ~/.nanobanana.env（GEMINI_API_KEY=sk-dummy）またはシェル環境に GEMINI_API_KEY を設定します。
  2. requirements.txt に記載された Python 依存関係をインストールします。
  3. 実行ファイルは、このスキルと同じディレクトリにある nanobanana.py です。実行前に絶対パスを一度確認してください。

CLI は、認証情報がなくても --help を表示できます。API クライアントを作成する前にローカルの入力ファイルを検証し、API が画像を返さなかった場合はゼロ以外の終了コードで終了します。

デフォルト設定

モデルは gemini-3.1-flash-image-preview、検索によるグラウンディングは有効、思考の要約はレベル high で有効、解像度は 1K です。リクエストから形状が指定されていない場合、アスペクト比は設定しません。このレベルの制御をユーザーが求めていない限り、モデル、検索モード、思考モードをユーザーに選ばせないでください。

アスペクト比は未指定のままにしておくと、Gemini が入力画像の形状に合わせられるため、通常は編集に適しています。テキストのみの生成では、ポスター、正方形の投稿、バナー、スマートフォンの壁紙、横長のヒーロー画像など、ユーザーが形式を指定した場合にのみ設定します。

上書きを検討する設定：細部が非常に多い場合やタイポグラフィーを重視する場合は --model gemini-3-pro-image-preview（処理は遅くなります）、素早くアイデアを出す場合は --resolution 512px（Nanobanana 2 モデルのみ）、完成度の高い成果物には 2K／4K、洗練度より応答速度を優先する場合は --thinking-level low、純粋に想像力に基づいた結果を希望する場合は検索を無効にします。アスペクト比とモデルの完全な一覧を含む、正確な指定値を確認するには、python3 /absolute/path/to/nanobanana.py --help を実行してください。

実行方法

テキストから生成します。

python3 /absolute/path/to/nanobanana.py \
  --prompt "Create a high-end coffee bag package design with tactile paper texture and clear typography" \
  --output /absolute/path/to/output/package.png

編集または合成する場合は、参照画像ごとに --input を指定します。Nanobanana 2 は複数の参照画像を適切に組み合わせられるため、ブレンド、ラインナップ、ストーリーボード、一貫性を保つための処理を単一の画像に絞り込まないでください。

python3 /absolute/path/to/nanobanana.py \
  --prompt "Turn these product photos into a clean ecommerce hero image with a soft studio shadow and subtle headline area" \
  --input /absolute/path/to/ref1.png /absolute/path/to/ref2.png \
  --aspect-ratio 4:5 \
  --output /absolute/path/to/output/hero.png

グラウンディングを使って生成し、モデルのテキストとメタデータを画像と一緒に保存します。

python3 /absolute/path/to/nanobanana.py \
  --prompt "Use Google Search to ground an editorial illustration about the most recent lunar mission and create a clean magazine cover concept" \
  --text-output /absolute/path/to/output/cover.txt \
  --metadata-output /absolute/path/to/output/cover.json \
  --output /absolute/path/to/output/cover.png

その後、保存先のパス、検索によるグラウンディングが有効のままだったかどうか、テキストや思考の要約の保存先、実行時の警告を報告してください。モデルがテキストを返したものの画像を返さなかった場合は、そのことを明確に伝え、実行が成功したかのように扱うのではなく、画像生成により焦点を当てたプロンプトを提案してください。

プロンプトの書き方

効果的な Nanobanana プロンプトは、芸術的な願望ではなく、制作ブリーフです。被写体、ビジュアルスタイル、構図やカメラのフレーミング、必要なテキスト、出力の用途、ブランドカラー、余白、リアリティの度合いなどの制約を含めます。

Create a premium sparkling water can advertisement. Use a cold studio product-photo look, silver highlights, condensation droplets, and a clean dark-teal background. Leave negative space in the upper-right for headline copy.

編集では、変更する内容だけでなく、保持する内容も伝えてください。

Keep the shoe silhouette and logo placement intact. Replace the background with a bright outdoor basketball court, add dynamic afternoon shadows, and keep the image looking like a real sports campaign photo.

実行が失敗した場合

認証情報が設定されていることを値を表示せずに確認し、入力ファイルが読み取り可能か、出力先に書き込み可能かを確認します。未対応のオプションがある場合は、ヘルパーで指定可能な値を確認してください。依頼された結果の範囲内で、アシスタントが選んだオプションを修正してください。ただし、ユーザーが選んだモデルやプロバイダーを黙って切り替えてはいけません。回数を限定して再試行する前に、先の試行ですでに出力が生成されていないか確認してください。復旧に新たな権限の取得や依頼内容の変更が必要な場合は、実際のエラーを報告してください。

コメント

Markdown 対応