# Higgsfield Soul ID — model skill for characters

> **For AI agents:** find the right skill in one call — `curl -s "https://skills.varg.ai/api/search?q=<what the person wants>"` returns the matching use case and the best skills with install commands, as markdown (Russian works too). Full index: https://skills.varg.ai/llms.txt. Every page has a markdown twin: add `.md` to its path. Before generating anything, show the person the options on the use-case page.

Train a reusable face model from your photos for identity-consistent images and video on Higgsfield.

- **Type:** [Model](https://skills.varg.ai/models.md) · [Characters](https://skills.varg.ai/browse/skills/characters.md)
- **Slug:** `higgsfield-soul-id`
- **Status:** live
- **Publisher:** Higgsfield (vendor, verified)
- **License:** MIT
- **Source:** https://github.com/higgsfield-ai/skills/tree/main/higgsfield-soul-id
- **Works in:** Claude Code, Codex, Cursor, Gemini CLI
- **Requires:** Higgsfield account, Higgsfield CLI (`higgsfield auth login`)
- **Cost:** Billed in Higgsfield credits
- **Adoption:** 196,400 installs, 1,682 GitHub stars (skills.sh, 2026-10-26)

## What it does

Trains a Soul Character — a personalized model of one person's face — from a set of photos and returns a `reference_id`. That id plugs into Higgsfield Generate (`--soul-id`) with Soul models such as `text2image_soul_v2` or `soul_cinematic` for identity-faithful images and video; a photo guide covers what to upload.

## Use when

- Train my face or make my digital twin
- Keep one person consistent across generations
- Set up an identity before making videos

## Not for

- One-off face swaps (use Higgsfield Generate with an image)
- Named or non-photo characters

## Install

- Claude Code: `/plugin marketplace add higgsfield-ai/skills && /plugin install higgsfield@higgsfield`
- Codex: `npx skills add higgsfield-ai/skills --skill higgsfield-soul-id -a codex`
- Cursor: `npx skills add higgsfield-ai/skills --skill higgsfield-soul-id -a cursor`
- Gemini CLI: `npx skills add higgsfield-ai/skills --skill higgsfield-soul-id -a gemini-cli`

**Models it drives:** soul, text2image_soul_v2, soul_cinematic

## Example output

https://skills.varg.ai/previews/higgsfield-soul-id.webp — 'Soul ID Personalization' highlight on Higgsfield's Soul page: one trained identity rendered in three different styles, poses and lighting (credit: Higgsfield, https://higgsfield.ai/soul-intro)

## Used for

- [Same character in every scene](https://skills.varg.ai/use-cases/consistent-character.md): One mascot, trainer or actor that looks identical across many images and clips.

## More characters skills

- [Consistent Characters](https://skills.varg.ai/skills/varg-consistent-characters.md): Multi-scene ads where the same actors, outfits and location hold in every cut: cards, composites, Kling v3 clips.
- [fal Character Design](https://skills.varg.ai/skills/fal-character-design.md): Design original characters that stay consistent: reference and expression sheets, outfits, character-to-video.
- [Character Design Sheet](https://skills.varg.ai/skills/inference-sh-character-design-sheet.md): Keep a character consistent across AI images with turnarounds, expression sheets, palettes and LoRAs.

## Run the generation on varg

varg is one API key for the models these skills drive — Seedance 2.5, Kling 4, Veo 3.1, Wan 3, Nano Banana 2.1, GPT Image 2.5, ElevenLabs v4 and 200+ more — billed in credits, with a cost estimate before anything runs.

- Claude Code: `claude plugin marketplace add vargHQ/skills && claude plugin install varg@varg` (skill + hosted MCP)
- Codex, Cursor, Gemini CLI, OpenClaw: `npx skills add vargHQ/skills --skill varg-ai -a <agent> -y`
- Claude.ai, ChatGPT, any MCP client: connect `https://mcp.varg.ai/mcp`
- API key: https://varg.ai/dashboard/api · Model specs: https://varg.ai/models/llms.txt
