Install
$ agentstack add skill-osidemedia-higgsfield-ai-prompt-skill-higgsfield-soul ✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
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
- Create a Soul ID — Upload a reference image or generate one using Soul 2.0
- The platform stores the character — assigns it an ID
- Reference in future prompts — "using Soul ID character [name/reference]"
- 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:
- Generate your character in Cinema Studio using your preferred optical stack
- Use Grid Generation (2×2 or 4×4) to produce multiple variations
- Alternatively, use 3D Mode (Gaussian splatting) to orbit a single generation and
capture front, side, and 3/4 angles
- Arrange the best angles into a single composite reference image
- 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:
- Identity — which character this is (matches a Soul ID
handle when references are present)
- Screen position — qualitative anchor + percentage notation
paired per ../higgsfield-seedance/SKILL.md § Frame Coordinate System
- Depth layer — foreground / midground / background
- Frame occupancy — % of frame area the character fills
- Body orientation — direction the character faces (toward
camera, away, profile-left, profile-right, three-quarter)
- Pose — current physical configuration (standing, seated,
leaning, mid-stride)
- Gaze direction — where the character is looking, named
either by frame-position or by another subject (looking at Character B)
- Contact points — what physical surface or object the
character is grounded against
- State lock — current emotional or physical state (calm,
exhausted, injured, soaked, in motion) — see § Multi-Form State Tracking for state-across-scenes discipline
- 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
- Source: OSideMedia/higgsfield-ai-prompt-skill
- License: MIT
- Homepage: https://higgsfield.ai
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet — be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.