higgsfield-generate

The general-purpose one: describe what you want and it comes back as a picture, a short video, a 3D model or a piece of sound. It can also watch a video you already have and estimate how far it is likely to travel.

WHEN TO USE

SCOPE

USE FOR

Generate a high-fidelity image, banner, or design straight from a text prompt.
Turn a product photo into a multi-shot marketing ad or a casual, user-generated-content-style video.
Animate a still photo into a short cinematic video clip.
Create a 3D model from one or more reference images.
Generate a sound effect, ambient track, or piece of music from a text prompt.
Score a finished video's hook, attention, and virality potential before you publish it.

NOT FOR

Training a reusable Soul Character identity — that's a separate one-time step.
A full brand identity system: logo, palette, typography, or a brandbook.
Branded product visuals such as lifestyle shots, hero banners, or virtual try-on images.
Marketplace listing cards and A+ style content modules.

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 (11)

Higgsfield Generate

Submit jobs to any Higgsfield model. Wraps the higgsfield CLI. Covers generic image/video/3D/audio generation, Marketing Studio (branded ads, avatars, products, hooks, settings), and, secondarily, Virality Predictor video scoring.

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. No raw IDs, no JSON dumps in chat. Print the media URL for generated assets, or the text summary for Virality Predictor.
No internal jargon. Don't narrate "calling higgsfield cost", "polling job".
Detect the user's language from the first message and reply in it. Technical args (--aspect_ratio 16:9) stay English.
Don't batch-ask. Pick a sane default model and ask one thing at a time only if genuinely missing.
Don't pre-estimate cost or optimize for cheaper models unless the user asks. Prefer the quality default first.
Pass --wait to generate create so the command blocks until done and prints the result URL itself. Avoid the two-step create → wait pattern.

Discovery guardrail

When looking for a Higgsfield feature/model, do not rely only on semantic search or CLI --help. First run an unfiltered model list, then inspect likely job_set_type names. If the user says a model exists but search returns no results, trust that signal and verify with the full model list before answering.

Workflows are separate from models. Discover them with higgsfield workflow list and inspect params with higgsfield workflow get <workflow_name>.

Virality Predictor is exposed as:

Customer-facing name: Virality Predictor
Technical job_set_type: brain_activity
Category/output: text report. This is video-in/text-out analysis, not a text/chat generation model.
Input: uploaded video
Purpose: finished-video hook, attention, retention, and virality analysis

If the user says "analyze this video", "score this ad", "evaluate the hook", or similar, route to brain_activity even though it appears under text/analysis models. Classify by task intent and required input, not by output category alone.

Workflow — generic generation

Pick a model. Start with the core defaults unless the brief clearly needs a specialist:
- GPT Image 2.5 → default image model for high-fidelity general generation, graphic design, UI, banners, typography, and on-image text.
- Seedance 2.5 (seedance_2_5) → SOTA default video model for serious motion, cinematic clips, multi-shot work, and image-to-video. Supports 4–30s output up to 1080p; use Seedance 2.0 when native 4K is required.
- Nano Banana 2/Lite/Pro → default for character, cartoon, stylized, and reference-driven image work; use Lite for speed/cost, Pro for harder briefs.
- Marketing Studio → default for ads, UGC, product demos, unboxing, TV spots, presenter videos, and brand/product workflows.
- Seed Audio 1.0 → default audio model for text-to-audio, voice, sound effects, ambience, foley, and music-like audio unless the user names Sonilo/Mirelo.
Image:
- Complete brand identity, logo system, palette, typography, brandbook, packaging system, signage, or coordinated branded asset suite → use higgsfield-brandkit instead.
- YouTube thumbnail, Shorts cover, or Instagram video cover → use higgsfield-youtube-thumbnail instead.
- Brand product visual (Pinterest pin, lifestyle, hero banner, ad pack, virtual try-on) → use higgsfield-product-photoshoot instead. NOT this skill.
- Generated product concept / packaging / can / bottle with brand name or label text → GPT Image 2.5.
- Branded ad image with avatar + product (Marketing Studio shape) → Marketing Studio Image (see Marketing Studio below)
- Aesthetic UGC / fashion editorial / lifestyle character → Soul 2.0
- Cinematic still frame → Soul Cinema
- Highly characterful creative persona (text-only, distinctive) → Soul Cast
- Locations / environments / no-people scenes → Soul Location (best in class)
- Logo, icon, vector-like illustration, brand mark, controlled-palette graphic → Recraft V4.1 (recraft_v4_1, often with --model_type vector)
- Face edit + complex scene swap → Seedream 4.5
- Soul Character (reference id from higgsfield-soul-id) → Soul 2.0 for stills, Soul Cinema for cinematic
- Character or cartoon-style work → Nano Banana 2; use Nano Banana 2 Lite (nano_banana_2_lite) for fast/simple reference edits, step up to Nano Banana Pro on hard cases
- Fast and cheap iteration → Z Image
- Default for everything else → GPT Image 2.5. Graphic design, UI, banners, typography, and high-fidelity general generation.
Video:
- Complete narrated explainer from a topic, story, or document → use higgsfield-video-explainer, not generic video generation.
- All advertising / commercial / branded ad video → Marketing Studio (see Marketing Studio below)
- Edit existing video from sketch/timestamp, or reframe to another aspect ratio → workflow (draw_to_video or reframe), not a model. See references/workflows.md.
- Default all-purpose serious video (multi-shot, consistent identity, motion-heavy, image-to-video, 4–30s requests) → Seedance 2.5. SOTA. Do not downgrade to Seedance 1.5 just because its duration enum is easier to read; validate Seedance 2.5 first.
- Single-plane scene without strong dynamics, lower-cost option → Kling 3.0; if the user explicitly asks for Turbo, faster, or lower-cost Kling output → Kling 3.0 Turbo (kling3_0_turbo)
- Cheap clean shot without cuts, only when the user asks for cheaper/budget output → Seedance 1.5 Pro
- Cinema-grade highest fidelity → Cinema Studio Video 3.0
- Cheap with strong physics, no audio needed → Minimax Hailuo
- Fast batch / volume → Veo 3.1 Lite
- Bold/stylized image-to-video from a required start image → Grok Video 1.5 (grok_video_v15). Requires one --start-image or --image, duration 2–15s, resolution 480p or 720p.
- Multimodal reference-to-video with up to 7 images or one video reference → Gemini Omni Flash (gemini_omni); keep Seedance 2.5 as the default serious-video pick.
- Reference-driven generation, editing an existing video, or extending one → Seedance 2.5 (seedance_2_5), whose modes are t2v / omni_reference / video_edit / video_extension and which takes image/video/audio reference arrays. Use omni_reference for reference inputs, including start/end frames; t2v accepts no media. Supports up to 1080p; use Seedance 2.0 when native 4K is required.
Video analysis:
- Rate a finished video's hook, virality potential, attention, retention, or distraction risk → Virality Predictor (brain_activity). This is a video analysis model that returns a text score/report, not a generated media asset.
3D:
- A 3D asset within a playable game or game-wide asset system → use higgsfield-game-generation.
- Create an actual 3D mesh/model/GLB from one or more object/product reference images → Multi-Image to 3D (multi_image_to_3d). Pass 1–4 images with repeated --image; use --should_texture true when the asset needs texture. If the user only asks for a 3D-rendered picture, use an image model instead.
Audio:
- Default for audio generation → Seed Audio 1.0 (seed_audio). Use for text-to-audio, sound effects, ambience, foley, impacts, environmental audio, voice-style generations, and music-like audio. It requires --prompt; use optional --audio-references/--image-references only when the user provides references.
- Use Sonilo Music (sonilo_music) only when the user explicitly asks for Sonilo or you need that specialist music model. It requires --prompt and --duration, and returns audio.
- Use Mirelo Text to Audio (mirelo_text_to_audio) only when the user explicitly asks for Mirelo or you need that legacy SFX model. It requires --prompt and --duration, and returns audio.
For the actual --model ID to pass to higgsfield generate create, run higgsfield model list --json | jq to map display names to IDs. See references/model-catalog.md for the full table.
Pass media inputs straight to flags. Media flags accept a local file path or a UUID. CLI auto-uploads paths and auto-detects job vs upload for UUIDs. No need to pre-upload. Each model declares accepted media roles or *_references params — see references/media-inputs.md.
Validate quickly. If unsure of params, run higgsfield model get <jst> --json once and pass only what's needed. Validate the preferred model before falling back to an older one. Use schema defaults otherwise. The server returns adjustments for non-fatal coercions (e.g. aspect_ratio=99:99 → closest match) and a structured error for invalid declared-param values.
Submit and wait in one shot. higgsfield generate create <jst> [--prompt "..."] [media flags] [param flags] --wait. Blocks until terminal status and prints the result on stdout. Tunables: --wait-timeout 20m (default 10m), --wait-interval 5s (default 3s). Virality Predictor does not need a prompt; pass --video.
Deliver. For generated media and 3D assets, send the primary result URL plus a one-line summary (model, duration if video; GLB/asset URL for 3D). For Virality Predictor, deliver the scores, business interpretation, and the Open report link. Do not surface Virality Predictor .glb, .bin, or region-table internals in normal chat output.

To inspect or rerun later, higgsfield generate list --json and higgsfield generate get <id> --json work for retrospection. higgsfield generate wait <id> is still available if you ever need to rejoin a job started without --wait.

For workflow jobs, use higgsfield generate workflow <workflow_name> ... --wait. Cost syntax is higgsfield generate cost workflow <workflow_name> .... See references/workflows.md.

Media flags

Flag	Purpose	Models that accept it
`--image <path-or-id>`	reference image	most image models, `grok_video_v15`, `multi_image_to_3d`, `seedance_2_0`, `seedance_2_5`, `veo3`, `marketing_studio_video`
`--start-image <path-or-id>`	first frame for image-to-video transitions	`grok_video_v15`, `kling3_0`, `kling3_0_turbo`, `kling2_6`, `veo3_1`, `seedance_2_0`, `seedance_2_5`, `marketing_studio_video`
`--end-image <path-or-id>`	last frame for transitions	`kling3_0`, `seedance_2_0`, `seedance_2_5`, `marketing_studio_video`
`--video <path-or-id>`	reference or analyzed video	`seedance_2_0`, `seedance_2_5`, `brain_activity`
`--audio <path-or-id>`	reference audio (lipsync, soundtrack match)	`seedance_2_0`, `seedance_2_5` (reference input; distinct from generating output audio)

For reference-array models, the explicit flags are --image-references, --video-references, and --audio-references; --image, --video, and --audio are short aliases when the schema exposes those params.

Each flag accepts either a local file path (auto-uploaded) or a UUID (upload id from higgsfield upload create, or a previous job id). Each model declares its own media roles or *_references params. See references/media-inputs.md for the full table.

Common params

Flags pass through to model schema. Use higgsfield model get <jst> to discover.

higgsfield generate create gpt_image_2_5 --prompt "neon city at dusk" --aspect_ratio 16:9 --resolution 2k --wait
higgsfield generate create nano_banana_2 --prompt "anime character concept, expressive pose" --image ./ref.png --wait
higgsfield generate create seedance_2_5 --prompt "camera dollies in" --mode omni_reference --start-image ./first.png --duration 12 --resolution 1080p --wait
higgsfield generate create grok_video_v15 --prompt "cinematic handheld shot, neon rainy street" --start-image ./image.png --duration 5 --resolution 720p --wait
higgsfield generate create text2image_soul_v2 --prompt "..." --soul-id <soul_ref_id> --quality 2k --wait
higgsfield generate create multi_image_to_3d --image ./front.png --image ./side.png --should_texture true --wait
higgsfield generate create seed_audio --prompt "cinematic rain ambience with distant thunder" --wait
higgsfield generate create sonilo_music --prompt "cinematic synthwave track" --duration 12 --wait
higgsfield generate create mirelo_text_to_audio --prompt "glass breaking in a large hall" --duration 4 --wait
higgsfield generate create brain_activity --video ./ad.mp4 --wait

For machine-readable output (chained pipelines, agent context), add --json. With --wait --json you get the final job object array. Without --wait, you get the job IDs. Virality Predictor stores raw analysis and render artifacts in the job params, but the default text output should stay to scores plus Open report.

Stdin prompt: echo "..." | higgsfield generate create z_image --wait.

Soul image quality: for text2image_soul_v2 and soul_cinematic, pass --quality 1.5k or --quality 2k. These are UI-facing tiers; the backend maps them to 720p/1080p and model-specific dimensions from the selected --aspect_ratio. soul_location has no quality selector; it uses fixed dimensions per aspect ratio.

Marketing Studio

Branded image/video gen: avatars + products + optional setup hooks/settings + ad-style modes. Use models marketing_studio_video and marketing_studio_image.

Concepts

Avatar — presenter face. Curated preset (browse higgsfield marketing-studio avatars list) or custom (uploaded photos via higgsfield marketing-studio avatars create). For UGC modes, an avatar is optional if the brief clearly mentions a person; the backend can create a Soul Character automatically. Pass an avatar when the user wants a specific presenter.
Product — brand item with title + reference images. Imported from URL (higgsfield marketing-studio products fetch --url ...) or created from uploaded images (higgsfield marketing-studio products create).
Webproduct — App Store / web page version. Auto-routes when fetching App Store URLs.
Hook — reusable opening angle / ad hook. Browse with higgsfield marketing-studio hooks list. Hook text is prepended to the user's prompt; it does not replace --prompt.
Setting — reusable environment / scene context. Browse with higgsfield marketing-studio settings list.
Ad reference — reusable inspiration video that can be bound to an avatar and/or product. Created from an uploaded video (--video-input <upload_id>) or a previous generation job (--job <job_id>). Browse with higgsfield marketing-studio ad-references list. See references/marketing-ad-references.md.
Brand kit — captures a brand's identity (name, logo, hero images, colours, fonts, tone) for reuse across image generations. Created by handing in a website URL (higgsfield marketing-studio brand-kits fetch --url https://… --wait). See references/marketing-brand-kits.md.
Ad format — presets that drives the visual structure of a generated image (headline, bullet-points, etc.). Read-only, browse with higgsfield marketing-studio ad-formats list. Required input for dtc-ads generate.

Discovery commands

Use these exact list commands when the user asks what already exists:

higgsfield marketing-studio avatars list --json
higgsfield marketing-studio products list --json
higgsfield marketing-studio hooks list --json
higgsfield marketing-studio settings list --json
higgsfield marketing-studio ad-references list --json
higgsfield marketing-studio brand-kits list --json
higgsfield marketing-studio ad-formats list --json

--hook_id and --setting_id are supported by marketing_studio_video only; do not pass them to marketing_studio_image.

UX rules (additional)

One question per phase. Don't ask product+avatar+mode upfront.
Two ad approaches are mutually exclusive. Either the user gives an ad reference video (reference-driven) or picks hook/setting blocks (composed-from-blocks) — never both. If the user has an ad reference selected, do not offer hook/setting; if hook/setting are picked, do not offer to attach an ad reference.
Ad reference source. The only valid inputs are a local video file (uploaded via higgsfield upload create ... --video) or a prior video job. If the user provides anything else, ask for a local file.
dtc-ads ad format is mandatory. Always ask the user to pick from ad-formats list. There is no auto-default — both the CLI and server reject calls without --format-id.
dtc-ads optional inputs. Suggest avatars, products, and reference media when the brief calls for them; only attach what the user picks.

Workflow — quick ad video

Get product.
- Existing product → higgsfield marketing-studio products list --json
- URL → higgsfield marketing-studio products fetch --url <url> --wait (polls until import done)
- Local images → higgsfield upload create <photo>... then higgsfield marketing-studio products create --title "..." --image <id>... Capture product id. When using --hook_id, strongly prefer passing --product_ids; hooks are designed to pivot into a product and work poorly without product context.
Pick avatar if needed.
- Default: higgsfield marketing-studio avatars list and pick a preset matching the brand voice.
- Custom: higgsfield marketing-studio avatars create --name "..." --image <upload_id>. For UGC modes, you may omit --avatars when no specific presenter is required and the brief mentions a person; the backend can synthesize a Soul Character.
Optionally pick setup items.
- Hook: higgsfield marketing-studio hooks list --json
- Setting: higgsfield marketing-studio settings list --json Pass selected IDs as --hook_id <hook_id> and --setting_id <setting_id> for marketing_studio_video only. Do not copy the hook's prompt into --prompt unless the user explicitly wants to reinforce the same wording.
Pick mode if needed. Default is ugc; --mode is not required just because --hook_id is present. Other current slugs: ugc_how_to, ugc_unboxing, product_showcase, product_review, tv_spot, wild_card, ugc_virtual_try_on, virtual_try_on. Hook/setting are valid only for ugc, ugc_how_to, ugc_unboxing, product_review, ugc_virtual_try_on — do not pass --hook_id / --setting_id with the other modes. See references/marketing-modes.md.
Generate (one-shot).
```
PRODUCT_IDS_JSON=$(mktemp)
AVATARS_JSON=$(mktemp)
printf '["<product_id>"]' > "$PRODUCT_IDS_JSON"
printf '[{"id":"<avatar_id>","type":"preset"}]' > "$AVATARS_JSON"

higgsfield generate create marketing_studio_video \
  --prompt "..." \
  --avatars @"$AVATARS_JSON" \
  --product_ids @"$PRODUCT_IDS_JSON" \
  --mode ugc \
  --duration 15 \
  --resolution 720p \
  --aspect_ratio 9:16 \
  --wait
```
Add --hook_id <hook_id> and/or --setting_id <setting_id> when a setup hook/setting was selected. product_ids and avatars are JSON arrays; pass them via @/path/to/file.json. Do not pass a bare UUID to --product_ids. Resolution is 480p or 720p. Aspect ratio is one of auto/21:9/16:9/4:3/1:1/3:4/9:16. --generate-audio true is supported here (unlike seedance_2_0). --wait blocks until done; bump --wait-timeout 30m for longer ad runs.
Deliver. URL + one-line summary (mode, duration).

Click-to-Ad shortcut (URL-driven)

When the user gives a product URL and wants a marketing video in one go:

# 1. Trigger fetch (returns the product id, import runs in the background)
higgsfield marketing-studio products fetch --url https://shop.example.com/sneakers --wait

# 2. Generate the marketing video against the same URL — backend reuses the entity
higgsfield generate create marketing_studio_video \
  --url https://shop.example.com/sneakers \
  --mode ugc \
  --duration 15 \
  --aspect_ratio 9:16 \
  --wait

Backend dedupes by URL, so repeated runs reuse the existing entity instead of re-fetching.

Workflow — marketing image

Same as above but use marketing_studio_image model:

higgsfield generate create marketing_studio_image \
  --prompt "..." \
  --aspect_ratio 1:1 \
  --resolution 2k \
  --wait

Virality Predictor video scoring

Use Virality Predictor (brain_activity) when the user wants to evaluate a finished video as a business creative: hook strength, virality potential, attention, retention, or how well the content/product holds focus and minimizes distraction. Treat "Virality Predictor" as the customer-facing feature name; brain_activity is only the CLI/job_set_type.

higgsfield generate create brain_activity --video ./creative.mp4 --wait

The result is text, not a generated image/video. Report the overall score, peak hook second, sustain score, strongest/weakest regions, and report URL if present. Interpret it as an objective attention proxy for creative testing: higher Visual/Auditory/Language/Attention scores suggest stronger stimulus and focus; lower Default Mode is better because it suggests less mind-wandering.

The CLI prints an Open report URL like https://<app-domain>/apps/virality-predictor?resultJobId=<job_id>. Send that URL for the visual report. Raw artifact URLs such as brain_example_url, vertexMapBinaryUrl, and vertexMapUrl are implementation details; mention them only when the user asks for raw data or implementation details.

Good final shape:

Overall score: 44/100
Peak hook: 49% at 1s
Sustain: 89%
Strongest region: Visual Cortex
Risk: Default Mode is high, which can indicate mind-wandering.

Open report: <report_url>

Errors

Missing required params: prompt → user gave no prompt; ask for it.
Missing required params: medias on brain_activity / Virality Predictor → pass exactly one video via --video <path-or-id>.
Invalid values: aspect_ratio=99:99 (allowed: ...) → bad enum; pick from allowed.
Unknown params: foo → schema doesn't accept that flag; check higgsfield model get <jst>. If this happens for hook_id or setting_id, the selected model/job_set_type does not support Marketing Studio setup items.
Session expired → higgsfield auth login.

See references/troubleshooting.md for more.

Reference docs

Load on demand:

references/model-catalog.md — picking the right model for the task
references/workflows.md — draw_to_video and reframe workflow generation
references/prompt-engineering.md — writing prompts that work
references/media-inputs.md — image/video/audio reference flows and Virality Predictor video analysis
references/troubleshooting.md — common errors and fixes
references/marketing-avatars.md — preset vs custom avatars
references/marketing-products.md — URL fetch vs manual product create
references/marketing-setup-items.md — hooks/settings discovery and usage
references/marketing-ad-references.md — ad reference videos (create/list/get)
references/marketing-brand-kits.md — brand kits (fetch from URL, list, get)
references/marketing-dtc-ads.md — DTC Ads Engine (dtc-ads generate)
references/marketing-modes.md — every Marketing Studio mode

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 when 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-generate" --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-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-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. 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).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