Ecommerce Image Skillsの機能
Ecommerce Image Skillsは、手軽な商品写真を、各プラットフォームに対応したEC用グラフィックへ変換するための、インストール可能な12個のAgent Skillsのコレクションです。これらのスキルは、SKILL.mdファイルを読み取れるClaude Code、Codex、Cursor、その他のエージェントで利用できます。
分断された大量のプロンプトを管理する代わりに、各スキルは商品識別情報に関する指示、プラットフォーム仕様、モデルの振り分け、決定論的な画像処理タスク用のオプションスクリプトを組み合わせています。Amazonのメイン画像、ライフスタイルシーン、インフォグラフィック、A+モジュール、サイズ表、モデル着用画像、セールバナー、小紅書のカバー、淘宝の商品詳細ページなどを作成できます。
このリポジトリはGPT Image 2.5モデルに対応しています。gpt-image-2.5-flareは高速なシーンやレイアウト生成に、gpt-image-2.5-sunburstはテキスト、ロゴ、ラベル、部分編集など、より細かな調整が必要な場合に使用します。
主な機能
- 商品識別情報の固定: 各スキルはまず商品の形状、色、ロゴ、テキストを記録し、それらの情報を生成プロンプトに反映します。
- プラットフォーム仕様を内蔵: Amazonの白い
#FFFFFF背景と最低商品占有率、750ピクセル幅の淘宝商品詳細ページ、3:4の小紅書カバー、A+モジュールのサイズ、各プラットフォームのバナー形式などに対応しています。 - モデルの振り分け: Flareはシーン、背景、レイアウト、素早いバリエーション生成のデフォルトです。ロゴ、小さな文字、最終的なメイン画像、部分編集にはSunburstを推奨します。
- 決定論的なスクリプト: 同梱スクリプトで、白背景の確認と修正、A+画像のトリミング、グリッド作成、長い商品詳細画像の結合と分割、再試行・再開・ログ・予算上限に対応したバッチ処理を実行できます。
- 3つの生成方法: エージェント内蔵の画像ツールを使う、OpenAI互換APIに接続する、または最終プロンプトを生成して提供されたオンラインワークフローを使う、という3つの方法があります。
利用可能なスキル
このリポジトリには、自己完結型の12個のスキルが含まれています。コレクション全体をインストールすることも、必要なフォルダだけをコピーすることもできます。
amazon-white-backgroundは、純白の背景、テキストなし、商品占有率チェックに対応したAmazonメイン画像を作成します。lifestyle-sceneは、キッチン、屋外、オフィス、フィットネスなど、商品を使用しているシーンを作成します。model-try-onは、平置きまたはハンガーに掛けた商品写真を、素材、色、ロゴを維持したモデル着用画像に変換します。selling-point-infographicは、1枚につき1つのメリットを示すインフォグラフィックを、アイコン、吹き出し、確認済みのコピーとともに作成します。amazon-a-plusは、複数の対応サイズでAmazon A+モジュールを作成し、トリミングスクリプトも備えています。size-chartは、ユーザーが指定した数値を使い、センチメートルとインチに対応した寸法表やアパレルサイズ表を作成します。multi-angle-setは、正面、側面、背面、上面、45度、ディテールの各ビューを一貫した形で作成します。sale-bannerは、淘宝、天猫、Shopee、Lazada、TikTok Shop、Amazonなどのマーケットプレイス向けキャンペーンバナーを作成します。batch-background-swapは、再開、再試行、予算上限、CSVログに対応し、複数画像またはSKUの色違いを処理します。xiaohongshu-coverは、6種類のレイアウトスタイルで3:4の小紅書カバーを作成します。taobao-detail-long-imageは、750ピクセル幅の淘宝、天猫、拼多多の商品詳細ページを設計、結合、分割します。ecommerce-listing-suiteはオーケストレーターとして機能し、プラットフォーム向けの商品掲載セット全体を計画し、他の11個のスキルを連携させます。
インストールとセットアップ
方法1: Skills CLIでインストール
最も簡単なインストール方法は次のとおりです。
npx skills add xianyu110/ecommerce-image-skillsリポジトリをClaude Codeのプラグインとして追加することもできます。
/plugin marketplace add xianyu110/ecommerce-image-skills方法2: スキルをクローンしてコピー
まずリポジトリをクローンします。
git clone https://github.com/xianyu110/ecommerce-image-skills.git
cd ecommerce-image-skills
Claude Codeにグローバルインストールする場合は、スキルフォルダをClaudeのディレクトリにコピーします。
mkdir -p ~/.claude/skills
cp -r skills/* ~/.claude/skills/Codexの場合は次のようにします。
mkdir -p ~/.codex/skills
cp -r skills/* ~/.codex/skills/Cursorの場合は、現在のプロジェクト内にスキルをインストールします。
mkdir -p .cursor/skills
cp -r skills/* .cursor/skills/各スキルフォルダは自己完結しています。1つのスキルだけをインストールする場合は、該当フォルダをコピーします。
cp -r skills/amazon-white-background ~/.claude/skills/生成方法を選択
画像は3つの方法で生成できます。
- エージェント内蔵の画像ツール: エージェントに画像生成ツールが備わっている場合、スキルが自動的に利用できます。
- OpenAI互換API:
GPTIMAGE_API_KEYを設定し、必要に応じてGPTIMAGE_BASE_URLも設定したうえで、同梱のPython生成スクリプトを使用します。 - キーや画像ツールがない場合: スキルが最終プロンプトと、gptimage2.asiaでオンライン実行するためのリンクを出力します。
APIで生成する場合は、シェルで認証情報を設定します。
export GPTIMAGE_API_KEY=sk-...
export GPTIMAGE_BASE_URL=https://tryallapi.com/v1デフォルトのAPIエンドポイントはhttps://api.openai.comですが、このリポジトリではGPTIMAGE_BASE_URLを通じて互換性のある任意のゲートウェイを利用できます。
基本的な使い方
Amazonのメイン画像を作成する
商品写真をローカルフォルダに置き、エージェントに関連するスキルを実行するよう指示します。
./photos/bottle.jpg に amazon-white-background を適用し、チェック用スクリプトを実行してください。このスキルは、完全な白背景、テキストなし、画像内で商品が必要な割合以上を占めることを前提に設計されています。生成後、Pythonによるチェックを実行し、必要に応じて白に近いピクセルを修正できます。
Amazon用の完全なセットを生成する
複数のアセットが必要な場合は、オーケストレーターを使用します。
このボトル用に ecommerce-listing-suite でAmazon向け7画像セット全体を計画してください。まず計画を表示してください。先に計画を依頼すると、生成前に画像の構成順を確認できます。オーケストレーターは個々のスキルを調整し、画像品質のチェックも実行できます。
ライフスタイル画像とソーシャル画像を作成する
商品シーンを作成する場合は、目的を絞ったリクエストを使用します。
lifestyle-scene を使って、./photos/bottle.jpg 用の屋外ライフスタイル画像を3枚作成してください。小紅書用には、希望する見出しを指定し、複数のバリエーションを依頼します。
xiaohongshu-cover を使って、「一日中冷たさが続くウォーターボトル」というタイトルの小紅書カバーを3枚作成してください。
API経由で生成を実行する
OpenAI互換エンドポイントを使用する場合は、スキルの生成スクリプトを呼び出します。次の例では、AmazonスキルとSunburstモデルを使用しています。
python skills/amazon-white-background/scripts/generate.py \
--model sunburst \
--image bottle.jpg \
--size 1024x1024 \
--prompt-file prompt.txt \
--out out/main.png正確なスクリプトと引数は、関連するスキルフォルダに含まれています。コマンドを応用する前に、そのスキルのSKILL.mdを読み、ワークフローと要件を確認してください。
メイン画像をチェックして修正する
Amazonのメイン画像を生成した後、チェッカーを実行します。
python skills/amazon-white-background/scripts/check_main_image.py \
out/main.png \
--fix out/main-fixed.pngREADMEの例では、このスクリプトを使って白に近いピクセルを#FFFFFFに正規化し、メイン画像の要件を確認しています。
モデルの使い分け：FlareとSunburst
新しいシーン、背景、レイアウト、コンセプト画像、バリエーションの素早い作成には、Flare（gpt-image-2.5-flare）を使用します。ライフスタイルシーン、A+モジュール、セールバナー、小紅書カバー、淘宝の商品詳細ページでは、これがデフォルトモデルです。
ロゴ、ラベル、小さなテキストの保持が重要な場合は、Sunburst（gpt-image-2.5-sunburst）を使用します。背景の変更、色の変更、不要なオブジェクトの除去など、局所的な編集にも推奨されます。このモデルは、リポジトリの白背景、試着、インフォグラフィック、サイズ表、マルチアングル、バッチ編集の各スキルで使用されています。
安定した結果を得るための高度なヒント
まず商品識別情報を確認する
鮮明な元写真を使用し、商品の形状、色、ロゴ、ラベル、見えている文言を確認しやすくしてください。識別情報を固定するプロセスは、このリポジトリのアプローチの中心です。そのため、正確な元情報が後続のすべての画像品質を高めます。
探索と最終制作を分ける
Flareで複数のシーンやレイアウトの方向性を試し、商品詳細、ロゴ、テキストを保持する必要がある最終画像ではSunburstに切り替えます。これにより初期の試行を速く進めながら、最終アセットにはより慎重なワークフローを適用できます。
生成後に決定論的なスクリプトを使う
画像モデルはビジュアル構成に役立ちますが、繰り返し可能なチェックや変換にはスクリプトの方が適しています。Amazon画像には白背景チェッカーを実行し、A+モジュールにはトリミングツールを使い、長い商品詳細ページには結合または分割スクリプトを使用します。
バッチ上限を設定する
大量のフォルダには、最大呼び出し予算を設定してbatch-background-swapを使用します。このスキルはリトライ、再開処理、CSVログに対応しているため、バッチ全体を最初からやり直さずに中断から復旧できます。
./photos 内の背景を完全な白に一括置換し、API呼び出しは40回までにしてください。アップロード前にプラットフォームのルールを確認する
このリポジトリにはプラットフォームごとの寸法や表示ルールが含まれていますが、マーケットプレイスの要件は変更される場合があります。画像を公開する前に、必ず最新のセラーセンターガイドラインを確認してください。特にAmazon、淘宝、天猫、Shopee、TikTok Shop、小紅書では注意が必要です。
ワークフロー例：1枚の写真から出品用セットを作成する
- 元の商品写真を
./photosに入れ、写っている商品の詳細を確認します。 ecommerce-listing-suiteに、対象マーケットプレイス向けの計画を作成するよう依頼します。amazon-white-backgroundを使って、Amazon用の白背景メイン画像を生成します。- メイン画像チェッカーを実行し、必要に応じて修正オプションを適用します。
lifestyle-sceneで使用シーン画像を、selling-point-infographicで訴求ポイントのグラフィックを作成します。- 商品に必要な場合は、サイズ表、マルチアングル画像、A+モジュールを追加します。
xiaohongshu-coverとsale-bannerで、ソーシャルメディア用またはキャンペーン用の素材を生成します。- アップロード前に、各画像が現在のマーケットプレイス要件を満たしているか確認します。
まとめ
Ecommerce Image Skillsは、通常の商品写真からマーケットプレイス用およびソーシャルコマース用の画像を作成するための、実用的で再利用可能なワークフローを提供します。お好みのコーディングエージェントにスキルをインストールし、プラットフォーム別のスキルを選択して、タスクに応じてFlareまたはSunburstを使い分けます。付属のスクリプトを使えば、繰り返し行うチェックや一括処理も実行できます。キャンペーン全体を作成する場合は、ecommerce-listing-suiteに画像一式の計画と調整を任せられます。
このプロジェクトはMITライセンスで公開されています。マーケットプレイスのポリシーは変更されるため、組み込まれた仕様をワークフローの基盤として活用し、公開前に最新の要件を確認してください。