
fiction-architect
Designs plot structure and story arcs using McKee's value turns, Campbell's monomyth, and Sanderson's Promise/Progress/Payoff model to ensure causal integrity and emotional resonance. Use when constructing narratives, outlining novels, or diagnosing why a story feels broken.
- Installs
- 55
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/joellewis/skill-library --skill fiction-architect- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads fiction-architect automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Overview
Fiction architecture is the structural engineering of story. It focuses on the causal design of events (Plot) and the transformation of characters through conflict. By applying McKee's value turns, Campbell's monomythic arc, and Sanderson's "Promise/Progress/Payoff" model, the architect ensures that a narrative has both logical integrity and emotional resonance.
Guiding Principles
Principle 1: Plot is a Choice of Events (Source: McKee, Story)
Plot is not a formula; it is the writer's strategic selection of events from a character's life story. Every event must be meaningful, meaning it creates change in a life situation and is achieved through conflict.
Principle 2: Reversing Value Polarity (Source: McKee, Story)
Every scene, sequence, and act must "turn" a value. A value is a universal quality (e.g., love/hate, freedom/slavery) that must shift from positive to negative (or vice-versa) during the action. If a scene doesn't turn, it is mere activity, not an event.
Principle 3: The Sacred Flaw (Source: Storr, Science of Storytelling)
Plot is the process of breaking a character's "theory of control." The protagonist begins with a flawed belief about how the world works (The Sacred Flaw). The events of the plot must systematically challenge this flaw until the character is forced to change or perish.
Principle 4: The Monomythic Cycle (Source: Campbell, Hero With a Thousand Faces)
Human stories tend to follow a three-act cycle:
- Separation: The hero leaves the world of common day for a region of supernatural wonder.
- Initiation: Fabulous forces are encountered, and a decisive victory is won.
- Return: The hero comes back with the power to bestow boons on their fellow man.
Principle 5: Promise, Progress, Payoff (Source: Sanderson, BYU Lectures)
Story momentum is maintained by keeping promises. The "Promise" sets the tone and expectations; the "Progress" shows the hero moving closer to the goal; the "Payoff" delivers a resolution that is both surprising and inevitable.
When to Use This Skill
- Outlining a new novel, screenplay, or short story.
- Troubleshooting a "sagging middle" in a manuscript.
- Evaluating the causal logic of a narrative arc.
- Designing high-impact plot twists or act climaxes.
When NOT to Use This Skill
- During "Shitty First Draft" generation (where structure should be felt, not analyzed).
- Writing non-narrative technical documentation or neutral reports.
Core Process
Step 1: The Inciting Incident (Source: McKee / Storr)
Identify the moment of "Unexpected Change" that throws the protagonist's life out of balance. This event must open a "Curiosity Gap" and set a specific goal (The Object of Desire).
Step 2: The ABT causal chain (Source: Industrial Scripts)
Structure the primary arc using the "And, But, Therefore" framework:
- And: Establish the world and context.
- But: Introduce the primary conflict or complication.
- Therefore: State the causal result that drives the next sequence.
Step 3: The Initiation (Source: Campbell)
Map the "Road of Trials." Ensure each obstacle tests the protagonist's "Sacred Flaw." Use the "Principle of Antagonism": the protagonist is only as compelling as the forces against them.
Step 4: The Value Audit (Source: McKee)
Review each act climax. Does it represent a major reversal of values?
- Act I Climax: A point of no return.
- Act II Climax: The "All is Lost" moment or the final insight.
- Act III Climax: The Story Climax—absolute and irreversible change.
Step 5: The Payoff Check (Source: Sanderson)
Does the ending deliver on the specific promises made in the beginning? Ensure the "Object of Desire" is either obtained or permanently lost in a way that satisfies the audience's emotional investment.
Frameworks & Models
The Structure Spectrum (Source: McKee, Story)
- Archplot (Classical): Active protagonist, external conflict, linear time, closed ending.
- Miniplot (Minimalism): Passive protagonist, internal conflict, open ending.
- Antiplot (Antistructure): Discontinuous time, coincidence over causality, fragmentation.
The Monomyth (Source: Campbell, Hero With a Thousand Faces)
- The Call to Adventure: The "Herald" summons the hero.
- Supernatural Aid: A guide or talisman is provided.
- Crossing the First Threshold: Leaving the "Known World."
- The Belly of the Whale: The point of transition and metamorphosis.
- The Ultimate Boon: Achieving the goal.
Cross-Skill Invocations
REQUIRED SUB-SKILL: character-vulnerability — because plot is merely the "X-ray" of character. RECOMMENDED SUB-SKILL: world-building-logic — to ensure the setting supports the causality of the plot.
Common Mistakes
- Exposition as Scene: Including scenes where nothing "turns" just to deliver information. (Source: McKee)
- Ignoring the Sacred Flaw: Creating a plot that doesn't force the character to face their primary misbelief. (Source: Storr)
- Deus Ex Machina: Resolving the conflict through coincidence rather than character action. (Source: Campbell/McKee)
Diagnostic Checklist
- Does the story begin with an event of unexpected change?
- Is there a clear causal "Therefore" between every major plot point?
- Do the forces of antagonism escalate throughout the second act?
- Does the protagonist move from a passive to an active state?
- Is the ending an absolute and irreversible change of values?
Sources
- McKee, Robert. Story. Ch. 2 (Structure Spectrum), Ch. 8 (Inciting Incident), Ch. 14 (Principle of Antagonism).
- Storr, Will. The Science of Storytelling. Ch. 1 (Unexpected Change), Ch. 2 (The Flawed Self).
- Campbell, Joseph. The Hero With a Thousand Faces. Part I (The Adventure of the Hero).
- Sanderson, Brandon. "Promise, Progress, Payoff" (BYU Lectures).
FAQ
What does the fiction-architect skill do?
Designs plot structure and story arcs using McKee's value turns, Campbell's monomyth, and Sanderson's Promise/Progress/Payoff model to ensure causal integrity and emotional resonance. Use when constructing narratives, outlining novels, or diagnosing why a story feels broken.
How do I install fiction-architect?
Run npx skills add https://github.com/joellewis/skill-library --skill fiction-architect in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/fiction-architect/ (personal) or .claude/skills/fiction-architect/ (project).
Which AI agents can use fiction-architect?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is fiction-architect safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains fiction-architect?
It is published by joellewis in joellewis/skill-library. It has 55 recorded installs.
More from joellewis/skill-library
world-building-logic
joellewis/skill-library
Engineers internally consistent fictional worlds using Brand's Pace Layers for social structure and Sanderson's Laws of Magic for system constraints. Use when building settings, designing magic or tech systems, or auditing a world for logical contradictions.
dialogue-craft
joellewis/skill-library
Writes and refines dialogue that serves plot and reveals character through subtext, intention, and behavioral exchange — applying McKee's subtext principle and Sorkin's intention-and-obstacle model. Use when dialogue feels flat, expository, or 'on the nose.'
one-pager
joellewis/skill-library
Use when compressing a complex strategy or analysis into a strictly one-page narrative—enforces Pyramid SCQ structure and Orwell word-budget discipline.
character-vulnerability
joellewis/skill-library
Use when a character feels flat, too competent, or unrelatable—identifies the Sacred Flaw (Storr's Theory of Control) and dials the Three Sliders (Sanderson) to create earned vulnerability.
problem-framing
joellewis/skill-library
Use when beginning analytical or strategic tasks, facing undefined problems, or facing analysis paralysis—requires explicit problem definition before proceeding.
non-fiction-precision
joellewis/skill-library
Use when a document's argument buries its conclusion or has logical gaps—applies Minto's Pyramid (Answer First, MECE grouping) and Orwell's concision rules to rebuild structure.
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.