higgsfield

name	higgsfield
version	0.3.0
description	AI agent skills for image and video generation via Higgsfield AI. Use this skill when asked to generate images or videos from a prompt, create branded ad video (UGC, unboxing, TV spot) with Marketing Studio, produce product photography or marketplace cards, train a reusable face identity (Soul Character), score a finished video's virality, or build/edit/deploy a full-stack website. Image/video generation spans 30+ models (Nano Banana 2, Soul V2, Veo 3.1, Kling 3.0, Seedance 2.0, Flux 2, GPT Image 2, …). Bundles five skills: higgsfield-generate, higgsfield-soul-id, higgsfield-product-photoshoot, higgsfield-marketplace-cards, and higgsfield-websites Markdown-based agents.
metadata	{"starchild":{"emoji":"🎬","skillKey":"higgsfield","requires":{"env":["HIGGSFIELD_API_KEY"]}}}
user-invocable	false

Higgsfield AI Skills

AI agent skills for image/video generation via Higgsfield AI, including Marketing Studio and Virality Predictor video scoring. Works with Claude Code, Cursor, Codex, and other AI coding agents that load Markdown-based skills.

Install

Pick one. Each method handles the Higgsfield CLI install and auth as part of skill setup.

npx skills — recommended, cross-agent

npx skills add higgsfield-ai/skills

Setup script

Universal fallback:

git clone --depth 1 https://github.com/higgsfield-ai/skills.git
cd skills
./setup

More options in INSTALL.md. Agent-driven install (paste into your agent): INSTALL_FOR_AGENTS.md.

Skills

Skill	Invoke	Description
higgsfield-generate	/higgsfield:generate	Image, video, 3D, and audio generation across 30+ models (Nano Banana 2, Soul V2, Veo 3.1, Kling 3.0, Seedance 2.0, Seed Audio 1.0, Flux 2, GPT Image 2, …), plus Marketing Studio for branded ads with avatars/products/hooks/settings and Virality Predictor scoring for finished videos.
higgsfield-soul-id	/higgsfield:soul-id	Train a Soul Character — a reusable, face-faithful identity model. Returns a reference_id consumable by Soul-aware generation.
higgsfield-product-photoshoot	/higgsfield:product-photoshoot	Brand-quality product imagery with mode-specific prompt enhancement. 10 modes (studio, lifestyle, Pinterest, hero banner, ad packs, virtual try-on, …) backed by gpt_image_2.
higgsfield-marketplace-cards	/higgsfield:marketplace-cards	Marketplace product cards: compliant main image, secondary product images, and A+ style modules via backend prompt enhancement.
higgsfield-websites	/higgsfield:websites	Build, edit, and deploy full-stack websites — React 19 + TanStack Start, server-rendered as one Cloudflare Worker with D1 / R2 / KV / Durable Objects / Containers. Create → get git repo access → edit locally → push → deploy preview/production, all via higgsfield website ….

The skills chain: train Soul → use the reference id in generate (including Marketing Studio jobs). product-photoshoot and marketplace-cards are self-contained — backend enhances prompts before submitting image jobs. websites chains with generate to embed bespoke hero images, video loops, and OG assets in the site.

Modes

higgsfield-product-photoshoot — 10 modes for brand visuals:

Mode	What it's for
product_shot	Product on neutral / studio / catalog background
lifestyle_scene	Product in a real environment — hands, action, atmosphere
closeup_product_with_person	Tight crop with hands or partial face — beauty, demonstrating
moodboard_pin	Vertical 2:3 Pinterest-native pin, 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
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

higgsfield-generate Marketing Studio — 9 modes for branded ad video:

Mode	What it's for
ugc	Default. Casual, organic-feel content from a presenter
ugc_how_to	Tutorial / explainer
ugc_unboxing	Unboxing reveal
product_showcase	Clean product highlight, polished
product_review	Presenter giving an opinion
tv_spot	Broadcast-style commercial
wild_card	Experimental, model picks the vibe
ugc_virtual_try_on	Trying on clothing — UGC vibe
virtual_try_on	Trying on clothing — polished, model-driven

Quick Reference

What you want	Skill	Note
Generate any image / video from a prompt	higgsfield-generate	Prefers gpt_image_2 / nano_banana_2 for images and seedance_2_0 for video by default
Generate audio from a prompt	higgsfield-generate	Prefers seed_audio by default
Image with my own face	higgsfield-soul-id then higgsfield-generate	One-time training, then --soul-id
Branded product photo (studio / lifestyle / Pinterest / hero / ad pack)	higgsfield-product-photoshoot	Mode-specific prompt enhancer + gpt_image_2
Marketplace product cards / A+ style content	higgsfield-marketplace-cards	Main image, secondary images, and A+ style modules with hidden marketplace prompt templates
Branded ad video / UGC / unboxing / TV spot	higgsfield-generate	Marketing Studio mode with avatars + products + optional hooks/settings
Analyze a video's hook / attention / virality potential	higgsfield-generate	Uses Virality Predictor (brain_activity) with --video; returns score metrics plus an Open report link
Train a custom face identity	higgsfield-soul-id	5–20 photos, returns reference_id
Image-to-video animation	higgsfield-generate	Prefer seedance_2_0 with --start-image; use kling3_0 as lower-cost fallback
Build / edit / deploy a website, web app, landing page, or dashboard	higgsfield-websites	Full-stack React 19 + TanStack Start on Cloudflare; higgsfield website create/repo-access/deploy

License

MIT — see LICENSE.