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.
1---2name: higgsfield3version: 0.3.14description: |5 AI agent skills for image and video generation via Higgsfield AI. Use this skill when asked to6 generate images or videos from a prompt, create branded ad video (UGC, unboxing, TV spot) with7 Marketing Studio, produce product photography or marketplace cards, train a reusable face identity8 (Soul Character), score a finished video's virality, or build/edit/deploy a full-stack website.9 Image/video generation spans 30+ models (Nano Banana 2, Soul V2, Veo 3.1, Kling 3.0, Seedance 2.0,10 Flux 2, GPT Image 2, …). Bundles five skills: higgsfield-generate, higgsfield-soul-id,11 higgsfield-product-photoshoot, higgsfield-marketplace-cards, and higgsfield-websites12 Markdown-based agents.13metadata:14 source: https://skillmd.com/skills/starchild-ai-agent/higgsfield15 starchild:16 emoji: "🎬"17 skillKey: higgsfield18 requires:19 env: [HIGGSFIELD_API_KEY]20user-invocable: false2122---2324# Higgsfield AI Skills2526[](https://github.com/higgsfield-ai/skills/blob/main/LICENSE)27[](https://github.com/higgsfield-ai/skills/blob/main/VERSION)28[](#skills)29[](https://discord.com/invite/higgsfield)3031AI agent skills for image/video generation via [Higgsfield AI](https://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.3233## Install3435Pick one. Each method handles the Higgsfield CLI install and auth as part of skill setup.3637### `npx skills` — recommended, cross-agent3839```bash40npx skills add higgsfield-ai/skills41```4243### Setup script4445Universal fallback:4647```bash48git clone --depth 1 https://github.com/higgsfield-ai/skills.git49cd skills50./setup51```5253More options in [INSTALL.md](https://github.com/higgsfield-ai/skills/blob/main/INSTALL.md). Agent-driven install (paste into your agent): [INSTALL_FOR_AGENTS.md](https://github.com/higgsfield-ai/skills/blob/main/INSTALL_FOR_AGENTS.md).5455## Skills5657| Skill | Invoke | Description |58|---|---|---|59| `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. |60| `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. |61| `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`. |62| `higgsfield-marketplace-cards` | `/higgsfield:marketplace-cards` | Marketplace product cards: compliant main image, secondary product images, and A+ style modules via backend prompt enhancement. |63| `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 …`. |6465The 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.6667### Modes6869**`higgsfield-product-photoshoot`** — 10 modes for brand visuals:7071| Mode | What it's for |72|---|---|73| `product_shot` | Product on neutral / studio / catalog background |74| `lifestyle_scene` | Product in a real environment — hands, action, atmosphere |75| `closeup_product_with_person` | Tight crop with hands or partial face — beauty, demonstrating |76| `moodboard_pin` | Vertical 2:3 Pinterest-native pin, moodboard feel |77| `hero_banner` | Wide-format website / email / campaign header |78| `social_carousel` | 3–10 connected slides for IG / LinkedIn / Facebook |79| `ad_creative_pack` | Coordinated pack of static ad variants for Meta / TikTok / Pinterest / Google |80| `virtual_model_tryout` | Product worn or used by an AI-rendered model |81| `conceptual_product` | Surreal / CGI-style / levitating / splash / sculptural product |82| `restyle` | Transform an existing image's aesthetic, mood, or seasonal context |8384**`higgsfield-generate` Marketing Studio** — 9 modes for branded ad video:8586| Mode | What it's for |87|---|---|88| `ugc` | Default. Casual, organic-feel content from a presenter |89| `ugc_how_to` | Tutorial / explainer |90| `ugc_unboxing` | Unboxing reveal |91| `product_showcase` | Clean product highlight, polished |92| `product_review` | Presenter giving an opinion |93| `tv_spot` | Broadcast-style commercial |94| `wild_card` | Experimental, model picks the vibe |95| `ugc_virtual_try_on` | Trying on clothing — UGC vibe |96| `virtual_try_on` | Trying on clothing — polished, model-driven |9798## Quick Reference99100| What you want | Skill | Note |101|---|---|---|102| 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 |103| Generate audio from a prompt | `higgsfield-generate` | Prefers `seed_audio` by default |104| Image with my own face | `higgsfield-soul-id` then `higgsfield-generate` | One-time training, then `--soul-id` |105| Branded product photo (studio / lifestyle / Pinterest / hero / ad pack) | `higgsfield-product-photoshoot` | Mode-specific prompt enhancer + `gpt_image_2` |106| Marketplace product cards / A+ style content | `higgsfield-marketplace-cards` | Main image, secondary images, and A+ style modules with hidden marketplace prompt templates |107| Branded ad video / UGC / unboxing / TV spot | `higgsfield-generate` | Marketing Studio mode with avatars + products + optional hooks/settings |108| 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 |109| Train a custom face identity | `higgsfield-soul-id` | 5–20 photos, returns `reference_id` |110| Image-to-video animation | `higgsfield-generate` | Prefer `seedance_2_0` with `--start-image`; use `kling3_0` as lower-cost fallback |111| 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` |112113## License114115MIT — see [LICENSE](https://github.com/higgsfield-ai/skills/blob/main/LICENSE).