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.