Higgsfield / aeon skill

AI agent for image and video generation

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.

CATEGORY ProductivityRUNS On demandUPDATED
Skill
Higgsfield higgsfield
Category
Productivity
Default schedule
On demand
Last updated

commit ef04cf1
Source
aeonfun/aeon/skills/higgsfield/SKILL.md MIT licensed, one prompt file

What it does

Higgsfield is an aeon skill: 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. Like every aeon skill it is one SKILL.md prompt file that runs unattended on your own GitHub Actions, on a schedule or when you trigger it, and sends what it finds to Telegram, Discord, Slack or email.

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.

Input: the var setting

Every aeon skill takes one optional text input, var, set in aeon.yml or typed in when you run it by hand. It picks the target or the mode for that run.

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.

What it needs

Besides the model you connected to aeon, Higgsfield uses the following. Add secrets as GitHub Actions secrets on your aeon repo, or in Aeon Connect.

  • higgsfield MCP server - required, connect it once from the dashboard MCP panel (OAuth)

Install and run it

Easiest: open Aeon Connect, sign in with GitHub and turn on Higgsfield. No clone, no terminal. To add it to an existing aeon repo from a shell, run:

bin/add-skill aeonfun/aeon higgsfield

Then switch it on in aeon.yml (the default schedule is filled in):

skills:
  higgsfield: { enabled: true, schedule: "workflow_dispatch", var: "" }

New to aeon? Read the docs for how skills, schedules and memory fit together, or browse all skills.