beatra-ai/beatra-skills / plugins/product-photo-studio/skills/product-photo-studio
product-photo-studio
VerifiedTransform a real product photo into a studio-quality ecommerce image, lifestyle scene, or marketplace-ready hero shot. This AI product photography tool replaces backgrounds, improves lighting, and stages scenes while using the source photo and confirmed product details as the visual anchor. Create clean white-background listings, contextual lifestyle compositions, and premium ad visuals from a single phone snap for Amazon, Taobao, Shopify, and social media. Start from one product photo, combine several references, or refine a selected draft toward a polished listing image.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.9 KB |
| install-source.json | config | 39 B |
| manifest.json | config | 4.9 KB |
| references/billing-errors-and-recovery.md | markdown | 5.8 KB |
| references/installation-and-auth.md | markdown | 9.3 KB |
| references/installation-registration.md | markdown | 2.0 KB |
| references/mcp-connection.md | markdown | 3.3 KB |
| references/product-routing.md | markdown | 3.9 KB |
| references/review-and-recovery.md | markdown | 3.7 KB |
| references/scene-craft.md | markdown | 3.2 KB |
| references/tasks-and-results.md | markdown | 2.2 KB |
| references/uninstall-and-disconnect.md | markdown | 2.7 KB |
| references/updates-and-security.md | markdown | 5.9 KB |
| references/workflow.md | markdown | 3.5 KB |
| scripts/authorize.py | script | 61.1 KB |
| scripts/mcp_client.py | script | 86.4 KB |
| scripts/uninstall.py | script | 12.6 KB |
references/workflow.md
View on GitHub# Workflow
## Build one product image brief
Translate the product type, target marketplace, background or scene direction,
and any style references into a single coherent prompt. Keep the prompt focused
on the background and scene, not on changing the product.
## Prepare the selected route
### Transform to clean background
Use `beatra.images.transform` with the product photo as the first ordered
reference. Label the product's role explicitly.
```json
{
"prompt": "Professional ecommerce product photo. Image 1 is the product reference; match its shape, color, label, and proportions closely. Place it on a pure white background, with even studio lighting, a subtle contact shadow, and clean edges with no halo.",
"model": "auto",
"count": 1,
"canvas": {
"type": "preset",
"tier": "2K",
"aspect": "1:1"
},
"images": [
{"type": "artifact", "artifact_id": "<product-photo-artifact-id>"}
],
"client_request_id": "product-clean-bg-001"
}
```
### Transform to lifestyle scene
Use `beatra.images.transform` with the product photo first and optional style
or background references after. Label each image's role.
```json
{
"prompt": "Professional lifestyle product photo. Image 1 is the product reference; match its shape, color, label, and proportions closely. Image 2 guides only the desired scene style and color palette. Place the product on a warm wooden kitchen counter, soft morning window light from the left, shallow depth of field, natural contact shadow.",
"model": "auto",
"count": 1,
"canvas": {
"type": "preset",
"tier": "2K",
"aspect": "1:1"
},
"images": [
{"type": "artifact", "artifact_id": "<product-photo-artifact-id>"},
{"type": "artifact", "artifact_id": "<scene-style-artifact-id>"}
],
"client_request_id": "product-lifestyle-001"
}
```
When more than one reference is supplied, their order matters. The product
photo should always be `images[0]`. Later images guide style, background, or
angle only. The last image anchors the output ratio when canvas aspect is
`source`.
### Edit an accepted draft
Use `beatra.images.edit` with the accepted image as `images[0]`. Use at most
two normalized `edit_regions` for targeted fixes; omit regions for a
whole-image adjustment.
```json
{
"prompt": "Remove the small reflection on the lower left of the product bottle. Keep everything else unchanged.",
"model": "auto",
"count": 1,
"images": [
{"type": "artifact", "artifact_id": "<accepted-draft-artifact-id>"}
],
"edit_regions": [
{
"image_index": 0,
"x": 0.1,
"y": 0.6,
"width": 0.25,
"height": 0.2
}
],
"client_request_id": "product-fix-reflection-001"
}
```
## Apply model controls
Keep `model=auto` unless the user explicitly requests a concrete model. Keep
`count=1`—product photography requires precision, not variation. Call
`beatra.models.list` with the relevant capability (`image_to_image` or
`image_edit`) only when the user asks about model availability, compatibility,
or price.
## Confirm, submit once, and monitor
Present one final confirmation card containing the complete prompt, ordered
references, canvas, background or scene direction, count, and model. After
approval, create one stable opaque `client_request_id` and submit once. Record
the returned `task_id` and poll with `beatra.tasks.get`.
A changed prompt, reference set or order, canvas, scene direction, model,
count, or control value is new paid work requiring a new confirmation and a new
`client_request_id`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |