Menu

Individual skill

higgsfield

Generate images and video through the Higgsfield MCP - text-to-image, text-to-video, and image-to-video with motion control across 100+ models. Generation draws real credits from the connected Higgsfield account; OAuth Connect via the dashboard MCP panel.

skills/higgsfield/SKILL.md

Read pinned source

Source commit 25575a6be3bfab41925964de55654056a2fe0c39

What was checked

Matches the observed repository HEAD
Yes
Scanner rules are current
No
Repository scan complete
No
Skill scan complete
No
Observed behavior
Not checked yet
Last checked
Nov 6, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings)
789
Repository last updated
Nov 7, 2026
License
MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files
Read excerpt
> **${var}** — the generation request. **Required.** Prefix picks the mode:
> - `image: <prompt>` (or a bare `<prompt>`) → text-to-image
> - `video: <prompt>` → text-to-video
> - `animate: <image-url> | <motion prompt>` → image-to-video (motion control)
>
> Optional trailing hints are honoured when the server supports them: `--ar 16:9` / `--ar 9:16` (aspect ratio), `--seconds N` (video duration), `--n K` (output count, capped below), `--model <name>`. If empty, log `HIGGS_NO_PROMPT` and exit cleanly — **no notify**. This skill spends credits, so it never fires on a blank/default run.

Generate visual media through the **Higgsfield** MCP server (`mcp.higgsfield.ai/mcp`): text-to-image, text-to-video, and image-to-video with motion control, across Higgsfield's library of 100+ generative models. **Every generation consumes real credits from the operator's Higgsfield account** — spend is irreversible, so the run is prompt-gated and bounded.

## Detection & auth

The server is wired by the dashboard MCP panel's one-click **Connect** (OAuth, Authorization Code + PKCE with `offline_access`; tokens stored as `MCP_HIGGSFIELD_TOKEN` + `MCP_HIGGSFIELD_OAUTH`, refreshed each run by `scripts/mcp-oauth-refresh.sh`). Its tools surface as `mcp__higgsfield__*` — discover them from the server; the tool descriptions are the source of truth, don't assume a fixed list or invent model names.

- **No `mcp__higgsfield__*` tool callable** → the server isn't connected (or its secrets are missing, in which case the workflow logged a `::warning::` and skipped MCP). Log `HIGGS_NOT_CONNECTED`, notify once pointing the operator at the dashboard → MCP → Connect Higgsfield, and exit. Don't try to reach the API with curl — there is no static key.
- **Tools exist but return 401/invalid-token** → the OAuth refresh failed (rotating refresh tokens need `GH_SECRETS_PAT` — see `docs/mcp-oauth.md`). Log `HIGGS_AUTH_STALE`, notify the operator to re-connect the server once in the dashboard, and exit. Don't retry the same call more than twice.