higgsfield-soul-idlisted
Install: claude install-skill frankxai/claude-skills-library
# 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:
```bash
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.**
```bash
higgsfield soul-id create --name "<name>" --soul-2 --image ./photo1.png --image ./photo2.png ...
higgsfield soul-id