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/review-and-recovery.md
View on GitHub# Review and recovery
## Before the paid boundary
Present one final direction. Freeze the prompt, ordered references, canvas,
background or scene direction, count, model, and controls in a single
confirmation. After approval, create one stable opaque `client_request_id` for
that exact logical request and submit once. Any change—prompt, reference or
order, canvas, scene direction, model, count, or control—is new paid work with
a new confirmation and a new ID.
## Monitor and recover
After receiving a `task_id`, poll only that task with `beatra.tasks.get`. Use
bounded backoff: first poll around 2 seconds, increasing toward 5 and 10
seconds, maximum 15 seconds. Honor `deadline_at`. Stop active polling after 30
minutes and report the task ID and status.
- **Lost create response:** if the response to the original submission is
genuinely unknown, retry the exact same parameters with the same
`client_request_id`.
- **Lost task ID:** call `beatra.tasks.list` to find candidates, then verify
the selected one with `beatra.tasks.get`. Match by capability, input, and
timing. If the match is ambiguous, do not submit a replacement.
- **Slow task:** a queued or running task never authorizes a replacement.
- **Authorization failure:** run `python3 scripts/authorize.py` and follow its output until it prints `Beatra is ready`.
The original `client_request_id` remains valid for idempotent recovery.
- **Connection failure:** preserve the credential and the original
`client_request_id`. Retry only the exact same parameters.
Use `beatra.tasks.cancel` only when the user asks. If cancellation returns
`409`, the task continues. See the shared
[billing, errors, and recovery](billing-errors-and-recovery.md) for the full
structured-failure reference.
## Review only what is visible
When the result is visible, review in this order:
1. **Product fidelity** — is the product itself recognizable, correctly shaped,
and undistorted? Compare against the original product photo.
2. **Color accuracy** — do the product's colors match the original? Look for
color casts introduced by the scene lighting.
3. **Edge quality** — are the product's edges clean where they meet the
background? No halo, fringe, or ghosting.
4. **Shadow and grounding** — does the product cast a natural contact shadow?
A floating product looks artificial.
5. **Lighting consistency** — does the light direction on the product match
the scene's implied light source?
6. **Marketplace guidance** — if targeting a specific marketplace, compare the
image with the platform's current background, size, and framing guidance.
If the host cannot view the artifact, state that visual verification was not
possible and deliver the result links for the user to review.
## Deliver
Present the returned image. Include the artifact links, observed dimensions,
task ID, and `billing.net_charged_credits`. Do not infer credits from elapsed
time.
Offer at most one focused, unexecuted revision. When the user accepts a result
but wants a specific fix, describe the revision as a new `beatra.images.edit`
request with the accepted image as `images[0]`.
## Product image variant set
A complete ecommerce listing typically uses several image variants:
- **main image** — clean white background, product centered (marketplace
requirement);
- **lifestyle scene** — product in a real-world context;
- **detail or infographic** — close-up of a feature or annotated callouts
(text added downstream);
- **scale or dimension** — product next to a common object for size reference;
- **seasonal or campaign** — holiday or promotion-themed background.
Each variant is a distinct paid request with its own confirmation and
`client_request_id`. Review each result independently for product fidelity.
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 |