Higgsfield Soul ID Skill for Claude: Train a Face-Faithful Character

Trains a Soul Character, a reusable model of your face on Higgsfield, so later images and videos keep your likeness.

Installs: 203.6K; on skills.sh
Stars: 1.8K; on GitHub
Files: 2; besides SKILL.md
Updated: Oct 2026; last repo commit

higgsfield-soul-id has Claude train a personalized face model on Higgsfield, called a Soul Character, from 5 to 20 of your photos. You get back a reference id that Higgsfield's Soul-aware models use to keep generated images and video faithful to the person.

It triggers on requests like "train my face" or "make my digital twin". It needs the higgsfield command-line tool signed in to your account, and Soul training needs a paid plan (Basic or above). To use the finished Soul, SKILL.md points to the higgsfield-generate skill from the same repo. Two reference files cover photo choice and training failures.

Good for

Creators who want their own face in AI images and video
Brands building a consistent character or avatar
Anyone setting up a digital twin on Higgsfield

Install higgsfield-soul-id

Claude Code

Copy this prompt.

Install the higgsfield-soul-id skill in Claude Code. Run this command:

npx skills add higgsfield-ai/skills

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The README says each install method also handles the Higgsfield CLI install and sign-in as part of skill setup. It lists gh skill install (GitHub CLI 2.90 or newer) and a setup script as other routes. All routes take the whole repo; the README lists 9 skills.

From the project README. Source.

What's in the skill

When it loads

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 Soul", "train my face", "make my digital twin", "build me an avatar", "learn my appearance", "create a character of me", "set up identity for video", "I want my face in generated images". Chain: train Soul (one-time, returns reference_id) → use in higgsfield-generate via `--soul-id <id>` with models like `text2image_soul_v2` or `soul_cinematic`. NOT for: one-shot face swaps (use higgsfield-generate with --image), named-character / non-photo avatars (use higgsfield-generate with prompt).

Sections in SKILL.md

Step 0 — Bootstrap
UX Rules
Workflow
Use the Soul
Listing existing Souls
Errors
Reference docs

Key facts

Author: Higgsfield AI (higgsfield-ai)
Repository: higgsfield-ai/skills
Installs on skills.sh: 203,630 (crawled 2026-11-02)
GitHub stars: 1,843 (whole repo)
License: MIT
Last repo commit: 2026-10-27
Files in the skill folder: 3 files: SKILL.md, references/photo-guide.md and references/troubleshooting.md. No scripts.
skills.sh audits: Gen Agent Trust Hub: fail, Socket: pass, Snyk: pass
Works in (per README): Claude Code, Cursor, Codex and other agents that load Markdown-based skills

What it includes

Installs the higgsfield CLI if missing, checks sign-in, warns on a free plan
Runs code · Step 0: Bootstrap
One-word name and 5 to 20 face photos at varied angles and lighting
Get name and photos
--soul-2 for images (default) or --soul-cinematic for cinematic or video work
Pick a variant
Uploads your photos and starts training; returns a reference id
Runs code · higgsfield soul-id create
Waits silently for training; default timeout 30 minutes
Network · higgsfield soul-id wait
Lists your Souls or shows one by id
Network · higgsfield soul-id list / get
Pass --soul-id to higgsfield generate with Soul models; handled by higgsfield-generate
Network · Use the Soul

From the official docs

Permissions

Medium risk

It uploads photos of a real face to Higgsfield and may install a command-line tool from the internet. Use photos you are happy to share with Higgsfield, and install the CLI yourself first if you prefer.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Your face photos go to Higgsfield
The CLI auto-uploads the local photos you pass in. Use only photos you have the right to use, and check Higgsfield's retention terms.
It installs a CLI from the internet if missing
If `higgsfield` is not on your PATH, SKILL.md has Claude run the official install script from raw.githubusercontent.com. Install the CLI yourself first if you want to read it.
Training needs a paid plan
SKILL.md says Soul training requires Basic or above and that Claude should say so before submitting.
Every install route takes the whole repo
npx skills add higgsfield-ai/skills, gh skill install and the Claude Code plugin all install every skill in the repo, and the README says setup also installs the Higgsfield CLI and signs you in. There is no single-skill command in the README.

Technical details

Talks to	Higgsfield (photo upload, training). raw.githubusercontent.com (CLI installer, if missing)
Sign-in and keys	Sign-in is done by you with `higgsfield auth login`. SKILL.md does not say where the CLI keeps the session.
Scopes	Your Higgsfield account (paid plan for Soul training)

Questions

What does higgsfield-soul-id do?

It trains a Soul Character: a model of your face that Higgsfield uses for identity-faithful image and video generation. You give it a name and 5 to 20 photos, and it returns a reference id for later generations.

How do I install it?

Use the install box at the top of this page. The README says each install method also handles the Higgsfield CLI install and sign-in as part of skill setup, and lists npx skills, gh skill install, a Claude Code marketplace and a setup script.

Do I need a paid Higgsfield plan?

Yes for training. SKILL.md says Soul training requires a paid plan (Basic or above) and has Claude tell you before submitting if your account is on the free plan.

Do I need the higgsfield-generate skill?

Not to train a Soul. To use it, SKILL.md says to pass the reference id to higgsfield-generate with --soul-id. That skill is in the same repo.

Is it safe to upload my photos?

The CLI uploads the photos you give it to Higgsfield, so read Higgsfield's own privacy terms first. The skill bundles no scripts. It also has Claude install the Higgsfield CLI with a curl script if it is missing.

What is it not for?

One-shot face swaps and named or non-photo characters. SKILL.md sends those to higgsfield-generate.

Information

updated Nov 2, 2026

Repository: higgsfield-ai/skills
Folder: higgsfield-soul-id

higgsfield-ai/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

higgsfield-ai/skills README · github.com
INSTALL.md · github.com
higgsfield-soul-id SKILL.md · github.com