mcpField
G
generate-image

generate-image

github.com/laurigatesクリエイティブ・メディア59177 回インストール今日更新
リポジトリ

generate-image について

Google's Nano Banana Pro（Gemini 3 Pro Image）で画像を生成するスキルです。プロンプトから写真風またはイラスト風の作品を作る際に、参照画像、アスペクト比、解像度を指定できます。

主な機能

  1. 01テキストプロンプトから画像を生成
  2. 02最大 5 枚の参照画像を使用
  3. 03アスペクト比の選択
  4. 041K、2K、4K 解像度の指定
  5. 05出力先パスの指定

活用シーン

  1. 01シネマティックな作品やポートレートの作成
  2. 02説明文からの商品画像の生成
  3. 03参照画像をもとにした新規画像の作成
  4. 04用途に合わせた画像サイズの選択

インストール

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

$npx skills add https://github.com/laurigates/claude-plugins --skill generate-image

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

詳細

Google の Nano Banana Pro（Gemini 3 Pro Image）モデルを使用して画像を生成します。

このスキルを使用するタイミング

このスキルを使用する場合...代わりに imagemagick-conversion を使用する場合...
テキストプロンプトからまったく新しい画像を作成する既存の画像を変換、サイズ変更、圧縮する
映画のようなアート、製品画像、ポートレートを生成するサムネイルを作成したり、多数のファイルを一括処理したりする
最大5枚の参照画像を新しいレンダリングに組み合わせる回転、切り抜き、形式変更などの決定的な変換を適用する
このスキルを使用する場合...代わりに mermaid-diagrams または d2-diagrams を使用する場合...
出力が写真またはイラスト画像である出力がフローチャート、シーケンス図、アーキテクチャ図である
品質設定（1K／2K／4K）とアスペクト比が重要であるダイアグラムをコードでレンダリングしたほうが保守しやすい

パラメーター

$ARGUMENTS から次の値を解析します。プロンプトは引用符で囲まれた文字列です（引用符がない場合は、最初の -- フラグより前のすべてのトークンです）。

  • prompt（必須）：画像の説明。$ARGUMENTS が空の場合は、ユーザーにプロンプトを尋ねて終了します。
  • --aspect：アスペクト比（1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9）。デフォルト：16:9
  • --resolution：画像の解像度（1K、2K、4K）。デフォルト：2K
  • --reference：参照画像のパス（複数回指定可能、最大5枚）
  • --output：出力先のカスタムパス

環境要件

API キーが設定されていることを確認します：

echo "API Key: ${GOOGLE_API_KEY:+SET}${GEMINI_API_KEY:+SET}"

設定されていない場合は、こちらから取得してください：https://aistudio.google.com/apikey

使用例

/generate-image "A beautiful mountain landscape at sunset"
/generate-image "Product photo on white background" --aspect 1:1 --resolution 4K
/generate-image "Portrait photo" --aspect 3:4
/generate-image "Cinematic scene" --aspect 21:9
/generate-image "Similar style" --reference existing_image.png

タスクのワークフロー

  1. $ARGUMENTS から引数を解析します（パラメーターを参照）。

    • プロンプトを抽出します
    • --aspect（デフォルトは 16:9）、--resolution（デフォルトは 2K）、各 --reference <path>（最大5つ）、指定されている場合は --output <path> を読み取ります

  2. コマンドを組み立てて実行し、解析した値で <...> の部分を置き換えます。参照画像ごとに --reference <path> を1つ追加し、指定されている場合にのみ --output <path> を追加します：

    uv run python .claude/scripts/nano_banana_pro.py "<prompt>" \
  --aspect <ratio> \
  --resolution <size> \
  --reference <path>

  3. 結果を報告します：

    • 生成された画像のパスを表示します
    • 使用した参照画像があれば記載します
    • 次のステップ（再生成、別のアスペクト比など）を提案します

出力

デフォルトの出力先：./generated/image_YYYYMMDD_HHMMSS.png

--output を指定した場合のカスタム出力：

/generate-image "Scene" --output custom_name.png

参照画像

参照画像を使うと、一貫性を保ちやすくなります：

  • 既存の画像をスタイルの参照として使用します
  • 生成画像間で被写体の一貫性を保ちます
  • アートスタイルを合わせます

参照画像を使う場合は、画像同士の関係を説明します：

  • 「参照画像に似たスタイル」
  • 「別の場所にいるこの人物」
  • 「同じ製品を別の角度から」

1回の生成につき、参照画像は最大5枚です。

アスペクト比のクイックリファレンス

用途比率
正方形／Instagram1:1
ポートレート3:4、9:16
ランドスケープ16:9
ウルトラワイド21:9
写真3:2、4:3

解像度のクイックリファレンス

用途解像度
プレビュー1K
標準2K
高品質4K

エラー処理

  • API キーがない：GOOGLE_API_KEY または GEMINI_API_KEY を設定します
  • 生成に失敗した：プロンプトを簡潔にするか、参照画像を減らします
  • レート制限：待ってから再試行します

コメント

Markdown 対応