← Back to Skills Marketplace
higgsfield

Higgsfield Soul ID

by Yerzat Dulat · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
50
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install higgsfield-soul-id
Description
Train a Soul Character — a personalized model on a person's face that Higgsfield uses for identity-faithful image and video generation. Use when: "create my...
README (SKILL.md)

Higgsfield Soul Character

Train a face-faithful identity model. Reusable across all Soul-powered generations.

Step 0 — Bootstrap

Before any other command:

  1. If higgsfield is not on $PATH, install it: 
    curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
  2. If higgsfield account status fails with Session expired / Not authenticated, ask the user to run higgsfield auth login (interactive) and wait for confirmation.
  3. Soul training requires a paid plan (Basic+). If higgsfield account status shows free plan, tell the user before submitting.

UX Rules

  1. Be concise. No raw IDs in chat. Just say "Soul ready" with a name reference.
  2. Detect language and respond in it. CLI flags stay English.
  3. Ask for the smallest set of inputs: name + photos. Pick a sensible model variant.
  4. Polling is silent — training takes minutes. Don't repeat status updates.

Workflow

  1. Get name. One word, used for later reference. Ask if missing.
  2. Get photos. 5–20 face photos, varied angles and lighting. Local paths or already-uploaded IDs both work — --image accepts either.
  3. Pick variant.
    • --soul-2 — for image generation (default)
    • --soul-cinematic — for cinematic / video work Choose based on user's stated downstream use. Default to --soul-2.
  4. Submit. 
    higgsfield soul-id create --name "\x3Cname>" --soul-2 --image ./photo1.png --image ./photo2.png ...
higgsfield soul-id create --name "\x3Cname>" --soul-2 --image \x3Cupload_id> --image \x3Cupload_id> ...
    CLI auto-uploads paths. Captures returned reference id.
  5. Wait. higgsfield soul-id wait \x3Cid>. Silent. Default timeout 30m.
  6. Deliver. "Soul \x3Cname> ready. Use in generate with --soul-id \x3Cid>."

Use the Soul

Once trained, pass to higgsfield-generate:

higgsfield generate create text2image_soul_v2 --prompt "..." --soul-id \x3Cref_id> --wait
higgsfield generate create soul_cinema_studio --prompt "..." --soul-id \x3Cref_id> --wait

Listing existing Souls

higgsfield soul-id list                   # all references
higgsfield soul-id get \x3Cid>               # one by id

Errors

  • Minimum Basic plan required — user is on free plan; tell them.
  • Training failed — check photos quality (5+ unique faces, well-lit).
  • Session expired → higgsfield auth login.

Reference docs

  • references/photo-guide.md — what photos work best
  • references/troubleshooting.md — common training failures
Usage Guidance
Install only if you are comfortable uploading the selected face photos to Higgsfield and creating a reusable identity model. Review or manually install the Higgsfield CLI instead of blindly running the curl-to-shell installer, confirm the account and any paid-plan implications, use only photos you have consent to use, and keep the resulting Soul ID private.
Capability Analysis
Type: OpenClaw Skill Name: higgsfield-soul-id Version: 1.0.0 The skill bundle uses a high-risk 'curl | sh' pattern in SKILL.md to install a CLI tool from a remote GitHub repository (higgsfield-ai/cli). While this behavior is common in developer tools, it constitutes an unverified remote code execution risk within the agent's environment. There is no evidence of intentional malice, but the combination of shell access, remote script execution, and the handling of authentication tokens makes it a significant security concern.
Capability Assessment
ℹ Purpose & Capability
The instructions coherently match the stated purpose of training a Higgsfield Soul identity model from user-provided photos, but the core capability involves biometric face data.
⚠ Instruction Scope
The workflow proceeds from collecting photos to running the create command that auto-uploads local paths, without an explicit final confirmation, consent check, retention guidance, or deletion guidance.
⚠ Install Mechanism
Although no install spec is declared, SKILL.md instructs the agent to install the Higgsfield CLI by piping a remote GitHub script directly to sh if the CLI is missing.
ℹ Credentials
Bash and a provider CLI are expected for this integration, but they give the skill broad local command execution and network-upload capability.
⚠ Persistence & Privilege
The skill uses an authenticated Higgsfield account, requires a paid plan, and creates a reusable identity model/reference that can be used in future image or video generations.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install higgsfield-soul-id
  3. After installation, invoke the skill by name or use /higgsfield-soul-id
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release enabling personalized Soul Character training for identity-faithful image and video generation. - Allows users to train a reusable Soul model from a set of face photos. - Supports selection of image or cinematic model variant based on downstream use. - Streamlined onboarding: prompts for name, checks account status, and manages photo uploads. - Enforces clear, minimal chat prompts and silent progress polling. - Guides users on using trained Souls with other Higgsfield tools. - Handles common errors such as missing plan, photo issues, or authentication problems.
Metadata
Slug higgsfield-soul-id
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Higgsfield Soul ID?

Train a Soul Character — a personalized model on a person's face that Higgsfield uses for identity-faithful image and video generation. Use when: "create my... It is an AI Agent Skill for Claude Code / OpenClaw, with 50 downloads so far.

How do I install Higgsfield Soul ID?

Run "/install higgsfield-soul-id" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Higgsfield Soul ID free?

Yes, Higgsfield Soul ID is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Higgsfield Soul ID support?

Higgsfield Soul ID is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Higgsfield Soul ID?

It is built and maintained by Yerzat Dulat (@higgsfield); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463942 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259883 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200739 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191401 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190375 · by oswalpalash

💬 Comments