product-shots
Open-source Claude Code skills that turn one product photo into a full set of e-commerce visuals — main images, A+ detail pages, multi-angle shoots, social posts, and ad creatives. For cross-border sellers on Amazon, Shopify, TikTok Shop.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/motiful--product-shots)HTML
<a href="/listings/motiful--product-shots"><img src="/api/listings/motiful--product-shots/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Three distinct operations. Pick the one that matches your job:
"Generate Amazon listing photos for this product" — 7 marketplace-compliant images (main + 6 secondary), white-background spec auto-applied. "Get a 9-angle shoot of this dress" — fashion-on-model lookbook: front / back / side / 3/4 / detail / hanger / lifestyle, 14 identity anchors locked. "Make cross-platform ad creatives for this product" — Meta + TikTok + Google + YouTube variants in correct ratios, platform style applied, copy preserved verbatim.
Each command lands in `product-shots`, which clarifies what's missing (≤4 rounds), injects platform × industry Visual DNA, and dispatches to the right specialist. The render goes through the shared `product-shots-image-gen` engine.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 405 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <!-- ============================================================ -->
- <!-- TIER 1: ABOVE THE FOLD -->
- <!-- ============================================================ -->
- <div align="center">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset=".github/logo-dark.svg">
- <source media="(prefers-color-scheme: light)" srcset=".github/logo-light.svg">
- <img alt="product-shots" src=".github/logo-light.svg" width="540">
- </picture>
- <p><strong>One product photo in. Your full e-commerce visual stack out.</strong></p>
- </div>
- <div align="center">
- [![License: MIT][license-shield]][license-url]
- [![Skills: 7][skills-count-shield]][skills-anchor]
- [![Agent Skills][skills-shield]][skills-url]
- [![Platforms: 5][platforms-shield]][platforms-anchor]
- [![Status: alpha][status-shield]][status-anchor]
- </div>
- <div align="center">
- <a href="#gallery">Gallery</a> ·
- <a href="#features">Features</a> ·
- <a href="#quick-start">Quick Start</a> ·
- <a href="#install">Install</a> ·
- <a href="#usage">Usage</a> ·
- <a href="#skills">Skills</a>
- </div>
- <br>
- > Drop one photo of your SKU into Claude Code. Get back the full visual stack a cross-border listing needs — Amazon-compliant main images, A+ detail-page modules, a 9-angle fashion-on-model lookbook, platform-native ads, and social posts. All as open-source [Agent Skills](https://agentskills.io), no SaaS lock-in.
- ---
- <!-- ============================================================ -->
- <!-- GALLERY — moved to the top -->
- <!-- ============================================================ -->
- ## Gallery
- Real outputs from the five user-facing `product-shots-*` skills. Two products, one section per skill, two examples per skill, two-or-more images per example. Generated end-to-end via `product-shots-image-gen` against the OmniMaaS gateway (`gemini-3-pro-image-preview`). No manual prompt tuning beyond what the skill emits.
- ### `product-shots-main-image` — Amazon-compliant main + secondary
- > Marketplace-compliant main image (pure white, ≥85% frame fill, no overlay text) + a secondary detail shot. Amazon's 9 MUST rules are encoded as prompt fields, not patched post-render.
- <table>
- <tr>
- <th align="center" colspan="2">☕ Smart espresso machine</th>
- <th align="center" colspan="2">👗 Women's floral midi dress</th>
- </tr>
- <tr>
- <td><img src="assets/gallery/coffee-machine/main-image/01-amazon-main.jpeg" width="200"></td>
- <td><img src="assets/gallery/coffee-machine/main-image/02-secondary-feature.jpeg" width="200"></td>
- <td><img src="assets/gallery/dress/main-image/01-amazon-main.jpeg" width="200"></td>
- <td><img src="assets/gallery/dress/main-image/02-secondary-feature.jpeg" width="200"></td>
- </tr>
- <tr>
- <td align="center"><sub>Main, white bg</sub></td>
- <td align="center"><sub>Secondary, 3/4 detail</sub></td>
- <td align="center"><sub>Main, full body</sub></td>
- <td align="center"><sub>Fabric closeup</sub></td>
- </tr>
- </table>
- ### `product-shots-detail-page` — A+ Content modules
- > Hero band + feature module + lifestyle scene + spec callouts, with cross-image consistency anchors so the SKU doesn't morph between modules.
- <table>
- <tr>
- <th align="center" colspan="2">☕ Smart espresso machine</th>
- <th align="center" colspan="2">👗 Women's floral midi dress</th>
- </tr>
- <tr>
- <td><img src="assets/gallery/coffee-machine/detail-page/01-hero-band.jpeg" width="200"></td>
- <td><img src="assets/gallery/coffee-machine/detail-page/02-feature-module.jpeg" width="200"></td>
- <td><img src="assets/gallery/dress/detail-page/01-hero-band.jpeg" width="200"></td>
- <td><img src="assets/gallery/dress/detail-page/02-lifestyle-feature.jpeg" width="200"></td>
- </tr>
- <tr>
- <td align="center"><sub>Hero band, 21:9</sub></td>
- <td align="center"><sub>Feature module</sub></td>
- <td align="center"><sub>Hero band, lifestyle</sub></td>
- <td align="center"><sub>Café feature, 3:2</sub></td>
- </tr>
- </table>
- ### `product-shots-multi-angle` — fashion-on-model lookbook
- > 14 identity anchors (face / hair / skin / eyes / outfit / accessories / lighting / camera) locked across all frames so every angle reads as the same model wearing the same look. Specialized for **fashion-on-model** lookbooks; works on products without a model but with reduced identity fidelity.
- **👗 Floral midi dress — 9 canonical angles (killer demo)**
- <table>
- <tr>
- <td><img src="assets/gallery/dress/multi-angle/01-front.jpeg" width="180"></td>
- <td><img src="assets/gallery/dress/multi-angle/02-three-quarter-front.jpeg" width="180"></td>
- <td><img src="assets/gallery/dress/multi-angle/03-side.jpeg" width="180"></td>
- </tr>
- <tr>
- <td align="center"><sub>1. Front</sub></td>
- <td align="center"><sub>2. 3/4 front</sub></td>
- <td align="center"><sub>3. Side</sub></td>
- </tr>
- <tr>
- <td><img src="assets/gallery/dress/multi-angle/04-three-quarter-back.jpeg" width="180"></td>
- <td><img src="assets/gallery/dress/multi-angle/05-back.jpeg" width="180"></td>
- <td><img src="assets/gallery/dress/multi-angle/06-detail.jpeg" width="180"></td>
- </tr>
- <tr>
- <td align="center"><sub>4. 3/4 back</sub></td>
- <td align="center"><sub>5. Back</sub></td>
- <td align="center"><sub>6. Detail closeup</sub></td>
- </tr>
- <tr>
- <td><img src="assets/gallery/dress/multi-angle/07-on-hanger.jpeg" width="180"></td>
- <td><img src="assets/gallery/dress/multi-angle/08-lifestyle-indoor.jpeg" width="180"></td>
- <td><img src="assets/gallery/dress/multi-angle/09-lifestyle-outdoor.jpeg" width="180"></td>
- </tr>
- <tr>
- <td align="center"><sub>7. On hanger</sub></td>
- <td align="center"><sub>8. Lifestyle indoor</sub></td>
- <td align="center"><sub>9. Lifestyle outdoor</sub></td>
- </tr>
- </table>
- **☕ Smart espresso machine — 2-angle product rotation (non-fashion fallback)**
- <table>
- <tr>
- <td><img src="assets/gallery/coffee-machine/multi-angle/01-front.jpeg" width="220"></td>
- <td><img src="assets/gallery/coffee-machine/multi-angle/02-three-quarter.jpeg" width="220"></td>
- </tr>
- <tr>
- <td align="center"><sub>Front</sub></td>
- <td align="center"><sub>3/4 angle</sub></td>
- </tr>
- </table>
- ### `product-shots-ad-creative` — platform-native ads
- > Per-platform style profiles (TikTok UGC ≠ Meta editorial ≠ Google polished) baked into the prompt; banned-words filter applied; user copy preserved verbatim.
- <table>
- <tr>
- <th align="center" colspan="2">☕ Smart espresso machine</th>
- <th align="center" colspan="2">👗 Women's floral midi dress</th>
- </tr>
- <tr>
- <td><img src="assets/gallery/coffee-machine/ad-creative/01-tiktok-ugc.jpeg" width="200"></td>
- <td><img src="assets/gallery/coffee-machine/ad-creative/02-meta-feed.jpeg" width="200"></td>
- <td><img src="assets/gallery/dress/ad-creative/01-tiktok-ugc.jpeg" width="200"></td>
- <td><img src="assets/gallery/dress/ad-creative/02-meta-feed.jpeg" width="200"></td>
- </tr>
- <tr>
- <td align="center"><sub>TikTok UGC, 9:16</sub></td>
- <td align="center"><sub>Meta feed, 1:1</sub></td>
- <td align="center"><sub>TikTok UGC, 9:16</sub></td>
- <td align="center"><sub>Meta feed, 1:1</sub></td>
- </tr>
- </table>
- ### `product-shots-social-post` — feed / story / reel / carousel
- > Industry-aware DNA preset (beauty ≠ hardware ≠ apparel each get a different visual language) + 14-point self-check before render.
- <table>
- <tr>
- <th align="center" colspan="2">☕ Smart espresso machine</th>
- <th align="center" colspan="2">👗 Women's floral midi dress</th>
- </tr>
- <tr>
- <td><img src="assets/gallery/coffee-machine/social-post/01-ig-feed.jpeg" width="200"></td>
- <td><img src="assets/gallery/coffee-machine/social-post/02-ig-story.jpeg" width="200"></td>
- <td><img src="assets/gallery/dress/social-post/01-ig-carousel.jpeg" width="200"></td>
- <td><img src="assets/gallery/dress/social-post/02-ig-story.jpeg" width="200"></td>
- </tr>
- <tr>
- <td align="center"><sub>IG feed, 1:1</sub></td>
- <td align="center"><sub>IG story, 9:16</sub></td>
- <td align="center"><sub>IG carousel, 1:1</sub></td>
- <td align="center"><sub>IG story, 9:16</sub></td>
- </tr>
- </table>
- ---
- <!-- ============================================================ -->
- <!-- TIER 2: SCAN QUICKLY -->
- <!-- ============================================================ -->
- ## The Problem
- One SKU on a cross-border listing needs **a brutal visual pipeline**: 7 Amazon images at the right ratio and white-background spec, an A+ detail page with module-to-module consistency, a 9-angle on-model shoot for clothing or footwear, 4-8 ad-creative variants across TikTok / Meta / Google, and 6 social posts sized for 5 platforms — all rendering the *same* product without drifting into a different SKU.
- Sellers either pay a closed SaaS to do it (and hand over their brand assets), hire a studio (slow, expensive, single-channel), or burn weeks tuning Midjourney prompts by hand. None of those compose with the rest of an AI-first workflow.
- `product-shots` ships the same pipeline as **open-source Claude Code skills**. It runs in your terminal, lives next to your other skills, never sees your assets outside your machine, and outputs files you fully own.
- **If you sell on Amazon, Shopify, TikTok Shop, or an independent storefront — and you want the visual production layer to be code you control, not a subscription — you're the target user.**
- ## Features
- Seven skills, ordered by what carries the most weight in a real listing. The first three are where the wow lives; the rest are platform breadth, then the infrastructure that makes the whole thing portable.
- | Skill | What you get |
- |---|---|
- | [`product-shots-multi-angle`](#skills) | One reference photo of a model + outfit → **9 consistent angles** of the same look. Fourteen identity anchors (face, hair, skin, eyes, outfit, accessories, lighting, camera, …) lock so the front-3/4 and back-3/4 read as the same person in the same garment. The killer feature for **fashion-on-model lookbooks**. |
- | [`product-shots-detail-page`](#skills) | A full **A+ Content** detail-page module set — hero band, feature grid, lifestyle scene, size/spec callouts — with cross-image consistency anchors so the SKU doesn't morph between modules. |
- | [`product-shots-main-image`](#skills) | Marketplace-compliant **main + secondary images**. Amazon's 9 mandatory rules (pure white, ≥85% frame fill, no text/logos/watermarks, even studio light, apparel exceptions) are encoded as prompt fields — compliance is decided before the model renders, not patched after. Auto-adapts to category-specific norms (electronics vs apparel vs grocery). |
- | [`product-shots-ad-creative`](#skills) | Platform-native ad creatives across **8 platforms** — Meta, TikTok, Google Display, Google Demand Gen, YouTube, Pinterest, LinkedIn, X. Per-platform style profiles, banned-words filter, user copy preserved verbatim. |
- | [`product-shots-social-post`](#skills) | Feed / Story / Reel / Carousel posts with industry-aware DNA (beauty vs hardware vs apparel each get a different visual language) and a 14-point self-check before render. |
- | [`product-shots-image-gen`](#skills) | The shared **image-gen engine**. One API surface across OpenAI `gpt-image-2`, Gemini `gemini-3-pro-image-preview`, and Flux families. OmniMaaS-gateway compatible — endpoint is one env var, no vendor lock-in. Auto-resizes oversize references, retries with sane backoff. |
- | [`product-shots`](#skills) | The **intent router** at the front door. Four-stage clarification (≤4 rounds), Visual DNA injection (platform × industry), then dispatch to one of the five business skills above. Stops underspecified prompts from wasting a render. |
- > **What product-shots is not:** a generic design tool. It does not write copy, build landing pages, or replace a brand designer. Every skill is sharpened around one job in a cross-border seller's daily workflow.
- ## Quick Start
- Three distinct operations. Pick the one that matches your job:
- ```text
- "Generate Amazon listing photos for this product" — 7 marketplace-compliant images (main + 6 secondary), white-background spec auto-applied.
- "Get a 9-angle shoot of this dress" — fashion-on-model lookbook: front / back / side / 3/4 / detail / hanger / lifestyle, 14 identity anchors locked.
- "Make cross-platform ad creatives for this product" — Meta + TikTok + Google + YouTube variants in correct ratios, platform style applied, copy preserved verbatim.
- ```
- Each command lands in `product-shots`, which clarifies what's missing (≤4 rounds), injects platform × industry Visual DNA, and dispatches to the right specialist. The render goes through the shared `product-shots-image-gen` engine.
- ## Install
- ```bash
- npx skills add motiful/product-shots
- ```
- This registers the seven skills with whichever Agent Skills harness you're running (Claude Code, Codex, Cursor, Windsurf, GitHub Copilot).
- **Configure the image backend** — `product-shots-image-gen` reads its API key from one of these env vars in priority order:
- ```bash
- # Option A — UCWS / Cloubic / OmniMaaS gateway (preferred)
- export OMNIMAAS_API_KEY='sk-...'
- # optional: defaults to https://api.omnimaas.com/v1 when API key is set
- export OMNIMAAS_BASE_URL='https://api.omnimaas.com/v1'
- # Option B — any other OpenAI-SDK-compatible image gateway
- export PRODUCT_SHOTS_IMAGEGEN_API_KEY='sk-...'
- export PRODUCT_SHOTS_IMAGEGEN_BASE_URL='https://your-image-gateway.example.com/v1'
- # Option C — file-based, no env vars
- echo "sk-..." > ~/.product_shots_imagegen_api_key
- chmod 600 ~/.product_shots_imagegen_api_key
- ```
- API keys are only ever sent via the `Authorization` header — never logged, never written to stdout. The skill **never asks you to fork the repo or paste your key into chat**.
- **Manual registration** (clone + symlink — only if you don't want the `npx skills` route). The skills are platform-agnostic — register in whichever Agent Skills harness root your editor uses:
- ```bash
- git clone https://github.com/motiful/product-shots ~/skills/product-shots
- SKILLS=(product-shots product-shots-image-gen \
- product-shots-main-image product-shots-detail-page \
- product-shots-multi-angle product-shots-ad-creative \
- product-shots-social-post)
- # Pick whichever harness root(s) you actually use:
- # Claude Code → ~/.claude/skills/
- # Codex → ~/.agents/skills/
- # Cursor → ~/.cursor/skills/
- # Windsurf → ~/.codeium/windsurf/skills/
- # GitHub Copilot (VS Code) → ~/.copilot/skills/
- HARNESS=~/.claude/skills # change to the path for your editor
- mkdir -p "$HARNESS"
- for s in "${SKILLS[@]}"; do
- ln -sfn ~/skills/product-shots/skills/$s "$HARNESS/$s"
- done
- ```
- ## Usage
- Two real scenarios, end-to-end. Both start from a single reference photo in your working directory.
- ### Scenario A — Smart coffee machine, full Amazon listing
- ```text
- > here's the product shot: ./refs/coffee-machine-v2.jpg
- > give me the full Amazon listing — main, 6 secondaries, A+ page, and 4 ad creatives
- ```
- What `product-shots` will do, in order:
- 1. **Clarify** category (small kitchen appliance), market (US Amazon), brand voice in ≤4 questions.
- 2. **Dispatch** `product-shots-main-image` → 7 compliant images, white-background, ≥85% fill, no overlay text on the main.
- 3. **Dispatch** `product-shots-detail-page` → A+ hero band + 3 feature modules + 1 lifestyle scene + 1 spec callout. Same SKU across all six modules — no model drift.
- 4. **Dispatch** `product-shots-ad-creative` → 4 variants targeting Meta feed, Meta story, TikTok feed, YouTube short. Each in correct ratio with platform-native styling.
- Output: 18 PNGs, organized by skill, ready to upload.
- ### Scenario B — Women's dress, 9-angle shoot + social rollout
- ```text
- > reference: ./refs/dress-floral.jpg
- > i need a 9-angle shoot + 5 Instagram posts (3 feed, 2 story)
- ```
- What happens:
- 1. `product-shots` confirms this is apparel (triggers `product-shots-multi-angle`'s fashion-on-model profile).
- 2. `product-shots-multi-angle` locks face, hair, skin, eyes, outfit, accessories, lighting, and camera — then renders front / 3/4 front / side / 3/4 back / back / detail (closeup) / on-hanger / lifestyle (indoor) / lifestyle (outdoor).
- 3. `product-shots-social-post` applies the apparel industry DNA preset (editorial, warm-neutral palette, type hierarchy) and produces 3 feed posts (1:1) + 2 stories (9:16), all derived from the same 9-angle set so the campaign reads as one shoot.
- Output: 14 images. The model is recognizably the *same* person wearing the *same* dress in every frame — that's the whole point.
- ---
- <!-- ============================================================ -->
- <!-- TIER 3: SUPPORTING CONTENT -->
- <!-- ============================================================ -->
- ## Skills
- Each skill is self-contained — a `SKILL.md` plus its `references/` and `scripts/`. Trigger phrases below are the canonical ones; `product-shots` accepts free-form natural-language variants and routes on intent, not exact wording.
- | Skill | Trigger | Primary deliverable |
- |---|---|---|
- | `product-shots` | (front door for all of the below) | Clarified, DNA-injected dispatch to one specialist |
- | `product-shots-multi-angle` | "9-angle shoot of this dress" | 9 identity-locked angles, same model in same outfit |
- | `product-shots-detail-page` | "build an A+ detail page for this" | Hero + feature + lifestyle + spec modules, consistent SKU |
- | `product-shots-main-image` | "Amazon main image for this product" | Marketplace-compliant main + secondary set |
- | `product-shots-ad-creative` | "cross-platform ad creatives" | 8-platform ad variants, per-platform style profiles |
- | `product-shots-social-post` | "Instagram / TikTok posts for this" | Feed / Story / Reel / Carousel with industry DNA |
- | `product-shots-image-gen` | (called by the others; or `"just generate: <prompt>"`) | Raw image generation across OpenAI / Gemini / Flux |
- ## How It Works
- `product-shots` pushes the hard work — compliance rules, platform specs, identity anchors, banned-words — **upstream of the model** as prompt fields. Compliance becomes a verifiable intermediate artifact, not a post-hoc check. Model selection is part of the skill, not the user's job: CJK long headlines and photoreal UGC route to `gpt-image-2`; golden-hour lifestyle photoreal routes to `gemini-3-pro-image-preview`. The `product-shots-image-gen` engine handles the actual dispatch, retries oversized references, and falls back across providers when one returns an empty image.
- → [Architecture notes](docs/how-it-works.md)
- ## What's Inside
- ```text
- skills/
- product-shots/ — intent router (4-stage clarification + Visual DNA injection)
- product-shots-image-gen/ — unified image-gen engine (OpenAI / Gemini / Flux)
- product-shots-main-image/ — Amazon 9 MUST rules + category profiles
- product-shots-detail-page/ — A+ module set with cross-image consistency anchors
- product-shots-multi-angle/ — 14-anchor identity lock, fashion-editorial portraits
- product-shots-ad-creative/ — 8-platform style profiles, banned-words filter
- product-shots-social-post/ — 7-industry DNA presets, 14-point self-check
- .github/ — logo (light/dark), repo metadata
- assets/gallery/ — 27 real outputs across 5 skills × 2 products
- LICENSE — MIT
- ```
- ## Compatibility
- Built against the [Agent Skills](https://agentskills.io) protocol — runs in Claude Code, Codex, Cursor, Windsurf, and GitHub Copilot. No MCP server, no custom runtime, no proprietary client. The image backend is endpoint-agnostic: any OpenAI-SDK-compatible gateway works.
- ## Contributing
- Issues and PRs welcome. Each skill is independently reviewable — open a PR scoped to one skill at a time. For new platform support (e.g., a new ad network in `product-shots-ad-creative`), include the platform's spec source and a sample render.
- ## Contact
- The skills in this repo are the **open-source surface** of what we build. `motiful` runs an internal stack that goes further — bigger product galleries from a single brand kit, model-locked lookbooks at studio scale, on-prem rendering, brand-asset integration, and managed pipelines for sellers shipping thousands of SKUs.
- If you're a cross-border seller, agency, or platform team and any of that is interesting:
- - **Commercial / partnerships / custom skills** — [kungfu@motiful.ai](mailto:kungfu@motiful.ai)
- - **Follow what we ship next** — [@whiletrue0x on X](https://x.com/whiletrue0x/)
- Bug reports and skill-level feature requests should stay on [GitHub Issues](https://github.com/motiful/product-shots/issues) — the inbox above is for the things issues can't capture.
- ## License
- MIT — see [LICENSE](LICENSE).
- ---
- <div align="center">
- <sub>Forged with <a href="https://github.com/motiful/skill-forge">Skill Forge</a> · Crafted with <a href="https://github.com/motiful/readme-craft">Readme Craft</a></sub>
- <br>
- <sub><i>Submitted to UCWS Singapore Hackathon 2026. Built by <a href="https://github.com/motiful">motiful</a>.</i></sub>
- </div>
- <!-- Reference-style link definitions -->
- [license-shield]: https://img.shields.io/badge/License-MIT-green.svg
- [license-url]: LICENSE
- [skills-count-shield]: https://img.shields.io/badge/skills-7-success.svg
- [skills-anchor]: #skills
- [skills-shield]: https://img.shields.io/badge/Agent%20Skills-compatible-DA7857?logo=anthropic
- [skills-url]: https://agentskills.io
- [platforms-shield]: https://img.shields.io/badge/platforms-CC%20%C2%B7%20Codex%20%C2%B7%20Cursor%20%C2%B7%20Windsurf%20%C2%B7%20Copilot-5b8def
- [platforms-anchor]: #compatibility
- [status-shield]: https://img.shields.io/badge/status-alpha-orange.svg
- [status-anchor]: #the-problem
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.