SkillAgentSearch skills...

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-id

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

87/100

Supported Platforms

Zed

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.

Substance
26/30
Structure
18/20
Description
15/15
Adoption
13/20
Freshness
15/15

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

Review

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.

  • 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.

SkillScoreStarsUpdatedFormat
higgsfield-soul-id (this skill)by higgsfield-ai871.1k2mo agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.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.

version: 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:

  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 "<name>" --soul-2 --image ./photo1.png --image ./photo2.png ...
    higgsfield soul-id create --name "<name>" --soul-2 --image <upload_id> --image <upload_id> ...
    
    CLI auto-uploads paths. Captures returned reference id.
  5. Wait. higgsfield soul-id wait <id>. Silent. Default timeout 30m.
  6. 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 best
  • references/troubleshooting.md — common training failures

Related Skills

View on GitHub
GitHub Stars1.1k
CategoryDevelopment
Updated2mo ago
Forks216

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions