higgsfield-marketplace-cards

An online marketplace has rules about the photos on a listing — what has to be in the first one, what is not allowed. This produces the whole set to those rules: the main shot, the extra angles, and the illustrated panels further down the page.

WHEN TO USE

SCOPE

USE FOR

Generate the main compliant product image required for a marketplace listing.
Create a full set of secondary images alongside the main listing photo.
Build A+ style content modules like features, pain points, and how-to-use panels.
Produce an infographic or lifestyle shot sized for a marketplace product page.

NOT FOR

Product photography for a brand site or ad campaign, outside a marketplace listing.
Video generation or UGC-style ad content.
Training a Soul Character model on a person's face.

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

Marketplace Cards

Create marketplace-ready product visuals with higgsfield marketplace-cards create. The CLI first calls the backend enhancer, where marketplace rules and templates are kept private, then creates nano_banana_2 jobs and prints result URLs.

Bootstrap

If higgsfield is not on $PATH, install it by running the official installer with Bash: curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh.
If higgsfield account status fails with authentication errors, ask the user to run higgsfield auth login.

UX Rules

Respond in the user's language.
Ask at most one concise confirmation question before running.
Prefer a product image. If the user provides only text or a URL, proceed only when the product details are clear.
Do not write final image-generation prompts yourself. Backend enhancement owns that.
Final answer should contain only the ready image URLs and short labels.

Scope Selection

Use --scope when the user asks for a common bundle:

Scope	Creates
`main`	1 marketplace main image
`product-images`	main image + 5 secondary images
`aplus`	main image + 7 A+ modules
`full-set`	main image + 5 secondary images + 7 A+ modules

Use repeated --asset only for custom subsets:

main_image
infographic
multi_angle
detail_shot
lifestyle
whats_in_box
aplus_hero_banner
aplus_pain_points
aplus_features
aplus_ingredients
aplus_efficacy
aplus_how_to_use
aplus_endorsement

Command

Build and run one higgsfield marketplace-cards create command from the user's request.

For common bundles, use --scope <main|product-images|aplus|full-set>, --prompt "<short product and listing intent>", optional repeated --image <path-or-upload-id>, and optional context flags: --product_context, --brand_context, --category, --visual_style.

Examples to mirror when choosing arguments:

Product images: higgsfield marketplace-cards create --scope product-images --prompt "sparkling peach lemonade can for marketplace listing" --image ./can.png --category "beverage"
Full set: higgsfield marketplace-cards create --scope full-set --prompt "premium skincare serum, clean clinical marketplace visual system" --image ./serum.jpg --brand_context "minimal white and sage palette"
Custom subset: repeat --asset, for example --asset main_image --asset infographic --asset lifestyle.
Existing completed main image job: use --main-job <completed_main_job_id> with the requested secondary or A+ --asset values.

Delivery

Print URLs with labels:

Marketplace cards ready:
- Main image: https://...
- Infographic: https://...
- Lifestyle: https://...

Avoid JSON, job IDs, internal model names, or enhanced prompt text unless the user explicitly asks.

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 if higgsfield account status fails with an authentication 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-marketplace-cards" --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-generate
Generate images/videos/3D assets/audio via Higgsfield AI. Defaults: GPT Image 2.5 for image/design/text, Seedance 2.5 for video, Nano Banana 2/Lite/Pro for character/reference images, Marketing Studio for ads, Seed Audio 1.0 for audio. Use when: "generate an image", "make a video", "animate this photo", "image-to-video", "edit/stylize/remix this image", "reframe this video", "edit this video from a sketch", "create a 3D model/GLB", "create a sound effect", "make music", "text-to-audio", "create an ad", "make a UGC video", "unboxing", "presenter video", "import product from URL", or "analyze video virality". Supports generic generation, workflows, Marketing Studio, and Virality Predictor. Chain with higgsfield-soul-id for face/identity consistency. NOT for: Soul training, brand systems/brandbooks (use higgsfield-brandkit), photoshoots, cards, YouTube thumbnails (use higgsfield-youtube-thumbnail), explainers (use higgsfield-video-explainer), playable games/assets (use higgsfield-game-generation), or TTS.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

Marketplace Cards

Bootstrap

UX Rules

Scope Selection

Command

Delivery

Account or credentials required

Install just this skill

Install the whole plugin

Add the marketplace, then install the plugin

What's inside

More skills

higgsfield-brandkit

higgsfield-generate

higgsfield-product-photoshoot

higgsfield-soul-id

higgsfield-video-explainer

higgsfield-websites