本文へ移動
cccskills
無料GitHub で公開

design-product-photography

Define product photography standards for e-commerce — shot types, composition, lighting, consistency rules, AI-assisted generation, and platform-specific variants. Covers the full product imagery pipeline from concept to published asset. Use when you need to plan product photoshoots, create photography briefs, set image standards for an e-commerce catalog, generate AI product lifestyle shots, or ensure visual consistency across hundreds of products.

インストール方法を見る

含まれるファイル(1)

  • SKILL.md17.4 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Product Photography

Use this skill when planning, creating, or reviewing product images for e-commerce — whether real photography or AI-generated visuals.

MCP Tool Discovery

Photography TaskTool
Generate product images (AI — Gemini)generate_gemini_image_validated (agent-prefixed or bare)
Generate product images (AI — DALL·E/OpenAI)generate_openai_image
Edit/retouch images (AI)edit_gemini_image_validated
Background removalremove_background
Resize for platformsresize_image
Generate scene backgroundsproduct_actualization (place product in generated scene)
Alt text generationgenerate_image_alt_text_validated
Image analysis (quality check)analyze_image

WP-CLI Commands

Key mcp-ai WP-CLI commands for photography workflows. Run via terminal:

CommandUse for
wp mcp-ai healthVerify image generation/editing tools
wp mcp-ai providerCheck configured AI providers (Gemini, etc.)
wp mcp-ai bulkBatch process product images

When to use this skill

Trigger when ANY of the following is true:

  • Planning product photography for new arrivals or catalog updates.
  • The task asks to "create product images", "shoot products", or "generate product visuals".
  • Setting image standards for an e-commerce store.
  • Creating photography briefs for a photographer or AI generation session.
  • Ensuring image consistency across 100+ products.
  • The task mentions "product shot", "hero image", "product photography", or "lifestyle image".
  • Generating platform-specific product visuals (Instagram, website, ads).

The Product Image Stack

Every product needs these image types:

┌──────────────────────────────────────────────┐
│              LIFESTYLE / CONTEXT              │  ← Social media, ads, hero banners
│    "The product in someone's life"            │
├──────────────────────────────────────────────┤
│              ANGLED / DETAIL                   │  ← Secondary gallery images
│    "What it looks like from every side"       │
├──────────────────────────────────────────────┤
│              WHITE BACKGROUND                 │  ← Primary product page image
│    "Clean, consistent, shoppable"            │
└──────────────────────────────────────────────┘

Image Inventory Per Product

#TypePurposeHow to Create
1White background — FrontPrimary product imagePhotography or AI + remove_background
2White background — BackShow reverse side, label, detailsPhotography or AI
3White background — Angle3/4 view showing depth and shapePhotography or AI
4Detail / MacroTexture, cap, engraving, ingredientsPhotography (macro) or AI detail crop
5Packaging / BoxUnboxing appeal, gift-ready presentationPhotography or AI
6Lifestyle — In UsePerson holding/using the productAI generation (product_actualization)
7Lifestyle — SceneProduct in aspirational settingAI generation or styled photoshoot
8Size ReferenceProduct next to common object for scalePhotography or simple composition

White Background Standards

The primary product image — the first thing customers see — must be consistent across your entire catalog.

Technical Specs

Format:      WebP or JPEG (PNG if transparency needed)
Resolution:  2000px minimum on longest side (4K-ready, good for zoom)
Color space: sRGB
Background:  Pure white (#FFFFFF) or transparent
Lighting:    Even, no harsh shadows, no blown highlights
Composition: Product centered, filling 80–90% of frame
Angle:       Slight 3/4 turn (not perfectly flat — show depth)

Consistency Rules

✓ ALL products on white background
✓ ALL products at similar scale (a 30ml bottle and 100ml bottle
  should look proportionally different, not randomly zoomed)
✓ ALL products with the same lighting temperature
  (don't mix cool/clinical with warm/lifestyle whites)
✓ ALL products with the same shadow treatment
  (natural drop shadow OR no shadow — pick one, apply to all)

✗ Mixed backgrounds (some white, some gray, some beige)
✗ Different lighting across products in the same category
✗ Products at wildly different scales
✗ Visible floor/wall seams or backdrop edges
✗ Reflections of the photographer/studio in glass bottles

By Product Category

Fragrance Bottles:

  • Glass is tricky — use diffused lighting, avoid hard reflections
  • Show the bottle shape clearly (silhouette matters for recognition)
  • Include the cap ON and OFF if the cap is a design feature
  • Spray mechanism visible in at least one shot

Jewelry:

  • Macro lens or close crop (small details matter)
  • Velvet or neutral surface — no distracting textures
  • Show clasp/closure in detail shot
  • Include wearing shot (on skin, not just on surface)
  • Scale reference critical (ring on finger, bracelet on wrist)

Skincare:

  • Clean, clinical lighting (suggests purity and hygiene)
  • Show texture — pump dispenser, dropper, jar opening
  • Ingredients list visible on back label if space allows
  • Include "amount dispensed" shot (dollop of cream, drop of serum)

AI-Generated Product Images

When to Use AI vs Photography

Use CaseBest Approach
White background product shotsPhotography preferred (accuracy). AI if photo unavailable.
Lifestyle / scene imagesAI excels here — use product_actualization or generate_gemini_image_validated
Social media creative variantsAI (fast, infinite variations)
Seasonal or themed versionsAI (add holiday props, change background season)
Color variants of same productAI editing (edit_gemini_image_validated)

Media Studio Fashion Production Suite (NV oOS v1.1.92+)

The Media Studio addon ships a production-grade AI fashion photography stack (addon 0.6.0, PRs #6839/#6844 — plans: docs/project/plans/media-studio-fashion-photography-*.md). Use it when the brief needs on-model apparel work at scale:

  • fashion-studio SPA mode — the [nvoos_media_studio_app] shortcode gains a fashion-studio mode (media-library source picker, presets, review-confirm + one-time acknowledgment dialogs, result grid with compliance chips).
  • Eight AI transforms (NV_oOS_Media_Studio_AI_Service, Gemini via edit_gemini_image): on-model, model-swap, face-swap, background, recolor, packshot, detail-repair, try-on. Face outputs carry a forced disclosure watermark and the disclosure-policy floor stays at metadata.
  • Consent + cost rails — D-1 one-time acknowledgment; D-3 cost tripwires ($0.25 per-image / $10 per-job review, $100 hard cap, unknown pricing → review).
  • Pro batch/review queue — mcp_ai_fashion_job CPT with approve/reject/reroll and WooCommerce + media collection export; fashion identity library on mcp_ai_fashion_model (consent-gated); 8 Pro tools (fashion_onmodel_generate, fashion_model_swap, fashion_background_generate, fashion_recolor, fashion_packshot, fashion_virtual_tryon, fashion_batch_job, fashion_identity_manage).
  • Marketplace output pipeline — amazon/woocommerce/social/web profiles with format conversion, alt text, and white-background validation.
  • Provenance — IPTC 2025.1 XMP (JPEG/PNG/WebP) + best-effort C2PA; keep provenance metadata when exporting marketplace assets.

Product Actualization (AI Scene Generation)

Use product_actualization to place a real product image into an AI-generated scene:

product_actualization {
  product_attachment_id: [your product photo]
  mode: "image"
  scene_prompt: "Elegant marble bathroom vanity, morning sunlight streaming
                 through frosted glass, fresh flowers, spa-like atmosphere,
                 shallow depth of field, luxury aesthetic"
  aspect_ratio: "3:2"
  integration_mode: "ai"
}

This naturally embeds the product with matching lighting, shadows, and reflections — far better than manual compositing.

Prompt Structure for Fragrance Photography

[Product type] + [Setting] + [Lighting] + [Mood] + [Camera details]

"An 80ml Carolina Herrera Good Girl stiletto-shaped perfume bottle on a
black marble surface, dramatic side lighting creating long shadows, gold
accents catching the light, luxury editorial photography, shallow depth
of field, bokeh background, 85mm lens, high-end fragrance campaign"

Prompt Structure for Jewelry Photography

[Jewelry piece] + [Surface] + [Lighting] + [Detail] + [Style]

"Swarovski crystal bracelet draped over a dark velvet jewelry display,
soft diffused light catching every facet, macro photography showing
crystal clarity and cut precision, elegant and minimal composition,
no distracting elements, luxury catalog style"

Prompt Structure for Skincare Photography

[Product] + [Props] + [Lighting] + [Vibe] + [Style]

"Conatural face wash bottle surrounded by fresh lavender sprigs and
chamomile flowers, natural window light, soft shadows, clean white
marble surface, spa aesthetic, bright and airy, wellness photography,
minimal and fresh composition"

Social Media Image Variants

Platform-Specific Crops from One Hero Image

Source: 2000×2000px product hero (1:1 square)

Instagram Feed:  1080×1080px (1:1) — crop from center
Instagram Story: 1080×1920px (9:16) — product bottom-third, text space top
Facebook Feed:   1200×630px (1.91:1) — product left-third, text space right
Pinterest:       1000×1500px (2:3) — full product, clean background
Website Hero:    1920×800px — product right-third, text space left

Use resize_image for each variant — never upload the full-resolution original to social media.

Adding Text Overlay Space

When shooting or generating images intended for social posts with text overlay:

Rule of thirds:
  ┌──────────┬──────────┬──────────┐
  │          │          │          │
  │  TEXT    │  TEXT    │          │
  │  ZONE    │  ZONE    │  PRODUCT │
  │          │          │          │
  │          │          │          │
  └──────────┴──────────┴──────────┘

Product should occupy 1/3 of frame (right or bottom)
Empty space on the remaining 2/3 for headline, caption, or CTA

Photography Brief Template

When briefing a photographer or planning an AI generation session:

PRODUCT PHOTOGRAPHY BRIEF
─────────────────────────
Product: [Name, SKU, size]
Brand: [Brand name]

SHOT LIST:
  □ White background — Front (primary)
  □ White background — Back
  □ White background — 45° angle
  □ Detail — [specific feature to highlight]
  □ Detail — [second feature]
  □ Packaging — Box/tin unopened
  □ Packaging — Box/tin open with product
  □ Lifestyle — [scene description]
  □ Lifestyle — [alternate scene]
  □ Size reference — [comparison object]

TECHNICAL:
  Format: WebP or JPEG
  Resolution: 2000px minimum
  Color space: sRGB
  Background: #FFFFFF (white background shots)

STYLE REFERENCES:
  [2–3 links or descriptions of images with the desired aesthetic]

NOTES:
  [Any special handling — reflective surfaces, fragile items,
   specific angles needed, text that must be readable, etc.]

Image Quality Checklist

Before publishing any product image:

□ Background is clean (white = pure white, not off-white or gray)
□ Product is in focus (crisp edges, no softness)
□ Lighting is even (no harsh shadows except intentional creative choices)
□ Colors are accurate (matches the real product — check against reference)
□ No dust, fingerprints, or smudges on the product
□ Labels and text are readable and correctly oriented
□ Image is properly cropped (product fills 80–90% of frame)
□ File is optimized (WebP, properly compressed — see design-image-optimization)
□ Alt text is written via generate_image_alt_text_validated
□ Filename is descriptive (brand-product-view.format), not IMG_4829.jpg

Batch Consistency Across a Catalog

When you have 100+ products, consistency is the hardest thing to achieve and the most valuable:

Consistency Checklist

□ All primary images use the same background color
□ All products at consistent scale within their category
  (a 30ml fragrance should look smaller than an 80ml — consistently)
□ Same angle for all primary shots (all slightly 3/4, all front-facing, etc.)
□ Same lighting temperature across the entire catalog
□ Same shadow treatment (drop shadow style, opacity, direction)
□ Same file format and approximate file size per image
□ Same naming convention across all files

AI Consistency

When generating images with AI for a catalog:

Use consistent prompt templates:
  "Product photography of [PRODUCT NAME], [FIXED LIGHTING],
   [FIXED BACKGROUND], [FIXED STYLE], luxury e-commerce catalog,
   [FIXED COLOR PALETTE], [FIXED COMPOSITION]"

Keep these elements IDENTICAL across all prompts:
  ● Background description
  ● Lighting description
  ● Style keywords
  ● Composition instructions

Only vary:
  ● Product name and description
  ● Any category-specific details (glass for fragrance, velvet for jewelry)

Common Mistakes

WRONG:
  ✗ Mixed backgrounds — some white, some gray, some lifestyle
  ✗ Inconsistent scale — one bottle fills the frame, another is tiny
  ✗ Using lifestyle images as primary product images (confusing)
  ✗ Blown highlights on glass bottles (no detail in the brightest areas)
  ✗ 500KB+ images slowing down product pages
  ✗ Same image used for every variant (color, size — looks lazy)
  ✗ No detail shots — just one front-facing image
  ✗ Watermarked or manufacturer-supplied images (looks dropshipped)

RIGHT:
  ✓ Every primary image: white background, consistent lighting, clean
  ✓ Products shown to scale — a 30ml looks smaller than an 80ml
  ✓ 6–8 images per product: front, back, angle, detail×2, packaging, lifestyle
  ✓ Proper exposure: highlights preserved, shadows open, details visible
  ✓ Optimized files (WebP, < 200KB for primary image)
  ✓ Unique image per variant (different size shown, different color shown)
  ✓ at least one in-use or lifestyle shot per product
  ✓ Original or AI-generated — never use supplier shots alone

Critical Rules

  • White background consistency is non-negotiable — if your catalog has 100 products, all 100 primary images need the same background, lighting, and scale.
  • 6 images minimum per product — front, back, angle, 2× detail, packaging. Lifestyle is bonus.
  • AI excels at lifestyle — use product_actualization or generate_gemini_image_validated for scene imagery.
  • Optimize before uploading — resize_image to platform dimensions, convert to WebP via media worker.
  • Consistent naming — [brand]-[product]-[view].webp. Never IMG_4829.jpg.
  • Alt text on every image — use generate_image_alt_text_validated before publishing.
  • No supplier images as primary — they look generic and destroy brand trust. Use only as reference.

What This Skill Does NOT Cover

  • Image generation techniques — use design-image-generation for prompt engineering, model selection, and AI provider configuration.
  • Image optimization — use design-image-optimization for format conversion, compression, responsive sizing, and alt text generation.
  • Social media publishing — use design-social-publishing to post product images to Instagram, Facebook, and other platforms.
  • Brand identity creation — use design-brand-kit for logo design, color palettes, and typography that define the visual brand context.
  • Product copywriting — use design-product-research for product descriptions and marketing copy that accompanies product images.
  • Video product showcases — use design-video-creation for product video content (unboxing, demos, short-form Reels).

Cross-references

  • Run design-image-generation for AI generation techniques — check your tool list for the Gemini image tool.
  • Run design-image-optimization to resize, compress, and convert images — use resize_image (MCP).
  • Run design-brand-kit to align product imagery with brand visual identity.
  • Run design-product-research to understand the product before creating its visual story.
  • Run design-seo-content for image SEO — filenames, alt text, and product page optimization.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.

日本語の概要は準備中です。原文の説明を表示しています。

nvdigitalsolutions/mcp-ai-wpoos72026年10月13日 更新

Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.

日本語の概要は準備中です。原文の説明を表示しています。

nvdigitalsolutions/mcp-ai-wpoos72026年10月13日 更新

Control a headless browser to navigate URLs, click elements, fill forms, extract content from JavaScript-rendered pages, take screenshots, and automate end-to-end web workflows.

日本語の概要は準備中です。原文の説明を表示しています。

nvdigitalsolutions/mcp-ai-wpoos72026年10月13日 更新

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

日本語の概要は準備中です。原文の説明を表示しています。

nvdigitalsolutions/mcp-ai-wpoos72026年10月13日 更新

Review code for quality, simplicity, and maintainability. Identifies unnecessary abstractions, duplicated logic, oversized functions, missing error handling, and naming issues — then fixes them automatically before presenting the result.

日本語の概要は準備中です。原文の説明を表示しています。

nvdigitalsolutions/mcp-ai-wpoos72026年10月13日 更新

WooCommerce store operations through NV oOS Pro — product research, catalog cross-referencing, inventory lookups, and Shopify or Flowhub comparisons where integrations are configured.

日本語の概要は準備中です。原文の説明を表示しています。

nvdigitalsolutions/mcp-ai-wpoos72026年10月13日 更新

nvdigitalsolutions のスキルをすべて見る

このスキルの問題を報告する