agentleFS
qwwiwiqwwiwi/agentos-skills-public/skills/higgsfield-product-photoshoot/SKILL.md

higgsfield-product-photoshoot

Skill4 starsChanged 4 months agoMITView on GitHub

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).

  • Pipes a download into a shell

17 other projects use a version of this, 10 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use higgsfield-youtube-thumbnail, higgsfield-websites and 9 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • higgsfield-aiSkill

    higgsfield-youtube-thumbnail

    Create high-click-through YouTube thumbnails and vertical video covers through the Higgsfield CLI. Builds a truthful information-gap concept, preserves up to three referenced identities, supports logos and controlled variants, renders the main image with Nano Banana Pro, and applies focused Seedream edits. Use when: "make a YouTube thumbnail", "thumbnail for this video", "MrBeast-style cover", "Shorts cover", or "Instagram video cover". Chain after any video workflow once its truthful topic and visual direction are known. NOT for producing the video itself (use higgsfield-generate), product catalog photos (use higgsfield-product-photoshoot), or marketplace cards (use higgsfield-marketplace-cards).

    Also in 6 projects that use this

  • higgsfield-aiSkill

    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).

    Also in 6 projects that use this

  • OpenAISkill

    remotion-render

    Export a Remotion video

    Also in 3 projects that use this

  • OpenAISkill

    hyperframes-cli

    HyperFrames CLI tool — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting, validating, inspecting visual layout in compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

    Also in 3 projects that use this

  • boraoztuncSkill

    animation-vocabulary

    Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

    Also in 3 projects that use this

  • arkanSkill

    review-animations

    Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

    Also in 3 projects that use this

  • +2 more from higgsfield-ai

The file

Show its rules and text

We split this skill into the rules it gives an agent

13 rules. 7 are common, 0 are distinctive, and 6 are very specific to this project.

  • 7

    Common

    Most of the 10 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 6

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Common:

    Before any other command:

    line 31
  2. Very specific:

    If higgsfield is not on $PATH, install it:

    line 33
  3. Very specific:

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

    line 37
  4. Common:

    Ask at most 4 short questions before submitting.

    line 43
  5. Common:

    Never write the gpt_image_2 prompt yourself — backend assembles it.

    line 45
  6. Common:

    Ask 3–4 short questions before submitting.

    line 86
  7. Common:

    If not, describe the product — category, packaging, color, distinctive features.

    line 106
  8. Common:

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

    line 134
  9. Very specific:

    Use 2k for every product-photoshoot job.

    line 189
  10. Common:

    Does not write gpt_image_2 prompts directly.

    line 204
  11. Very specific:

    Does not auto-pick a different image-gen model.

    line 205
  12. Very specific:

    Does not replace higgsfield-generate Marketing Studio for branded video / avatar workflows.

    line 206
  13. Very specific:

    Does not replace higgsfield-generate for raw text-to-image without a product or brand context.

    line 207

“Common” is measured: kept by at least 6 in 10 of the 10 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

ModeWhen user wants…
product_shotProduct on neutral / studio / catalog background
lifestyle_sceneProduct in real-world environment, hands, action, atmosphere
closeup_product_with_personTight crop with hands / partial face — beauty application, holding, demonstrating
moodboard_pinVertical 2:3 Pinterest-native aesthetic, moodboard feel
hero_bannerWide-format website / email / campaign header
social_carousel3–10 connected slides for IG / LinkedIn / Facebook
ad_creative_packCoordinated pack of static ad variants for Meta / TikTok / Pinterest / Google Ads
virtual_model_tryoutProduct worn or used by an AI-rendered model
conceptual_productSurreal / CGI-style / levitating / splash / sculptural product
restyleTransform 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.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.