mcpField
I
imagen

imagen

github.com/sickn33クリエイティブ・メディア48.7k80 回インストール1 日前に更新
リポジトリ

imagen について

imagen は Claude Code 向けの画像生成スキルで、Google Gemini API にテキストプロンプトを送り、PNG ファイルを作成してパスを返します。画面素材やドキュメントの図、概念の可視化に使えます。実行前にモデルの互換性、権限、費用の確認が必要です。

主な機能

  1. 01テキストプロンプトから画像を生成
  2. 02生成結果を PNG で保存
  3. 03モデル、サイズ、出力先を指定
  4. 04Python 標準ライブラリの補助スクリプト
  5. 05応答確認と PNG シグネチャ検証

活用シーン

  1. 01フロントエンド画面のメイン画像や仮画像の作成
  2. 02ドキュメント用のアーキテクチャ図の生成
  3. 03アバター、アイコン、画面素材の作成

インストール

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

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill imagen

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

同梱ファイル

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

UPSTREAM-NOTICE.md
UPSTREAM-LICENSE.txt
scripts/
generate_image.py

詳細

Imagen - AI 画像生成スキル

概要

このスキルには、明示的に選択された、サポート対象の Gemini 画像モデル向けにレビュー済みの標準ライブラリヘルパーが含まれています。許可された呼び出しを行う前に、モデルの提供状況と料金を確認してください。フロントエンド UI の構築、ドキュメントの作成、概念の視覚化など、あらゆる Claude Code セッション中にシームレスな画像作成を実現します。

クロスプラットフォーム：Windows、macOS、Linux で動作します。

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

実際のホストの画像ツールのワークフローと許可されたプロバイダーの範囲内で、次の場合に使用します。

  • ユーザーが画像生成を依頼した場合（例：「〜の画像を生成して」「画像を作成して」）
  • フロントエンド開発でプレースホルダー画像または実際の画像が必要な場合
  • ドキュメントにイラストや図が必要な場合
  • 概念、アーキテクチャ、アイデアを視覚化する場合
  • アイコン、ロゴ、UI アセットを作成する場合
  • AI 生成画像が役立つあらゆるタスク

仕組み

  1. 生成したい画像を説明するテキストプロンプトを受け取ります
  2. 画像生成の設定を指定して Google Gemini API を呼び出します
  3. 生成した画像を指定した場所に保存します（既定では現在のディレクトリ）
  4. プロジェクトで使用する画像のファイルパスを返します

使用方法

Python（クロスプラットフォーム — 推奨）
# Basic usage
python scripts/generate_image.py --model "$GEMINI_MODEL" "A futuristic city skyline at sunset" "./generated-image.png"

# With custom output path
python scripts/generate_image.py "A minimalist app icon for a music player" "./assets/icons/music-icon.png"

# With custom size
python scripts/generate_image.py --size 2K "High resolution landscape" "./wallpaper.png"

要件

  • GEMINI_API_KEY 環境変数が設定されていること
  • Python 3.10 以降（標準ライブラリのヘルパーのため、pip によるインストールは不要）
  • レビュー済みの GEMINI_MODEL または --model を明示的に指定すること。サポート対象のサイズと API スキーマを確認してください
  • 許可された既存のプライベート出力ディレクトリと、新しい .png ファイル名

データ、料金、出力に関する確認事項

プロンプトは Google に送信され、プロバイダーの料金が発生する場合があります。まず、サービスとデータの取り扱い、および費用の範囲を確認してください。認証情報を自動でインストールしたり、課金の有無が不明な呼び出しを再試行したり、ファイルを上書きしたりしないでください。同梱のヘルパーはリダイレクトを拒否し、レスポンスのバイト数を制限し、PNG の MIME タイプとシグネチャを検証します。ただし、完全な画像デコーダーではなく、画像が視覚的に正しいことを証明するものでもありません。ソケットのタイムアウトは、処理全体の経過時間を保証するものではありません。生成後にサイズ、内容、権利を確認し、許可されている場合に限り公開してください。ホストの契約で専用の画像ツールを使用することが定められている場合は、そのツールを使用してください。

現在の Gemini 画像 API；上流の出典情報。

出力

生成された画像は PNG ファイルとして保存されます。スクリプトは以下を返します。

  • 成功：生成された画像のパス
  • 失敗：詳細を含むエラーメッセージ

例

フロントエンド開発
User: "I need a hero image for my landing page - something abstract and tech-focused"
-> Generates and saves image, provides path for use in HTML/CSS
ドキュメント
User: "Create a diagram showing microservices architecture"
-> Generates visual representation, ready for README or docs
UI アセット
User: "Generate a placeholder avatar image for the user profile component"
-> Creates image in appropriate size for component use

制限事項

  • このスキルは、タスクが上記の範囲に明確に当てはまる場合にのみ使用してください。
  • 出力を、環境固有の検証、テスト、専門家によるレビューの代わりとして扱わないでください。
  • 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認してください。

API の互換性に関する注意

このヘルパーは generateContent エンベロープを実装しています。一方、リンク先の最新の画像ガイドでは Interactions API が紹介されており、エンドポイント、リクエストフィールド、レスポンス形式が異なります。Interactions 専用として案内されているモデルをこのヘルパーに渡したり、その imageSize オプションがサポートされていると想定したりしないでください。課金対象のリクエストを行う前に、選択したモデルがヘルパーの generateContent スキーマを明示的にサポートしていることを確認してください。サポートされていない場合は、レビュー済みのプロバイダーアダプターまたはホストの画像ツールを使用してください。ここでは API 呼び出しもプラットフォーム互換性テストも実施していません。プロンプトのコマンドライン引数はプロセス一覧や履歴に表示される場合があるため、このインターフェースでは機密情報を含まないプロンプトのみを使用してください。ディスクへの書き込みエラー後に出力の一部が残る場合があります。非公開の状態で内容を確認し、プロバイダーに自動で再試行せず、新しいパスを指定してください。

コメント

Markdown 対応