higgsfield-generate
starsforks
How to install higgsfield-generate?
moizibnyousaf/marketing-cli/higgsfield-generate
$npx -y skills add MoizIbnYousaf/marketing-cli --skill higgsfield-generateUse when the user wants to generate an image or video via Higgsfield AI. Covers 30+ models: Soul V2, Seedance 2.0, Kling 3.0, Veo 3.1, GPT Image 2, Nano Banana 2. Also covers Marketing Studio — branded ad video/image with avatars and products. Use whenever: "generate an image", "
SKILL.md
| 1 | # /higgsfield-generate — AI Image & Video Generation via Higgsfield |
| 2 | |
| 3 | Submit jobs to any Higgsfield model. Wraps the `higgsfield` CLI. Covers generic image/video gen and Marketing Studio (branded ads, avatars, products). |
| 4 | |
| 5 | ## When to use |
| 6 | |
| 7 | - User wants an image or video generated by AI — any model, any style |
| 8 | - "animate this photo", "make a video from an image", "img2vid" |
| 9 | - "create a UGC ad", "Marketing Studio video", "brand video with avatar" |
| 10 | - "import this product URL and make an ad" |
| 11 | - "generate a cinematic still", "make a character illustration" |
| 12 | - Anything involving Seedance, Kling, Veo, Soul, Nano Banana, Flux, GPT Image |
| 13 | |
| 14 | **Route elsewhere if:** |
| 15 | - User wants to train a reusable face identity → `higgsfield-soul-id` |
| 16 | - User wants a mode-enhanced product photoshoot → `higgsfield-product-photoshoot` |
| 17 | - User just needs a one-off image without Higgsfield → `image-gen` (Gemini, free tier) |
| 18 | |
| 19 | ## On Activation |
| 20 | |
| 21 | 1. Read `brand/voice-profile.md`, `brand/visual-style.md`, and `brand/creative-kit.md` if present. Use brand context to inform model choice and prompt style where relevant. All files are optional — zero-context operation is fine. |
| 22 | 2. Check CLI: `higgsfield account status`. If not on `$PATH`, surface install command (see Optional dependency section). If session expired, prompt auth. |
| 23 | 3. Pick a model from the workflow below. Ask one question at a time if context is missing. |
| 24 | |
| 25 | ## Optional dependency — Higgsfield account |
| 26 | |
| 27 | This skill requires the `@higgsfield/cli` binary and a Higgsfield account. |
| 28 | |
| 29 | **Without the CLI installed**, return a clear actionable error: |
| 30 | ``` |
| 31 | higgsfield CLI not found. Install with: |
| 32 | curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh |
| 33 | Then authenticate: |
| 34 | higgsfield auth login |
| 35 | ``` |
| 36 | |
| 37 | **Without an authed Higgsfield account**, the CLI itself surfaces the auth prompt — no special handling needed in the skill. |
| 38 | |
| 39 | **Fallback for image generation only:** if the user just needs a one-off image and doesn't have a Higgsfield account, route them to `image-gen` (Gemini, model `gemini-3.1-flash-image-preview`, free tier). Video generation, Marketing Studio, Soul Characters, and product modes have no fallback — they require Higgsfield. |
| 40 | |
| 41 | ## Step 0 — Bootstrap |
| 42 | |
| 43 | Before any other command, make sure the CLI is installed and authenticated: |
| 44 | |
| 45 | 1. If `higgsfield` is not on `$PATH`, install it: |
| 46 | ```bash |
| 47 | curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh |
| 48 | ``` |
| 49 | 2. If `higgsfield account status` fails with `Session expired` / `Not authenticated`, ask the user to run `higgsfield auth login` (interactive, opens a browser) and wait for them to confirm before continuing. |
| 50 | |
| 51 | Skip both checks if `higgsfield account status` already prints account info. |
| 52 | |
| 53 | ## UX Rules |
| 54 | |
| 55 | 1. Be concise. No raw IDs, no JSON dumps in chat. Print result URL when ready. |
| 56 | 2. No internal jargon. Don't narrate "calling higgsfield cost", "polling job". |
| 57 | 3. Detect the user's language from the first message and reply in it. Technical args (`--aspect_ratio 16:9`) stay English. |
| 58 | 4. Don't batch-ask. Pick a sane default model and ask one thing at a time only if genuinely missing. |
| 59 | 5. Don't pre-estimate cost. Just submit unless the user asks. |
| 60 | 6. Pass `--wait` to `generate create` so the command blocks until done and prints the result URL itself. Avoid the two-step `create` → `wait` pattern. |
| 61 | |
| 62 | ## Workflow — generic generation |
| 63 | |
| 64 | 1. **Pick a model.** Practical defaults from production use: |
| 65 | |
| 66 | **Image:** |
| 67 | - Brand product visual (Pinterest pin, lifestyle, hero banner, ad pack, virtual try-on) → use `higgsfield-product-photoshoot` instead. NOT this skill. |
| 68 | - Branded ad image with avatar + product (Marketing Studio shape) → Marketing Studio Image (see Marketing Studio below) |
| 69 | - Aesthetic UGC / fashion editorial / lifestyle character → So |
People who liked this also viewed
6 picksType
- ai-video-generationinference.sh Agent skills for using our API to give your agents access to hundreds of apps and other agentsSkillsJul 2026
- imagegen-frontend-webElite frontend image-direction skill for generating premium, conversion-aware website design references. CRITICAL OUTPUT RULE — generate ONE separate horizontal image FOR EVERY section. A landing pageSkillsJul 2026
- hyperframes-mediaWrite HTML. Render video. Built for agents.SkillsJul 2026
- media-useAgent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + leSkillsJul 2026
- general-videoAuthor or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, staticSkillsJul 2026
- product-launch-videoTurn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market,SkillsJul 2026
