| name | consulting-higgsfield |
| description | Generate AI media for content by driving the Higgsfield CLI — photoreal or cinematic IMAGES, AI VIDEO / b-roll, branded PRODUCT shots, a face-consistent AI CHARACTER/avatar ("Soul"), and AI VOICEOVERS. Use on "generate an image/photo/video with Higgsfield", "make a photorealistic / cinematic / AI-generated visual", "AI b-roll", "product photoshoot", "make an AI avatar / a recurring character", "AI voiceover", or whenever content needs *generated pixels* that can't be drawn in HTML/CSS. NOT for typographic/designed stills (quote cards, frameworks, stat cards, carousels, thumbnails, OG images) → use consulting-graphics; NOT for HTML-rendered/deterministic video (explainers, captions, motion-type, slideshows) → use consulting-hyperframes-video. Bills credits (paid) — always preview cost first. |
Consulting Higgsfield
Generative AI media for the content flywheel. Where consulting-graphics designs a still (HTML → PNG,
pixel-perfect text) and consulting-hyperframes-video renders video from HTML, Higgsfield generates
pixels from a prompt — photoreal scenes, cinematic video, a face-consistent character, product
photography, voiceover — the imagery you can't author by hand.
The Higgsfield CLI is the client (browser auth, bills credits). Command reference, auth, and cost
mechanics live in integrations/higgsfield/AGENTS.md — read it; don't restate it here.
Route first — is this even a Higgsfield job?
| The content needs… | Use | Why |
|---|
| A quote card, framework, stat card, carousel, thumbnail, OG image, banner — anything typographic / designed | consulting-graphics | AI models render text unreliably; HTML gives pixel-perfect, on-brand type |
| An explainer, captioned clip, kinetic-type / motion graphic, slideshow — HTML-rendered video | consulting-hyperframes-video | Deterministic, brand-driven, text-perfect |
| A photoreal / cinematic / illustrative image, AI video / b-roll, a product shot, a recurring AI character, an AI voiceover | this skill | Only generative AI can make pixels that don't exist yet |
The power move is the combo: generate the imagery in Higgsfield → add the text + branding on top
with consulting-graphics (HTML overlay). Never bake headline copy into an AI generation — the type won't
be on-brand or reliably legible.
Prerequisite
CLI installed + authed — higgsfield account status shows the plan + credits. If it errors with
Not authenticated, the user runs higgsfield auth login (browser; can't be automated). Full setup and
the command cheat-sheet → integrations/higgsfield/AGENTS.md.
Workflow
- Confirm the brief + load the brand. What's the asset, where does it go, what should it feel like?
Pull look-and-feel from
consulting-tasteful-design (it carries DESIGN.md — palette, mood, the
anti-AI-slop bar) and voice from consulting-copy-writer. Encode brand mood/palette into the prompt;
for anything the brand canon doesn't cover, ask — don't invent.
- Pick the model from the live catalog — never invent a name.
higgsfield model list (--video to
filter) is the source of truth. Match the model to the job (image vs video vs voice vs product/marketing).
- Write the prompt. Specific subject, composition, lighting, mood, palette (from
DESIGN.md), and
aspect ratio. Pass reference images with --image <path|uuid> (a local path auto-uploads). Keep text
out of the image.
- Preview cost — every time (money).
higgsfield generate cost <model> --prompt "…", and check
higgsfield account status for balance. State the credit cost to the user before any paid run.
- Generate.
higgsfield generate create <model> --prompt "…" [--image <id>] --wait (blocks, prints
the result URL). Add --json to parse. Image gen can take a couple minutes; video longer.
- Land the raw result. Download into the gitignored
integrations/higgsfield/_work/ —
curl -fsSL "<url>" -o integrations/higgsfield/_work/YYYY-MM-DD-<slug>.png (or .mp4).
- Finish + brand (usually a handoff). Needs text/logo/framing → pass the generated image to
consulting-graphics as a background and overlay branded type. A clip for a post →
consulting-hyperframes-video can package it with captions/overlays.
- Promote keepers →
content/. Move only what you'll use into the draft's folder (or content/_work/
while staging; content/04-published/ once shipped). The repo isn't the archive — Higgsfield's cloud keeps
job history (higgsfield generate list).
- Publish. Hand the final asset + caption to
consulting-linkedin-publisher (Postbridge). Never
auto-send — confirm the final creative + copy first.
Soul characters (a consistent brand persona)
To reuse the same AI person across many posts (a recurring face, a mascot, Sid-as-avatar): train a
Soul once with higgsfield soul-id …, then reference it in later generations for a consistent look.
Training is an expensive, gated lane — confirm the spend and the reference images with the user before
running it. See integrations/higgsfield/AGENTS.md and higgsfield soul-id create --help.
Cost discipline (paid — non-negotiable)
- Preview before every spend (
generate cost); after a paid run, cite the actual credit cost —
quote the real number from the CLI, don't estimate (evidence discipline).
- Gate the expensive lanes — video + Soul training — behind explicit user go-ahead. Iterate the look on
a cheap image model first, then commit to the costly render.
- Never loop generations unattended — each
create bills credits.
Don't
- Don't bake headline / marketing text into the AI image — overlay it with
consulting-graphics.
- Don't invent model names —
higgsfield model list is the source of truth.
- Don't commit raw media to git — it lives in gitignored
_work/; promote only keepers to content/.
- Don't auto-publish — confirm the final creative + caption before
consulting-linkedin-publisher sends.
