SkillAgentSearch skills...

higgsfield-product-photoshoot

Generate brand-quality product images through Higgsfield product-photoshoot prompt enhancement on GPT Image 2 / gpt_image_2. Entry point for professional brand/product visuals.

Install / Use

npx skills add higgsfield-ai/skills --skill higgsfield-product-photoshoot

Installs into whichever agent you are using.

About this skill
πŸ“„

SKILL.md

Installable skill definition

Quality Score

91/100

Supported Platforms

Universal

Our assessment of higgsfield-product-photoshoot

higgsfield-product-photoshoot scores 91/100 on our quality scale, 330th of 950 AI & Machine Learning skills we index (top 35%).

Its SKILL.md is 9.1 KB long, well organised into 20 sections with 5 code examples: a thorough specification that gives an agent plenty to work with.

With 1,120 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so higgsfield-product-photoshoot is actively maintained.
  • Our last check on 2026-10-29 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit β€” read the skill file before letting an agent act on it.

Safety scan

Review

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (1 minor note below). An AI review judged it risky: Step 0 instructs the agent to run `curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh` if the CLI is missing.

  • noteInstalls by piping a downloaded script into a shellline 35
    curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh

AI review: risky

  • Step 0 instructs the agent to run `curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh` if the CLI is missing
  • Piping a remote install script directly into a shell bypasses package-manager verification and can execute arbitrary code
  • The remainder of the skill is a benign product-image generation workflow, but the bootstrap command meaningfully weakens safeguards

AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk β€” read a skill before letting an agent act on it.

higgsfield-product-photoshoot compared with similar skills

All 4 of these similar skills score higher than higgsfield-product-photoshoot; compare them before choosing.

SkillScoreStarsUpdatedFormat
higgsfield-product-photoshoot (this skill)by higgsfield-ai911.1k2mo agoSKILL.md
claude-memby thedotmack100117.6ktodayCLAUDE.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Understand-Anythingby Egonex-AI10092.8k1d agoCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md

Frequently asked questions

How do I install higgsfield-product-photoshoot?
Run npx skills add higgsfield-ai/skills --skill higgsfield-product-photoshoot. The install tabs above show the steps for each supported agent.
Which AI agents does higgsfield-product-photoshoot work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is higgsfield-product-photoshoot safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (1 minor note below). An AI review judged it risky: Step 0 instructs the agent to run curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh if the CLI is missing. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is higgsfield-product-photoshoot still maintained?
The repository was last updated about 2 months ago, so higgsfield-product-photoshoot is actively maintained.

version: 0.13.0 name: higgsfield-product-photoshoot description: | Generate brand-quality product images through Higgsfield product-photoshoot prompt enhancement on GPT Image 2 / gpt_image_2. Entry point for professional brand/product visuals. Use when: "product photo", "studio shot", "lifestyle image", "Pinterest pin", "hero/banner", "carousel", "ad creative", "Meta ads", "virtual try-on", "model wearing", "person holding product", "closeup with hands", "levitating/floating/splash product", "CGI/surreal product", "restyle", "seasonal/aesthetic variation", or any product, brand, or paid-social creative. Modes: product_shot, lifestyle_scene, closeup_product_with_person, moodboard_pin, hero_banner, social_carousel, ad_creative_pack, virtual_model_tryout, conceptual_product, restyle. Backend assembles the final prompt; never freehand it. NOT for: no-product text-to-image (use higgsfield-generate), branded avatar video (use higgsfield-generate Marketing Studio), marketplace listing cards (use higgsfield-marketplace-cards), Soul Character training (use higgsfield-soul-id). argument-hint: "[--mode <mode>] [--count N] [prompt]" allowed-tools: Bash

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:

  1. If higgsfield is not on $PATH, install it:
    curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
    
  2. 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

  1. Be concise. Print only image URLs in the final reply.
  2. Detect language, respond in it. Mode names and CLI flags stay English.
  3. Ask at most 4 short questions before submitting. Use labeled options, never open-ended.
  4. Skip questions whose answer is obvious from context (uploaded image, prior turn, brand memory).
  5. Never write the gpt_image_2 prompt yourself β€” backend assembles it.
  6. 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"

  1. How many? [1 / 3 / 5]
  2. What style/mood? [Clean studio / Lifestyle / Conceptual / With a model / Other]
  3. Where will you use them? [Shopify / Instagram / Pinterest / Paid ads / Website hero]
  4. 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:

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

Type C β€” text only, no product photo

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

Type D β€” uploaded existing image, "redo / change vibe / different version"

β†’ restyle

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

Type E β€” model wearing a product (fashion, accessories)

β†’ virtual_model_tryout

  1. Model archetype? (suggest 2–3 based on brand audience)
  2. Environment? [Studio clean / Outdoor natural / Street style / Editorial / Home cozy]
  3. 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".

  1. What product or topic?
  2. Goal? [Sell on a marketplace / Build awareness / Run paid ads / Update website]
  3. 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.

Related Skills

View on GitHub
GitHub Stars1.1k
CategoryAI
Updated2mo ago
Forks216

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit β€” see the Safety scan above for what the skill file itself contains.

No cautions
higgsfield-product-photoshoot β€” Universal Skill: Install & Safety Check | SkillAgent