1Click Ecom PDP Skill is an e-commerce image generation tool designed specifically for AI Agents.

You simply tell it "what product you're selling" and "who the target audience is", and it will automatically write English marketing copy, plan the layout structure, and call AI image generation tools to deliver a complete set of ready-to-publish product images (Main Images + Detail Page Images).

• 📸 End-to-End One-Click Generation: Automatically generates 5 main images + 7~9 detail page images (by default) based on simple descriptions, with fully automated delivery.
• 🎨 Visual Consistency Across Images: Automatically aligns style and product subject to ensure the whole image set has a unified visual identity, eliminating the "patchwork" feel.
• 🎯 Conversion-Driven Copy & Structure: Built-in blockbuster logic, automatically generating authentic English (US) copy tailored for channels like Amazon.
• 🤖 Broad Framework Compatibility: Built for Agents, deeply verified on mainstream frameworks like OpenClaw, Hermes, Codex, and Claude Code.

Your Input (Example):

Auto-Generated Main Images:

Auto-Generated Detail Page:

Send the following instruction to your AI Agent:

Please install this Skill: `https://github.com/coolqoo/1click-ecom-detailpage`

Once installed, configure the image generation model API (see 🔑 API Configuration below), and you can drive it directly via natural language.

(Note: If the API is not configured, the system will only output executable Prompts.)

Example Instruction to Agent:

Use ecom-pdp to create an Amazon US PDP image pack for this product:
Output 5 main images + 8 detail page images.

mkdir -p ~/.codex/skills/ecom-pdp
rsync -a --exclude .git --exclude .env --exclude "generated-images/" ./ ~/.codex/skills/ecom-pdp/

python3 ~/.codex/skills/ecom-pdp/scripts/generate_image.py --help

To enable one-click generation of the image pack, please copy the environment variables file in the project root:

cp .env.example .env

And fill in the compatible service credentials in .env:

IMG_BASE_URL=https://api.openai.com/v1
IMG_MODEL=gpt-image-1.5
IMG_API_KEY=your-api-key

Security Tip: Please keep your keys safe and never commit .env to the repository. The script is also compatible with common environment variables like OPENAI_API_KEY.

Initiate a task conversationally with your AI Agent:

Use ecom-pdp to generate an Amazon US PDP image pack for this portable blender:
Target audience is fitness and commuting crowds, key selling points are 20-second blending, USB-C charging, portable and leak-proof.
Output 5 main images + 8 detail page images, provide Prompts first; if local API configuration is ready, generate images directly.

python3 scripts/generate_image.py \
  --mode prompt \
  --prompt "premium Amazon main image for a portable blender, clean white background, large product, concise benefit label" \
  --job-dir generated-images/portable-blender-pack-20260509-120000 \
  --asset-type main \
  --size 1024x1024

python3 scripts/generate_image.py \
  --prompt-file prompts/main-01.txt \
  --job-dir generated-images/portable-blender-pack-20260509-120000 \
  --asset-type main

python3 scripts/generate_image.py \
  --prompt-file prompts/angle-sheet.txt \
  --image product.png \
  --job-dir generated-images/portable-blender-pack-20260509-120000 \
  --asset-type angle-sheet

For many cross-border e-commerce initial tests, the bottleneck isn't "having a product," but rather whether the creatives, pages, and ad costs can be quickly validated. This Skill handles the first half: using natural language to extract product selling points and create main/detail image packs, allowing you to quickly build landing materials for Amazon, standalone sites, or TikTok Shop.

If your next step is running TikTok ads, you might want to check out ttoh.app. It is an independent TikTok ad offer hub that organizes available ad credits, coupons, and landing page entrances across different countries and regions, such as new account ad credits, Messaging Ads discounts, and TikTok Business Landing Pages for various languages/regions.

In short, this Skill helps you solve "how to create product pages and ad creatives"; ttoh.app acts more like an offer index before your cold start, helping you quickly check if there are suitable TikTok ad credits or campaign entrances for your target market. For sellers just starting to test products who want to manage their initial budget carefully, this step can save a lot of searching.

It is not a required dependency for this project; if you only need to generate PDP image packs, this Skill is sufficient. But if you plan to use TikTok traffic to test the product, check ttoh.app first for available offers.

1. Multi-Level Context Completion: Automatically fills in missing information by weight (User Input > Attachment Context > Web Research > Logical Inference > Default Assumptions).
2. Conversion-Driven Insights: Intelligently analyzes whether the product is Visual-Driven, Pain-Driven, or Emotion-Value-Driven.
3. Strategy Card Output: Generates a Buyer Reason Card to set the tone for baseline English copy and core CTAs.
4. Visual Style Lock: Establishes a global Campaign Style Lock to ensure tight consistency across dozens of images.
5. On-Demand Direct Delivery: When user instructions are clear and APIs are ready, directly calls internal scripts to render the complete asset pack.

By default, compliance review is disabled to maximize creative freedom. If you request "enable compliance/risk review":

• It strictly filters efficacy promises, medical implications, absolute terms, and improper comparisons.
• Forces data, certifications, sales volumes, and user reviews to have legal, verifiable sources.
• When authentic materials are lacking, it replaces review sections with feature breakdowns / FAQs / scenarios.

When core information (like product itself, core audience, target platform) is missing, the Agent will initiate up to 3-5 core questions. If given authorization like "you decide" or "generate quickly," the system automatically engages assumptions and inference to continue the flow, highlighting Assumptions / Defaults Used at the end to guarantee a smooth process.

The system structures a clear task directory for each output, facilitating subsequent manual review and A/B testing:

generated-images/<product-slug>-pack-<yyyymmdd-hhmmss>/
  ├── angle-sheet/  # 🛠️ Temporary product angle baseline images (for consistency control)
  ├── main/         # 🖼️ Main image group (1024x1024)
  ├── detail/       # 📜 Detail page long image group (1024x1536)
  ├── prompts/      # 📝 Independent execution Prompts for each asset image
  ├── extras/       # 🎨 Extra variants or fallback images generated by the API
  └── custom/       # 🧪 Temporary debug and custom generated images

Whenever "detail page / PDP / main image stack / full set of product images" is mentioned, the Skill defaults to the following delivery model:

• 5 Main Images: Hero Image (Selling Point) → Mechanism Parsing → Benefit Proof → Scenario Comparison → Offer Guarantee.
• 7-9 Detail Images: Hero Screen Follow-up → Pain Point Amplification → Mechanism Explanation → Step-by-Step Scenario → Competitor Comparison → Testimonial Endorsement → Risk Reversal (CTA).
• Independent Prompts per image, rejecting poor collages, forcing the application of the global Style Lock.

• Image Generation Boundaries: Currently supports text-to-image and single product reference image generation; precise local inpainting based on masks is not yet supported.
• External API Dependency: Highly dependent on OpenAI-compatible Images APIs. Image quality, coherence, and processing time depend on your configured underlying model (like DALL·E 3 / Flux) and service provider.
• Conversion Attribution: This Skill outputs strategy and creative baselines with high conversion potential. Real commercial returns (CTR/CVR/AOV) are still limited by your product strength, market pricing, and traffic acquisition strategies.

Thanks to the linux.do community for the support.

This project is open-sourced under the MIT License.