higgsfield-soul-id — Skills

What it does

--soul-2 — for image generation (default)

--soul-cinematic — for cinematic / video work

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.

references/photo-guide.md — what photos work best

references/troubleshooting.md — common training failures

Train a reusable face identity model for personalized image and video generation.

Source

Repository: https://github.com/higgsfield-ai/skills

higgsfield-soul-id FAQ

What does the higgsfield-soul-id skill do?

| 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_cinema_studio`. NOT for: one-shot face swaps (use higgsfield-generate with --image), named-character / non-photo avatars (use higgsfield-generate with prompt). --soul-2 — for image generation (default) --soul-cinematic — for cinematic / video work

What does higgsfield-soul-id require?

3. Soul training requires a paid plan (Basic+). If higgsfield account status shows free plan, tell the user before submitting. Configuration keys: PATH.

How do I install higgsfield-soul-id?

Run: npx -y skills add https://github.com/higgsfield-ai/skills --skill higgsfield-soul-id --agent claude-code — the source lives at github.com/higgsfield-ai/skills.

Maintain higgsfield-soul-id?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[![higgsfield-soul-id on getagentictools](https://getagentictools.com/badge/skills/higgsfield-ai-skills-higgsfield-soul-id.svg)](https://getagentictools.com/skills/higgsfield-ai-skills-higgsfield-soul-id?ref=badge)

npx agentictools info skills/higgsfield-ai-skills-higgsfield-soul-id

The second line is the CLI lookup for this page — handy in READMEs and docs.