All skills
hoodini avatar

/director

@6c79770

Award-winning director's brain for making films/videos with AI. Runs a gated, interrogation-first process: lock the IDEA and the SCRIPT (the story) in words before generating a single pixel, then plan shots/camera/light/sound, then generate and edit. Use whenever creating a video, film, teaser, trailer, promo, ad, short, reel, documentary, or narrative piece AND the storytelling must actually work — or any time the user says the story/script keeps failing. Hebrew triggers: סרטון, טיזר, פרומו, פרסומת, ריל, סרט, תסריט, סטוריבורד. Handles development, story, and shot-planning; composes with cinematic-ai-video and yuv-fomo-teaser (style/manipulation), hyperframes (render), nano-banana-2/ElevenLabs (assets). Backed by a 28-chapter Director's Bible in references/.

Use this Skill: https://skilld.dev/gh/hoodini/ai-agents-skills/director

This session only. Nothing lands on disk.

references21-theme-premise-moral-argument.md

≈4.7k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Theme, Premise & The Moral Argument

Structure (see 01-story-structure.md) tells you the shape of events. This chapter is about the spine beneath the shape — the single load-bearing idea that decides which events belong in your story at all. Most failed films (and most failed 60-second ads) are not broken at the beat level. They are broken because they are about nothing — or, worse, about several things at once, none of them pressed hard enough to leave a mark. A story with crisp craft and no spine feels slick and forgettable. A story with a fierce spine and rough craft still haunts you.

The trap for an advanced, AI-native creator is to treat "theme" as a soft, English-class afterthought — a label you slap on after the fun part. It is the opposite. Theme is the first engineering decision and the last quality gate. Everything in between is implementation.

The Five Terms, Disambiguated

These terms overlap in casual use, and writers conflate them constantly. They are not synonyms. Here is the precise ladder, from most abstract to most operational.

1. THEME — the subject (an abstract noun)

Theme is the topic your story explores: justice, loyalty, freedom, ambition, grief, identity. It is a single abstract word or short phrase. It is necessary but insufficient — "a film about loyalty" tells you nothing about what the film claims. A theme is a question's subject, not its answer. Treat it as the arena, not the verdict.

2. PREMISE — Egri's dramatized cause-and-effect statement

Lajos Egri, in The Art of Dramatic Writing (1942), rejects vague "theme" and demands a premise: a single sentence stating a cause that produces an effect. His canonical example for Romeo and Juliet is "Great love defies even death." Notice its three parts: a quality of character (great love), a conflict (defies), and an outcome (even death). Egri's rule is that the premise must be active and provable: "if you choose 'Great love defies even death,' you must believe in it, since you are to prove it." The whole play exists to demonstrate that proposition — the lovers literally die for love, proving the claim. A premise you can't dramatize to a clear yes/no is not yet a premise.

→ The premise is a promise to the audience and a contract with yourself. It tells you what your ending must prove.

3. CONTROLLING IDEA — McKee's value + cause

Robert McKee, in Story (1997), uses controlling idea: "one clear, coherent sentence that expresses a story's irreducible meaning." It has exactly two components:

  • Value — the positive or negative charge the story ends on (e.g. justice, love, ruin).
  • Cause — how/why life ends in that charged state.

So the form is always Value + because + Cause: "Justice prevails when the underdog outwits the powerful." Value = justice prevails; Cause = the underdog outwits the powerful. McKee insists there is one controlling idea per story, and he classifies them into three flavors: idealist ("life as we wish it to be"), pessimist ("life as we dread it"), and ironist ("life at its most complete and realistic," where the value is double-edged). Egri's premise and McKee's controlling idea are nearly the same tool from two traditions — Egri stresses proof, McKee stresses value-charge. Use them interchangeably in practice, but keep the attribution straight.

4. MORAL ARGUMENT — Truby's story-as-argument-about-how-to-live

John Truby, in The Anatomy of Story (2007), reframes theme as a moral argument: every story is "an argument of action" trying to persuade the audience of a worldview — the proper way to act in the world. Crucially, Truby's argument is made by action, not stated in dialogue. The mechanism: the hero and the main opponent personify the primary moral opposition — both believe they are right, both have reasons, both are wrong in different ways. They compete for the same goal using different means, and those competing means are the argument. The verdict is delivered at the hero's final moral decision — "a choice between two ways of acting," usually during the climactic confrontation. The ending of the argument is the moral the audience walks out with. This is the most dynamic of the five terms: it doesn't just state a claim, it stages a debate and lets the better way of living win by demonstration.

5. DESIGNING PRINCIPLE — Truby's one-line organizing metaphor

The designing principle is Truby's most distinctive contribution and the one most writers miss. It is "the synthesizing idea, the shaping cause of the story... what internally makes the story a single unit and what makes it different from all other stories." Truby's formula: designing principle = story process + original execution. It is not a moral claim — it is the organizing strategy/metaphor that makes this story unrepeatable. His verbatim examples:

Story Designing Principle (Truby, verbatim)
It's a Wonderful Life "Express the power of the individual by showing what a town, and a nation, would be like if one man had never lived."
Citizen Kane "Use a number of storytellers to show that a man's life can never be known."
A Christmas Carol "Trace the rebirth of a man by forcing him to view his past, his present, and his future over the course of one Christmas Eve."
Tootsie "Force a male chauvinist to live as a woman."
The Godfather "Use the classic fairy-tale strategy of showing how the youngest of three sons becomes the new 'king.'"

A note on accuracy, because the brief raised it: the popular line "a good man becomes the thing he set out to destroy" is a superb controlling idea for The Godfather (Michael's value arc, ironist mode) — but it is not Truby's designing principle for that film. Truby's actual designing principle is the fairy-tale-king line above. Keep them in separate boxes: the controlling idea names the meaning; the designing principle names the unique machine that delivers it.

The ladder, in one view

Term Author / Work What it answers Form Example
Theme (general) What's the subject? abstract noun Justice
Premise Egri, Art of Dramatic Writing What does the story prove? cause → effect "Great love defies even death."
Controlling Idea McKee, Story What's the value + why? value + cause "Justice prevails when the underdog outwits the powerful."
Moral Argument Truby, Anatomy of Story How should one live? hero-vs-opponent values, resolved by choice Michael's means vs. the family's — ruthlessness wins, and damns him
Designing Principle Truby, Anatomy of Story What makes this story unique? process + original execution "What would a town be like if one man had never lived."

→ SHORT-FORM: In a 60-second piece you do not run all five. You lock two: one controlling idea (the meaning) and one designing principle (the device). That's the entire creative brief. A teaser does not have room to prove a premise across acts — it has room to embody one in a single gesture. Pick the controlling idea, then pick the one visual machine that makes it land.

→ AI APPLICATION: Make these five fields explicit slots in the project spec your LLM fills before generating anything. Most LLM "story help" fails because the model generates plot from a logline with no spine, so beats drift. Force the model to emit theme, premise, controlling_idea, moral_argument (hero value vs. opponent value), and designing_principle as structured fields in Phase 1 (see 19-the-grilling-workflow.md). Everything downstream references these slots.

The Craft Law: Dramatize, Never State

This is the single most important rule in the chapter, and the one Yuval (and every AI pipeline) violates by default. Theme is proven through opposition and choice — it is never spoken aloud as a thesis. The failure mode has a name: on-the-nose dialogue / "stating the theme."

On-the-nose is when a character says exactly what they think or feel — or worse, recites the moral — with no subtext. "I guess what I learned is that family is more important than money." The instant a character announces the theme, three things break: the audience feels lectured, the moment feels fake (real people imply, they rarely state), and the story collapses from an experience into a message. Truby's whole point about the moral argument being "an argument of action" exists to forbid this: you weave theme through structure, not sermons.

How value / counter-value works

Every scene is a small trial of the controlling idea. McKee's value-charge (covered in 01-story-structure.md and 03-character-and-scene-craft.md) is the mechanism: a scene opens on one charge of the thematic value and closes on its opposite. If your theme is trust, scenes oscillate trust ↔ betrayal. The story is the accumulating verdict of these swings. Truby splits the same idea into a web of opposition: you don't have one hero and one villain debating — you give each major character a different stance on the theme, so a cast of five is five answers to the same moral question. The protagonist's allies, lovers, and rivals each argue a variation, and the hero's final choice is the story selecting a winner among them.

Concrete example — The Dark Knight. Controlling idea (ironist): order survives only when good people refuse to become the monster fighting them — but the cost is they must lie about it. The Joker argues "civilization is a thin veneer; pressure anyone and they break." Harvey Dent argues "the system can be saved by a clean hero." Batman argues "I'll absorb the darkness so others stay clean." The ferry scene is the moral argument staged as action — two boats, two detonators, no narration. The passengers' refusal to blow each other up proves the controlling idea without a single character announcing it. That's value/counter-value resolved by choice.

→ SHORT-FORM: The compression trap is to narrate the theme in voiceover because you're scared 60 seconds isn't enough to dramatize it. Resist. A teaser dramatizes by juxtaposition: show the value, then immediately show the counter-value, and let the cut do the arguing. Nike's "before/after," a SaaS demo's "the painful old way → one click," a movie trailer's "ordinary world → threat" — these are value/counter-value compressed to a single edit. The product demo is the proof of the controlling idea: "this tool makes the impossible trivial."

→ AI APPLICATION: Give the LLM an explicit anti-on-the-nose linter. After it drafts dialogue or VO, run a pass: "Flag any line where a character states the theme, the moral, or their own emotional state directly. Rewrite as subtext or replace with an action beat." Then make the controlling idea a generation constraint, not a generation output: instruct the model to never put the controlling idea in dialogue, only to let scenes test it.

How to Find Your Theme

Two legitimate roads. Neither is "wait for inspiration."

Top-down (argument-first)

You start from conviction. You believe something about how people should live, and you build a story to prove it. Egri works this way — pick the premise, then reverse-engineer characters who will prove it through their collision. This is fast and gives you a built-in filter from day one, but the danger is propaganda: if you love your thesis too much, you'll stack the deck, the opponent becomes a straw man, and the moral argument loses (because the audience smells the rigging). Antidote: make the opponent's argument genuinely strong. Truby's rule that both hero and opponent have real reasons is the safeguard.

Bottom-up (discover-then-sharpen)

You start from an image, a character, a "what if," and you draft to find out what it's about. The theme is latent in your obsessions — you keep circling the same wound. McKee notes the controlling idea often emerges in the writing and is recognized afterward, then sharpened. After a draft, ask: "What value charges every scene? What does my ending actually prove?" Whatever you find, you then cut everything that doesn't serve it and amplify what does. This produces less preachy work, but risks meandering if you never lock the idea.

Most professionals do both: discover bottom-up in the first draft, then impose top-down discipline in the rewrite. The point is that by the time you're generating final beats, the controlling idea is locked and acts as a scalpel.

→ SHORT-FORM: Always top-down. You have no budget to discover. The brief is the controlling idea. "What's the one thing this 30-second spot proves?" — answer it before you storyboard a frame.

→ AI APPLICATION: LLMs are natural bottom-up generators and terrible top-down disciplinarians unless forced. Use the model's fluency to brainstorm 10 candidate controlling ideas from a rough concept (bottom-up), have a human pick one, then freeze it and switch the model into top-down mode where the locked idea is a hard constraint on every subsequent beat.

Theme and the Ending: The Ending Is the Proof

The ending is not "where it stops." The ending is the verdict your story returns on its own controlling idea. Egri's "you are to prove it" lands here: the climax is the courtroom, the hero's final choice is the testimony, and the resolution is the jury's verdict. Truby is explicit that the moral argument is epitomized at the hero's final moral decision — the choice between two ways of acting is the theme made flesh.

This gives you the single most useful diagnostic in the bible: does the ending prove the controlling idea you claimed? If your stated controlling idea is "love redeems," but your hero ends alone and bitter, you do not have a broken ending — you have the wrong stated controlling idea (your real one is ironist: "the pursuit of love can hollow you out"). Align the two. A mismatched ending is the fingerprint of a story that doesn't know what it believes.

Note the three McKee flavors govern endings:

  • Idealist ending — value wins clean (Rocky: dignity through effort).
  • Pessimist ending — value lost (Chinatown: corruption is total; "Forget it, Jake").
  • Ironist ending — value won and lost (The Godfather: Michael wins the family war and loses his soul; the door closes on Kay).

→ SHORT-FORM: A teaser's "ending" is the last 3–5 seconds — the payoff frame and the CTA. It must prove the controlling idea in one image. If the idea is "this changes everything," the final frame shows the after-state, transformed, undeniable. The button/CTA is the audience's invitation to enter the proven world.

→ AI APPLICATION: Add a final automated gate before render: "Compare the resolution beat to the locked controlling_idea. Does the ending's value-charge match the claimed charge (idealist/pessimist/ironist)? If not, flag mismatch." This catches the most expensive failure — a generated film that builds tension correctly but lands on a meaning it never set up.

The Theme as Beat-Filter (Operational Summary)

Here is the whole chapter as a workflow you can hand to a human or an LLM:

  1. Lock the controlling idea (value + cause), in one sentence, before generating beats. State its McKee flavor.
  2. Lock the designing principle (process + original execution) — the one device that makes this story unrepeatable.
  3. Build the web of opposition — assign each major character a distinct stance on the theme; the opponent's stance must be genuinely strong.
  4. Run every candidate beat through the filter: "Does this scene test the controlling idea via a value/counter-value swing? If not, cut it." This is how the theme kills off-theme beats — the single highest-leverage use of a locked idea.
  5. Forbid on-the-nose: the idea never appears in dialogue, only in choices and juxtapositions.
  6. Prove it at the ending: the hero's final choice returns the verdict; confirm the verdict's charge matches the claimed flavor.

→ AI APPLICATION (the core loop): The locked one-line controlling idea + designing principle become the system-prompt constants for the entire generation session. Every beat-generation call includes them; every beat is scored "on-theme / off-theme" against them; off-theme beats are regenerated, not patched. This single discipline — idea before generation, idea as filter during generation, idea as gate after generation — is the difference between an AI pipeline that produces a coherent short film and one that produces a beautiful, expensive, meaningless montage.

Sources

Source: SKILL.md on GitHub

No alerts3mo3 checks · Risk SAFE
  • Gen Agent Trust Hub3mo

    This skill acts as a comprehensive educational and procedural resource for AI filmmaking. It implements a structured 'Director's Bible' consisting of 28 chapters of professional craft knowledge and a gated 'Grilling Workflow' that guides the user through story development, shot planning, and production. No malicious patterns, obfuscation, or data exfiltration attempts were detected.

  • Socket3mo

    No alerts

  • Snyk3mo

    Risk: LOW · No issues

Signed by skilld at 6c79770. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Steadyupdated 4 months ago

README badge

README badge for hoodini/ai-agents-skills/director