higgsfield-product-photoshoot

One photograph of your product becomes the shoot you never paid for — on a clean studio background, sitting on a real kitchen counter, held by a model, or laid out as a set of advert variants for each platform.

WHEN TO USE

SCOPE

USE FOR

Turn a product photo into a clean studio shot on a neutral background.
Place your product into a real-world lifestyle scene, like a kitchen counter or cafe.
Build a coordinated pack of ad creative variants for Meta, TikTok, or Pinterest.
Show a model wearing or holding your product for a virtual try-on shot.
Create a vertical Pinterest-style pin or moodboard image for your brand.
Restyle an existing product photo into a new season or aesthetic.

NOT FOR

Text-to-image generation with no product or brand in frame.
A branded avatar or presenter ad video.
Marketplace listing images like a compliant main shot or A+ modules.
Setting up a Soul Character identity for someone's face.

This is a saved copy of the skill's SKILL.md instructions. It may differ from the upstream file or the version you install.

In this document (14)

Product Photoshoot

Brand-image generation via the higgsfield product-photoshoot create command. The CLI calls a backend prompt enhancer that holds mode-specific photography vocabulary and structural templates, then submits to gpt_image_2 and returns image URLs.

Step 0 — Bootstrap

Before any other command:

If higgsfield is not on $PATH, install it:

curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh

If higgsfield account status fails with Session expired / Not authenticated, ask the user to run higgsfield auth login (interactive) and wait for confirmation.

UX Rules

Be concise. Print only image URLs in the final reply.
Detect language, respond in it. Mode names and CLI flags stay English.
Ask at most 4 short questions before submitting. Use labeled options, never open-ended.
Skip questions whose answer is obvious from context (uploaded image, prior turn, brand memory).
Never write the gpt_image_2 prompt yourself — backend assembles it.
Polling is silent. Wait until URLs are ready, then deliver.

Modes

Mode	When user wants…
`product_shot`	Product on neutral / studio / catalog background
`lifestyle_scene`	Product in real-world environment, hands, action, atmosphere
`closeup_product_with_person`	Tight crop with hands / partial face — beauty application, holding, demonstrating
`moodboard_pin`	Vertical 2:3 Pinterest-native aesthetic, moodboard feel
`hero_banner`	Wide-format website / email / campaign header
`social_carousel`	3–10 connected slides for IG / LinkedIn / Facebook
`ad_creative_pack`	Coordinated pack of static ad variants for Meta / TikTok / Pinterest / Google Ads
`virtual_model_tryout`	Product worn or used by an AI-rendered model
`conceptual_product`	Surreal / CGI-style / levitating / splash / sculptural product
`restyle`	Transform an existing image's aesthetic, mood, or seasonal context

Mode selection

Pick by intent, not surface keyword. When two modes could apply, prefer the more specific one.

product + neutral / clean / white / studio / catalog / Shopify → product_shot
product + scene / in use / kitchen / outdoor / cafe / gym → lifestyle_scene
hands holding / face with product / beauty application / demonstrating → closeup_product_with_person
Pinterest, pin, vertical pin → moodboard_pin
hero, banner, website header, landing page, email header, wide format → hero_banner
carousel, slide post, multi-slide, swipeable → social_carousel
ads, ad pack, paid social, Meta / TikTok / Pinterest ads → ad_creative_pack
model wearing, virtual try-on, on body, fashion shoot, lookbook → virtual_model_tryout
levitating, floating, splash, frozen motion, surreal, CGI, sculptural → conceptual_product
modify EXISTING image's aesthetic, mood, season — without changing subject → restyle

Tie-breakers:

"Pinterest pin of my product on a kitchen counter" → moodboard_pin (Pinterest is the platform)
"Hero banner showing my product in use" → hero_banner (banner format wins)
"Carousel of my product in different scenes" → social_carousel (multi-slide wins)
"Closeup of person applying my serum" → closeup_product_with_person (specific genre wins)

Pre-generation interview

Ask 3–4 short questions before submitting. Always labeled options, never open-ended. Skip a question whose answer is obvious from context.

Type A — uploaded a product photo, "make me images / photoshoots"

How many? [1 / 3 / 5]
What style/mood? [Clean studio / Lifestyle / Conceptual / With a model / Other]
Where will you use them? [Shopify / Instagram / Pinterest / Paid ads / Website hero]
Brand colors to match? (skip if obvious)

Type B — uploaded a product photo, named a use case

E.g. "make ads for my product", "make a Pinterest pin", "make a hero banner". Mode is obvious. Ask only the gaps:

How many? (if multi-output mode)
What's the offer / mood / hook?
Anything in particular to emphasize?

Type C — text only, no product photo

Can you upload a product photo? (preferred — much higher fidelity)
If not, describe the product — category, packaging, color, distinctive features.
What style? (same options as Type A)
Where will you use it?

Type D — uploaded existing image, "redo / change vibe / different version"

→ restyle

What aesthetic? [Clean girl / Cottagecore / Quiet luxury / Dark academia / Y2K / Other]
Seasonal context? [Christmas / Valentine's / Halloween / Black Friday / None]
What to preserve, what to change? (only if ambiguous)

Type E — model wearing a product (fashion, accessories)

→ virtual_model_tryout

Model archetype? (suggest 2–3 based on brand audience)
Environment? [Studio clean / Outdoor natural / Street style / Editorial / Home cozy]
Framing? [Full body / Three-quarter / Waist up / Closeup on product area]

Type F — vague request, unclear subject

E.g. "make me something cool for my brand".

What product or topic?
Goal? [Sell on a marketplace / Build awareness / Run paid ads / Update website]
Upload a reference image?

After answers → return to the relevant Type A–E.

Generation

Single command. Backend assembles the final prompt and submits to gpt_image_2. URLs print on stdout.

higgsfield product-photoshoot create \
  --mode <mode> \
  --prompt "<short user-intent description from interview answers>" \
  [--image <path-or-upload-id>]... \
  [--count <1-10>] \
  [--aspect_ratio <override>]

Examples:

higgsfield product-photoshoot create \
  --mode lifestyle_scene \
  --prompt "bottle of cold-brew on a sunlit kitchen counter, IG feed" \
  --image bottle.jpg \
  --count 3

higgsfield product-photoshoot create \
  --mode moodboard_pin \
  --prompt "vertical pin for my candle brand, cottagecore mood" \
  --image candle.jpg

higgsfield product-photoshoot create \
  --mode restyle \
  --prompt "Christmas version, quiet-luxury aesthetic" \
  --image existing-shot.jpg

Image inputs

--image accepts a local file path (auto-uploaded) OR an existing upload UUID. Repeat the flag for multiple references.

Multi-variant

--count 3 returns 3 distinct image URLs. Backend asks the enhancer to vary preset, lighting, angle, and palette across variants — they will not be paraphrased copies of one another.

For social_carousel and ad_creative_pack, count = number of slides / variants in the pack. Backend locks the visual system across all slides automatically.

Aspect ratio

Backend picks a sensible default per mode. Override with --aspect_ratio only if the user explicitly asks for a different one. Allowed values: 1:1, 4:5, 5:4, 3:4, 4:3, 2:3, 3:2, 9:16, 16:9.

Resolution

Use 2k for every product-photoshoot job.

Delivering results

Print the image URLs as a short bulleted list. No JSON, no IDs, no internal model names, no enhanced prompt text. If a job failed, mention it briefly with the failure status.

3 lifestyle shots ready:
- https://cdn.higgsfield.ai/.../job_abc.jpg
- https://cdn.higgsfield.ai/.../job_def.jpg
- https://cdn.higgsfield.ai/.../job_ghi.jpg

What this skill does NOT do

Does not write gpt_image_2 prompts directly. Backend owns prompt assembly.
Does not auto-pick a different image-gen model. Always gpt_image_2.
Does not replace higgsfield-generate Marketing Studio for branded video / avatar workflows.
Does not replace higgsfield-generate for raw text-to-image without a product or brand context.

Common mistakes to avoid

Asking more than 4 interview questions in a single message.
Picking the wrong mode (e.g. product_shot when the user wants a Pinterest pin).
Calling higgsfield generate create gpt_image_2 --prompt ... directly instead of higgsfield product-photoshoot create — bypasses the prompt enhancer and produces noticeably worse output.
Pasting the assembled prompt back to the user — they want the URLs.
Using a --mode value not in the table above.

Account or credentials required

1 FOR YOU · 1 FOR THE AGENT

All items below are required.

01
Install the Higgsfield CLI
Install the higgsfield CLI if it isn't on $PATH: curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh.
02
Sign in with Higgsfield auth login
Run higgsfield auth login interactively if higgsfield account status reports a session expired or not-authenticated error.
```
higgsfield auth login
```

Listed as free: Connected services may require an account or charge fees.

This skill ships inside the Higgsfield AI Skills plugin.

Install just this skill

Run this outside your AI tool, using Node.js 22.20.0 or newer. Skills CLI 1.7.2 skips skill selection; prompts cancel installation without an interactive terminal. If choosing Project when asked about installation scope, open your project's folder before running this.

Install checklist

Check selected tools if a picker appears; Claude Code may be unchecked under Additional agents. ↑/↓ moves, Space toggles selections, Enter confirms.
Without a tool picker, check Installing to: for your intended tool. Stop if it names a different tool.
If asked, choose Symlink (Recommended) for shared files or Copy to all agents for separate copies; review the summary before confirming installation.
Install the find-skills skill? defaults to Yes, adding another skill for all projects. Choose No if you don't want that extra installation.

Skills CLI 1.7.2 sends install data to skills.sh by default, including the source, skill names, target tools and file details; GitHub sources are reported only when GitHub confirms the repository is public, while other remote sources can also be reported. Confirmed-public GitHub sources also trigger a security-audit request. Before installing, set the environment variable DO_NOT_TRACK=1 or DISABLE_TELEMETRY=1 to disable both.

npx skills add higgsfield-ai/skills --skill "higgsfield-product-photoshoot" --full-depth

After installing for Claude Code, open it in the installation project if you chose Project; Global makes the skill available across projects on this computer. Once Claude Code loads the skill, its description helps Claude decide when to use it.

If installation created a top-level skills folder that did not exist when your Claude Code session started, run /reload-skills in that session. Run it again after later changes in that folder.

Install the whole plugin

This route installs the Higgsfield AI Skills plugin package selected for your AI tool.

PLUGIN MARKETPLACE

Add the marketplace, then install the plugin

Typed inside the agent's own prompt, not in a terminal. The marketplace is called higgsfield, which is the part after the @.

/plugin marketplace add higgsfield-ai/skills

02
```
/plugin install higgsfield@higgsfield
```

Open plugin page ↗

What's inside

Files included with this skill.

View on GitHub

Same repository

higgsfield-brandkit
Create and extend complete visual brand systems through the Higgsfield CLI and bundled deterministic local tooling: palettes, SVG logo marks, typography, mockups, social graphics, packaging, signage, merchandise, posters, presentation decks, and editable PPTX/PDF brandbooks. Preserves official supplied assets, persists approvals locally, and regenerates only dependent outputs. Use when: "create a brand kit", "make a visual identity", "design a logo and brandbook", "apply this logo to branded assets", "make packaging or signage", or "extend our existing branding". Chain with higgsfield-generate for general image production and Marketing Studio brand-kits when importing website metadata for ads. NOT for unbranded image generation (use higgsfield-generate), product catalog photography (use higgsfield-product-photoshoot), website implementation (use higgsfield-websites), or native Figma/Canva/PSD/AI delivery.Read full description
higgsfield-generate
Generate images/videos/3D assets/audio via Higgsfield AI. Defaults: GPT Image 2.5 for image/design/text, Seedance 2.5 for video, Nano Banana 2/Lite/Pro for character/reference images, Marketing Studio for ads, Seed Audio 1.0 for audio. Use when: "generate an image", "make a video", "animate this photo", "image-to-video", "edit/stylize/remix this image", "reframe this video", "edit this video from a sketch", "create a 3D model/GLB", "create a sound effect", "make music", "text-to-audio", "create an ad", "make a UGC video", "unboxing", "presenter video", "import product from URL", or "analyze video virality". Supports generic generation, workflows, Marketing Studio, and Virality Predictor. Chain with higgsfield-soul-id for face/identity consistency. NOT for: Soul training, brand systems/brandbooks (use higgsfield-brandkit), photoshoots, cards, YouTube thumbnails (use higgsfield-youtube-thumbnail), explainers (use higgsfield-video-explainer), playable games/assets (use higgsfield-game-generation), or TTS.Read full description
higgsfield-marketplace-cards
Generate marketplace product image cards through Higgsfield: compliant main image, secondary product images, and A+ style content modules. Use when the user asks for marketplace listing images, product detail cards, secondary product images, product infographics, lifestyle listing shots, A+ style content, marketplace image sets, or sales-ready product visuals. Backend owns marketplace compliance references and prompt templates; this skill only routes user intent to the CLI. NOT for generic brand product photography without marketplace/listing context (use higgsfield-product-photoshoot), video generation or UGC ads (use higgsfield-generate), or Soul Character training (use higgsfield-soul-id).Read full description
higgsfield-soul-id
Train a Soul Character — a personalized model on a person's face that Higgsfield uses for identity-faithful image and video generation. Use when: "create my Soul", "train my face", "make my digital twin", "build me an avatar", "learn my appearance", "create a character of me", "set up identity for video", "I want my face in generated images". Chain: train Soul (one-time, returns reference_id) → use in higgsfield-generate via --soul-id <id> with models like text2image_soul_v2 or soul_cinema_studio. NOT for: one-shot face swaps (use higgsfield-generate with --image), named-character / non-photo avatars (use higgsfield-generate with prompt).Read full description
higgsfield-video-explainer
Build a complete non-photoreal narrated explainer or story video from ordered 10-second blocks: one narrator, one universal style key, one Seed Audio take and one Gemini Omni clip per block, then server-side assembly with explainer_video. Use when: "make an explainer video", "explain this in a video", "turn this topic or document into a narrated video", "tell this story as an animated video", "make a faceless narrated video", or "show me explainer styles". Supports live CMS presets, custom style references, mascot/faceless modes, two aspects, and optional burned subtitles. NOT for: photoreal films, ads/UGC, talking heads, podcasts, motion typography reels, one-off clips without narration, or editing a finished video.Read full description
higgsfield-websites
Build, edit, and deploy full-stack websites, apps and games via the Higgsfield CLI (higgsfield website …). Each is a React 19 + TanStack Start SSR app in one Cloudflare Worker (D1/R2/KV/DO/Containers). THREE product types, picked via --type on create: website (standalone, no Higgsfield integration — references/website-flow.md), app (Sign in with Higgsfield + fnf SDK, Quanta — references/app-flow.md), game (realtime multiplayer rooms — references/game-flow.md). Routes to the right flow; each carries its own rules and deploy/publish gates. Use when: "build me a website", "make a landing page", "create a web app", "build a SaaS dashboard / portfolio", "make me a game", "deploy this site", "publish". Also owns GAME ART: "make a spritesheet", "tileable texture", "animate a 3D character", game music/SFX — see the game-* references. NOT for: single image/video/audio generation (higgsfield-generate), product photos (higgsfield-product-photoshoot), marketplace cards (higgsfield-marketplace-cards).Read full description