higgsfield v0.3.0A

Immutable. This exact content is served forever at /api/v1/blob/65de7ffac31643fd.

---
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

[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
[![Version](https://img.shields.io/badge/version-0.3.0-green.svg)](./VERSION)
[![Skills](https://img.shields.io/badge/skills-5-blueviolet.svg)](#skills)
[![Discord](https://img.shields.io/badge/discord-join-5865F2?logo=discord&logoColor=white)](https://discord.com/invite/higgsfield)

AI 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.

## Install

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

### `npx skills` — recommended, cross-agent

```bash
npx skills add higgsfield-ai/skills
```

### Setup script

Universal fallback:

```bash
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): [INSTALL_FOR_AGENTS.md](./INSTALL_FOR_AGENTS.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 `gpt_image_2`. |
| [`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 |
| `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](./LICENSE).