Community画像github.com

steipete/nano-banana-pro

Nano Banana/Gemini 画像生成・編集:テキスト/画像入力、512~4K ワークフロー。

nano-banana-pro とは?

このスキルは、Google の Nano Banana 2 API(Gemini 3.1 Flash Image)を使用して、画像の生成と編集を行うためのものです。ユーザーはテキストプロンプトから新しい画像を生成したり、既存の画像に対して編集指示を与えることができます。解像度は 512px から 4K まで選択可能で、開発プロセスに合わせてドラフト(1K)→ イテレーション → ファイナル(4K)という段階的なワークフローが推奨されています。対応プラットフォームは Codex(および類似の AI エージェント)で、スクリプトは `uv` で直接実行します。API キーはコマンドライン引数または環境変数 `GEMINI_API_KEY` で指定可能で、ファイル名はタイムスタンプベースで自動生成されます。画像編集では、入力画像のパスを指定し、変更内容をプロンプトで指示します。このスキールは、プロンプトが確定するまでは低解像度で素早く反復し、最終出力のみ高解像度で生成する効率的なワークフローを提供します。

対応~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/nano-banana-pro

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Nano Banana 2 画像生成・編集

Google の Nano Banana 2 API(Gemini 3.1 Flash Image)を使用して、新しい画像を生成したり、既存の画像を編集します。

使用方法

スクリプトは絶対パスで実行してください(最初に skill ディレクトリに cd しないこと)。

新しい画像を生成:

uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "画像の説明" --filename "出力ファイル名.png" [--resolution 512|1K|2K|4K] [--api-key KEY]

既存の画像を編集:

uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "編集指示" --filename "出力ファイル名.png" --input-image "入力画像のパス.png" [--resolution 512|1K|2K|4K] [--api-key KEY]

重要: 常にユーザーの現在の作業ディレクトリから実行し、画像が skill ディレクトリではなくユーザーの作業場所に保存されるようにしてください。

デフォルトのワークフロー(ドラフト → イテレーション → 最終)

目標:プロンプトが確定するまでは 4K で時間を浪費せず、高速に反復すること。

  • ドラフト(1K):素早いフィードバックループ
    • uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<ドラフトプロンプト>" --filename "yyyy-mm-dd-hh-mm-ss-draft.png" --resolution 1K
  • イテレーション:プロンプトを少しずつ調整。実行ごとに新しいファイル名を付ける。
    • 編集の場合:満足するまで毎回同じ --input-image を使用する。
  • 最終(4K):プロンプトが確定したら
    • uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<最終プロンプト>" --filename "yyyy-mm-dd-hh-mm-ss-final.png" --resolution 4K

解像度オプション

Gemini 3.1 Flash Image API は以下の出力サイズ値をサポートしています。

  • 512 - コンパクトな ~512px クラスの解像度
  • 1K(デフォルト)- ~1024px 解像度
  • 2K - ~2048px 解像度
  • 4K - ~4096px 解像度

ユーザーの要求を API パラメータにマッピング:

  • "512", "512px", "0.5K", "thumbnail", "tiny" → 512
  • 解像度の指定がない場合 → 1K
  • "low resolution", "1080", "1080p", "1K" → 1K
  • "2K", "2048", "normal", "medium resolution" → 2K
  • "high resolution", "high-res", "hi-res", "4K", "ultra" → 4K

API キー

スクリプトは以下の順序で API キーを確認します。

  1. --api-key 引数(ユーザーがチャットでキーを提供した場合に使用)
  2. GEMINI_API_KEY 環境変数

どちらも利用できない場合、スクリプトはエラーメッセージを表示して終了します。

事前確認 + よくある失敗(素早い修正)

  • 事前確認:

    • command -v uv(存在する必要あり)
    • test -n "$GEMINI_API_KEY"(または --api-key を渡す)
    • 編集の場合:test -f "path/to/input.png"
  • よくある失敗:

    • Error: No API key provided. → GEMINI_API_KEY を設定するか --api-key を渡す
    • Error loading input image: → パスが間違っているかファイルが読み取れない;--input-image が実際の画像を指しているか確認
    • 「quota/permission/403」系の API エラー → キーが間違っている、アクセス権がない、またはクォータ超過;別のキーやアカウントを試す

ファイル名生成

ファイル名は yyyy-mm-dd-hh-mm-ss-name.png のパターンで生成します。

形式: {タイムスタンプ}-{説明名}.png

  • タイムスタンプ:現在の日時を yyyy-mm-dd-hh-mm-ss 形式(24時間制)で
  • 名前:ハイフン区切りの小文字の説明テキスト
  • 説明部分は簡潔に(通常 1~5 語)
  • ユーザーのプロンプトや会話の文脈を利用
  • 不明な場合はランダムな識別子(例:x9k2、a7b3)を使用

例:

  • プロンプト「A serene Japanese garden」 → 2025-11-23-14-23-05-japanese-garden.png
  • プロンプト「sunset over mountains」 → 2025-11-23-15-30-12-sunset-mountains.png
  • プロンプト「create an image of a robot」 → 2025-11-23-16-45-33-robot.png
  • 文脈が不明 → 2025-11-23-17-12-48-x9k2.png

画像編集

ユーザーが既存の画像を変更したい場合:

  1. 画像パスが提供されているか、またはカレントディレクトリ内の画像が参照されているかを確認
  2. --input-image パラメータに画像のパスを指定
  3. プロンプトには編集指示を含める(例:「空をもっとドラマチックに」、「人物を消して」、「漫画スタイルに変更して」)
  4. 一般的な編集タスク:要素の追加・削除、スタイル変更、色調整、背景ぼかしなど

プロンプトの扱い

生成の場合: ユーザーの画像説明をそのまま --prompt に渡します。明らかに不十分な場合のみ修正します。

編集の場合: 編集指示を --prompt に渡します(例:「空に虹を追加」、「水彩画のように見せる」)

どちらの場合もユーザーの創造意図を尊重してください。

プロンプトテンプレート(成功率が高いもの)

ユーザーが曖昧な場合や、編集を正確に行う必要がある場合にテンプレートを使用します。

  • 生成テンプレート:

    • 「<主題> の画像を作成。スタイル:<スタイル>。構図:<カメラ/ショット>。照明:<照明>。背景:<背景>。カラーパレット:<パレット>。避けるもの:<リスト>。」
  • 編集テンプレート(それ以外は維持):

    • 「変更するのは <1つの変更> のみ。維持するもの:主題、構図/トリミング、ポーズ、照明、カラーパレット、背景、テキスト、および全体的なスタイル。新しいオブジェクトを追加しない。テキストがある場合は変更しない。」

出力

  • PNG をカレントディレクトリに保存(ファイル名にディレクトリを含めることでパス指定可能)
  • スクリプトは生成された画像のフルパスを出力
  • 画像を読み込んで表示しない – 保存されたパスをユーザーに知らせるだけ

例

新しい画像を生成:

uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "桜のある静かな日本庭園" --filename "2025-11-23-14-23-05-japanese-garden.png" --resolution 4K

既存の画像を編集:

uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "空を嵐雲でもっとドラマチックに" --filename "2025-11-23-14-25-30-dramatic-sky.png" --input-image "original-photo.jpg" --resolution 2K

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

関連スキル