| name | higgsfield-soul-id |
| version | 0.3.0 |
| description | Use when the user wants to train a reusable face-faithful Soul Character identity
on Higgsfield. One-time training returns a reference_id passed to Soul models in
higgsfield-generate via `--soul-id`.
Use this skill whenever: "train soul character", "create my Soul", "train my face",
"make my digital twin", "build me an avatar", "create a character of me",
"set up identity for video", "I want my face in generated images",
"face-faithful character", "reusable character", "brand character training",
"build a character from photos", "soul training", "soul-id create".
After training, logs the soul_reference_id to `brand/assets.md`.
NOT for: one-shot face swaps (use higgsfield-generate with --image),
fictional/non-photo avatars (use higgsfield-generate with a prompt).
Requires Higgsfield CLI + Basic plan or higher.
|
| argument-hint | [name] [photo paths...] |
| allowed-tools | ["Bash","Read","Write","Edit","Skill"] |
| reads | ["brand/creative-kit.md"] |
| writes | ["brand/assets.md"] |
| author | Higgsfield AI (ported by moiz) |
| license | MIT |
| user-invocable | true |
| metadata | {"openclaw":{"emoji":"🪪"}} |
/higgsfield-soul-id — Train a Reusable Face Identity
Train a face-faithful Soul Character model. Reusable across all Soul-powered image and video generations in higgsfield-generate.
When to use
- User wants their face (or a specific person's face) in Higgsfield-generated images/videos
- "train my soul", "create soul character", "make a digital twin", "brand character training"
- Setting up a reusable identity before a campaign requiring consistent character appearance
- The user has 5–20 photos of a face and wants them persisted as a model reference
Route elsewhere if:
- User just wants a one-shot image with a face reference →
higgsfield-generate with --image
- User wants a fictional/non-photo avatar from a text description →
higgsfield-generate with a prompt
On Activation
- Read
brand/creative-kit.md if present (written by /visual-style) — check for brand character or persona notes.
- Ask for the name to assign to the Soul (one word, used for later reference).
- Ask for photos (5–20 face photos, local paths or upload UUIDs).
- Confirm plan tier: Soul training requires Basic+ plan. Check
higgsfield account status.
Optional dependency — Higgsfield account
This skill requires the @higgsfield/cli binary and a Higgsfield account.
Without the CLI installed, return a clear actionable error:
higgsfield CLI not found. Install with:
curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
Then authenticate:
higgsfield auth login
Without an authed Higgsfield account, the CLI itself surfaces the auth prompt — no special handling needed in the skill.
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). Soul Character training has no fallback — it requires Higgsfield.
Step 0 — Bootstrap
Before any other command:
- If
higgsfield is not on $PATH, install it:
curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
