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
- Vujavujavuja/Stillmotion-onbrandedited, first seen Nov 16, 2026
- MoizIbnYousaf/marketing-cliedited, first seen Nov 1, 2026
- aipphilie/claude-skillsedited, first seen Nov 1, 2026
- davidanthonyn/claude-skillsedited, first seen Oct 20, 2026
- michellek807-cell/CLAUDE-SKILLSedited, first seen Oct 13, 2026
- mppyxx/claude-power-packword for word, first seen Oct 8, 2026
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-aiSkillhiggsfield-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-aiSkillhiggsfield-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
OpenAISkillremotion-render
Export a Remotion video
Also in 3 projects that use this
OpenAISkillhyperframes-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
boraoztuncSkillanimation-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
arkanSkillreview-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
Other versions17 projects use a version of this.
Word for word · 6
- kevinbadi/higgsfield-supercomputer★ 30100% same
- avenoxai/higgsfield-studio★ 9100% same
- desaultkhan/Kalinga-Shorts-Factory★ 4100% same
- clandestudioagency/ClaudeCode★ 0100% same
- mppyxx/claude-power-pack★ 0100% same
- nikunj812/claude-skill★ 0100% same
Edited · 10
- higgsfield-ai/skills★ 1.9k100% same
- MoizIbnYousaf/marketing-cli★ 3361% same
- isaacsight/kernel★ 16100% same
- edorabma9304/Claude-Skill-by-Ozolab-Indonesia★ 2100% same
- nomdedev/agent-manager-template★ 2100% same
- Vujavujavuja/Stillmotion-onbrand★ 2100% same
- aipphilie/claude-skills★ 0100% same
- Biznomad/claude-skills★ 092% same
- davidanthonyn/claude-skills★ 0100% same
- michellek807-cell/CLAUDE-SKILLS★ 0100% same
Wrote their own version · 1
- CoopersWorkwear/claude_skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository43 other files it gives its agents.
- agent-browserSkill
- agent-introspectionSkill
- agentos-contentSkill
- carousel-instagramSkill
- chat-archiveSkill
- codex-imageSkill
- content-engineSkill
- cross-reviewSkill
- datawrapperSkill
- dev-pipelineSkill
- excalidrawSkill
- fast-loop-codingSkill
- groq-voiceSkill
- higgsfield-generateSkill
- higgsfield-marketplace-cardsSkill
- higgsfield-soul-idSkill
- instagram-superpowerSkill
- learningsSkill
- loop-codingSkill
- markdown-newSkill
- mcp-api-buildSkill
- mcp-builderSkill
- memory-auditSkill
- miro-boardSkill
- perplexity-researchSkill
- presentSkill
- reel-radarSkill
- reels-analytics-for-brokersSkill
- reelsSkill
- remote-agent-desktopSkill
- security-auditSkill
- senior-brainstormSkill
- seo-tuneSkill
- server-doctorSkill
- telegram-chipSkill
- threads-contentSkill
- topic-monitorSkill
- transcriptSkill
- twitterSkill
- workshopSkill
- youtube-producerSkill
- youtube-thumbnailSkill
- yt-researchSkill
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
- Common: line 31
Before any other command:
- Very specific: line 33
If higgsfield is not on $PATH, install it:
- Very specific: line 37
If higgsfield account status fails with Session expired / Not authenticated, ask the user to run higgsfield auth login (interactive) and …
- Common: line 43
Ask at most 4 short questions before submitting.
- Common: line 45
Never write the gpt_image_2 prompt yourself — backend assembles it.
- Common: line 86
Ask 3–4 short questions before submitting.
- Common: line 106
If not, describe the product — category, packaging, color, distinctive features.
- Common: line 134
After answers → return to the relevant Type A–E.
- Very specific: line 189
Use 2k for every product-photoshoot job.
- Common: line 204
Does not write gpt_image_2 prompts directly.
- Very specific: line 205
Does not auto-pick a different image-gen model.
- Very specific: line 206
Does not replace higgsfield-generate Marketing Studio for branded video / avatar workflows.
- Very specific: line 207
Does not replace higgsfield-generate for raw text-to-image without a product or brand context.
“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.
Files
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
higgsfieldis not on$PATH, install it:curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh - If
higgsfield account statusfails withSession expired/Not authenticated, ask the user to runhiggsfield 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 3higgsfield product-photoshoot create \
--mode moodboard_pin \
--prompt "vertical pin for my candle brand, cottagecore mood" \
--image candle.jpghiggsfield product-photoshoot create \
--mode restyle \
--prompt "Christmas version, quiet-luxury aesthetic" \
--image existing-shot.jpgImage 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.jpgWhat 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-generateMarketing Studio for branded video / avatar workflows. - Does not replace
higgsfield-generatefor 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_shotwhen the user wants a Pinterest pin). - Calling
higgsfield generate create gpt_image_2 --prompt ...directly instead ofhiggsfield 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
--modevalue not in the table above.
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
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.

