Skip to content
Back to search

higgsfield

Writes and refines prompts for Higgsfield AI's video and image models, and picks the model, camera controls and motion presets for each shot. Use whenever the user asks anything about Higgsfield AI — writing or refining video/image prompts, choosing a model (Kling, Veo, Wan, Seedance, Minimax Hailuo, DoP, Soul, Nano Banana, Seedream, Flux, GPT Image, etc.), camera controls, named motion presets, Soul ID character consistency, Cinema Studio 2.5/3.0, Vibe Motion, troubleshooting failed generations, credit optimization, Photodump, or any mention of higgsfield.ai. Also trigger on generic "write me a video prompt" or "make me an AI video prompt" requests when Higgsfield is the user's configured platform.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/osidemedia/higgsfield-ai-prompt-skill with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/osidemedia/higgsfield-ai-prompt-skill'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/osidemedia--higgsfield-ai-prompt-skill/badge.svg)](/listings/osidemedia--higgsfield-ai-prompt-skill)

HTML

<a href="/listings/osidemedia--higgsfield-ai-prompt-skill"><img src="/api/listings/osidemedia--higgsfield-ai-prompt-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

git clone https://github.com/OSideMedia/higgsfield-ai-prompt-skill ~/.claude/skills/higgsfield

Claude Code registers the root `SKILL.md` as one skill, `higgsfield`. The 35 sub-skills under `skills/` are not registered separately; the root routes to each by its full path and Claude opens it from there. The skill's scripts need only `python3` (standard library).

Your documents and the skill's deliverables go in a `workspace/` folder (`input/`, `output/`, `processed/`) inside the project you are working in, created on first use. Your documents and deliverables are never written into `~/.claude/skills/higgsfield/`, so updating or reinstalling the skill never touches them. The learning memory and generation ledger live in `~/.higgsfield-skill/db/`, outside the skill folder, so an update or reinstall keeps them too. The skill creates that folder on first use from its own `db/`, which also carries over the memory from an install older than v3.42.0. If you had two older installs (say a personal one and one inside a project), the second one's own entries are kept in `~/.higgsfield-skill/unmerged/`, not merged into the first; `where` lists them. In Cowork, or when you run the skill from a clone of this repo, the memory stays in the skill's own `db/`. To see which folder is in use, run `python3 scripts/higgsfield_memory.py where` from the skill's folder.

Claude Cowork

Drop the repo folder into your Cowork workspace. The skill dispatcher is at `SKILL.md` in the repo root.

Claude.ai Projects

Upload `SKILL.md` (root) as your project instruction base. Upload files from `skills/` as project documents.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 500 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ---
  2. name: higgsfield
  3. description: >
  4. Writes and refines prompts for Higgsfield AI's video and image models, and picks the
  5. model, camera controls and motion presets for each shot. Use whenever the user asks
  6. anything about Higgsfield AI — writing or
  7. refining video/image prompts, choosing a model (Kling, Veo, Wan, Seedance,
  8. Minimax Hailuo, DoP, Soul, Nano Banana, Seedream, Flux, GPT Image, etc.), camera
  9. controls, named motion presets, Soul ID character consistency, Cinema Studio 2.5/3.0,
  10. Vibe Motion, troubleshooting failed generations, credit optimization, Photodump,
  11. or any mention of higgsfield.ai. Also trigger on generic "write me a video prompt"
  12. or "make me an AI video prompt" requests when Higgsfield is the user's configured
  13. platform.
  14. user-invocable: true
  15. metadata:
  16. tags: [higgsfield, video, image, prompt, cinematic, AI, filmmaking, motion, camera]
  17. version: 3.42.0
  18. updated: 2026-10-23
  19. author: O-Side Media
  20. license: MIT
  21. ---
  22. # Higgsfield AI Prompt Skill
  23. <!-- CONTENTS — generated by scripts/build_index.py; do not hand-edit -->
  24. **Contents**
  25. - [HARD RULES — pre-delivery checklist](#hard-rules--pre-delivery-checklist)
  26. - [What Is Higgsfield?](#what-is-higgsfield)
  27. - [Working Folders — file handling](#working-folders--file-handling)
  28. - [Handling a Request](#handling-a-request)
  29. - [Fast Path — Simple Creative Requests](#fast-path--simple-creative-requests)
  30. - [Full Path — Production Requests](#full-path--production-requests)
  31. - [Route to the Right Skill](#route-to-the-right-skill)
  32. - [Load Map — how much to read](#load-map--how-much-to-read)
  33. - [Check Templates for Genre Match](#check-templates-for-genre-match)
  34. - [Build the Prompt Using the MCSLA Formula](#build-the-prompt-using-the-mcsla-formula)
  35. - [Output Format](#output-format)
  36. - [Generation Ledger — log every result](#generation-ledger--log-every-result)
  37. - [@ Reference Rules](#-reference-rules)
  38. - [Shared Resources](#shared-resources)
  39. - [Reference files inside sub-skills](#reference-files-inside-sub-skills)
  40. - [Sub-Skills — open `skills/<name>/SKILL.md` yourself](#sub-skills--open-skillsnameskillmd-yourself)
  41. <!-- /CONTENTS -->
  42. **Language rule:** Reply in whatever language the user writes in.
  43. **Paths:** every path in this file (`skills/…`, `templates/…`, `specs/…`, `scripts/…`,
  44. `db/…`) is relative to the folder this `SKILL.md` lives in, not to the user's working
  45. directory. A path inside any other file is relative to that file's own folder
  46. (`../../specs/…` in a sub-skill climbs back to this one). Two exceptions:
  47. `workspace/` lives in the user's working directory, and the learning memory may live
  48. outside this folder (both in § Working Folders). Sub-skills are plain
  49. files, not separately registered skills: nothing loads them for you, so open
  50. `skills/<name>/SKILL.md` yourself.
  51. **MCP tools:** `Higgsfield:<tool>` (e.g. `Higgsfield:models_explore`) means that tool on
  52. the Higgsfield MCP server (`https://mcp.higgsfield.ai/mcp`). Its name in your tool list
  53. depends on how it was added — the claude.ai connector shows up in Claude Code as
  54. `mcp__claude_ai_Higgsfield__<tool>` — so match on the Higgsfield server, never on a
  55. same-named tool from another server. A bare tool name in a sub-skill means the same.
  56. ---
  57. ## HARD RULES — pre-delivery checklist
  58. These rules apply to every Higgsfield response. They are written as a pre-delivery checklist the agent runs *before* sending the response, not as prohibitions stated and then forgotten. The failure mode they prevent is **plausibility-over-verification** — producing a response that looks correct because the agent's training data knows the rough shape of Higgsfield work, rather than because the agent actually read the skill files and verified the platform's ground truth.
  59. **Before delivering any Higgsfield response, confirm in this order:**
  60. 1. **Routing line present.** First line of response names which sub-skills you routed to (e.g. "Routing to higgsfield-prompt + higgsfield-camera for an Atmosphere push-in"). One line, then the work. Missing routing line = response is incomplete; add it.
  61. 2. **Routed sub-skills opened and read in this conversation.** Match the user's ask to the routing table below, open the matching sub-skill files (`skills/<name>/SKILL.md`) with the read tool, and READ them. Root `SKILL.md` and `skills/higgsfield-prompt/SKILL.md` are mandatory at minimum on any prompt request. Grepped snippets do not satisfy this rule. Full reads do. If your only access to root `SKILL.md` or `skills/higgsfield-prompt/SKILL.md` in this conversation came from grep results, you have not satisfied this rule — open the file. Platform vocabulary, preset names, and model parameters must come from the files because this platform's lineup changes between releases.
  62. 3. **Named vocabulary verified, not invented.** Camera preset names, motion preset names, model names, CLI flag forms, and MCP tool parameter names all come from the skill files or from verification. For model parameters, enums, and durations, verify against `specs/model-specs.yaml` first — it is generated from a dated `models_explore` snapshot (see `snapshot_date` inside the file); if the snapshot is stale (>30 days), verify live instead (`higgsfield model get <model>` for CLI param schemas; `Higgsfield:models_explore` for MCP). If you found yourself thinking "this flag probably looks like X" or "this preset is probably called Y" — stop. Read the file or run the verification command. Plausibility is not validity. Do not substitute generic video-prompt vocabulary for named Higgsfield presets; do not invent model versions, camera presets, or motion-preset names. If the user names one you don't see in the skill files, say so and ask for clarification.
  63. 4. **MCSLA structure intact on video prompts.** Model · Camera · Subject · Look · Action. Five layers, every video prompt, unless the user explicitly opted out.
  64. 5. **Shared negative constraints appended.** Pull positive-phrasing prevention phrases from `skills/shared/negative-constraints.md`. Do not paraphrase from training; use the exact phrasing from the file. (Kling 3.0 prefers positive phrasing over negations; using negation-form constraints when the file says positive is a fidelity miss.)
  65. 6. **Preflight surfaced when applicable.** If execution intent is signaled (CLI / MCP / bundled-skills mentioned) AND a video-class or high-cost model is named OR a budget concern is named, surface the two-step preflight (`model get` / `Higgsfield:models_explore` for schema, then cost estimate). See `skills/higgsfield-stack/SKILL.md` § Preflight discipline.
  66. 7. **Aspect ratio is an enum, not a free-form value.** Check the model's allowed ratios against `specs/model-specs.yaml` before writing them into the header; if the snapshot is stale (>30 days), verify live via schema (`Higgsfield:models_explore` / `model get`). Example of why this matters: Seedance 2.0 supports native 21:9, Kling 3.0 does not. Anamorphic / 2.35:1 / 2.39:1 are *style register* vocabulary for the Look line, not output ratios. See `vocab.md` § Aspect Ratio: output spec vs. style register. In a multi-shot Seedance sequence whose location plates carry a baked lens, whether the optics words still belong in the video prompt (Style Prefix included) is OPEN — one studio drops them, Hell Grind keeps the look in both (`skills/higgsfield-seedance/SKILL.md` § Bake it into the asset; `skills/shared/house-rulings.md` P2-6).
  67. 8. **Prompt under 200 words — short-form regime only.** Soft cap from MCSLA section. Going over is a signal you're padding rather than locking — tighten. **Regime exception:** block-scaffold production prompts (`skills/higgsfield-seedance/SKILL.md` § Official Prompt Architecture) replace the word cap with structural lint — harvested production Seedance briefs run 218–2,059-word medians depending on register `[FIELD — 13-project community harvest, 2026-07-18]`. The cap governs single-shot MCSLA prompts; a block-scaffold prompt over 200 words is not a rule-8 violation.
  68. **If any of items 1–8 are missing or unverified, the response is incomplete. Complete them before sending, not after.**
  69. ---
  70. ## What Is Higgsfield?
  71. Higgsfield is a cinematic AI video and image generation platform built for filmmakers and
  72. creators. Unlike single-model tools, Higgsfield hosts **multiple generation engines** on one
  73. platform — Kling 3.0/3.0 Omni/3.0 Motion Control, Google Veo 3.1/3.1 Lite, Wan 2.7/2.6/2.5,
  74. Seedance 2.5/2.0/Pro, FLUX 3 Video, Minimax Hailuo 2.3/02, Higgsfield DoP (Lite/Standard/Turbo) for video; Soul 2.0, Soul Cinema Preview,
  75. Soul Cast, Nano Banana Pro/2, Kling Image 3.0/Omni, Seedream 5.0 Pro/Lite/Flash + 4.5, GPT Image 2.0 / 2.5,
  76. Flux 2/Kontext for images — plus a library of 100+ named **Motion Presets**, a **Soul ID**
  77. character consistency system, **Cinema Studio 2.5**, **Cinema Studio 3.0** (Business/Team plan), and **Cinema Studio 3.5** with Soul Cast AI actors, native dual-channel stereo audio, and 80+
  78. one-click **Apps**. **Sora 2 is retired from this skill's recommendations:** OpenAI shut the Sora 2 API down on 2026-09-24; Higgsfield only ever offered it in its web UI, and whether the UI still does is unconfirmed. For scale / physics shots use Seedance 2.0 or Minimax Hailuo 2.3 (`model-guide.md`). **Catalog check (2026-09-26):** Kling 3.0 Omni, Wan 2.5, Seedance Pro, Higgsfield DoP, Soul Cinema Preview and Kling Image 3.0 / Omni are not in the API catalog (`higgsfield model list` / `workflow list`). They may be UI-only — verify in the live UI before recommending them, and prefer a catalog pick where `model-guide.md` names one. No catalog variant of Minimax Hailuo is named 02.
  79. ---
  80. ## Working Folders — file handling
  81. `workspace/` lives in the **user's current working directory** (the folder the
  82. session was started in), not in this skill's folder. Use its three subfolders for
  83. every task that involves a user-provided document or a file you produce. This keeps
  84. uploads and deliverables out of the project root.
  85. - **Session started inside this repo** (Cowork with the repo folder as the workspace,
  86. or Claude Code opened here): it is this repo's own `workspace/`.
  87. - **Skill installed elsewhere** (e.g. `~/.claude/skills/higgsfield/`) **while working in
  88. another project:** use `<that project>/workspace/`, creating `input/`, `output/` and
  89. `processed/` there on first use. Never put the user's files in the skill's install
  90. folder — a reinstall replaces that folder and everything in it.
  91. | Folder | Role | Your behavior |
  92. |--------|------|---------------|
  93. | `workspace/input/` | Documents the user wants you to read (scripts, story bibles, briefs, character sheets, references). | Read from here first. If the user's file is somewhere else, **copy it into `workspace/input/`** and leave the original where it is — never move or delete it. When you need a document from the user, ask them to drop it in `workspace/input/`. |
  94. | `workspace/output/` | Files you generate for the user (prompt packs, shot breakdowns, batch CSVs, reports, exported docs). | **Write every file deliverable here**, not to the project root. Tell the user the path when you finish. |
  95. | `workspace/processed/` | Inputs you have finished consuming. | When a task is complete, **move the file from `input/` to `processed/`** so `input/` stays clean. Never delete the user's files — relocate them. |
  96. Rules:
  97. - Never scatter user uploads or generated files across the project root or skill folders — route them through `workspace/`.
  98. - Treat `workspace/input/` as the canonical place to look when the user says "the script / bible / reference I gave you."
  99. - In this repo the three folders' contents are git-ignored. In another project they are not unless the user ignores them: never assume anything in them is committed or private, and ask before editing the user's `.gitignore`.
  100. **The memory folder.** The filter memory, quality memory and generation ledger live in
  101. one folder, and only `scripts/higgsfield_memory.py` reads or writes it. When this skill
  102. runs from a Claude Code skill install (a `.claude/skills/<name>/` folder), the memory
  103. folder is `~/.higgsfield-skill/db/`, copied from this skill's `db/` on first use, so a
  104. reinstall or update cannot erase it. Anywhere else (a Cowork workspace, a clone of the
  105. repo) it is this skill's own `db/`. The `HF_DB_DIR` environment variable overrides both.
  106. `python3 <this skill's folder>/scripts/higgsfield_memory.py where` prints the folder in
  107. use; give the user that path when they ask where their memory is or before a reinstall.
  108. If its `unmerged` list is not empty, another install held entries the memory folder
  109. lacks (its own memory from before v3.42.0, or starter entries from a newer release): they
  110. were kept there, not merged. Tell the user once.
  111. ## Handling a Request
  112. ### Fast Path — Simple Creative Requests
  113. If the user provides a clear creative intent ("write me a prompt for a car chase at night")
  114. with no specific constraints, **generate immediately** using these sensible defaults:
  115. > **Fast Path still requires reading `skills/higgsfield-prompt/SKILL.md` first — Fast Path means skip clarifying questions, NOT skip the file read.**
  116. | Parameter | Default |
  117. |-----------|---------|
  118. | Aspect ratio | 16:9 |
  119. | Duration | 8s (Kling lanes — see Seedance exception below) |
  120. | Style | Cinematic |
  121. | Video model | Kling 3.0 (character-focused) or Seedance 2.0 (action/scale/references) |
  122. | Image model | Soul 2.0 (portrait) or Nano Banana 2 (everything else) |
  123. Do not ask clarifying questions. Deliver a ready-to-paste prompt. Mention the defaults
  124. used so the user can adjust if they want something different.
  125. > **Seedance exception:** Seedance 2.0 never gets a silently defaulted runtime
  126. > (`skills/higgsfield-seedance/SKILL.md` — always ask, never default). On Fast
  127. > Path that means: if the user named no duration, route video to Kling 3.0;
  128. > pick Seedance 2.0 only when the request names a duration — or when the user
  129. > asked for Seedance by name, in which case state the assumed runtime as the
  130. > first adjustable default in the delivery.
  131. > If you did not read `skills/higgsfield-prompt/SKILL.md` earlier in this conversation, read it now before writing the prompt.
  132. ### Full Path — Production Requests
  133. When the user signals production-grade intent (Cinema Studio, multi-shot, specific model,
  134. budget constraints, client work), **confirm before generating:**
  135. **Required:**
  136. - **Generation type**: Image / Video / App (one-click)
  137. - **Video duration**: model-dependent enum — check the model's `duration` values in `specs/model-specs.yaml` before offering choices (e.g. Seedance 2.0 4–15s, Veo 3.1 4/6/8s; image-to-video clips trend short)
  138. - **Aspect ratio**: 16:9 / 9:16 / 1:1 / 4:5 / 4:3 / 21:9-where-supported (default: 16:9) — enums per model in `specs/model-specs.yaml` (HARD RULE 7); anamorphic / 2.35:1 / 2.39:1 are **Look-line style register**, never output ratios
  139. - **Model preference** (or ask Claude to recommend — see `skills/higgsfield-models/SKILL.md`)
  140. **Optional (skip if user already provided):**
  141. - Visual style: Cinematic / VHS / Super 8MM / Anamorphic / Abstract
  142. - Soul ID character reference (if character consistency needed)
  143. - Reference image for image-to-video
  144. - Motion preset preference
  145. > Ask everything in one message — do not split across multiple rounds.
  146. ---
  147. ### Route to the Right Skill
  148. | User wants | Route to |
  149. |------------|----------|
  150. | User unsure which workspace/tool fits, or asks "what should I use for X" | `skills/higgsfield-workspaces/SKILL.md` |
  151. | Write or improve a prompt | `skills/higgsfield-prompt/SKILL.md` + relevant sub-skills |
  152. | Develop a character / world / story / premise before prompting, build a character sheet / story bible, lock a visual style ("visual DNA"), keep a character consistent across many shots, or "I keep getting generic AI characters" | `skills/higgsfield-character-design/SKILL.md` |
  153. | Audit or strengthen a scene / sequence / beat outline before generating it, or "is this scene working", "what's weak here", "why doesn't this land" | `skills/higgsfield-scene-engine/SKILL.md` |
  154. | Cinematic still image prompt (shot framing, angles) | `skills/higgsfield-image-shots/SKILL.md` |
  155. | GPT Image 2.0 / 2.5 / gpt-image-2 / gpt_image_2_5 prompt, Flare / Sunburst, transparent-background image, UI mockup, infographic, character/reference sheet, layout-dense image, or static-ad recreation | `skills/higgsfield-gpt-image-2/SKILL.md` |
  156. | Choose the right model — incl. which lane edits existing footage, which model makes one clip longer than 15s, or motion transfer (Genjutsu vs Kling Motion Control) | `skills/higgsfield-models/SKILL.md` + `model-guide.md` (§ Edit-Lane Chooser, § Long-Take Chooser) |
  157. | Camera movement guidance (video) | `skills/higgsfield-camera/SKILL.md` |
  158. | Named motion preset (Explosion, Werewolf, etc.) | `skills/higgsfield-motion/SKILL.md` |
  159. | Visual style selection | `skills/higgsfield-style/SKILL.md` |
  160. | Character consistency across shots | `skills/higgsfield-soul/SKILL.md` |
  161. | **Consistency tie-break:** character consistency via a live Soul ID / reference images inside Higgsfield → `skills/higgsfield-soul/SKILL.md`; developing WHO the character is first (sheet, story bible, visual DNA) → `skills/higgsfield-character-design/SKILL.md`. Both may apply in sequence: design first, then lock with Soul. | — |
  162. | VFX presets (Air Bending, Plasma, etc.) | `skills/higgsfield-motion/SKILL.md` |
  163. | One-click App workflow | `skills/higgsfield-apps/SKILL.md` |
  164. | Genre recipe (action, horror, ad, etc.) | `skills/higgsfield-recipes/SKILL.md` |
  165. | Fix a failing generation | `skills/higgsfield-troubleshoot/SKILL.md` |
  166. | A Seedance take came back wrong (not flagged) — reversal, babble, a third hand, gliding walk, choppy fight | `skills/higgsfield-seedance/SKILL.md` (`skills/higgsfield-seedance/FAILURE-MODES.md`) + `skills/higgsfield-troubleshoot/SKILL.md` (§ Stop-Rule Ladder) |
  167. | Moodboard, style direction, Soul Hex color | `skills/higgsfield-moodboard/SKILL.md` |
  168. | Visual consistency across a project | `skills/higgsfield-moodboard/SKILL.md` |
  169. | Mixed Media presets (Noir, Sketch, Particles, etc.) | `skills/higgsfield-mixed-media/SKILL.md` |
  170. | Photodump style preset / social-feed photo-dump aesthetic | `photodump-presets.md` (root reference) |
  171. | Artistic style transformation, preset stacking | `skills/higgsfield-mixed-media/SKILL.md` |
  172. | Higgsfield Assist (GPT-5 copilot) | `skills/higgsfield-assist/SKILL.md` |
  173. | Credit optimization, plan selection, budget strategy | `skills/higgsfield-assist/SKILL.md` |
  174. | Cinema Studio 2.5 / Cinema Studio 3.0 / Cinema Studio 3.5 / Cinema Studio 4.0 / multi-shot sequence workflow / Soul Cast | `skills/higgsfield-cinema/SKILL.md` |
  175. | Cinema Studio 4.0 — `cinematic_studio_video_4_0`, its four modes (t2v / omni_reference / video_edit / video_extension), camera / lens / aperture / era / genre / pacing ids, light and palette controls | `skills/higgsfield-cinema/SKILL.md` |
  176. | Optical physics, camera bodies, lenses, Hero Frame | `skills/higgsfield-cinema/SKILL.md` |
  177. | Elements system (@Characters/@Locations/@Props) | `skills/higgsfield-cinema/SKILL.md` |
  178. | Director Panel, Speed Ramp, shot modes, Popcorn | `skills/higgsfield-cinema/SKILL.md` |
  179. | Cinema Studio 3.0 Smart mode, @ references, native audio | `skills/higgsfield-cinema/SKILL.md` |
  180. | Cinema Studio 3.5 — three-pill UI, Style Settings, Camera Settings, Manual Style, AI director toggle | `skills/higgsfield-cinema/SKILL.md` |
  181. | User mentions Marketing Studio, DTC Ads, `ms_image`, or `marketing_studio_video` model | `skills/higgsfield-marketing-studio/SKILL.md` |
  182. | User wants UGC / Tutorial / Unboxing / Hyper Motion / Product Review / TV Spot / Wild Card / UGC Virtual Try On / Pro Virtual Try On ad video | `skills/higgsfield-marketing-studio/SKILL.md` |
  183. | User mentions hook+setting picklists, preset / custom / text-generated avatars in MS context, or 4–15s ad video constraints | `skills/higgsfield-marketing-studio/SKILL.md` |
  184. | **Ad Multiplier** ("multiply my ad", many independently edited versions of one 4–30s ad) or a one-off **Genjutsu** edit of a finished ad (swap one object / product / garment using a reference image of the new one, transfer motion) | `skills/higgsfield-marketing-studio/SKILL.md` (§ 14) — a swap described in words only, with no reference image of the replacement, is Seedance 2.5 `video_edit` (`model-guide.md` § Edit-Lane Chooser) |
  185. | User wants to run a full campaign pipeline — research → plan → generate → publish → report, "create a campaign", "100 UGC videos", content plan, batch ads, cost-savings report | `skills/higgsfield-content-factory/SKILL.md` |
  186. | User mentions Higgsfield Canvas, a node-based / node-graph workspace, an infinite board, chaining prompts→images→videos into a pipeline, Shared Canvas, or a ComfyUI-style node workflow | `skills/higgsfield-canvas/SKILL.md` |
  187. | Multi-shot workflow, chaining tools, full production pipeline | `skills/higgsfield-pipeline/SKILL.md` |
  188. | Short film, branded content, Popcorn → video → assembly | `skills/higgsfield-pipeline/SKILL.md` |
  189. | Vibe Motion, kinetic typography, animated text, infographic/data/presentation animation, logo/brand animation as **code** (Remotion — crisp text, exact brand colors, deployable, real-time edits) | `skills/higgsfield-vibe-motion/SKILL.md` |
  190. | Animated AD / brand promo as an **AI-generated video** built brief → storyboard sheet → Seedance ("make a motion", "motion design ad", "animate my logo into a video", "promo/ad video", classicMD/highMD) | `skills/higgsfield-motion-design/SKILL.md` |
  191. | **Vibe Motion vs Motion Design** (both say "motion graphics / brand / logo animation"): want **crisp text, exact colors, deployable code, editable canvas** → `skills/higgsfield-vibe-motion/SKILL.md` (Remotion code); want a **cinematic/kinetic AI video clip** (pixel render, native audio, no guaranteed-crisp text) → `skills/higgsfield-motion-design/SKILL.md` (Seedance). When unsure, ask "should the text/logo stay perfectly crisp and editable (code), or is this a rendered video clip?" | — |
  192. | Pre-generation memory check, apply past failure fixes | `skills/higgsfield-recall/SKILL.md` |
  193. | User reports a generation result (kept/rejected/flagged) — log it to the ledger | `skills/higgsfield-recall/SKILL.md` |
  194. | Takes-per-kept ratios, credit budgeting from logged data | `skills/higgsfield-assist/SKILL.md` |
  195. | Audio design, dialogue cues, SFX, ambient sound | `skills/higgsfield-audio/SKILL.md` |
  196. | **Standalone audio generation** — soundtrack, ambience bed, multi-speaker scene audio, Seed Audio 1.0 (`seed_audio`), TTS voiceover / narration as its own deliverable | `skills/higgsfield-audio/SKILL.md` |
  197. | Swap or revoice the speaker in a finished video (`Higgsfield:voice_change`), or clone / create a reusable voice (`Higgsfield:create_voice` → `voice_type: element`) | `skills/higgsfield-audio/SKILL.md` |
  198. | **A finished video in, something derived out** — Shorts Studio (restyle one video into shorts), Clipify (YouTube → subtitled clips), Virality Predictor ("will this go viral", score my ad), Video Analysis (scene-by-scene breakdown), and which of these cost credits | `skills/higgsfield-repurpose/SKILL.md` |
  199. | **3D** — image→3D / multi-view→3D / text→3D mesh (GLB), rigging or animating a mesh, remesh / retexture, 3D Body, 3D Jutsu / Scene Builder 3D projects, a 3D turnaround as a multi-angle reference, a 3D blockout as a staging reference (`Higgsfield:generate_3d`, `Higgsfield:scene_builder_3d_*`) | `skills/higgsfield-3d/SKILL.md` |
  200. | **Extend / continue an existing clip** — "make it longer", "what happens next / before", prequel, last-frame handoff, extension chains | a native forward/backward extension on 2.5 → `skills/higgsfield-seedance-2-5/SKILL.md` (`video_extension`); a 2.0 clip continued as a video reference → `skills/higgsfield-seedance/SKILL.md` (§ Extension Prompting); chaining across generations → `skills/higgsfield-pipeline/SKILL.md` (§ Continuation & Extension Handoff) |
  201. | **Prep assets / reference sheets before video** — character sheet, prop three-view, location plate, "build my elements", variety sheet for crowds | `templates/ad-asset-prep.md` + `skills/higgsfield-gpt-image-2/SKILL.md` (props) + `skills/higgsfield-soul/SKILL.md` (people & crowds) |
  202. | Audition / screen-test a designed character (how they move, speak, react) before scene generation | `skills/higgsfield-character-design/SKILL.md` (§ Screen Test / Audition) |
  203. | Seedance 2.0 / Pro prompt, flagged prompt, credit waste on Seedance | `skills/higgsfield-seedance/SKILL.md` |
  204. | **Seedance 2.5** — user names 2.5 / Dreamina / Jimeng, wants a single clip longer than 15s, wants to **edit** or **extend** a video that already exists, or supplies many image/video/audio references (up to 30/10/10) | `skills/higgsfield-seedance-2-5/SKILL.md` |
  205. | **2.0 vs 2.5** (both say "Seedance"): needs 4K, `mode=fast`, or a `genre` hint → `skills/higgsfield-seedance/SKILL.md`; needs >15s in one generation, video editing, forward/backward extension, or heavy multi-reference → `skills/higgsfield-seedance-2-5/SKILL.md`. Both do 1080p and platform start/end frames (2.5 only in `omni_reference`); 2.5 caps at 1080p | — |
  206. | **Character performance** — acting, behavior, mannerisms, tics, a gait, subtext, "my characters look wooden / dead-eyed / AI", keeping a character themselves across many shots, an acting master profile | `skills/higgsfield-acting/SKILL.md` |
  207. | **Feature-film production pipeline on Seedance** — headless character sheets, location sheets, a scene geography block reused across shots, dialogue construction, iteration discipline, giants / crowds / threshold transitions | `skills/higgsfield-seedance/SKILL.md` (`skills/higgsfield-seedance/HELL-GRIND.md`) |
  208. | **Transform footage the user already has** (video-to-video): "make a Seedance prompt for this video/clip", add a VFX element (set my head/hair on fire, transform my hand, make a limb invisible), swap the world/background around a preserved subject (desert, clouds, lava, neon city), put a giant creature behind me or on a landmark, relight/regrade to match, sync a crash-zoom/push-in to a line — a **real source clip** is the starting point | `skills/higgsfield-seedance-vfx/SKILL.md` |
  209. | **Replace a VFX/3D pipeline with generation** — "can AI do this instead of VFX", put myself in this plate, put a creature in my footage, a dragon/monster shot without buying or rigging a 3D model, "how do I build a whole VFX shot", asset sheets → size-ref → locations → shots as one pipeline; also "my v2v keeps failing / turns to slop", scale drift between two subjects, which image model for faces vs creatures vs clothing vs locations | `skills/higgsfield-seedance-2-5/SKILL.md` (`skills/higgsfield-seedance-2-5/VFX-PIPELINE.md`) |
  210. | Precise facial expression / FACS / Action Unit codes (AU12, AU6…), forced or uncanny or mixed expression, close-up micro-performance, monologue/dialogue facial acting, "which AU code for anger/fear", FACS reference sheet | `skills/higgsfield-facs/SKILL.md` |
  211. | "Make a shotlist", break a script/brief/treatment into many connected Seedance prompts, director's shotlist, global style prefix + `@`-glossary + named per-scene prompts as one editable HTML | `skills/higgsfield-shotlist-director/SKILL.md` |
  212. | User has Higgsfield CLI / MCP / bundled skills installed and asks how this skill works alongside them | `skills/higgsfield-stack/SKILL.md` |
  213. | User mentions `higgsfield auth login`, `higgsfield generate create`, `mcp.higgsfield.ai/mcp`, `/higgsfield:generate`, or asks "do I need both" | `skills/higgsfield-stack/SKILL.md` |
  214. | Request is squarely one of Higgsfield's own connector workflows (character-sheet, thumbnail-generation, ugc-*, faceless-video, narrator, subtitles, product-photoshoot, brand-asset-creation, ad-multiplier, video-editing / Higgsedit) — what this library adds vs hands off | `skills/higgsfield-stack/SKILL.md` |
  215. | User asks where the prompt construction ends and the CLI/MCP execution begins (handoff questions) | `skills/higgsfield-stack/SKILL.md` |
  216. ---
  217. ### Load Map — how much to read
  218. The routing table says *where*; this says *how much*. Loads are cumulative — every path starts from HARD RULE 2's mandatory reads.
  219. | Situation | Load |
  220. |-----------|------|
  221. | Simple creative prompt (Fast Path) | root `SKILL.md` + `skills/higgsfield-prompt/SKILL.md` — nothing else |
  222. | Any Seedance prompt | + `skills/higgsfield-seedance/SKILL.md` (+ the matching `templates/seedance/` file when the request is technique-shaped) |
  223. | Multi-scene / sequence / script breakdown | + `skills/higgsfield-shotlist-director/SKILL.md` + `skills/higgsfield-pipeline/SKILL.md` |
  224. | Model choice unclear or contested | + `skills/higgsfield-models/SKILL.md` + `specs/` (the generated spec for the output type) |
  225. | User reports a generation result | + `skills/higgsfield-recall/SKILL.md` (ledger write) |
  226. | A Seedance render failed (not filtered) | + `skills/higgsfield-seedance/FAILURE-MODES.md` + `skills/higgsfield-troubleshoot/SKILL.md` |
  227. | Budget / credits / plan question | + `skills/higgsfield-assist/SKILL.md` |
  228. | Anything else | one routing-table row → that sub-skill; resist loading more than the row names |
  229. ### Check Templates for Genre Match
  230. Before writing a prompt from scratch, check if the user's request matches a common genre
  231. pattern. The `templates/` folder contains 10 annotated example templates with line-by-line
  232. breakdowns, recommended models, negative constraints, and variations.
  233. | User request matches | Check template |
  234. |---------------------|----------------|
  235. | Chase, pursuit, action, parkour | `templates/01-cinematic-action-chase.md` |
  236. | Product, commercial, ad, UGC | `templates/02-product-ugc-showcase.md` |
  237. | Horror, scary, creepy, dread | `templates/03-horror-atmosphere.md` |
  238. | Fashion, editorial, lookbook | `templates/04-fashion-editorial.md` |
  239. | Sci-fi, cyberpunk, VFX, space | `templates/05-sci-fi-vfx.md` |
  240. | Portrait, character intro, close-up | `templates/06-portrait-character-intro.md` |
  241. | Landscape, nature, establishing shot | `templates/07-landscape-establishing-shot.md` |
  242. | Comedy, social media, TikTok, skit | `templates/08-comedy-social-media.md` |
  243. | Romance, intimate, couple, wedding | `templates/09-romantic-intimate.md` |
  244. | Dance, music, performance, concert | `templates/10-dance-music-performance.md` |
  245. Use the template as a starting point — adapt the example prompt to the user's specific
  246. request. The annotations explain WHY each element works, helping you make informed
  247. substitutions.
  248. **Technique templates** (`templates/seedance/`) — structure templates for Seedance
  249. prompts where the user request is technique-shaped rather than genre-shaped:
  250. | Technique need | Template |
  251. |---|---|
  252. | Pre-visualize multi-character spatial geometry before prompting | `templates/seedance/top-down-map.md` |
  253. | Multi-character shot with cross-character relationships | `templates/seedance/multi-character-anchor.md` |
  254. | Single-character shot with position + pose + contact-point locks | `templates/seedance/single-character-position.md` |
  255. | Worked example: two-character anchoring end-to-end | `templates/seedance/worked-example-two-character.md` |
  256. | Anime / stylized-2D animation — layered formula + style block + character turnaround | `templates/seedance/anime-animation.md` |
  257. | Close-up facial acting via FACS Action Unit codes — beat-synced expression schedule | `templates/seedance/facs-expression-beats.md` |
  258. | Seedance **2.5** multi-reference brief — role map + staged beats with end states | `templates/seedance/omni-reference-2-5.md` |
  259. | Transform footage the user already has — preserve the subject + camera move, add the VFX element | `templates/seedance/footage-vfx-transform.md` |
  260. | One style prefix shared by every shot in a sequence | `templates/seedance/global-style-prefix.md` |
  261. | Show the model WHERE figures stand — a front-on outline position reference attached LAST (one incomplete-record run: no bleed, NOT reliable at moving blocking) | `templates/seedance/staging-reference.md` |
  262. **Text-overlay templates** (`templates/text-overlays/`) — paste-ready text-rendering
  263. prompts for slogan / subtitle / speech-bubble overlays:
  264. | Text overlay type | Template |
  265. |---|---|
  266. | Slogan / brand callout / opening title | `templates/text-overlays/slogan.md` |
  267. | Subtitle (dialogue-synchronized) | `templates/text-overlays/subtitle.md` |
  268. | Speech bubble (character-attributed) | `templates/text-overlays/speech-bubble.md` |
  269. ---
  270. ### Build the Prompt Using the MCSLA Formula
  271. Full MCSLA definition and prompt structure → `skills/higgsfield-prompt/SKILL.md`
  272. Quick summary — five layers, every prompt:
  273. | M | C | S | L | A |
  274. |---|---|---|---|---|
  275. | Model | Camera | Subject | Look | Action |
  276. **Core rules:**
  277. - Be specific — name camera presets, describe VFX concretely
  278. - Keep prompts under 200 words (short-form regime — block-scaffold production prompts follow their own structural rules, HARD RULE 8)
  279. - Subject → Action → Camera → Style is the most reliable order
  280. ---
  281. ### Output Format
  282. **Single prompt:**
  283. ```
  284. **Model**: [model name]
  285. **Aspect ratio**: [ratio] **Duration**: [Xs] **Style**: [style]
  286. [Prompt]
  287. **Camera**: [camera control name]
  288. **Motion preset** (if used): [preset name]
  289. ```
  290. **Two versions (when style varies):**
  291. ```
  292. ### Version 1 — [Style Name]
  293. [Prompt]
  294. ---
  295. ### Version 2 — [Style Name]
  296. [Prompt]
  297. ```
  298. **Output rules:**
  299. - Output a clean, ready-to-paste prompt — no meta-commentary after
  300. - Do not explain what every line does unless the user asks
  301. - Always name the camera control and motion preset explicitly
  302. ---
  303. ## Generation Ledger — log every result
  304. Every generation attempt the user reports — kept, rejected, or filter-flagged —
  305. gets one row in the ledger (`ledger/<project>.json` in the memory folder, § Working
  306. Folders). The denominator (successes too,
  307. not just failures) is what turns the memory system into takes-per-kept ratios
  308. and credit budgets.
  309. **The 5-second rule:** when the user reports a result, ask at most ONE
  310. question ("keep or reject — what failed?") and write the row yourself with
  311. one `scripts/higgsfield_memory.py log-gen` command (run it as `python3
  312. <this skill's folder>/scripts/higgsfield_memory.py`; it finds the memory folder itself). Never ask
  313. twice; never present a form. Every script this skill runs needs only `python3` and its
  314. standard library — no `pip install`. Full workflow: `skills/higgsfield-recall/SKILL.md` § Log the Generation
  315. Result. Ratios and budgeting: `skills/higgsfield-assist/SKILL.md`.
  316. ---
  317. ## @ Reference Rules
  318. - User uploads a document (script, bible, brief, reference notes): read it from `workspace/input/`; if it landed elsewhere, copy it there first and leave the original in place (see Working Folders above)
  319. - User uploads image: use `[reference image]` or describe it as "the provided reference"
  320. - For Soul ID character: note "using Soul ID character reference" in the prompt
  321. - For video extension: note "extend from [reference video], continue with..."
  322. - For style transfer: note "match the visual style of [reference image]"
  323. ---
  324. ## Shared Resources
  325. | Resource | What it contains | When to use |
  326. |----------|-----------------|-------------|
  327. | `INDEX.md` | Generated heading index of every `SKILL.md`, each heading anchor-linked | To land on one section of a sub-skill instead of hunting for it |
  328. | `DISCIPLINE.md` | Operating discipline patterns behind the HARD RULES (cites them by number, never restates them) | When unsure how a HARD RULE applies in practice |
  329. | `model-guide.md` | Video + image model comparison tables, § Edit-Lane Chooser, § Long-Take Chooser | Any model choice |
  330. | `image-models.md` | Image model specs, UI controls and pricing | Image model questions, specs or pricing |
  331. | `vocab.md` | Camera movement + cinematic vocabulary, aspect ratio vs style register | Camera, lens and look wording |
  332. | `prompt-examples.md` | Production prompt examples by genre | Before writing a prompt from scratch |
  333. | `photodump-presets.md` | 29 Photodump style presets | Photodump / social-feed photo-dump requests |
  334. | `production-benchmarks.md` | Production-cost and iteration anchors from a Higgsfield-made 90-minute AI feature | Credit budgets, realistic iteration counts, cost framing |
  335. | `docs/Seedance 2 Skill.md` | The bilingual EN+ZH JSON Seedance output profile — not the canonical Seedance skill | Only when the user wants bilingual-JSON Seedance output |
  336. | `docs/field-test-queue.md` | Models and doctrine claims this library states with no O-Side generation behind them yet | Before presenting one of them as tested |
  337. | `skills/shared/negative-constraints.md` | All generation artifacts + prevention phrases, by category | Check before every prompt — append relevant constraints |
  338. | `skills/shared/provenance.md` | Repo-wide provenance legend — what [OFFICIAL]/[DEMO]/[FIELD]/[EMPIRICAL]/[HOUSE]/[MEASURED] mean and the evidence each requires | Before leaning on a tagged claim |
  339. | `skills/shared/house-rulings.md` | Every contested doctrine question — ruling or OPEN, scope, both sides | When two skill files seem to disagree |
  340. | `templates/` | 10 annotated genre templates with examples, models, annotations, variations | When user request matches a common genre — use as starting point |
  341. | `templates/ad-asset-prep.md` | Ad asset preparation: product sheets, hero-character sheets, location plates — generate-many → test-in-motion → lock-the-winner | When an ad/product request needs reference assets built before video |
  342. | `templates/character-design/` | 6 character-design worksheets: `templates/character-design/premise.md`, `templates/character-design/world-sheet.md`, `templates/character-design/9-question-character-sheet.md`, `templates/character-design/character-web.md`, `templates/character-design/story-spine.md`, `templates/character-design/style-sheet.md` | With `skills/higgsfield-character-design/SKILL.md` when developing characters before prompting |
  343. | `templates/seedance/` | 10 Seedance technique templates, each listed by path in § Check Templates for Genre Match | When Seedance request is technique-shaped (spatial blocking, position references, multi-character anchoring, anime/stylized-2D, FACS acting, footage VFX, style prefix, 2.5 multi-reference) |
  344. | `templates/text-overlays/` | 3 text-rendering templates: slogan, subtitle, speech-bubble | When user request includes on-screen text rendering |
  345. ### Reference files inside sub-skills
  346. Open these directly when the row applies — alongside their sub-skill, not instead of it.
  347. | File | What it holds | Open when |
  348. |------|---------------|-----------|
  349. | `skills/higgsfield-seedance/ENGINE-RULES.md` | Seedance 2.0's hard rendering constraints — the shared core every Seedance dialect cites | Any Seedance 2.0 prompt |
  350. | `skills/higgsfield-seedance/FAILURE-MODES.md` | Catalog of Seedance 2.0 / Pro failure modes and their fixes | A Seedance take came back wrong |
  351. | `skills/higgsfield-seedance/HELL-GRIND.md` | Higgsfield's open-sourced feature-film pipeline on Seedance | Feature-length or multi-scene Seedance production |
  352. | `skills/higgsfield-seedance/PRODUCTION-PATTERNS.md` | Tutorial-demonstrated and field-harvested Seedance production patterns | Seedance production work beyond a single prompt |
  353. | `skills/higgsfield-seedance-2-5/MODE-PLAYBOOKS.md` | Long-form templates for each Seedance 2.5 mode and technique | Writing a 2.5 prompt in a named mode |
  354. | `skills/higgsfield-seedance-2-5/VFX-PIPELINE.md` | The AI-VFX pipeline: how a whole VFX shot gets built | Replacing a VFX/3D pipeline with generation |
  355. | `skills/higgsfield-seedance-vfx/references/first-frame.md` | Lock an uncertain look as a still first, then animate from it | A footage transform whose look is untested |
  356. | `skills/higgsfield-seedance-vfx/references/dialogue-timing.md` | Anchoring a timed camera move to a line and to a second mark | A crash zoom, push-in or reveal that must land on a beat |
  357. | `skills/higgsfield-models/MODELS-DEEP-REFERENCE.md` | Long-form per-model reference behind the model sub-skill | The sub-skill's summary is not enough for the call |
  358. | `skills/higgsfield-cinema/references/output-formats-2-5-3-0.md` | Per-mode output templates for Cinema Studio 2.5 + 3.0 | Formatting a Cinema Studio 2.5 / 3.0 delivery |
  359. | `skills/higgsfield-cinema/references/reference-sheet-types.md` | Motion/camera, outfit/material, palette/mood and product reference sheets | A reference sheet that is not a character or location |
  360. | `skills/higgsfield-gpt-image-2/reference-sheet-workflow.md` | Automatic Product Reference Sheet: one product image → a multi-view studio sheet | Product reference sheets |
  361. | `skills/higgsfield-gpt-image-2/static-ads-workflow.md` | Recreating an uploaded ad with GPT Image 2.0 | Static-ad recreation |
  362. | `skills/higgsfield-marketing-studio/cross-surface-workflow.md` | Four-surface ad recipe (GPT Image 2.0 → Soul Cinema → Nano Banana Pro → Marketing Studio) and `ms_image` / DTC Ads | A campaign built across image and video surfaces |
  363. | `skills/higgsfield-content-factory/publish-and-report-workflow.md` | Campaign Stage 4 (Meta Ads publish or content calendar) and Stage 5 (cost-comparison report) | Publishing or reporting a campaign |
  364. ---
  365. ## Sub-Skills — open `skills/<name>/SKILL.md` yourself
  366. These are plain files, not separately registered skills, so none of them loads on its own.
  367. Open the file in the Skill column with the read tool (paths are relative to this folder).
  368. | Skill | Trigger |
  369. |-------|---------|
  370. | `skills/higgsfield-workspaces/SKILL.md` | User is choosing a workspace / asking "what should I use for X" / hasn't picked a tool yet |
  371. | `skills/higgsfield-prompt/SKILL.md` | Any prompt writing or refinement request |
  372. | `skills/higgsfield-image-shots/SKILL.md` | Cinematic image prompts — shot framing, angles, composition |
  373. | `skills/higgsfield-gpt-image-2/SKILL.md` | GPT Image 2.0 / 2.5 prompts — when to prefer 2.5 (transparent background, xhigh/max), three-format taxonomy (JSON / prose / meta-prompt), UI mockups, infographics, reference sheets, static-ad recreation |
  374. | `skills/higgsfield-models/SKILL.md` | "Which model should I use?" / model comparison / edit-lane, long-take (>15s) and motion-transfer choosers |
  375. | `skills/higgsfield-camera/SKILL.md` | Camera movement questions (video) |
  376. | `skills/higgsfield-motion/SKILL.md` | Named preset requests (Explosion, Werewolf, VFX, etc.) |
  377. | `skills/higgsfield-style/SKILL.md` | Visual style / aesthetic questions |
  378. | `skills/higgsfield-soul/SKILL.md` | Character consistency / Soul ID |
  379. | `skills/higgsfield-character-design/SKILL.md` | Pre-production story bible — premise / world / 9-question character / story spine / visual DNA (before prompting) |
  380. | `skills/higgsfield-scene-engine/SKILL.md` | Scene/sequence structural audit — Goal / Obstacle / Tactic / Reversal / Value Shift (before spending credits) |
  381. | `skills/higgsfield-apps/SKILL.md` | One-click app recommendations |
  382. | `skills/higgsfield-recipes/SKILL.md` | Genre scene templates |
  383. | `skills/higgsfield-troubleshoot/SKILL.md` | Failed generations / quality issues |
  384. | `skills/higgsfield-moodboard/SKILL.md` | Moodboard / Soul Hex / project-level style consistency |
  385. | `skills/higgsfield-mixed-media/SKILL.md` | Artistic preset overlays (Noir, Sketch, Particles, etc.) |
  386. | `skills/higgsfield-assist/SKILL.md` | Higgsfield Assist copilot / credit optimization / plan selection |
  387. | `skills/higgsfield-cinema/SKILL.md` | Cinema Studio 2.5 + 3.0 + 3.5 / Soul Cast / color grading / optical physics / multi-shot / Elements / Smart mode / @ references / Style Settings / Camera Settings / Manual Style |
  388. | `skills/higgsfield-marketing-studio/SKILL.md` | Marketing Studio / DTC Ads / ad video / UGC video / Hyper Motion / TV Spot / Wild Card / Pro Virtual Try On / hook + setting picklists / 4–15s ad video / `marketing_studio_video` MCP / cross-surface workflow |
  389. | `skills/higgsfield-content-factory/SKILL.md` | Campaign pipeline (research → plan → generate → publish → report) / UGC-first 5-format mix / batch generation gate / Meta Ads scheduling / cost-savings report |
  390. | `skills/higgsfield-canvas/SKILL.md` | Node-based Canvas workspace / infinite board / chain prompts→images→videos / named canvas patterns / build-free generate-paid cost model / Shared Canvas live collaboration |
  391. | `skills/higgsfield-pipeline/SKILL.md` | Multi-shot workflow / tool chaining / full production pipeline |
  392. | `skills/higgsfield-vibe-motion/SKILL.md` | Vibe Motion — motion graphics / kinetic typography / brand + logo animation as **Remotion code** (crisp text, exact colors, deployable) |
  393. | `skills/higgsfield-motion-design/SKILL.md` | Animated-ad flow brief → storyboard → Seedance video (**AI pixel render**, not code; classicMD/highMD) |
  394. | `skills/higgsfield-recall/SKILL.md` | Pre-generation memory check / apply past failure fixes |
  395. | `skills/higgsfield-audio/SKILL.md` | Audio design, dialogue, SFX, ambient sound for audio-capable models |
  396. | `skills/higgsfield-seedance/SKILL.md` | Seedance 2.0 / Pro prompt director + content-filter preflight linter (+ `skills/higgsfield-seedance/HELL-GRIND.md`, Higgsfield's open-sourced feature-film pipeline) |
  397. | `skills/higgsfield-seedance-2-5/SKILL.md` | Seedance 2.5 omni-reference dialect — the four modes (t2v / omni_reference / video_edit / video_extension), reference-role grammar, 30s staging, editing + forward/backward extension, keyframes, storyboards, blockouts, transitions (+ `skills/higgsfield-seedance-2-5/VFX-PIPELINE.md`, the AI-VFX production pipeline: asset-class model routing, size-ref frame, the `omni_reference` v2v lane, the four-batch rule, the slop catalog) |
  398. | `skills/higgsfield-seedance-vfx/SKILL.md` | Video-to-video footage transformation for Seedance 2.0 — preserve a real subject + camera move, add a VFX element / swap the environment / drop a photoreal creature / relight to match / sync a timed zoom, run in std 4K |
  399. | `skills/higgsfield-acting/SKILL.md` | Character performance as behavior under pressure — objective / obstacle / tactics / beats / subtext, body + status + proxemics, mandatory eye life, the 150–220-word acting master profile and its per-scene rewrite, locked voice prompt |
  400. | `skills/higgsfield-shotlist-director/SKILL.md` | Brief/script → one connected Seedance shotlist (style prefix + `@`-glossary + named per-scene prompts) as editable HTML |
  401. | `skills/higgsfield-facs/SKILL.md` | FACS Action Unit codes for precise facial expressions in Seedance 2.0 — forced/uncanny/mixed expressions, close-up dialogue facial acting, emotion→AU recipes, FACS reference sheets |
  402. | `skills/higgsfield-stack/SKILL.md` | User mentions the Higgsfield CLI / MCP connector / bundled skills, or asks how this skill coexists with those execution surfaces |
  403. | `skills/higgsfield-3d/SKILL.md` | 3D meshes (image / multi-view / text → GLB), rigging + animation, remesh / retexture, 3D Body, 3D Jutsu scene projects, 3D turnarounds and 3D staging blockouts |
  404. | `skills/higgsfield-repurpose/SKILL.md` | Finished video in: Shorts Studio, Clipify, Virality Predictor, Video Analysis — with the paid / free split |
  405. > Full vocabulary in `vocab.md`
  406. > Full motion preset library in `skills/higgsfield-motion/SKILL.md`
  407. > Model comparison in `model-guide.md`
  408. > Example prompts in `prompt-examples.md`
  409. > Shared negative constraints in `skills/shared/negative-constraints.md`
  410. > Genre-specific annotated templates in `templates/`
README.md · README · 378 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. [![Version](https://img.shields.io/badge/version-3.42.0-blue)](https://github.com/OSideMedia/higgsfield-ai-prompt-skill)
  2. [![Specs snapshot](https://img.shields.io/badge/specs%20snapshot-2026--09--26-informational)](specs/MODEL-SPECS.md)
  3. [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
  4. [![Platform](https://img.shields.io/badge/platform-Claude%20Cowork%20%7C%20Claude%20Code-purple)](https://github.com/OSideMedia/higgsfield-ai-prompt-skill)
  5. # Higgsfield AI Prompt Skill
  6. > **⚠️ No longer maintained (archived November 2026).** Our work has moved to a different AI
  7. > filmmaking tool, so this skill gets no further updates, fixes or model refreshes. v3.42.0 is
  8. > the final release. Its model specs are a snapshot from 2026-09-26 and will fall behind the
  9. > Higgsfield platform as models change. The repo is archived and kept for reference: issues and
  10. > pull requests are closed. It is MIT-licensed, so you are welcome to fork it and carry it on.
  11. A comprehensive Claude skill library for generating high-quality prompts on
  12. [Higgsfield AI](https://higgsfield.ai) — the cinematic video and image generation platform.
  13. ## What This Skill Does
  14. Transforms natural language requests into production-ready Higgsfield prompts using:
  15. - The **MCSLA formula** (Model · Camera · Subject · Look · Action)
  16. - Named camera controls and motion presets the platform recognizes
  17. - Model selection guidance across Kling 3.0 / 3.0 Omni / 3.0 Motion Control, Veo 3.1, Wan, Seedance 2.5 / 2.0, FLUX 3 Video, Minimax Hailuo, Higgsfield DoP, and more
  18. - Genre recipe templates for action, horror, romance, sci-fi, product ads, and more
  19. - Soul ID character consistency guidance + Character Sheet creation
  20. - Troubleshooting for failed or poor generations
  21. - **Cinema Studio 2.5** advanced features: Soul Cast AI actors, built-in color grading, 3D Mode (Gaussian Splatting), Grid Generation, Resolution Settings, Frame Extraction Loop, Object & Person Insertion, Per-Character Emotions, Clustering, Five-View Location Reference Sheet, Reference Sheet Types (Motion / Outfit / Palette), Elements System with library surface (5 source tabs × 6 element categories)
  22. - **Cinema Studio 3.0** (Business/Team plan): native dual-channel stereo audio, Smart shot control, 15s max duration, 7 genres, @ reference patterns, Soul Cast 3.0
  23. - **Cinema Studio 4.0** (`cinematic_studio_video_4_0`, CLI workflow): the Seedance 2.5 four-mode surface (t2v / omni_reference / video_edit / video_extension) plus camera body / lens / aperture / era / genre / pacing and light / palette controls — schema-documented, not yet field-rated
  24. - **3D** (`higgsfield-3d`): image / multi-view / text → GLB meshes, rigging + a 678-clip animation library, remesh / retexture, 3D Jutsu scene projects, 3D turnarounds and staging blockouts
  25. - **Repurposing** (`higgsfield-repurpose`): Shorts Studio, Clipify, Virality Predictor, Video Analysis — with the paid / free split
  26. - **Cinema Studio 3.5**: three-pill main UI (Genre / Style / Camera), Style Settings panel (8 Color Palette / 6 Lighting / 9 Camera Moveset Style + Manual Style mode), Camera Settings four-axis panel (3 Camera Body / 5 Lens / 5 Focal Length including new 75mm / 3 Aperture), Image Mode with four Cinematic models picker (Soul Cinema default, Cinematic Characters, Cinematic Locations, Cinematic Cameras with 2.5 vocabulary)
  27. - **Seedance 2.0 prompting best practices** — Intent over Precision, Genre Router, I2V Gate, Anti-Slop, Physics Language, SCELA audio, Reference-Based / Continuation / Expand Shot / Edit Shot / Transformation prompt modes, Continuation Prompt Formula, the Iteration Rule
  28. - **Seedance 2.5 omni-reference director** — the four generation modes (`t2v` / `omni_reference` / `video_edit` / `video_extension`), explicit `@Image` / `@Video` / `@Audio` reference roles with exclusions, the five-step multi-reference workflow, 30-second staging with end states, timestamp pacing, bracket syntax for music / SFX / dialogue / subtitles, first-last-frame control (platform `start_image`/`end_image` in `omni_reference`, or declared in-prompt) and multi-keyframe control, storyboard grids, coarse-vs-fine blockout rendering, one-click video, seamless transitions, and a 2.0-vs-2.5 routing table
  29. - **Hell Grind feature-film pipeline** — Higgsfield's open-sourced 95-minute-feature system: headless character sheets, mask-composited point edits, location sheets with anchors and one light logic, the per-scene GEO SPATIAL LAYOUT block, the position-fixing first second, dialogue construction, the ban dictionary, the 10–15 iteration rule, and the crowd / giant / threshold solutions
  30. - **AI-VFX pipeline** — the production layer under Seedance 2.5, from Higgsfield's AI-vs-VFX challenge build: model routing per asset class (faces / creatures / clothing / locations), the plain-grey sheet law, two-close-up creature sheets, the face-lock crop, the size-ref frame for scale between two subjects, location batching selected on light, the `omni_reference` video-to-video lane (source ≥4s, duration = source) with its performance-inheritance clause, the four-batch stop rule and the i2v fallback with a deliberate empty-frame stitch point, and a slop catalog of the tells that give a shot away
  31. - **Acting director** — performance as behavior under pressure: objective / obstacle / tactics / beats / subtext, listening markers, body + status + proxemics, mandatory eye life, the 150–220-word acting master profile and its per-scene rewrite, the locked voice prompt, a 15-symptom atlas of bad acting, and a 0–5 performance scale
  32. - **GPT Image 2.0 prompt director** — three-format taxonomy (structured JSON for UI mockups / infographics / reference sheets, dense cinematic prose for single-subject scenes, auto-derive meta-prompt for theme-only concepts) plus reference-sheet and static-ad-recreation workflow satellites
  33. - **Higgsfield Canvas** — node-based / infinite-board workspace guidance: chaining prompts → images → videos, named canvas patterns, Shared Canvas live collaboration, build-free / generate-paid cost model
  34. - **Marketing Studio + Content Factory** — 9 DTC ad presets (UGC / Tutorial / Unboxing / Hyper Motion / TV Spot / Wild Card / Virtual Try-On) with 4–15s ad video, plus an end-to-end campaign pipeline (research → plan → generate → publish → report) with a cost-savings report
  35. - **Shared negative constraints reference** — categorized artifacts + prevention phrases (positive alternatives for 3.0); Kling 3.0 Motion Control failure diagnostic; Physics Rendering — Resolution Decision Matrix (cross-model 480p / 720p / 1080p routing rule for Seedance 2.0 + Cinema Studio 3.x)
  36. - **Identity vs. Motion separation** — hard rule for character consistency across shots
  37. - **Annotated templates library** — 10 genre templates with Cinema Studio 3.0 genre mappings, plus Seedance technique + character-design + text-overlay sub-libraries (19 files across 3 categories)
  38. - **DISCIPLINE.md cross-cutting framework** — 9 named discipline patterns in 3-3-3 tier symmetry (prompt-construction, model-selection, iteration-discipline) governing decisions across all sub-skills
  39. - **production-benchmarks.md** — Hell Grind 90-min Cannes feature reference, per-character iteration anchors, acceptance-rate calibration; what "production quality" means in practice
  40. - **FAILURE-MODES.md (Seedance)** — 15 named render failures documented with symptom + mechanism + counter for diagnosis-first iteration
  41. - **C-arc Building Complete AI Projects — 10-Step Methodology** — end-to-end pipeline from idea to delivered project; complements the genre/scene templates
  42. - **Expanded Seedance methodology + Soul refinement** — Iteration Rule + 6-Pass Diagnostic Sequence + Four Questions + Next-Shot Decision Tree + Bridging / Continuation / Repair working modes; Character Anchor Block + Two-Tool Refinement Pipeline for character consistency at production scale
  43. ## Install
  44. ### Claude Code
  45. ```bash
  46. git clone https://github.com/OSideMedia/higgsfield-ai-prompt-skill ~/.claude/skills/higgsfield
  47. ```
  48. Claude Code registers the root `SKILL.md` as one skill, `higgsfield`. The 35 sub-skills under `skills/` are not registered separately; the root routes to each by its full path and Claude opens it from there. The skill's scripts need only `python3` (standard library).
  49. Your documents and the skill's deliverables go in a `workspace/` folder (`input/`, `output/`, `processed/`) inside the project you are working in, created on first use. Your documents and deliverables are never written into `~/.claude/skills/higgsfield/`, so updating or reinstalling the skill never touches them. The learning memory and generation ledger live in `~/.higgsfield-skill/db/`, outside the skill folder, so an update or reinstall keeps them too. The skill creates that folder on first use from its own `db/`, which also carries over the memory from an install older than v3.42.0. If you had two older installs (say a personal one and one inside a project), the second one's own entries are kept in `~/.higgsfield-skill/unmerged/`, not merged into the first; `where` lists them. In Cowork, or when you run the skill from a clone of this repo, the memory stays in the skill's own `db/`. To see which folder is in use, run `python3 scripts/higgsfield_memory.py where` from the skill's folder.
  50. ### Claude Cowork
  51. Drop the repo folder into your Cowork workspace. The skill dispatcher is at `SKILL.md` in the repo root.
  52. ### Claude.ai Projects
  53. Upload `SKILL.md` (root) as your project instruction base. Upload files from `skills/` as project documents.
  54. ## Higgsfield Stack Integration
  55. This skill is the prompt-construction layer. Higgsfield ships official execution tooling — a CLI, an MCP custom connector, and a bundled skills package. They complement each other: this skill produces the prompt, their tooling executes it. None of their tooling is required for this skill to work — you can always paste prompts directly into higgsfield.ai. But if you want an end-to-end loop, you'll want one of the three.
  56. **A Higgsfield account is required** for any of the tooling below. Sign up at [higgsfield.ai](https://higgsfield.ai).
  57. ### Higgsfield CLI
  58. Command-line tool for terminal-native agents (Claude Code, Codex, Cursor). Per Higgsfield's own guidance, prefer the CLI over the MCP if you're working in a terminal.
  59. - Repo: [github.com/higgsfield-ai/cli](https://github.com/higgsfield-ai/cli)
  60. - Install: `curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh` or `brew install higgsfield-ai/tap/higgsfield`
  61. - Auth: `higgsfield auth login`
  62. ### Higgsfield MCP
  63. Custom connector for claude.ai web and the Claude desktop app. Separate product from the CLI.
  64. - Connector URL: `https://mcp.higgsfield.ai/mcp`
  65. - Install: claude.ai → Settings → Connectors → Add custom connector → paste the URL above → sign in
  66. ### Higgsfield Bundled Skills
  67. Markdown skill bundle for agents that consume Cowork-style skills. All three skills drive the CLI under the hood.
  68. - Repo: [github.com/higgsfield-ai/skills](https://github.com/higgsfield-ai/skills)
  69. - Install: `npx skills add higgsfield-ai/skills`
  70. - Skills included: `higgsfield-generate`, `higgsfield-soul`, `higgsfield-product-photoshoot`
  71. - Invoke: `/higgsfield:generate`, `/higgsfield:soul`, `/higgsfield:product-photoshoot`
  72. ### End-to-end example
  73. How the layers fit together for a real request:
  74. ```
  75. USER: "Make me a cinematic chase scene through a night market.
  76. Use my trained Soul character — reference_id abc123."
  77. ↓
  78. THIS SKILL — higgsfield-ai-prompt-skill
  79. • routes to higgsfield-prompt + higgsfield-camera + higgsfield-soul
  80. • picks Kling 3.0 (character-focused, supports --soul-id)
  81. • applies MCSLA: model, camera preset, subject, look, action
  82. • appends shared negative constraints
  83. • outputs a production-grade Higgsfield prompt
  84. ↓
  85. PRE-FLIGHT (optional, recommended for Veo / Kling / Seedance video):
  86. SCHEMA VERIFY (recommended for any model you haven't called recently):
  87. CLI path: higgsfield model get kling3_0
  88. → returns schema: aspect_ratio enum, duration range,
  89. mode/sound options, media roles
  90. MCP path: models_explore(action="get", model_id="kling3_0")
  91. → returns same schema as CLI
  92. COST ESTIMATE (no job submitted):
  93. MCP path: generate_video(..., get_cost: true)
  94. → returns credit cost + adjustments block
  95. CLI path: higgsfield generate cost kling3_0 \
  96. --prompt "<prompt from this skill>" \
  97. --aspect_ratio 16:9 \
  98. --duration 8
  99. # (add reference flags as needed: --soul-id, --start-image,
  100. # --end-image — consult `higgsfield model get kling3_0`
  101. # for supported media roles)
  102. Bundled skills: drop to CLI for the cost check (same auth, same workspace),
  103. then invoke /higgsfield:generate
  104. Optional account checks (same data across surfaces):
  105. MCP path: balance / transactions tools
  106. CLI path: higgsfield account status
  107. higgsfield account transactions --size 50
  108. Note: 2.35:1 is anamorphic STYLE vocabulary, not a valid Kling 3.0 output
  109. ratio. Output ratios are platform-bounded: 16:9 / 9:16 / 1:1 only.
  110. ↓
  111. HIGGSFIELD STACK — one of three execution surfaces:
  112. CLI path:
  113. higgsfield generate create kling3_0 \
  114. --prompt "<prompt from this skill>" \
  115. --aspect_ratio 16:9 \
  116. --duration 8 \
  117. --wait
  118. # (add reference flags as needed: --soul-id, --start-image, --end-image —
  119. # consult `higgsfield model get kling3_0` for supported media roles)
  120. Bundled skills path:
  121. /higgsfield:generate — takes the prompt as its --prompt argument,
  122. formats the CLI call above under the hood
  123. MCP path (claude.ai web/desktop):
  124. Claude invokes the Higgsfield connector with the prompt as input
  125. ↓
  126. USER: Result URL returned. Iterate if needed (this skill's
  127. iteration discipline applies regardless of execution surface).
  128. ```
  129. The layer split holds in every case: this skill always produces the prompt, the Higgsfield stack always handles the generation call. None of the three execution paths reach back into prompt construction; this skill never shells out to their CLI or API.
  130. > Full preflight discipline — when to surface it, marketing-studio caveat, CLI naming gotchas (`account status`, not `balance`), and the plan-tier-vs-surface framing — lives in [`skills/higgsfield-stack/SKILL.md`](skills/higgsfield-stack/SKILL.md) § Preflight discipline.
  131. ### Coexistence rules
  132. For the full coexistence rules, detection signals, naming-collision callouts, and handoff templates, see [`skills/higgsfield-stack/SKILL.md`](skills/higgsfield-stack/SKILL.md).
  133. ## Structure
  134. ```
  135. .
  136. ├── SKILL.md ← Main dispatcher (routes to sub-skills — start here)
  137. ├── README.md ← This file
  138. ├── CHANGELOG.md ← Version history
  139. ├── CONTRIBUTING.md ← Contribution guidelines
  140. ├── LICENSE ← MIT license
  141. ├── CLAUDE.md ← Project instructions for Claude Code
  142. ├── .markdownlint.json ← Linter config (CHANGELOG convention silencing — v3.6.1)
  143. ├── model-guide.md ← Model comparison tables + decision flowchart
  144. ├── image-models.md ← Image model reference + pricing tiers
  145. ├── vocab.md ← Full platform vocabulary reference
  146. ├── prompt-examples.md ← High-quality example prompts + Before/After pairs
  147. ├── photodump-presets.md ← Photodump mode presets
  148. ├── DISCIPLINE.md ← Cross-cutting discipline framework (9 patterns, 3-3-3 tier symmetry)
  149. ├── production-benchmarks.md ← Production-quality anchors + acceptance-rate calibration
  150. ├── scripts/ ← Python tooling (run from the repo root)
  151. │ ├── higgsfield_memory.py ← Memory system script
  152. │ ├── seedance_lint.py ← Seedance preflight linter
  153. │ ├── validate.py ← Pre-release validation script
  154. │ ├── build_index.py ← Regenerates INDEX.md + checks QUICK FACTS anchors
  155. │ ├── sync_specs.py ← Regenerates specs/ from a models_explore snapshot
  156. │ ├── refresh_specs.py ← Spec-drift tripwire (live CLI vs baseline; params, ranges, media roles)
  157. │ ├── snapshot_crosscheck.py ← Two-way structural check: models_explore snapshot vs live CLI
  158. │ ├── preflight.py ← Free any-model platform-constraint preflight (enums + CEL rules, fails closed)
  159. │ ├── claims_lint.py ← Doctrine claims vs today's specs (registry: evals/spec-claims.json)
  160. │ ├── repo_walk.py ← Repo file walks that skip agent worktrees
  161. │ ├── user_guide_content.py ← USER-GUIDE content derived from disk (dependency-free)
  162. │ ├── generate_user_guide.py ← USER-GUIDE.pdf generator (Path B refactor — v3.7.0)
  163. │ ├── validate_user_guide.py ← USER-GUIDE.pdf drift validator (text-extract + binary diff)
  164. │ └── sub_skill_descriptions.py ← Canonical sub-skill roster (shared data module)
  165. ├── db/
  166. │ ├── filter-memory.json ← Content filter memory (seeded)
  167. │ └── quality-memory.json ← Quality failure memory (seeded)
  168. ├── docs/ ← Extended reference documents
  169. │ ├── Seedance 2 Skill.md ← Bilingual EN+ZH Seedance director reference
  170. │ ├── archive/ ← Historical records
  171. │ │ ├── HISTORY.md ← Consolidated v3.0.0–v3.6.0 audit + inventory snapshots
  172. │ │ └── AUDIT-2026-06-03.md ← Full repo audit (security, bugs, docs hygiene)
  173. │ └── user-guide/ ← Exported USER-GUIDE.pdf + current-version baseline (rotate, not accumulate)
  174. ├── templates/ ← Genre templates + Seedance coordination + text-overlays
  175. │ ├── 01-cinematic-action-chase.md
  176. │ ├── 02-product-ugc-showcase.md
  177. │ ├── 03-horror-atmosphere.md
  178. │ ├── 04-fashion-editorial.md
  179. │ ├── 05-sci-fi-vfx.md
  180. │ ├── 06-portrait-character-intro.md
  181. │ ├── 07-landscape-establishing-shot.md
  182. │ ├── 08-comedy-social-media.md
  183. │ ├── 09-romantic-intimate.md
  184. │ ├── 10-dance-music-performance.md
  185. │ ├── seedance/ ← Seedance technique templates (10)
  186. │ │ ├── multi-character-anchor.md
  187. │ │ ├── single-character-position.md
  188. │ │ ├── top-down-map.md
  189. │ │ ├── omni-reference-2-5.md ← Seedance 2.5 multi-reference brief
  190. │ │ └── worked-example-two-character.md
  191. │ └── text-overlays/ ← Text overlay templates
  192. │ ├── slogan.md
  193. │ ├── speech-bubble.md
  194. │ └── subtitle.md
  195. └── skills/
  196. ├── shared/
  197. │ └── negative-constraints.md ← Shared artifact prevention reference
  198. ├── higgsfield-prompt/SKILL.md ← Core MCSLA formula + prompt structure + Identity/Motion separation
  199. ├── higgsfield-image-shots/SKILL.md ← Cinematic image prompting (shots, angles, composition)
  200. ├── higgsfield-gpt-image-2/
  201. │ ├── SKILL.md ← GPT Image 2.0 director (JSON / prose / meta-prompt taxonomy)
  202. │ ├── reference-sheet-workflow.md ← Automatic product reference-sheet workflow
  203. │ └── static-ads-workflow.md ← Static-ad recreation workflow
  204. ├── higgsfield-models/
  205. │ ├── SKILL.md ← Compact model selection guide
  206. │ └── MODELS-DEEP-REFERENCE.md ← Full per-model documentation (on-demand)
  207. ├── higgsfield-camera/SKILL.md ← All camera controls + usage
  208. ├── higgsfield-motion/SKILL.md ← Named motion presets library
  209. ├── higgsfield-style/SKILL.md ← Visual styles + color grades + lighting
  210. ├── higgsfield-soul/SKILL.md ← Soul ID character consistency
  211. ├── higgsfield-audio/SKILL.md ← Audio prompting + Cinema Studio 3.0 native audio
  212. ├── higgsfield-apps/SKILL.md ← One-click Apps guide
  213. ├── higgsfield-recipes/SKILL.md ← Genre scene templates
  214. ├── higgsfield-troubleshoot/SKILL.md ← Fix failing generations
  215. ├── higgsfield-assist/SKILL.md ← General assistant + platform guidance
  216. ├── higgsfield-mixed-media/SKILL.md ← Mixed media + hybrid generation
  217. ├── higgsfield-moodboard/SKILL.md ← Moodboard creation workflows
  218. ├── higgsfield-pipeline/SKILL.md ← Multi-step generation pipelines
  219. ├── higgsfield-canvas/SKILL.md ← Node-based Canvas workspace + named patterns + Shared Canvas
  220. ├── higgsfield-content-factory/
  221. │ ├── SKILL.md ← Campaign pipeline (research → plan → generate → publish → report)
  222. │ └── publish-and-report-workflow.md ← Publish + cost-savings report satellite
  223. ├── higgsfield-marketing-studio/
  224. │ ├── SKILL.md ← Marketing Studio: 9 ad presets + 4–15s ad video
  225. │ └── cross-surface-workflow.md ← ms_image / DTC Ads cross-surface workflow
  226. ├── higgsfield-recall/SKILL.md ← Recall + regeneration patterns
  227. ├── higgsfield-3d/SKILL.md ← 3D meshes (image / multi-view / text → GLB), rigging, 3D Jutsu scenes
  228. ├── higgsfield-repurpose/SKILL.md ← Finished video in: Shorts Studio, Clipify, Virality Predictor, Video Analysis
  229. ├── higgsfield-cinema/SKILL.md ← Cinema Studio 2.5 + 3.0 + 3.5 + 4.0 (Soul Cast, Color Grading, 3D Mode, Smart Mode, @ References, Native Audio, three-pill UI, Image Mode, Cinematic models picker)
  230. ├── higgsfield-seedance/
  231. │ ├── SKILL.md ← Seedance 2.0 prompt director + content-filter preflight
  232. │ ├── ENGINE-RULES.md ← Hard rendering constraints shared across the Seedance family
  233. │ ├── PRODUCTION-PATTERNS.md ← Tutorial-demonstrated production patterns
  234. │ ├── HELL-GRIND.md ← Higgsfield's open-sourced 95-min feature pipeline
  235. │ └── FAILURE-MODES.md ← 15 named Seedance render failures (symptom · mechanism · counter)
  236. ├── higgsfield-seedance-2-5/
  237. │ ├── SKILL.md ← Seedance 2.5 omni-reference dialect + 4-mode router
  238. │ ├── MODE-PLAYBOOKS.md ← Edit / extend / storyboard / blockout / one-click / transitions
  239. │ └── VFX-PIPELINE.md ← AI-VFX pipeline: asset routing, size-ref frame, omni_reference v2v, slop catalog
  240. ├── higgsfield-acting/SKILL.md ← Performance craft: objective, beats, eye life, master profile
  241. ├── higgsfield-scene-engine/SKILL.md ← Structural scene audit: goal · obstacle · tactic · reversal · value shift
  242. ├── higgsfield-vibe-motion/SKILL.md ← Vibe-based motion direction
  243. └── higgsfield-workspaces/SKILL.md ← Workspace-first decision layer (Cinema Studio / Lipsync / Draw-to-Video / Viral Hub presets / Click to Ad / Higgsfield Audio)
  244. ```
  245. ## Generation Ledger
  246. Every generation attempt — kept, rejected, or filter-flagged — gets one row in
  247. `ledger/<project>.json` in the memory folder, logged by the agent in ≤5 seconds (one question,
  248. one command — never a form). After ~30–40 rows a production has empirical
  249. takes-per-kept ratios per shot type instead of vibes:
  250. ```bash
  251. python3 scripts/higgsfield_memory.py log-gen adze --model seedance_2_0 \
  252. --tags dialogue-cu,two-char --outcome rejected --reason extra-cuts
  253. python3 scripts/higgsfield_memory.py ratio adze --credits # hit rates + money view
  254. python3 scripts/higgsfield_memory.py budget adze --shots plan.json # price before burning
  255. ```
  256. Tags and reject reasons come from controlled vocabularies (`db/ledger/README.md`);
  257. rows are append-only with superseding corrections; `ratio` splits structural vs
  258. stochastic rejections and flags `low-n` rows instead of faking precision.
  259. ## Maintenance — two activation steps
  260. Two capabilities ship **inactive on purpose** and need a one-time setup.
  261. ### 1. Activate the scheduled spec-drift check
  262. `.github/workflows/spec-drift.yml` runs `scripts/refresh_specs.py` weekly to catch when
  263. Higgsfield changes a model's lineup or capabilities before the 30-day staleness
  264. warning would. It ships **dormant** until you give it the Higgsfield CLI
  265. credentials as a repo secret:
  266. ```bash
  267. higgsfield auth login # if not already authenticated locally
  268. gh secret set HIGGSFIELD_CREDENTIALS < ~/.config/higgsfield/credentials.json
  269. ```
  270. Then run it once manually (Actions tab → **spec-drift** → *Run workflow*) to
  271. confirm the CLI-install step resolves on the runner. After that it's automatic:
  272. **fresh** → nothing; **drift** → it opens/updates a GitHub issue with next steps;
  273. **auth expired** → the job fails so GitHub notifies you to re-run
  274. `higgsfield auth login` and refresh the secret. The credentials live only in the
  275. GitHub secret — they are never committed.
  276. ### 2. Let routing telemetry accumulate before pruning
  277. `log-route` / `routing` (in `scripts/higgsfield_memory.py`) record which sub-skills each
  278. request opens, so "which skills are load-bearing, which to retire" becomes a
  279. data question:
  280. ```bash
  281. python3 scripts/higgsfield_memory.py log-route --skills higgsfield-prompt,higgsfield-camera
  282. python3 scripts/higgsfield_memory.py routing # ranks opens, lists the never-opened tail
  283. ```
  284. This is **instrumentation, not a verdict** — let real requests accumulate before
  285. acting on the tail. A small sample is not evidence a skill is dead.
  286. ## Example Prompts
  287. **Basic:**
  288. > "Write me a Higgsfield prompt for a cinematic action chase through a night market"
  289. **Specific:**
  290. > "I need a horror prompt using VHS style, Dutch angle camera, and the Horror Face preset"
  291. **With reference:**
  292. > "I have a Soul ID character. Write 3 different scene prompts with her — office, party, rooftop"
  293. **Model question:**
  294. > "Should I use Kling 3.0 or Seedance 2.0 for a large-scale battle scene?"
  295. **Troubleshoot:**
  296. > "My image-to-video isn't animating, it's just static. What am I doing wrong?"
  297. ## The MCSLA Formula
  298. | Letter | Layer | Example |
  299. |--------|-------|---------|
  300. | M | Model | Kling 3.0 |
  301. | C | Camera | FPV Drone weaving through the alley |
  302. | S | Subject | A woman in a tactical jacket |
  303. | L | Look | Cinematic, cold blue shadows, 16:9 |
  304. | A | Action | She sprints, slides under a gate |
  305. ## Acknowledgements
  306. - [@vitaesomniastore-commits](https://github.com/vitaesomniastore-commits) — skill-authoring
  307. review of v3.40.0 against Anthropic's skill best practices
  308. ([#110](https://github.com/OSideMedia/higgsfield-ai-prompt-skill/issues/110)), which shaped
  309. v3.41.0.
  310. ---
  311. Built February 2026 · v3.42.0 (updated 2026-10-23) · Platform: [higgsfield.ai](https://higgsfield.ai)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.