A comprehensive Claude skill library for generating high-quality prompts on Higgsfield AI — the cinematic video and image generation platform.
$ npx -y skills add OSideMedia/higgsfield-ai-prompt-skill --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
What's inside
A comprehensive Claude skill library for generating high-quality prompts on Higgsfield AI — the cinematic video and image generation platform.
Transforms natural language requests into production-ready Higgsfield prompts using:
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, in-prompt first-last-frame and multi-keyframe control, storyboard grids, coarse-vs-fine blockout rendering, one-click video, seamless transitions, and a 2.0-vs-2.5 routing tableomni_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 awaygit clone https://github.com/OSideMedia/higgsfield-ai-prompt-skill ~/.claude/skills/higgsfield
Drop the repo folder into your Cowork workspace. The skill dispatcher is at SKILL.md in the repo root.
Upload SKILL.md (root) as your project instruction base. Upload files from skills/ as project documents.
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.
A Higgsfield account is required for any of the tooling below. Sign up at higgsfield.ai.
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.
curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh or brew install higgsfield-ai/tap/higgsfieldhiggsfield auth loginCustom connector for claude.ai web and the Claude desktop app. Separate product from the CLI.
https://mcp.higgsfield.ai/mcpMarkdown skill bundle for agents that consume Cowork-style skills. All three skills drive the CLI under the hood.
npx skills add higgsfield-ai/skillshiggsfield-generate, higgsfield-soul, higgsfield-product-photoshoot/higgsfield:generate, /higgsfield:soul, /higgsfield:product-photoshootHow the layers fit together for a real request:
USER: "Make me a cinematic chase scene through a night market.
Use my trained Soul character — reference_id abc123."
↓
THIS SKILL — higgsfield-ai-prompt-skill
• routes to higgsfield-prompt + higgsfield-camera + higgsfield-soul
• picks Kling 3.0 (character-focused, supports --soul-id)
• applies MCSLA: model, camera preset, subject, look, action
• appends shared negative constraints
• outputs a production-grade Higgsfield prompt
↓
PRE-FLIGHT (optional, recommended for Veo / Kling / Sora / Seedance video):
SCHEMA VERIFY (recommended for any model you haven't called recently):
CLI path: higgsfield model get kling3_0
→ returns schema: aspect_ratio enum, duration range,
mode/sound options, media roles
MCP path: models_explore(action="get", model_id="kling3_0")
→ returns same schema as CLI
COST ESTIMATE (no job submitted):
MCP path: generate_video(..., get_cost: true)
→ returns credit cost + adjustments block
CLI path: higgsfield generate cost kling3_0 \
--prompt "<prompt from this skill>" \
--aspect_ratio 16:9 \
--duration 8
# (add reference flags as needed: --soul-id, --start-image,
# --end-image — consult `higgsfield model get kling3_0`
# for supported media roles)
Bundled skills: drop to CLI for the cost check (same auth, same workspace),
then invoke /higgsfield:generate
Optional account checks (same data across surfaces):
MCP path: balance / transactions tools
CLI path: higgsfield account status
higgsfield account transactions --size 50
Note: 2.35:1 is anamorphic STYLE vocabulary, not a valid Kling 3.0 output
ratio. Output ratios are platform-bounded: 16:9 / 9:16 / 1:1 only.
↓
HIGGSFIELD STACK — one of three execution surfaces:
CLI path:
higgsfield generate create kling3_0 \
--prompt "<prompt from this skill>" \
--aspect_ratio 16:9 \
--duration 8 \
--wait
# (add reference flags as needed: --soul-id, --start-image, --end-image —
# consult `higgsfield model get kling3_0` for supported media roles)
Bundled skills path:
/higgsfield:generate — takes the prompt as its --prompt argument,
formats the CLI call above under the hood
MCP path (claude.ai web/desktop):
Claude invokes the Higgsfield connector with the prompt as input
↓
USER: Result URL returned. Iterate if needed (this skill's
iteration discipline applies regardless of execution surface).
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.
Full preflight discipline — when to surface it, marketing-studio caveat, CLI naming gotchas (
account status, notbalance), and the plan-tier-vs-surface framing — lives inskills/higgsfield-stack/SKILL.md§ Preflight discipline.
For the full coexistence rules, detection signals, naming-collision callouts, and handoff templates, see skills/higgsfield-stack/SKILL.md.
.
├── SKILL.md ← Main dispatcher (routes to sub-skills — start here)
├── README.md ← This file
├── CHANGELOG.md ← Version history
├── CONTRIBUTING.md ← Contribution guidelines
├── LICENSE ← MIT license
├── CLAUDE.md ← Project instructions for Claude Code
├── .markdownlint.json ← Linter config (CHANGELOG convention silencing — v3.6.1)
├── model-guide.md ← Model comparison tables + decision flowchart
├── image-models.md ← Image model reference + pricing tiers
├── vocab.md ← Full platform vocabulary reference
├── prompt-examples.md ← High-quality example prompts + Before/After pairs
├── photodump-presets.md ← Photodump mode presets
├── DISCIPLINE.md ← Cross-cutting discipline framework (9 patterns, 3-3-3 tier symmetry)
├── production-benchmarks.md ← Production-quality anchors + acceptance-rate calibration
├── scripts/ ← Python tooling (run from the repo root)
│ ├── higgsfield_memory.py ← Memory system script
│ ├── seedance_lint.py ← Seedance preflight linter
│ ├── validate.py ← Pre-release validation script
│ ├── build_index.py ← Regenerates INDEX.md + checks QUICK FACTS anchors
│ ├── sync_specs.py ← Regenerates specs/ from a models_explore snapshot
│ ├── refresh_specs.py ← Spec-drift tripwire (live CLI vs baseline)
│ ├── generate_user_guide.py ← USER-GUIDE.pdf generator (Path B refactor — v3.7.0)
│ ├── validate_user_guide.py ← USER-GUIDE.pdf drift validator (text-extract + binary diff)
│ └── sub_skill_descriptions.py ← Canonical sub-skill roster (shared data module)
├── db/
│ ├── filter-memory.json ← Content filter memory (seeded)
│ └── quality-memory.json ← Quality failure memory (seeded)
├── docs/ ← Extended reference documents
│ ├── Seedance 2 Skill.md ← Bilingual EN+ZH Seedance director reference
│ ├── archive/ ← Historical records
│ │ ├── HISTORY.md ← Consolidated v3.0.0–v3.6.0 audit + inventory snapshots
│ │ └── AUDIT-2026-06-03.md ← Full repo audit (security, bugs, docs hygiene)
│ └── user-guide/ ← Exported USER-GUIDE.pdf + current-version baseline (rotate, not accumulate)
├── templates/ ← Genre templates + Seedance coordination + text-overlays
│ ├── 01-cinematic-action-chase.md
│ ├── 02-product-ugc-showcase.md
│ ├── 03-horror-atmosphere.md
│ ├── 04-fashion-editorial.md
│ ├── 05-sci-fi-vfx.md
│ ├── 06-portrait-character-intro.md
│ ├── 07-landscape-establishing-shot.md
│ ├── 08-comedy-social-media.md
│ ├── 09-romantic-intimate.md
│ ├── 10-dance-music-performance.md
│ ├── seedance/ ← Seedance technique templates (9)
│ │ ├── multi-character-anchor.md
│ │ ├── single-character-position.md
│ │ ├── top-down-map.md
│ │ ├── omni-reference-2-5.md ← Seedance 2.5 multi-reference brief
│ │ └── worked-example-two-character.md
│ └── text-overlays/ ← Text overlay templates
│ ├── slogan.md
│ ├── speech-bubble.md
│ └── subtitle.md
└── skills/
├── shared/
│ └── negative-constraints.md ← Shared artifact prevention reference
├── higgsfield-prompt/SKILL.md ← Core MCSLA formula + prompt structure + Identity/Motion separation
├── higgsfield-image-shots/SKILL.md ← Cinematic image prompting (shots, angles, composition)
├── higgsfield-gpt-image-2/
│ ├── SKILL.md ← GPT Image 2.0 director (JSON / prose / meta-prompt taxonomy)
│ ├── reference-sheet-workflow.md ← Automatic product reference-sheet workflow
│ └── static-ads-workflow.md ← Static-ad recreation workflow
├── higgsfield-models/
│ ├── SKILL.md ← Compact model selection guide
│ └── MODELS-DEEP-REFERENCE.md ← Full per-model documentation (on-demand)
├── higgsfield-camera/SKILL.md ← All camera controls + usage
├── higgsfield-motion/SKILL.md ← Named motion presets library
├── higgsfield-style/SKILL.md ← Visual styles + color grades + lighting
├── higgsfield-soul/SKILL.md ← Soul ID character consistency
├── higgsfield-audio/SKILL.md ← Audio prompting + Cinema Studio 3.0 native audio
├── higgsfield-apps/SKILL.md ← One-click Apps guide
├── higgsfield-recipes/SKILL.md ← Genre scene templates
├── higgsfield-troubleshoot/SKILL.md ← Fix failing generations
├── higgsfield-assist/SKILL.md ← General assistant + platform guidance
├── higgsfield-mixed-media/SKILL.md ← Mixed media + hybrid generation
├── higgsfield-moodboard/SKILL.md ← Moodboard creation workflows
├── higgsfield-pipeline/SKILL.md ← Multi-step generation pipelines
├── higgsfield-canvas/SKILL.md ← Node-based Canvas workspace + named patterns + Shared Canvas
├── higgsfield-content-factory/
│ ├── SKILL.md ← Campaign pipeline (research → plan → generate → publish → report)
│ └── publish-and-report-workflow.md ← Publish + cost-savings report satellite
├── higgsfield-marketing-studio/
│ ├── SKILL.md ← Marketing Studio: 9 ad presets + 4–15s ad video
│ └── cross-surface-workflow.md ← ms_image / DTC Ads cross-surface workflow
├── higgsfield-recall/SKILL.md ← Recall + regeneration patterns
├── higgsfield-cinema/SKILL.md ← Cinema Studio 2.5 + 3.0 + 3.5 (Soul Cast, Color Grading, 3D Mode, Smart Mode, @ References, Native Audio, three-pill UI, Image Mode, Cinematic models picker)
├── higgsfield-seedance/
│ ├── SKILL.md ← Seedance 2.0 prompt director + content-filter preflight
│ ├── ENGINE-RULES.md ← Hard rendering constraints shared across the Seedance family
│ ├── PRODUCTION-PATTERNS.md ← Tutorial-demonstrated production patterns
│ ├── HELL-GRIND.md ← Higgsfield's open-sourced 95-min feature pipeline
│ └── FAILURE-MODES.md ← 8 named Seedance render failures (symptom · mechanism · counter)
├── higgsfield-seedance-2-5/
│ ├── SKILL.md ← Seedance 2.5 omni-reference dialect + 4-mode router
│ ├── MODE-PLAYBOOKS.md ← Edit / extend / storyboard / blockout / one-click / transitions
│ └── VFX-PIPELINE.md ← AI-VFX pipeline: asset routing, size-ref frame, omni_reference v2v, slop catalog
├── higgsfield-acting/SKILL.md ← Performance craft: objective, beats, eye life, master profile
├── higgsfield-vibe-motion/SKILL.md ← Vibe-based motion direction
└── higgsfield-workspaces/SKILL.md ← Workspace-first decision layer (Cinema Studio / Lipsync / Draw-to-Video / Sora 2 Trends / Click to Ad / Higgsfield Audio)
Every generation attempt — kept, rejected, or filter-flagged — gets one row in
db/ledger/<project>.json, logged by the agent in ≤5 seconds (one question,
one command — never a form). After ~30–40 rows a production has empirical
takes-per-kept ratios per shot type instead of vibes:
python3 scripts/higgsfield_memory.py log-gen adze --model seedance_2_0 \
--tags dialogue-cu,two-char --outcome rejected --reason extra-cuts
python3 scripts/higgsfield_memory.py ratio adze --credits # hit rates + money view
python3 scripts/higgsfield_memory.py budget adze --shots plan.json # price before burning
Tags and reject reasons come from controlled vocabularies (db/ledger/README.md);
rows are append-only with superseding corrections; ratio splits structural vs
stochastic rejections and flags low-n rows instead of faking precision.
Two capabilities ship inactive on purpose and need a one-time setup.
.github/workflows/spec-drift.yml runs scripts/refresh_specs.py weekly to catch when
Higgsfield changes a model's lineup or capabilities before the 30-day staleness
warning would. It ships dormant until you give it the Higgsfield CLI
credentials as a repo secret:
higgsfield auth login # if not already authenticated locally
gh secret set HIGGSFIELD_CREDENTIALS < ~/.config/higgsfield/credentials.json
Then run it once manually (Actions tab → spec-drift → Run workflow) to
confirm the CLI-install step resolves on the runner. After that it's automatic:
fresh → nothing; drift → it opens/updates a GitHub issue with next steps;
auth expired → the job fails so GitHub notifies you to re-run
higgsfield auth login and refresh the secret. The credentials live only in the
GitHub secret — they are never committed.
log-route / routing (in scripts/higgsfield_memory.py) record which sub-skills each
request opens, so "which skills are load-bearing, which to retire" becomes a
data question:
python3 scripts/higgsfield_memory.py log-route --skills higgsfield-prompt,higgsfield-camera
python3 scripts/higgsfield_memory.py routing # ranks opens, lists the never-opened tail
This is instrumentation, not a verdict — let real requests accumulate before acting on the tail. A small sample is not evidence a skill is dead.
Basic:
"Write me a Higgsfield prompt for a cinematic action chase through a night market"
Specific:
"I need a horror prompt using VHS style, Dutch angle camera, and the Horror Face preset"
With reference:
"I have a Soul ID character. Write 3 different scene prompts with her — office, party, rooftop"
Model question:
"Should I use Kling 3.0 or Sora 2 for a large-scale battle scene?"
Troubleshoot:
"My image-to-video isn't animating, it's just static. What am I doing wrong?"
| Letter | Layer | Example |
|---|---|---|
| M | Model | Kling 3.0 |
| C | Camera | FPV Drone weaving through the alley |
| S | Subject | A woman in a tactical jacket |
| L | Look | Cinematic, cold blue shadows, 16:9 |
| A | Action | She sprints, slides under a gate |
Built February 2026 · v3.26.0 (updated 2026-08-08) · Platform: higgsfield.ai
.claude/
commands/
release.md
validate.md
rules/
cinematic-vocab.md
image-models.md
model-reference.md
photodump-presets.md
prompt-formula.md
settings.json
.gitattributes
.github/
workflows/
spec-drift.yml
validate.yml
.gitignore
.markdownlint.json
assets/
fonts/
DejaVuSansCondensed-Bold.ttf
DejaVuSansCondensed-Oblique.ttf
DejaVuSansCondensed.ttf
DejaVuSansMono.ttf
README.md
CHANGELOG.md
CLAUDE.md
CONTRIBUTING.md
db/
filter-memory.json
ledger/
_demo.json
_global.json
README.md
memory-summary.md
quality-memory.json
routing-log.json
DISCIPLINE.md
docs/
archive/
AUDIT-2026-06-03.md
CHANGELOG-v3.0-v3.14.md
HISTORY.md
Seedance 2 Skill.md
user-guide/
MANIFEST.json
evals/
cases/
audio.json
cinema.json
harvest.json
models.json
prompt.json
seedance-2-5.json
seedance.json
run_evals.py
image-models.md
INDEX.md
LICENSE
model-guide.md
photodump-presets.md
production-benchmarks.md
prompt-examples.md
README.md
requirements.txt
scripts/
build_index.py
generate_user_guide.py
higgsfield_memory.py
refresh_specs.py
seedance_lint.py
sub_skill_descriptions.py
sync_specs.py
validate_user_guide.py
validate.py
SKILL.md
skills/
higgsfield-acting/
SKILL.md
higgsfield-apps/
SKILL.md
higgsfield-assist/
SKILL.md
higgsfield-audio/
SKILL.md
higgsfield-camera/
SKILL.md
higgsfield-canvas/
SKILL.md
higgsfield-character-design/
SKILL.md
higgsfield-cinema/
SKILL.md
higgsfield-content-factory/
publish-and-report-workflow.md
SKILL.md
higgsfield-facs/
SKILL.md
higgsfield-gpt-image-2/
reference-sheet-workflow.md
SKILL.md
static-ads-workflow.md
higgsfield-image-shots/
SKILL.md
higgsfield-marketing-studio/
cross-surface-workflow.md
SKILL.md
higgsfield-mixed-media/
SKILL.md
higgsfield-models/
MODELS-DEEP-REFERENCE.md
SKILL.md
higgsfield-moodboard/
SKILL.md
higgsfield-motion/
higgsfield-motion-design/
SKILL.md
SKILL.md
higgsfield-pipeline/
SKILL.md
higgsfield-prompt/
SKILL.md
higgsfield-recall/
SKILL.md
higgsfield-recipes/
SKILL.md
higgsfield-seedance/
higgsfield-seedance-2-5/
MODE-PLAYBOOKS.md
SKILL.md
VFX-PIPELINE.md
higgsfield-seedance-vfx/
references/
dialogue-timing.md
first-frame.md
SKILL.md
ENGINE-RULES.md
FAILURE-MODES.md
HELL-GRIND.md
PRODUCTION-PATTERNS.md
SKILL.md
higgsfield-shotlist-director/
SKILL.md
higgsfield-soul/
SKILL.md
higgsfield-stack/
SKILL.md
higgsfield-style/
SKILL.md
higgsfield-troubleshoot/
SKILL.md
higgsfield-vibe-motion/
SKILL.md
higgsfield-workspaces/
SKILL.md
shared/
negative-constraints.md
specs/
audio-model-specs.json
AUDIO-MODEL-SPECS.md
audio-model-specs.yaml
cli_baseline.json
image-model-specs.json
IMAGE-MODEL-SPECS.md
image-model-specs.yaml
model-specs.json
MODEL-SPECS.md
model-specs.yaml
models_explore_snapshot_2026-06-11.json
models_explore_snapshot_2026-06-22.json
models_explore_snapshot_2026-07-05.json
models_explore_snapshot_2026-08-01.json
models_explore_snapshot_2026-08-07.json
models_explore_snapshot_audio_2026-07-05.json
models_explore_snapshot_audio_2026-08-01.json
models_explore_snapshot_image_2026-06-22.json
models_explore_snapshot_image_2026-07-05.json
models_explore_snapshot_image_2026-08-01.json
templates/
01-cinematic-action-chase.md
02-product-ugc-showcase.md
03-horror-atmosphere.md
04-fashion-editorial.md
05-sci-fi-vfx.md
06-portrait-character-intro.md
07-landscape-establishing-shot.md
08-comedy-social-media.md
09-romantic-intimate.md
10-dance-music-performance.md
ad-asset-prep.md
character-design/
9-question-character-sheet.md
character-web.md
premise.md
story-spine.md
style-sheet.md
world-sheet.md
seedance/
anime-animation.md
facs-expression-beats.md
footage-vfx-transform.md
global-style-prefix.md
multi-character-anchor.md
omni-reference-2-5.md
single-character-position.md
top-down-map.md
worked-example-two-character.md
text-overlays/
slogan.md
speech-bubble.md
subtitle.md
tests/
conftest.py
fixtures/
cli_1_0_1_model_get_seedance_2_0.json
cli_1_0_1_model_list_video.json
models_explore_snapshot_2026-06-11.json
test_ledger.py
test_lint_rules.py
test_memory.py
test_refresh.py
test_routing.py
test_sync_specs.py
test_validate.py
vocab.md
workspace/
input/
.gitignore
README.md
output/
.gitignore
README.md
processed/
.gitignore
README.md
README.mdFAQ
higgsfield-ai-prompt-skill is a Claude Code plugin with 32 hand-picked skills for content work, indexed on Flowy. Install it with the command on its page. It includes higgsfield-acting, higgsfield-apps, higgsfield-assist. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.