Agent skill

Higgsfield Scene Engine

by OSideMedia in OSideMedia/higgsfield-ai-prompt-skill

Tests whether a scene is structurally worth generating before any shot is prompted — a five-element engine of Goal, Obstacle, Tactic, Reversal, and Value Shift.

MITAuto-check passedMedia & Creative

Install Higgsfield Scene Engine

skills CLI
$ npx skills add OSideMedia/higgsfield-ai-prompt-skill --skill higgsfield-scene-engine -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install OSideMedia/higgsfield-ai-prompt-skill higgsfield-scene-engine --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/OSideMedia/higgsfield-ai-prompt-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/higgsfield-scene-engine .claude/skills/higgsfield-scene-engine && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
higgsfield-scene-engine
GitHub stars
707
Token cost
~2.8k tokens
SKILL.md length
1,443 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

Tests whether a scene is structurally worth generating before any shot is prompted — a five-element engine of Goal, Obstacle, Tactic, Reversal, and Value Shift.

  • Works in 5 steps: Goal → Obstacle → Tactic → …
  • The user has a scene
  • SKILL.md covers The five-element engine, The causal chain, Audit procedure and Where this sits before prompting, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Higgsfield Scene Engine is an agent skill from OSideMedia/higgsfield-ai-prompt-skill. Tests whether a scene is structurally worth generating before any shot is prompted — a five-element engine of Goal, Obstacle, Tactic, Reversal, and Value Shift. Use when the user has a scene, sequence, beat outline, or script and wants it audited or strengthened; when a sequence generates cleanly but lands flat and nobody can say why; when shots look good individually but the run of them does not build; or when the user asks 'is this scene working', 'what's weak here', or 'why doesn't this land'. Upstream of…

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Comics and storyboards and AI video generation. The repository describes itself as: Claude AI skill for cinematic Higgsfield AI prompts — 32 sub-skills covering Seedance 2.5 (omni-reference, video edit + extend) and 2.0, the Hell Grind feature-film pipeline, an… The licence is MIT.

When your agent uses it

  • The user has a scene
  • Script and wants it audited
  • A sequence generates cleanly but lands flat and nobody can say why
  • Shots look good individually but the run of them does not build

Example prompts

  • “is this scene working”
  • “s weak here”
  • “why doesn”
  • “/higgsfield-scene-engine”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Goal
  2. Obstacle
  3. Tactic
  4. Reversal
  5. Value Shift

What it can do on your machine

Read from SKILL.md and the folder at commit 7075497. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Higgsfield Scene Engine loads about 2.8k tokens when it runs. Until then it costs about 188 tokens; SKILL.md has 1,443 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~188
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from OSideMedia/higgsfield-ai-prompt-skill at commit 7075497, republished under its MIT licence (© OSideMedia). 1,443 words, ~2,800 tokens.

Download SKILL.mdSave it as .claude/skills/higgsfield-scene-engine/SKILL.md (or your agent's skills folder).
name
higgsfield-scene-engine
description
Tests whether a scene is structurally worth generating before any shot is prompted — a five-element engine of Goal, Obstacle, Tactic, Reversal, and Value Shift. Use when the user has a scene, sequence, beat outline, or script and wants it audited or strengthened; when a sequence generates cleanly but lands flat and nobody can say why; when shots look good individually but the run of them does not build; or when the user asks 'is this scene working', 'what's weak here', or 'why doesn't this land'. Upstream of prompting — it decides WHICH shots deserve the credits, not how to write them. Pairs with higgsfield-character-design (who the characters are) and higgsfield-shotlist-director (turning the settled scene into shots).
user-invocable
true
metadata.tags
higgsfield, story, scene, structure, sequence, audit, dramaturgy, pre-production, reversal, value-shift
metadata.version
1.1.0
metadata.updated
2026-09-26
metadata.parent
higgsfield

Higgsfield Scene Engine — is this scene worth generating?

[EMPIRICAL — Tigran's tig-scene-engine skill (2026-06-26), re-derived 2026-08-22] These definitions are bespoke and deliberately not the textbook ones. Apply them as written; do not substitute standard screenwriting glosses, which are looser and will pass scenes this engine fails.

Why a prompter carries this. Every shot costs credits and iterations. A structurally dead scene generates just as cleanly as a live one — the model has no opinion about whether a beat earns its place — so the failure surfaces only after the footage exists and the cut does not build. This skill is the cheapest pass in the repo: it runs on text, before any generation, and its whole job is to stop you paying to render a scene that cannot work.

It decides which shots deserve the spend. higgsfield-shotlist-director turns the settled scene into shots; higgsfield-acting writes the performance inside them.


The five-element engine

1. Goal

The single, unchanging thing the hero is fighting for: to fix what has already been established and reach, as fast as possible, the result that resolves it. "Already established" means anything set up earlier — deep backstory, a few scenes ago, or one minute ago.

  • The major goal never changes, and the hero is never wrong about it. He can be wrong about tactics, never about the goal.
  • Every scene goal must be a causal link toward the story goal. Test: if you can remove the scene and the chain still holds, the scene fails. No orphan scenes.
  • "What he ought to do" is not a separate thing to test — the right move is dictated by Obstacle + Stakes. A hero taking a tactic the stakes would not justify (showering while the building burns) is a flaggable inconsistency: name it as bad writing or as deliberate self-sabotage.
2. Obstacle

A strong circumstance that jeopardizes either one stage of the path or the whole goal. It threatens; it does not merely cost.

  • It can be a branching search space (many places to look, limited time) or a single hard wall (a dead battery — you cannot search a dead machine). A wall typically spawns a fresh sub-goal with its own terrain.
  • Name its scale: local (threatens the current stage) or global (threatens the whole goal).
  • The obstacle is what forces the hero to choose or change a tactic. No jeopardy → no tactic needed → no scene.
  • Audit test: name what is at risk, and at what scale. If nothing genuinely is, the obstacle is fake and the scene goes slack.
3. Tactic

The move the threat forces the hero to choose — a reasonable guess on his current, often incomplete, knowledge. This is search under uncertainty, not error-as-stupidity.

  • A "wrong" tactic is not dumbness; it is a plausible probe of a space he cannot fully see. The engine is a knowledge gap: the distance between what he believes and what is.
  • Each failed tactic must return information that narrows the search and reshapes the next move. The drama is the narrowing, not the punishment.
  • ✅ good: the tactic is a reasonable bet on current info, and its failure teaches something new.
  • ❌ weak: a tactic he had no reason to try, or a failure that returns zero information — a wheel-spin. A failing tactic is only a weakness when the failure teaches nothing.
4. Reversal

A turn against expectation. Three forms:

  1. My own action flips on me — what I did for something starts working against it (I shower to make the pitch; the shower makes me late and I miss it).
  2. Hidden agency revealed — the thing or person I thought I was acting on was acting on me all along. The thriller move; it often fires exactly when the knowledge gap closes.
  3. The general case: the situation turns opposite to what the tactic intended.

Placement: at least one reversal per sequence. A single scene may be pure escalation, but a resolved sequence with zero reversals fails.

A sequence is the run of scenes from when a specific jeopardy opens to when it resolves — overcome, or it defeats him and forces a new path. Sequences nest, and each resolving unit needs its own reversal. Flag which scale you are auditing.

5. Value Shift

The change in the AUDIENCE'S read of a character, triggered by a reversal. The keystone, and the most misunderstood element: it does not happen on the page, it happens in the viewer's mind. Each reversal forces the audience to re-judge the character — a moving verdict they keep revising (nice → experienced → cunning → no, he's desperate → devoted son → what a man).

THE CORE RULE: a reversal with no value shift is inert. A structural turn is not a reversal unless it moves the audience's verdict. If you cannot name a before-verdict and an after-verdict the audience would hold, the turn is dead weight no matter how much plot flipped.

Audit the trajectory, not just presence: are the revaluations building a deepening portrait, or just oscillating?


The causal chain

Goal (fixed; every scene a causal link toward it) → Obstacle (jeopardizes a stage or the whole goal; name what is at risk + scale) → Tactic (forced by the threat; a reasonable guess; its outcome must return information) → Reversal (turn against expectation; ≥1 per resolved sequence) → Value Shift (the audience re-judges the character; no shift → the reversal is useless)


Show full SKILL.md (562 more words)Show less

Audit procedure

Work the chain in order. Reversal and Value Shift are judged at the sequence level, not the scene.

  1. Goal — state the scene goal in one line. Is it a causal link to the story goal? Apply the removal test. If you do not know the story goal, ask — you cannot fully audit Goal without it.
  2. Obstacle — name the circumstance, exactly what it jeopardizes, and the scale.
  3. Tactic — is each forced by the jeopardy, reasonable on current knowledge, and does each outcome return information? Flag wheel-spins and unmotivated tactics.
  4. Reversal — locate them, name the form, confirm ≥1 per resolved sequence.
  5. Value Shift — for each reversal, name before-verdict → after-verdict. If you cannot, mark it INERT and make it the priority fix. Then assess the trajectory.
Audit output
SCENE/SEQUENCE: <one-line identification>

CHAIN CHECK
• Goal — <verdict + one line>
• Obstacle — <what's jeopardized + scale + verdict>
• Tactic — <forced? reasonable? returns info? verdict>
• Reversal — <form + present? ≥1 in sequence? verdict>
• Value Shift — <before-verdict → after-verdict per reversal, or INERT; trajectory note>

WEAKEST POINT: <the single element that, if fixed, recovers the most>

WHAT IF…
1. (Minimal) <change ONLY the weakest point so the rest of their scene still works>
2. (Clean) <a version that fully works, even if it departs further from the original>
3. (Optional) <only if it genuinely adds something>

The three tiers matter in that order: minimal preserves the user's version, clean is yours, and the third is optional. Do not collapse them into one rewrite.


Where this sits before prompting

Once the chain holds, the scene is worth spending on — and only then:

NextSkill
Who these people are, and their bible../higgsfield-character-design/SKILL.md
The shared scene direction and each character's fuel../higgsfield-acting/SKILL.md § The layer above the pillars
Breaking the settled scene into shots../higgsfield-shotlist-director/SKILL.md
Writing the shot itself../higgsfield-seedance/SKILL.md · ../higgsfield-seedance-2-5/SKILL.md

The most common real failure to hunt for first: a reversal that turns the plot but does not move the audience's verdict. Surface it before anything else — it is the one that survives a read-through, generates beautifully, and still lands flat in the cut.

Same words, different layer — the term map to higgsfield-acting

This engine and ../higgsfield-acting/SKILL.md § The five pillars share three words and define them differently, on purpose: this file audits structure (does the scene earn its credits), acting writes playable behaviour (what the body does in the shot). Carry an audit result into acting through this map, not by assuming the words mean the same thing (../shared/house-rulings.md P3-5):

Here (structure)In acting (performance)How one feeds the other
Goal — the hero's single unchanging story goal; each scene goal a causal link toward itSuper-objective (story-wide) and objective — what one character wants in this scene, from a specific person, as a verb aimed at the partnerThe scene goal names the step; acting turns it into a partner-directed verb for each character, including the ones this audit never mentions
Obstacle — a circumstance that jeopardizes a stage or the whole goal; name what is at risk and its scaleObstacle and stakes — what prevents the want, external or internal (pride, disbelief), plus the cost of failureThe audited jeopardy becomes the stakes; acting adds the internal obstacles a structural audit does not look for
Tactic — the plot-level move the threat forces, a reasonable guess under uncertainty whose failure must return informationTactics — moment-to-moment action verbs toward the partner (press · charm · stall), changed when one failsOne structural tactic is usually played as several acting tactics; a structural wheel-spin shows up in acting as monotactics
Reversal and Value Shift — judged at the sequence level, in the audience's verdictBeats — each visible change of tactic; subtextA value shift needs a visible beat change to land on screen; if acting cannot point to the beat, the shift will not render
  • ../higgsfield-character-design/SKILL.md — premise, world, character, story bible
  • ../higgsfield-acting/SKILL.md — the performance layer inside a settled scene
  • ../higgsfield-shotlist-director/SKILL.md — scene → shot list

© OSideMedia, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/higgsfield-scene-engine of OSideMedia/higgsfield-ai-prompt-skill.

Open the folder on GitHubat commit 7075497

Compare with similar skills

Higgsfield Scene Engine next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Higgsfield Scene Engine compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Higgsfield Scene Engine this skillOSideMedia/higgsfield-ai-prompt-skill707—~2.8kAutomated safety check: PassMIT
Scroll Promo Site Builderkangarooking/kangarooking-skills661—~2.6kAutomated safety check: PassMIT
Motion Graphics Music Videomakevoid/motion-graphics-music-video-skill141—~3.3kAutomated safety check: PassMIT
Music VideoNoizAI/skills526—~1.5kAutomated safety check: PassNone
Video ComposeUtopai-Research/pai-code355—~4.1kAutomated safety check: PassCustom licence
Xianxia Cinematic Video Directorliyue-aigc/xianxia-cinematic-video-director269—~1.4kAutomated safety check: PassNone

Similar skills

  • Scroll Promo Site Builder

    kangarooking/kangarooking-skills

    Create a scroll-controlled cinematic product website with rich motion (动效网站) from product materials, reference pages or videos, and brand assets.

    661 GitHub stars~2.6k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Motion Graphics Music Video

    makevoid/motion-graphics-music-video-skill

    Create and revise animated character music videos from a supplied song and creative prompt, with researched storyboards, Fal character and video generation, p5 motion graphics, audio editing, and…

    141 GitHub stars~3.3k tokensUpdated 4 days ago
    Media & CreativeAuto-check passed
  • Music Video

    NoizAI/skills

    Build a music video from an existing song and lyrics, either as p5.js/p5.brush animation or by assembling local images and clips.

    526 GitHub stars~1.5k tokensUpdated 11 days ago
    Media & CreativeAuto-check passed
  • Video Compose

    Utopai-Research/pai-code

    Generates and prompts video clips on the filmmaking canvas. An agent skill from Utopai-Research/pai-code.

    355 GitHub stars~4.1k tokensUpdated 9 days ago
    Media & CreativeAuto-check passed
  • Xianxia Cinematic Video Director

    liyue-aigc/xianxia-cinematic-video-director

    Design, derive, optimize, explain, and diagnose cinematic Eastern xianxia camera direction, storyboards, motion choreography, pacing, continuity locks, keyframes, and per-shot image-to-video prompts.

    269 GitHub stars~1.4k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Seedance 2.0 Storyboard Prompts

    elementsix/elementsix-skills

    Interviews you about a video idea, then writes a timed shot-by-shot prompt for Seedance 2.0 using its image, video and audio reference syntax.

    311 GitHub stars~1.4k tokensUpdated 7 mo ago
    Media & CreativeAuto-check passed

More from OSideMedia/higgsfield-ai-prompt-skill

All 33 skills in this repo
  • Higgsfield

    OSideMedia/higgsfield-ai-prompt-skill

    A skill your agent uses 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…

    707 GitHub stars~9.1k tokensUpdated 12 days ago
    Auto-check passed
  • Higgsfield Assist

    OSideMedia/higgsfield-ai-prompt-skill

    A skill your agent uses when the user asks about Higgsfield Assist (the built-in GPT-5 copilot), how to use the platform's native AI assistant, credit optimization strategies, plan selection, how to…

    707 GitHub stars~2.9k tokensUpdated 12 days ago
    Auto-check passed
  • Higgsfield Image Shots

    OSideMedia/higgsfield-ai-prompt-skill

    A skill your agent uses when the user wants to generate a cinematic still image on Higgsfield, asks about shot framing, camera angle, or composition for image prompts, needs a specific shot type…

    707 GitHub stars~5.1k tokensUpdated 12 days ago
    Auto-check passed
  • Higgsfield Mixed Media

    OSideMedia/higgsfield-ai-prompt-skill

    A skill your agent uses when the user asks about Mixed Media, wants to apply artistic preset styles to an image (Noir, Sketch, Paper, Canvas, Particles, Neon, etc.), combine multiple artistic…

    707 GitHub stars~2.3k tokensUpdated 12 days ago
    Auto-check passed
  • Higgsfield Moodboard

    OSideMedia/higgsfield-ai-prompt-skill

    A skill your agent uses when the user asks about Moodboard, building a moodboard from reference images, curated moodboard presets, Soul Hex color transfer, applying a visual style direction to…

    707 GitHub stars~2.3k tokensUpdated 12 days ago
    Auto-check passed
  • Higgsfield Motion

    OSideMedia/higgsfield-ai-prompt-skill

    A skill your agent uses when the user wants to apply a named Higgsfield motion preset, asks about VFX presets, transformation effects, elemental effects, or transition presets.

    707 GitHub stars~5k tokensUpdated 12 days ago
    Auto-check passed

Questions about Higgsfield Scene Engine

What does Higgsfield Scene Engine do?

Tests whether a scene is structurally worth generating before any shot is prompted — a five-element engine of Goal, Obstacle, Tactic, Reversal, and Value Shift. Higgsfield Scene Engine is an agent skill from OSideMedia/higgsfield-ai-prompt-skill. Tests whether a scene is structurally worth generating before any shot is prompted — a five-element engine of Goal, Obstacle, Tactic, Reversal, and Value Shift.

When should I use Higgsfield Scene Engine?

Higgsfield Scene Engine fits situations like: the user has a scene; script and wants it audited; A sequence generates cleanly but lands flat and nobody can say why; shots look good individually but the run of them does not build.

How do I install Higgsfield Scene Engine in Claude Code?

Run `npx skills add OSideMedia/higgsfield-ai-prompt-skill --skill higgsfield-scene-engine -a claude-code`. Or copy the skill folder (skills/higgsfield-scene-engine in OSideMedia/higgsfield-ai-prompt-skill) into .claude/skills/higgsfield-scene-engine in your project. Claude Code loads it when a task matches its description.

How do I install Higgsfield Scene Engine in Codex?

Run `npx skills add OSideMedia/higgsfield-ai-prompt-skill --skill higgsfield-scene-engine -a codex`. Or copy the skill folder (skills/higgsfield-scene-engine in OSideMedia/higgsfield-ai-prompt-skill) into .agents/skills/higgsfield-scene-engine in your project. Codex loads it when a task matches its description.

Can I use Higgsfield Scene Engine in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add OSideMedia/higgsfield-ai-prompt-skill --skill higgsfield-scene-engine -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/higgsfield-scene-engine, .gemini/skills/higgsfield-scene-engine, .github/skills/higgsfield-scene-engine and .opencode/skills/higgsfield-scene-engine in your project.

What does Higgsfield Scene Engine need to run?

SKILL.md names no scripts, command-line tools or credentials: Higgsfield Scene Engine is instructions for the agent only.

Does Higgsfield Scene Engine access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Higgsfield Scene Engine safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Higgsfield Scene Engine use?

Higgsfield Scene Engine is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Higgsfield Scene Engine use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Higgsfield Scene Engine?

Skills that share tags, products or a category with Higgsfield Scene Engine: Scroll Promo Site Builder (kangarooking/kangarooking-skills, 661 stars), Motion Graphics Music Video (makevoid/motion-graphics-music-video-skill, 141 stars), Music Video (NoizAI/skills, 526 stars) and Video Compose (Utopai-Research/pai-code, 355 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Higgsfield Scene Engine?

OSideMedia (a GitHub user) maintains it in OSideMedia/higgsfield-ai-prompt-skill, which has 707 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on September 27, 2026.

Source: OSideMedia/higgsfield-ai-prompt-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.