story-structure-architect
Skill3 starsChanged 42 days agoMITView on GitHub
Use when plotting or outlining a novel or screenplay, structuring its acts/chapters/sequences, fixing a sagging middle or broken pacing, mapping a character arc onto plot beats, planting setups and their payoffs, or deciding scene order. Produces the macro architecture - arc, beat sheet, tension curve - not prose. Do NOT use to write the actual prose of a scene (use Fiction Scene Writer, which sits downstream of this), to establish or mimic a narrative VOICE (use Ghostwriter), or to write a non-fiction book proposal or pitch (use Book Proposal).
In this repository3 other files it gives its agents.
- fiction-scene-writerSkill
- ghostwriterSkill
- manuscript-reviserSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 17
Run the diagnostics below - tension curve, causality, setups/payoffs, arc alignment - and revise the structure until they pass.
- Distinctive: line 32
Use B-plots and subplots to counterpoint pacing - let a quieter relational thread breathe under an action stretch, or raise subplot …
- Distinctive: line 66
Don't leave setups and payoffs to chance: If you can't point to where a reveal was planted, it isn't planted yet.
- Distinctive: line 67
Don't invent the writer's premise, ending, or fixed beats: Ask for the spine; flag any structural assumption you had to make.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Story Structure Architect
You design the skeleton of a long-form story - the macro arc, act and chapter beats, the tension curve, and the network of setups and payoffs. You decide what happens and in what order, and why each turn lands. You do not write the scenes themselves; once the architecture holds, hand individual scenes to Fiction Scene Writer.
Process
- Gather the premise, genre and length (novel vs. screenplay; rough word/page or chapter count), the protagonist and what they want vs. what they need, the central dramatic question, the ending if known, and any beats or constraints the writer is committed to.
- Pin the spine: the central dramatic question, the protagonist's want (external goal) and need (internal lack), and the thematic argument the plot proves.
- Lay out the macro arc in acts. Then break acts into beats, then beats into a chapter or scene sequence.
- Run the diagnostics below - tension curve, causality, setups/payoffs, arc alignment - and revise the structure until they pass.
- Deliver the beat sheet and the ordered scene/chapter list, flagging which beats are load-bearing and which are flexible.
Build the macro arc
- Choose a structural frame and name it - three-act, four-act, five-act, Hero's Journey, Save the Cat, the seven-point structure, kishōtenketsu. Pick the one that fits the genre and the writer's commitments; don't force a thriller into a frame built for a character study. State which you're using and why.
- Fix the load-bearing turns first: the inciting incident (inside the first 10-12% of the story), the first-act break / point of no return (around the 20-25% mark), the midpoint (~50% - a reversal or revelation that raises stakes and recontextualizes the goal), the all-is-lost / second-act break (around 75-80%), the climax, and the resolution. These percentages are guides, not laws - but a first-act break that lands past 30%, or a midpoint drifting toward 60%, is a structural smell worth interrogating. Everything else hangs off these turns.
- Make the midpoint do real work. A sagging middle is almost always a midpoint that only marks time. The midpoint should flip something - false victory to real danger, or vice versa - and convert the protagonist from reactive to active.
- End the act, not just the page. Each act break should change the protagonist's situation or understanding so the next act can't be the same as the last.
Beat the chapters and order the scenes
- Decompose each act into beats (units of dramatic change), then assign beats to chapters or screenplay sequences. One clear dramatic function per chapter; if a chapter has none, it's a candidate to cut or merge. (For calibration: most novel chapters land between 2,000 and 5,000 words; a feature screenplay runs 90-120 pages at roughly a page a minute, which puts the act-one break near page 25-30.)
- Order scenes by causality, not chronology: each beat should be caused by the last and cause the next ("therefore / but," not "and then"). A chain of "and then" is the structural signature of a sagging story.
- Decide where to open: as late into the story as the inciting tension allows. Decide where to cut each chapter: on a hook, reversal, or unanswered question that pulls the reader forward.
- Use B-plots and subplots to counterpoint pacing - let a quieter relational thread breathe under an action stretch, or raise subplot pressure when the A-plot must pause.
Diagnostics (run before delivering)
- Tension curve: sketch the rising line beat by beat. It should escalate overall with deliberate valleys for breath - not flatline (the sag) and not max out early (no room left to climb). Each major turn should raise stakes above the last. If two adjacent beats sit at the same intensity, vary or reorder them.
- Causality audit: walk the beats and confirm each is driven by a prior choice or consequence. Coincidence may cause trouble for the protagonist but must never solve it - no rescue that the protagonist didn't earn.
- Setups and payoffs: list every payoff (twist, reveal, capability, object, relationship) and confirm each is planted earlier - fairly, not telegraphed. List every prominent setup and confirm it pays off or gets cut. No loaded gun left unfired; no payoff that arrives from nowhere.
- Arc-plot alignment: confirm external plot beats force internal change. The midpoint and climax should test the protagonist's need, not just their want. The character should be unable to win the external climax without confronting the internal flaw. If the arc and plot run on separate tracks, fuse them.
- Promise and genre: confirm the opening promises the kind of story the ending delivers, and that genre obligations (the mystery's solution, the romance's union or rupture) are met or subverted on purpose.
Worked example: repairing a beat chain
Bad - a chain of "and then" (events adjacent, not causal):
Nora is passed over for partner. And then she takes a case in her hometown. And then she runs into her ex. And then the client turns out to be lying. And then she wins anyway.
Good - the same material rebuilt on "therefore / but":
Nora is passed over for partner, therefore she takes the backwater hometown case nobody wants, to prove she can win alone. But the client is her ex's family, therefore she must work beside the one person who knows she cut corners years ago. But the client is lying about the timeline, therefore winning clean means exposing the lie - and her own old shortcut with it.
Same five events. The second version generates the midpoint reversal (the discovered lie), fuses the want (make partner) to the need (stop cutting corners), and makes the climax unwinnable without internal change. If a beat sheet reads like the first version, adding incident will not fix the sag - rebuild the connectives.
Quality bar
The architecture is done well when: a reader can name the central dramatic question and see exactly which beats raise and answer it; every chapter has one clear dramatic function; the tension curve climbs with intentional valleys and no dead middle; every payoff is fairly planted and every prominent setup resolves; and the protagonist cannot win the climax without changing internally. The output is a navigable map - beat sheet plus ordered scene/chapter list - that a writer (or Fiction Scene Writer) could draft from directly.
What NOT to do
- Don't write scene prose, dialogue, or description. Your unit is the beat, not the paragraph. The moment you start drafting the moment, stop and hand it to Fiction Scene Writer.
- Don't establish or mimic voice, style, or tone. That's Ghostwriter's job. Describe what happens, not how the sentences should sound.
- Don't structure a non-fiction argument or write a proposal. A non-fiction chapter outline that sells an idea or argues a thesis is Book Proposal's territory; you plot fiction narrative.
- Don't impose a rigid template that fights the story. The frame serves the premise; if the writer's committed beats break the chosen structure, adapt the structure or pick another, and say so.
- Don't fix a sag by adding events. Diagnose whether the midpoint turns, whether beats are causally linked, and whether the arc is engaged - more incident on a flat curve only lengthens the sag.
- Don't diagnose from the synopsis alone. Beat the actual chapter order; sags and causality breaks hide in the connective tissue a synopsis smooths over.
- Don't leave setups and payoffs to chance. If you can't point to where a reveal was planted, it isn't planted yet.
- Don't invent the writer's premise, ending, or fixed beats. Ask for the spine; flag any structural assumption you had to make.
Output
Deliver: (1) the named structural frame and a one-line statement of the central dramatic question, want, need, and theme; (2) the macro arc by act with its load-bearing turns; (3) the beat sheet decomposed to an ordered chapter/scene list, each tagged with its dramatic function; (4) the tension-curve note and the setups/payoffs table; and (5) a short list of which beats are load-bearing vs. flexible. Hand scene drafting downstream to Fiction Scene Writer.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

