ecommerce — Claude Code skill: product catalog from photos
Turns a folder of raw product shots into packshots, cutouts, dimension images and marketplace listing variants for Amazon, Shopify and Etsy.
npx skills add Bria-AI/bria-skill --skill ecommerce -a claude-codeWhat ecommerce does
The ecommerce skill is the entry point to Bria's product pipeline. It renders nothing on its own — the actual work sits in the bria-ai skill, and this one points you at the right scripts and sections. Worth installing if you already use Bria or plan to; otherwise you get a thin wrapper.
Inside bria-ai there is build_catalog.py: feed it a folder of photos and it returns a cutout, a packshot, a dimensions image and lifestyle scenes per product. Marketplace output comes from export_variants.py plus presets for Amazon, Shopify and Etsy, which fix background, aspect ratio, product fill and minimum resolution. Each product can also get a listing.json holding an SEO title, description, bullets and tags.
Separate endpoints cover cutout, packshot, shadow, lifestyle shot from text or an image, product integrate, and Amazon-style dimension images with cm / in callouts, weight and capacity. Resize, crop and composite for the variant exporter are handled by the image-utils skill on Pillow — without it the variant step will not run.
What it helps with
- build packshots from a folder of raw product photos
- cut products off their backgrounds in batch
- produce a dimensions image with cm and inch callouts
- match image specs for Amazon, Shopify and Etsy listings
- generate a lifestyle scene from a text prompt
Example prompts for the agent
- Build a catalog from the
photos/rawfolder: cutouts, packshots and dimension images for every product - Export Amazon and Etsy listing variants from the finished packshots
- Create a lifestyle scene for this product on a wooden table
How to install ecommerce
1Skills CLI (Vercel)
npx skills add Bria-AI/bria-skill --skill ecommerce -a claude-code2Manually: put the files in place
~/.claude/skills/ecommerce/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ecommerce/
1Skills CLI (Vercel)
npx skills add Bria-AI/bria-skill --skill ecommerce -a codex2Manually: put the files in place
.agents/skills/ecommerce/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Bria-AI/bria-skill --skill ecommerce -a cursor2Manually: put the files in place
.cursor/skills/ecommerce/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Bria-AI/bria-skill ecommerce2Manually: put the files in place
.github/skills/ecommerce/SKILL.md1Skills CLI (Vercel)
npx skills add Bria-AI/bria-skill --skill ecommerce -a gemini-cli2Platform CLI
gemini skills install https://github.com/Bria-AI/bria-skill --path skills/ecommerceManually: put the files in place
.devin/skills/ecommerce/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Bria-AI/bria-skill --skill ecommerce -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ecommerce
How do I install ecommerce in Claude Code?
Run npx skills add Bria-AI/bria-skill --skill ecommerce -a claude-code. The skill file then lives at ~/.claude/skills/ecommerce/SKILL.md.
What does the ecommerce skill do?
It routes you into Bria's product pipeline: the catalog build script, the marketplace variant exporter and a listing scaffold. The image processing itself lives in the bria-ai skill.
How is ecommerce different from bria-ai?
bria-ai is the main skill with every image capability and the full catalog pipeline. ecommerce only covers the product side and links back to it.
What do I need for marketplace variant export?
The variant exporter relies on the image-utils skill for Pillow-based resize, crop and composite.
Source text
SKILL.md · MIT
--- name: ecommerce description: End-to-end e-commerce product catalog generation — turn a folder of raw product photos into clean packshots, product cutouts, Amazon-style dimensions images, lifestyle scenes, and marketplace-ready listing variants for Amazon, Shopify, and Etsy. Powered by Bria.ai's product pipeline. Use when building a product catalog, batch-processing product photos, or creating packshots, cutouts, dimension images, lifestyle shots, or marketplace-compliant listing images at scale. license: MIT metadata: author: Bria AI version: "1.4.0" --- # Bria E-commerce — Product Catalog Builder The full e-commerce product-catalog pipeline now lives in the **bria-ai** skill, alongside all other Bria image capabilities (generation, editing, background removal, upscaling, and more). This keeps one place to authenticate and one set of helpers to maintain. **Use the `bria-ai` skill for all product-catalog work.** It contains: - **Batch catalog pipeline** — `build_catalog.py`: a folder of raw product photos → per-product cutout, packshot, dimensions image, lifestyle scenes, and marketplace variants. - **Marketplace variants** — `export_variants.py` + Marketplace Presets: Amazon / Shopify / Etsy specs (background, aspect ratio, product fill, min resolution). - **Product endpoints** — cutout, packshot, shadow, lifestyle shot (by text or image), product integrate, and Amazon-style product dimensions images (with dual `cm / in` callouts, weight, and capacity). - **Listing copy scaffold** — a `listing.json` per product for SEO title, description, bullets, and tags. See the **bria-ai** skill's "Product Catalog Pipeline (batch)" section and its [API Endpoints Reference](../bria-ai/references/api-endpoints.md) for full details. ## Related Skills - **bria-ai** — the main skill; contains the full product-catalog pipeline and all image capabilities - **image-utils** — Pillow-based resize/crop/composite (used by the variant exporter)
© Bria AI · MIT · Bria-AI/bria-skill
