# Higgsfield Soul

> Creates and manages reusable character profiles (Soul IDs) for consistent facial and stylistic identity across multiple image and video generations. Provides identity-vs-motion prompt separation, character sheet creation workflows, micro-expression direction, and Soul Cast AI actor configuration. Use when the user wants to maintain character consistency across multiple generations, asks about Sou…

- **Type:** Skill
- **Install:** `agentstack add skill-osidemedia-higgsfield-ai-prompt-skill-higgsfield-soul`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [OSideMedia](https://agentstack.voostack.com/s/osidemedia)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [OSideMedia](https://github.com/OSideMedia)
- **Source:** https://github.com/OSideMedia/higgsfield-ai-prompt-skill/tree/main/skills/higgsfield-soul
- **Website:** https://higgsfield.ai

## Install

```sh
agentstack add skill-osidemedia-higgsfield-ai-prompt-skill-higgsfield-soul
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Higgsfield Soul ID — Character Consistency

## QUICK FACTS
*Generated-checked block (build_index.py verifies anchors). Read the linked sections for full context — these lines are routing aids, not the rules themselves.*
- Hard rule: every Soul ID prompt splits into Identity Block (static descriptors only) + Motion Block (temporal/camera only) [→](#identity-vs-motion-separation-hard-rule)
- Don't re-describe the face or core features — only describe what differs from the base character [→](#prompting-with-soul-id)
- Reference image rules: front or 3/4 angle, even lighting, neutral-to-slight expression, no blur, solo subject [→](#creating-a-strong-soul-id-reference)
- Reference generators: Soul 2.0 (fashion-forward), Nano Banana Pro (max sharpness), Seedream 4.5 (style range) [→](#creating-a-strong-soul-id-reference)
- Character sheet angles: front face, 3/4, side profile, optional full body + optional embedded prop sheets [→](#character-sheet-creation)
- Prefer the single-prompt 3×2 six-panel sheet (one 16:9 generation) — identity locks better than multi-step assembly [→](#single-prompt-6-panel-character-sheet-32-grid)
- Character Anchor Block = 10 per-shot attributes (identity, screen position, depth layer, frame occupancy, orientation, pose, gaze, contact points, state lock, expression) [→](#character-anchor-block)
- One Soul ID sheet PER character state — 5 transformation stages = 5 distinct sheets; the prompt names the stage [→](#multi-form-state-tracking)
- Micro-expression presets: 9 core + 10 extended [→](#core-set)
- Cinema Studio: identity goes in the @ Element definition, motion goes in the prompt field [→](#beforeafter-examples)
- Soul Cast is Business/Team plans only; 8 parameter categories incl. 12 Archetypes, Budget $10M–$500M, Era 1900s–2020s [→](#cinema-studio-30-soul-cast-businessteam-plan)
- Soul Cast specs: up to 4K (Character/Location modes) / 2K (General); batch 1 or 10; 0.125 credits per image [→](#30-soul-cast-specs)
- Use 2–3 reference shots (frontal, 3/4, side); if features drift, use the character sheet as @Image1 [→](#character-consistency-best-practices)
- Soul Cinema is the default CS 3.0/3.5 image-mode model — single-step, ~0.125 credits/image [→](#soul-cinema-as-the-cs-3035-default-image-model)
- Studio-feeling output is an intermediate, not a final — re-pass through Soul Cinema with grade, directional lighting, lens character [→](#studio-look-vs-cinematic-look-soul-cinema-as-the-re-pass)
- Skip Soul ID for single shots or when you want maximum creative variation [→](#when-to-use-soul-id)
- Plasticky face in wide shots: crop the face from a closer-shot panel and replace it in post [→](#face-from-wide-shot-workaround)

## What Is Soul ID?

Soul ID is Higgsfield's character consistency system. Create a character reference once,
then reuse it across unlimited generations — different scenes, angles, lighting, and
actions — while the face and core appearance remain consistent.

---

## How It Works

1. **Create a Soul ID** — Upload a reference image or generate one using Soul 2.0
2. **The platform stores the character** — assigns it an ID
3. **Reference in future prompts** — "using Soul ID character [name/reference]"
4. **Character stays consistent** — face, skin tone, basic features carry across generations

---

## When to Use Soul ID

✅ You're building a multi-shot sequence with the same character
✅ You're creating a short film / story with a recurring protagonist
✅ You're making an AI influencer or brand mascot
✅ You want consistent faces across a product ad campaign
✅ You're doing a multi-scene action sequence and need the hero to look the same

❌ Don't use if you only need one shot — overkill for single generations
❌ Don't use if you want maximum creative variation — consistency limits style range

---

## Prompting With Soul ID

When a Soul ID character is active, your prompt should:

**1. Reference the character simply:**
```
The Soul ID character walks through a crowded Tokyo street at night.
```

**2. Describe what changes — not what the character looks like:**
```
The Soul ID character now wears a formal black suit. She stands at a podium,
addressing a conference room. Camera: Dolly In toward her face.
Style: Cinematic, cool corporate lighting, 16:9.
```

**3. You can change clothing, setting, expression:**
```
The Soul ID character is now in a red dress, dancing alone in a ballroom.
Camera: 360 Orbit.
Style: Cinematic, warm golden chandelier light.
```

**Key rule:** Don't re-describe the face or core features — the Soul ID handles that.
Only describe what is *different* from the base character.

---

## Identity vs. Motion Separation — Hard Rule

When Soul ID is active, **every prompt MUST be split into two blocks**. This is the
single most important rule for preventing identity drift.

### Identity Block — Static descriptors only
Contains: face features, clothing, body type, distinguishing marks, color palette.
Does NOT contain: any motion, camera, speed, or temporal language.

### Motion Block — Temporal and camera only
Contains: camera movement, action choreography, speed, environmental changes.
Does NOT contain: any character appearance repetition.

### Before/After Examples

**Example 1 — Action scene:**

❌ **Mixed (bad) — causes identity drift:**
```
A tall woman with green eyes and freckles in a leather jacket sprints through
a warehouse while the camera tracks her and her green eyes flash with determination
and her freckles catch the fluorescent light as she vaults over a railing.
```
Face morphs mid-clip because the model re-reads face descriptors while processing motion.

✅ **Separated (good) — identity stays locked:**

**Identity Block:**
```
The Soul ID character — tall build, green eyes, light freckles across the nose
and cheeks, wearing a fitted black leather jacket, dark jeans.
```

**Motion Block:**
```
She sprints through a dimly lit warehouse, vaults over a metal railing
without breaking stride.
Camera: Action Run — low behind her, matching pace.
Fluorescent lights flicker overhead.
Style: Cinematic, cold industrial blue, high contrast. 16:9.
```

---

**Example 2 — Emotional close-up:**

❌ **Mixed (bad) — face warps during camera move:**
```
A weathered man with deep wrinkles and sad brown eyes wearing a grey wool coat
sits on a park bench as the camera slowly dollies in on his wrinkled face and
sad brown eyes while autumn leaves drift past his grey coat.
```

✅ **Separated (good) — face stays sharp:**

**Identity Block:**
```
The Soul ID character — man in his 60s, deep wrinkles, warm brown eyes,
wearing a heavy grey wool coat, brown leather gloves.
```

**Motion Block:**
```
He sits on a park bench, hands folded in his lap, staring at the ground.
A single autumn leaf drifts into frame and lands on the bench beside him.
Camera: slow Dolly In toward his face.
Style: Cinematic. Overcast diffused light, muted earth tones. 16:9.
```

---

**Example 3 — Cinema Studio (@ Elements):**

❌ **Mixed (bad) — identity in the prompt field:**
```
@Sarah with her dark curly hair and tattoo sleeve walks into the bar.
```

✅ **Separated (good) — identity in the Element, motion in the prompt:**

**@ Element definition (set in Cinema Studio UI):**
```
@Sarah: dark curly hair, tattoo sleeve on left arm, wearing a vintage band tee.
```

**Prompt field:**
```
@Sarah pushes open the door and steps inside. She scans the room, then walks
to the far end of the bar. The bartender nods.
```

### Which descriptors belong where

| Identity Block | Motion Block |
|---------------|-------------|
| Face shape, skin tone, eye color | Camera movement name |
| Hair style, color, length | Action verbs (runs, turns, sits) |
| Body type, height, build | Environmental motion (wind, rain, lights) |
| Clothing, accessories, jewelry | Speed and timing cues |
| Scars, tattoos, distinguishing marks | Atmospheric changes (light shifts, fog) |
| Color palette of the character | Style and color grade of the scene |

---

## Creating a Strong Soul ID Reference

The quality of your Soul ID reference image determines consistency quality.

**For best results:**
- Use a **front-facing or 3/4 angle** portrait — full face visible
- **Even lighting** — avoid harsh shadows obscuring features
- **Neutral to slight expression** — smile is fine, extreme emotion limits flexibility
- **Clear image** — no blur, no obstruction, no glasses if avoidable
- **Solo subject** — no other people in the reference frame

**Image models to generate your Soul ID reference:**
- **Soul 2.0** — best for fashion-forward, high-aesthetic characters
- **Nano Banana Pro** — best for maximum photorealistic sharpness
- **Seedream 4.5** — good for a range of styles

---

## Character Sheet Creation

A **character sheet** is a multi-angle reference image showing the same character from
several viewpoints — typically front, 3/4, side profile, and back. It gives the model
comprehensive geometry to work from and dramatically improves consistency.

**How to create a character sheet:**
1. Generate your character in Cinema Studio using your preferred optical stack
2. Use **Grid Generation (2×2 or 4×4)** to produce multiple variations
3. Alternatively, use **3D Mode (Gaussian splatting)** to orbit a single generation and
   capture front, side, and 3/4 angles
4. Arrange the best angles into a single composite reference image
5. Upload as your Soul ID reference

**What to include on a character sheet:**
- **Front face** — neutral expression, even lighting
- **3/4 angle** — shows depth of facial features
- **Side profile** — nose, jaw, ear structure
- **Full body** (optional) — posture, costume, proportions
- **Embedded prop sheets** (optional) — bake recurring character
  props directly into a character-sheet panel. Higgsfield image
  generation handles multi-element character images well, so prop
  continuity often holds without a separate prop sheet. For props
  that don't hold this way, see § Tricky-Prop Sheets below.

**Prompt pattern to generate character sheet content:**
```
Front-facing portrait of [character description], neutral expression, even studio lighting,
clean background. Head and shoulders visible.
```
Then use 3D Mode to orbit and capture additional angles from the same generation.

**Why it matters:** A multi-angle character sheet gives Soul ID far more geometry data
than a single photo. This translates directly into better consistency across extreme
angle changes, action shots, and profile views.

### Single-prompt 6-panel character sheet (3×2 grid)

An alternative to the multi-step assembly above is generating
the entire character sheet in **one prompt → one 16:9 image →
3×2 grid with six labeled panels**. Same character described
once; identity stays maximally locked across all six panels
because the generation pass is single. Prefer this for Soul ID
reference work when the image model supports a 16:9 grid layout
(Nano Banana Pro and similar grid-capable models).

The six panels in canonical order:

- **Panel 1 — Front body:** straight-on neutral stance, full
  styling visible head-to-toe
- **Panel 2 — 3/4 turn:** body angled ~30° from camera, weight
  on back hip
- **Panel 3 — Back body:** straight back view, hair fall and
  accessory details from behind
- **Panel 4 — Waist-up portrait:** head, shoulders, upper torso
- **Panel 5 — Hands detail close-up:** both hands forward, ring
  stack, nail finish, any held prop
- **Panel 6 — Face detail close-up:** tight crop from collarbone
  up, earrings, lips, skin texture, eyes

**Prompt pattern** — identity described once at the opening,
followed by panel position labels with what's different per
panel (stance, framing, focus). Close with: "Identical character
identity locked across all six panels. Uniform studio backdrop
and lighting across all six panels."

**Why single-prompt over multi-step:** the multi-step assembly
above (Grid Generation + 3D Mode + composite) produces a sheet
from multiple independent generations — identity can drift
panel-to-panel even with a strong reference. The single-prompt
3×2 grid keeps identity locked because all six panels render
together in one pass.

---

## Character Anchor Block

Where § Character Sheet Creation builds the multi-angle identity
reference that goes into Soul ID, the **Character Anchor Block**
is the per-shot prompt structure that locks how that character
appears IN a specific shot. The character sheet is build-time; the
anchor block is shot-time.

A complete anchor block names, per character in frame, ten
attributes:

1. **Identity** — which character this is (matches a Soul ID
   handle when references are present)
2. **Screen position** — qualitative anchor + percentage notation
   paired per `../higgsfield-seedance/SKILL.md` § Frame Coordinate
   System
3. **Depth layer** — foreground / midground / background
4. **Frame occupancy** — % of frame area the character fills
5. **Body orientation** — direction the character faces (toward
   camera, away, profile-left, profile-right, three-quarter)
6. **Pose** — current physical configuration (standing, seated,
   leaning, mid-stride)
7. **Gaze direction** — where the character is looking, named
   either by frame-position or by another subject (`looking at
   Character B`)
8. **Contact points** — what physical surface or object the
   character is grounded against
9. **State lock** — current emotional or physical state (calm,
   exhausted, injured, soaked, in motion) — see § Multi-Form State
   Tracking for state-across-scenes discipline
10. **Facial expression** — specific emotional register (composed,
    fearful, smiling small, gritted teeth)

The block sits before the Dynamic Description in the Seedance
output format and feeds a Spatial Layout Block when multiple
characters share frame (see `../higgsfield-seedance/SKILL.md`
§ Spatial Layout Block for the multi-character extension).

### Multi-Form State Tracking

When a character changes state across the project — wounds from a
fight scene that persist into the next scene, a costume change
midway through, a transformation across multiple stages — generate
a **separate anchor sheet per state**. Don't rely on the base
character sheet plus prompt-text descriptions to track the
difference; the model loses the state under iteration pressure.

The discipline is what film production calls **script supervising**:
every shot tracks which version of the character it should match. A
character with five stages (initial → fight-injuries → partially-
transformed → almost-fully → completely-transformed) gets five
distinct Soul ID sheets, one per stage. The shot list references
the matching sheet by name; the prompt names the stage in the
identity block.

The cost is one character-sheet generation pass per state; the
payoff is that no shot opens a continuity bug that has to be caught
at frame-review time (see `../higgsfield-seedance/FAILURE-MODES.md`
§ Frame-level review is mandatory).

### Face-from-Wide-Shot Workaround

In wide shots the face on a character-sheet panel often reads as
plasticky — the model deprioritizes facial detail when most of the
frame is body or environment. The workaround: render the wide shot,
then crop the **face** from a **closer shot** (medium-up, shoulders-
up, head-and-shoulders) and replace the wide-shot face with the
cropped one in post.

This is a character-sheet construction technique, not a generation
technique. Keep one closer-shot panel in the character sheet
specifically for this purpose — the face you'd cut and paste back
into wide shots that need it.

### Tricky-Prop Sheets

Some props don't generate consistently from a single reference panel
— a monster claw the model keeps rendering as a sword, a hand-prop
that defaults to a generic shape, an accessory that can't stay
continuous across shots. For these, build a **separate prop sheet**
alongside the character sheet:

- **Inside view** — interior structure or assembly detail
- **Outside view** — silhouette and surface
- **State variatio

…

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [OSideMedia](https://github.com/OSideMedia)
- **Source:** [OSideMedia/higgsfield-ai-prompt-skill](https://github.com/OSideMedia/higgsfield-ai-prompt-skill)
- **License:** MIT
- **Homepage:** https://higgsfield.ai

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-osidemedia-higgsfield-ai-prompt-skill-higgsfield-soul
- Seller: https://agentstack.voostack.com/s/osidemedia
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.