SKILL.md
Higgsfield AI Skills
[](./LICENSE) [
](./VERSION) [
](#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](./INSTALL.md). Agent-driven install (paste into your agent): [INSTALLFORAGENTS.md](./INSTALLFORAGENTS.md).
Skills
| Skill | Invoke | Description |
|---|---|---|
[higgsfield-generate](./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) |
/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) |
/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 gptimage2. |
[higgsfield-marketplace-cards](./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) |
/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 |
closeupproductwith_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 |
adcreativepack |
Coordinated pack of static ad variants for Meta / TikTok / Pinterest / Google |
virtualmodeltryout |
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 |
ugchowto |
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 |
ugcvirtualtry_on |
Trying on clothing — UGC vibe |
virtualtryon |
Trying on clothing — polished, model-driven |
Quick Reference
| What you want | Skill | Note |
|---|---|---|
| Generate any image / video from a prompt | higgsfield-generate |
Prefers gptimage2 / nanobanana2 for images and seedance20 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 + gptimage2 |
| 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 seedance20 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](./LICENSE).