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.
Install / Use
npx skills add higgsfield-ai/skills --skill higgsfield-soul-idInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of higgsfield-soul-id
higgsfield-soul-id scores 87/100 on our quality scale, 2210th of 4,700 Development & Engineering skills we index (top 48%).
Its SKILL.md is 3.5 KB long, well organised into 8 sections with 2 code examples: a solid amount of guidance for an agent.
With 1,120 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so higgsfield-soul-id is actively maintained.
- Our last check on 2026-11-02 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
ReviewOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (1 minor note below). An AI review judged it risky: Line 29 instructs the agent to run `curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh`, which is a remote script piped into a shell.
- noteInstalls by piping a downloaded script into a shellline 29
curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
AI review: risky
- Line 29 instructs the agent to run `curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh`, which is a remote script piped into a shell.
- Because this is a skill/rules file, that command is an instruction for the agent to execute, fitting the 'risky' category of piping a downloaded script into a shell.
- It also grants `Bash` as an allowed tool and has the agent silently install/run third-party code without explicit per-step user approval.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
higgsfield-soul-id compared with similar skills
All 4 of these similar skills score higher than higgsfield-soul-id; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| higgsfield-soul-id (this skill)by higgsfield-ai | 87 | 1.1k | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
Frequently asked questions
- How do I install higgsfield-soul-id?
- Run
npx skills add higgsfield-ai/skills --skill higgsfield-soul-id. The install tabs above show the steps for each supported agent. - Which AI agents does higgsfield-soul-id work with?
- It is written for Zed, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is higgsfield-soul-id safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (1 minor note below). An AI review judged it risky: Line 29 instructs the agent to run
curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh, which is a remote script piped into a shell. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand. - Is higgsfield-soul-id still maintained?
- The repository was last updated about 2 months ago, so higgsfield-soul-id is actively maintained.
Skill content
View source on GitHubversion: 0.13.0
name: 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 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).
argument-hint: "[name] [photo paths...]"
allowed-tools: Bash
Higgsfield Soul Character
Train a face-faithful identity model. Reusable across all Soul-powered generations.
Step 0 — Bootstrap
Before any other command:
- If
higgsfieldis not on$PATH, install it:curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh - If
higgsfield account statusfails withSession expired/Not authenticated, ask the user to runhiggsfield auth login(interactive) and wait for confirmation. - Soul training requires a paid plan (Basic+). If
higgsfield account statusshows free plan, tell the user before submitting.
UX Rules
- Be concise. No raw IDs in chat. Just say "Soul ready" with a name reference.
- Detect language and respond in it. CLI flags stay English.
- Ask for the smallest set of inputs: name + photos. Pick a sensible model variant.
- Polling is silent — training takes minutes. Don't repeat status updates.
Workflow
- Get name. One word, used for later reference. Ask if missing.
- Get photos. 5–20 face photos, varied angles and lighting. Local paths or already-uploaded IDs both work —
--imageaccepts either. - 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.
- Submit.
CLI auto-uploads paths. Captures returned reference id.higgsfield soul-id create --name "<name>" --soul-2 --image ./photo1.png --image ./photo2.png ... higgsfield soul-id create --name "<name>" --soul-2 --image <upload_id> --image <upload_id> ... - Wait.
higgsfield soul-id wait <id>. Silent. Default timeout 30m. - Deliver. "Soul
<name>ready. Use in generate with--soul-id <id>."
Use the Soul
Once trained, pass to higgsfield-generate:
higgsfield generate create text2image_soul_v2 --prompt "..." --soul-id <ref_id> --quality 2k --wait
higgsfield generate create soul_cinematic --prompt "..." --soul-id <ref_id> --quality 2k --wait
--soul-id is sent as the model's custom_reference_id. For a curated Soul style, list styles with higgsfield preset list soul-v2 and pass the chosen id as --style_id on text2image_soul_v2. --style_id cannot be combined with --image.
Listing existing Souls
higgsfield soul-id list # all references
higgsfield soul-id get <id> # 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 bestreferences/troubleshooting.md— common training failures
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
