$npx -y skills add MoizIbnYousaf/marketing-cli --skill higgsfield-product-photoshootUse when the user wants professional brand-quality product images via Higgsfield's mode-specific prompt enhancement pipeline. Entry point for any product visual with a specific format or platform target. Use whenever: "product photoshoot", "lifestyle product shots", "Pinterest pi
| 1 | # /higgsfield-product-photoshoot — Brand Product Image Generation |
| 2 | |
| 3 | 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. |
| 4 | |
| 5 | ## When to use |
| 6 | |
| 7 | - Any product visual with a specific output format: studio shot, Pinterest pin, hero banner, ad pack, carousel, model try-on |
| 8 | - User has a product photo and wants it adapted to a specific marketing context |
| 9 | - "make ads for my product", "make a hero banner", "create carousel images" |
| 10 | - "virtual try-on", "model wearing my jacket", "levitating product shot" |
| 11 | - Paid social creative packs (Meta, TikTok, Pinterest, Google Ads) |
| 12 | |
| 13 | **Route elsewhere if:** |
| 14 | - No product, no brand context, just a generic image prompt → `image-gen` (Gemini, free, faster) |
| 15 | - User needs a branded video ad with an avatar → `higgsfield-generate` (Marketing Studio) |
| 16 | - User wants to train a reusable face identity → `higgsfield-soul-id` |
| 17 | - User needs general-purpose AI image/video generation → `higgsfield-generate` |
| 18 | |
| 19 | ## On Activation |
| 20 | |
| 21 | 1. Read `brand/voice-profile.md`, `brand/visual-style.md`, and `brand/creative-kit.md` if present. Use brand colors, aesthetic language, and platform preferences to inform mode selection and interview answers. |
| 22 | 2. Check CLI: `higgsfield account status`. If not on `$PATH`, surface install command. If session expired, prompt auth. |
| 23 | 3. Run the pre-generation interview (see below) — at most 4 questions before submitting. |
| 24 | |
| 25 | ## Optional dependency — Higgsfield account |
| 26 | |
| 27 | This skill requires the `@higgsfield/cli` binary and a Higgsfield account. |
| 28 | |
| 29 | **Without the CLI installed**, return a clear actionable error: |
| 30 | ``` |
| 31 | higgsfield CLI not found. Install with: |
| 32 | curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh |
| 33 | Then authenticate: |
| 34 | higgsfield auth login |
| 35 | ``` |
| 36 | |
| 37 | **Without an authed Higgsfield account**, the CLI itself surfaces the auth prompt — no special handling needed in the skill. |
| 38 | |
| 39 | **Fallback for image generation only:** if the user just needs a one-off image and doesn't have a Higgsfield account, route them to `image-gen` (Gemini, model `gemini-3.1-flash-image-preview`, free tier). The product-photoshoot mode enhancer and all product-specific modes require Higgsfield. |
| 40 | |
| 41 | ## Step 0 — Bootstrap |
| 42 | |
| 43 | Before any other command: |
| 44 | |
| 45 | 1. If `higgsfield` is not on `$PATH`, install it: |
| 46 | ```bash |
| 47 | curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh |
| 48 | ``` |
| 49 | 2. If `higgsfield account status` fails with `Session expired` / `Not authenticated`, ask the user to run `higgsfield auth login` (interactive) and wait for confirmation. |
| 50 | |
| 51 | ## UX Rules |
| 52 | |
| 53 | 1. Be concise. Print only image URLs in the final reply. |
| 54 | 2. Detect language, respond in it. Mode names and CLI flags stay English. |
| 55 | 3. Ask at most 4 short questions before submitting. Use labeled options, never open-ended. |
| 56 | 4. Skip questions whose answer is obvious from context (uploaded image, prior turn, brand memory). |
| 57 | 5. Never write the gpt_image_2 prompt yourself — backend assembles it. |
| 58 | 6. Polling is silent. Wait until URLs are ready, then deliver. |
| 59 | |
| 60 | ## Modes |
| 61 | |
| 62 | | Mode | When user wants… | |
| 63 | |---|---| |
| 64 | | `product_shot` | Product on neutral / studio / catalog background | |
| 65 | | `lifestyle_scene` | Product in real-world environment, hands, action, atmosphere | |
| 66 | | `closeup_product_with_person` | Tight crop with hands / partial face — beauty application, holding, demonstrating | |
| 67 | | `moodboard_pin` | Vertical 2:3 Pinterest-native aesthetic, moodboard feel | |
| 68 | | `hero_banner` | Wide-format website / email / campaign header | |
| 69 | | `social_carousel` | 3–10 connect |