@rubytech/create-realagent-code 0.1.24 → 0.1.27

package/payload/platform/plugins/writer-craft/skills/prose-craft/references/word-economy.md

@@ -0,0 +1,93 @@
+# Word Economy: Adjectives, Adverbs, Crowding, and Leaping — Steering the Craft
+
+## Adjectives and Adverbs
+
+Adjectives and adverbs are rich, good, and nourishing. They add colour, life, immediacy. They cause obesity in prose only when used lazily or overused.
+
+### The Core Principle
+When the quality an adverb indicates can be put directly in the verb, or when the quality an adjective indicates can be put in the noun itself, the prose will be cleaner, more intense, more vivid.
+
+| Weak | Strong |
+|------|--------|
+| They ran quickly | They raced / They sprinted |
+| A growling voice | A growl |
+| She said loudly | She shouted / She bellowed |
+| He walked slowly | He shuffled / He crept |
+| A big house | A mansion / A sprawl |
+
+### Bloodsuckers: Qualifiers
+These words weaken almost every sentence they appear in:
+- rather
+- a little
+- just
+- very
+- kind of / sort of
+- somewhat
+- quite
+- really
+- perhaps (when hedging, not when genuinely uncertain)
+
+They are ticks in written prose. In conversation, they serve as social lubricant. In prose, they drain authority and precision.
+
+### Empty Intensifiers
+Words that have lost their meaning through overuse:
+- great
+- suddenly
+- somehow
+- absolutely
+- totally
+- literally (when used as emphasis)
+- amazing / incredible / unbelievable
+
+### The Muscle-to-Fat Ratio
+Narrative prose, especially long narrative, needs more muscle than fat. The English language is rich beyond belief — but richness must be earned by precision, not accumulated through decoration.
+
+## Crowding
+
+**Crowding** means loading every rift with ore. Avoiding flabby language and clichés. Always seeking the vivid phrase. Keeping the story full of what's happening in it, keeping it moving, keeping it interconnected.
+
+### Qualities of Crowded Prose
+- **Vivid** — the reader can see, hear, feel what's happening
+- **Exact** — the right word, not its approximate cousin
+- **Concrete** — specific objects, actions, sensations — not abstractions
+- **Accurate** — true to the physical and emotional reality being described
+- **Dense** — every sentence carrying weight
+- **Rich** — multiple layers of meaning working simultaneously
+
+### How to Crowd
+- Seek the specific over the general
+- Choose the vivid verb over the weak verb + adverb
+- Choose the precise noun over the generic noun + adjective
+- Make every detail do double or triple duty (reveal character AND advance plot AND illuminate theme)
+- Eliminate any word that isn't pulling its weight
+
+## Leaping
+
+**Leaping** means what you leave out. What you leave out is infinitely more than what you leave in. There must be white space around the word, silence around the voice.
+
+### What to Leave Out
+- Information the reader can infer
+- Steps in a sequence that are obvious
+- Descriptions of what the reader already knows or can imagine
+- Transitions that don't need to be spelled out
+- Emotional states that are already clear from action and dialogue
+
+### Listing Is Not Describing
+A catalogue of objects or actions does not create a vivid scene. Only the details that matter — that carry meaning — belong. The rest is noise.
+
+### The Danger of Overcrowding
+Even good writers can overdo crowding. Borges's fictional character Funes the Memorious perceived and remembered every detail of everything — and was utterly paralysed by it. Flaubert's Salammbô is a real-world cautionary tale: a novel choked by its own mots justes.
+
+### The Danger of Insufficient Leaping
+Action writing that tries to give blow-by-blow accounts creates confusion and boredom. The reader doesn't need to see every swing of the sword. They need to see the moments that change the stakes.
+
+## The Revision Method
+
+Crowd in the first draft — be generous, overwrite, include too much. Then cut.
+
+**Decide what counts, what tells, and cut and recombine until what's left is what counts.**
+
+Chekhov's advice: "First, throw out the first three pages." Most first drafts circle and explain before they find their way. In revision, if the beginning can be cut, cut it.
+
+### The Halving Exercise
+Take a piece of 400+ words and cut it to half — not trimming but counting words and actually reducing to half while keeping the narrative clear and the sensory impact vivid. This forces you to discover which words are Styrofoam and which are heavy gold.

package/payload/platform/plugins/writer-craft/skills/reader-engagement/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: reader-engagement
+description: "Analyzes and teaches reader engagement: hooking from page one, urgency, cause-and-effect chains, setup-payoff patterns, conflict escalation, emotional resonance, and pacing. Use this skill whenever the user asks about hooking readers, page one, opening scenes, reader engagement, urgency, cause and effect, setup and payoff, conflict escalation, raising stakes, pacing, 'why readers stop reading', 'my story is boring', 'the middle sags', or any question about why a story fails to hold attention. Also use when diagnosing why a manuscript loses momentum or when a writer needs to understand the neuroscience of why readers keep turning pages."
+---
+
+# Reader Engagement
+
+The brain is bombarded with 11 million bits of sensory information per second. It consciously processes approximately forty. The cognitive unconscious acts as a ruthless filter — keeping only what matters, discarding the rest. Story is the brain's native language for what matters. When a story meets the brain's hardwired criteria, the reader surrenders. When it doesn't, they put the book down.
+
+Reader engagement is not a vague aesthetic preference. It is a biological response driven by specific neurochemical mechanisms:
+
+| Trigger | Neurochemical | Reader Experience |
+|---------|--------------|-------------------|
+| **Curiosity** (broken pattern, unanswered question) | Dopamine | "What happens next?" |
+| **Conflict** (hard choice, consequences) | Cortisol | "Will they get through this?" |
+| **Vulnerability** (empathy with protagonist) | Oxytocin | "I'm on their side" |
+
+A story that triggers all three is virtually impossible to put down.
+
+## Hooking the Reader: Page One
+
+Three things readers hunt for from the first sentence:
+
+1. **Whose story is it?** The protagonist must appear immediately. Readers need a surrogate.
+2. **What's happening here?** Something must already be in motion. Not the preamble — the thing itself.
+3. **What's at stake?** Conflict specific to the protagonist must be visible.
+
+The first sentence must suggest that something is already wrong and about to get worse. This fires the dopamine circuit — the anticipation response. Beautiful language alone does not do this. Storytelling always trumps beautiful writing.
+
+## Cause and Effect: The Causal Spine
+
+The brain is a causal-inference engine. It demands to understand how each event caused the next. Not "and then... and then... and then" but "therefore... because... so..."
+
+Every scene must be triggered by the scene before it and must trigger the scene after it. If you can remove a scene without disrupting the chain, it has no business being there.
+
+Cause and effect operates on two levels:
+1. **External (plot)**: physical events cause physical consequences
+2. **Internal (character arc)**: each event triggers an emotional reaction → a decision → a new action
+
+The internal level is primary. The reader tracks this pattern whether they know it or not: **action → reaction → decision → new action**. When it breaks, the story loses them.
+
+### The "And So?" Test
+For every scene, every detail — ask "And so?" What does this lead to? What consequence does it produce? If you can't answer, the element is probably a darling that the story doesn't need.
+
+## Setup and Payoff
+
+The brain instinctively scans for patterns. In a story, readers are continuously looking for setups — hints, details, actions that signal future significance. When a payoff arrives, the brain experiences the reward of a pattern completed.
+
+Rules:
+- Every payoff requires a clear setup
+- Every setup requires a clear payoff
+- The road between them must build — each step increasing in significance
+- Setups and payoffs must be separated enough to create anticipation
+- **Audit for inadvertent setups** — details described at length that then vanish. Readers catalogue everything. Absence in the payoff register reads as error or cheat.
+
+## Conflict Escalation
+
+The brain uses story to simulate navigating difficult situations. A story that is too easy provides no simulation worth running. Everything that can go wrong must go wrong, and the wrongness must escalate.
+
+Principles:
+- Each complication raises stakes beyond where they were
+- Each apparent solution creates a larger problem
+- The protagonist must be forced to find resources they didn't know they had
+- The antagonist (person, force, or circumstance) must be specific, present, and active
+- There are no free victories — every gain costs something, every loss has consequences
+- The worst thing you can do as a writer is be kind to your protagonist
+
+## Emotional Resonance
+
+Emotion is not the enemy of reason — it is the system within which reason operates. Every decision is ultimately made emotionally. For readers: if they do not feel what the protagonist feels, they are not processing the story.
+
+The mechanism: mirror neurons. When we observe someone in pain or joy, the same neural circuits fire as when we experience it ourselves. The brain does not fully distinguish between observed and directly experienced emotion.
+
+Requirements:
+- The protagonist must react emotionally to everything — if they witness something terrible and don't react, meaning collapses
+- Body language is subtext — physical response communicates what the character might never say
+- Every event must register through the protagonist's subjective emotional filter
+- Never editorialise (tell the reader what to feel) — show the protagonist's specific, embodied reaction
+
+## Engagement Diagnostic Checklist
+
+- [ ] Does the opening sentence trigger curiosity about what happens next?
+- [ ] Is the protagonist present and affected from page one?
+- [ ] Are stakes visible immediately?
+- [ ] Does every scene follow from the previous one through cause and effect?
+- [ ] Can you trace the internal pattern (action → reaction → decision → action) in every scene?
+- [ ] Does the "And so?" test pass for every major element?
+- [ ] Is every setup paid off? Is every payoff set up?
+- [ ] Are there inadvertent setups — details that promise significance but deliver nothing?
+- [ ] Does conflict escalate with each complication?
+- [ ] Is the opposition specific, present, and active?
+- [ ] Does the protagonist react emotionally to events in ways the reader can mirror?
+- [ ] Is the protagonist earning every gain and paying for every loss?
+
+## When to Read Reference Files
+
+- **For hooking readers and page-one requirements** — read `references/hooking-readers.md`
+- **For cause-and-effect and setup-payoff in detail** — read `references/cause-effect-setup-payoff.md`
+- **For conflict escalation and stakes** — read `references/conflict-escalation.md`
+- **For the neurochemistry of engagement and emotion** — read `references/neurochemistry-of-engagement.md`

package/payload/platform/plugins/writer-craft/skills/reader-engagement/references/cause-effect-setup-payoff.md

@@ -0,0 +1,79 @@
+# Cause-and-Effect and Setup-Payoff Patterns
+
+## The Causal Spine
+
+The brain is a pattern-matching, causal-inference engine. It is not content to observe events — it demands to understand how each event caused the next. This is biology, not preference.
+
+### The Fundamental Test
+Not "and then... and then... and then" but "therefore... because... so..."
+
+If you can remove a scene without disrupting the causal chain, the scene has no business being there.
+
+### Two Levels of Cause and Effect
+
+**External (plot):** Physical events cause physical consequences.
+- She drops the letter → He finds it → He discovers the secret
+
+**Internal (character arc):** Each external event triggers an emotional reaction, which leads to a decision, which drives the next action.
+- She drops the letter → He finds it → He feels betrayed (reaction) → He decides to confront her (decision) → He drives to her house (action)
+
+The internal level is primary. The reader tracks this rhythm whether they know it or not.
+
+### The Internal Pattern
+**Action → Reaction → Decision → New Action**
+
+This four-beat pattern is the engine of narrative momentum. When it runs, the reader is engaged. When it breaks — when a character acts without reacting to what just happened, or reacts without making a visible decision — the reader disconnects.
+
+### Making Decisions Visible
+A common failure: the protagonist makes a decision whose reasoning is invisible to the reader. The writer knows why — but it's not on the page.
+
+Every decision must be traceable through the text. When a character changes their mind, the reader must see exactly what changed and why.
+
+### The "And So?" Test
+For every scene, every piece of information, every detail — ask "And so?" What does this lead to? What consequence does it produce? If you can't answer, the element is probably a darling — writing the author loves that the story doesn't need.
+
+## Setup and Payoff
+
+### The Brain Scans for Patterns
+The brain instinctively imposes pattern on everything it encounters. In a story, readers continuously scan for setups — hints, details, actions that signal future significance. When a payoff arrives, the reader experiences the satisfaction of a pattern completed, triggering a genuine neurological reward.
+
+### Setup-Payoff Rules
+
+1. **Every payoff requires a clear setup.** A payoff that arrives without a setup feels arbitrary, convenient, or cheap. The reader's response is "give me a break!" rather than "of course!"
+
+2. **Every setup requires a clear payoff.** A setup that is never paid off misleads the reader and destroys trust. The reader catalogued it; its absence from the payoff register reads as error or cheat.
+
+3. **The road between them must build.** Each step between setup and payoff should increase in significance. The dots must add up to a pattern.
+
+4. **Separate setup from payoff.** The payoff must not arrive too quickly after the setup, or too directly from it. The pleasure of anticipation requires distance. The reader should sense a pattern emerging but not see the destination.
+
+5. **Payoffs must be logistically possible.** Given what has been established, the payoff must make physical and psychological sense. No deus ex machina.
+
+### The Danger of Piggybacking
+When setup and payoff are too close together, the reader gets no pleasure of anticipation. The pattern completes before it registers as a pattern.
+
+### Inadvertent Setups
+Writers must audit for elements that inadvertently signal significance:
+- A detail described at length that then disappears from the story
+- A character trait mentioned in passing that is never relevant again
+- An object given narrative weight that plays no role in the plot
+- A scene that appears to establish something important but leads nowhere
+
+Readers will have catalogued all of these. Each unfulfilled promise erodes trust.
+
+### Auditing Setup-Payoff
+
+Create a two-column list:
+- **Left column:** Every setup you can identify (details, character traits, objects, scenes that promise future significance)
+- **Right column:** The payoff for each setup
+
+Any setup without a payoff needs either a payoff added or the setup removed.
+Any payoff without a setup needs a setup planted earlier.
+
+### Foreshadowing as Contract
+Foreshadowing is a specific form of setup — a promise that something is coming. When a character does something "out of character," it must have been foreshadowed. The goal is always the "aha!" reaction, not the "give me a break!" reaction.
+
+Foreshadowing works when:
+- The reader registers it subconsciously but doesn't see the destination
+- In retrospect, the outcome was inevitable given what was planted
+- The reader's second read reveals a rich network of planted clues

package/payload/platform/plugins/writer-craft/skills/reader-engagement/references/conflict-escalation.md

@@ -0,0 +1,81 @@
+# Conflict and Escalation
+
+## Why Conflict Is Non-Negotiable
+
+The brain's default setting is homeostasis — it goes to enormous lengths to maintain its existing models. Even beneficial change triggers resistance, because change means the existing model was wrong.
+
+This is why conflict is not dramatic embellishment. It is the mechanism of story. Without conflict strong enough to force genuine change, nothing of narrative consequence can happen. The protagonist will simply maintain their misbelief indefinitely — which is what they would do in real life if the story weren't intervening.
+
+## The "Versus"
+
+Every story requires a specific "versus" — the rock and the hard place.
+
+- On one side: what the protagonist wants and believes
+- On the other: the reality that will ultimately challenge that want and that belief
+
+The conflict must be:
+- **Personalised** — aimed at this specific protagonist's vulnerabilities
+- **Specific** — not vague menace, but a concrete threat or dilemma
+- **Unavoidable** — the protagonist cannot simply walk away
+
+### Conflict Must Arise From Character
+The best conflict is not external difficulty arbitrarily imposed. It flows from who the protagonist is. The most painful conflicts are those in which the protagonist's own fears, misbeliefs, and desires create the trap they're caught in. This makes their struggle feel inevitable rather than contrived.
+
+## The Escalation Principle
+
+Everything that can go wrong must go wrong — and the wrongness must escalate.
+
+### Rules of Escalation
+
+1. **Each complication raises the stakes** beyond where they were before
+2. **Each apparent solution creates a larger problem** — the fix makes things worse
+3. **The protagonist must be forced to find resources** they didn't know they had
+4. **Each failure costs more** — the price of losing increases with each setback
+5. **The protagonist is simultaneously forced to confront** the inner issue they've been avoiding
+
+### The Worst Thing You Can Do
+The worst thing you can do as a writer is be kind to your protagonist. Readers do not want to watch someone navigate manageable difficulties. They want to see someone survive — or fail to survive — the unsurvivable. The brain uses story to simulate navigating difficult situations. A story that is too easy provides no simulation worth running.
+
+### No Free Victories
+There are no free victories in a well-told story.
+- Every gain costs something
+- Every loss has a consequence
+- The universe of the story is governed by cause and effect applied mercilessly
+- If the protagonist gets things for free, the reader stops believing the story is real
+
+## Force of Opposition
+
+The antagonist — whether a person, a force, or a circumstance — must be:
+
+- **Specific** — not generalised evil or vague threat
+- **Present** — actively in the story, not lurking offscreen
+- **Active** — taking actions, not just existing as a backdrop
+- **Targeted** — aimed specifically at the protagonist's most vulnerable points
+- **Credible** — capable of actually winning
+
+### The Best Antagonists
+The most compelling antagonists aren't simply evil. They are:
+- Pursuing their own goals that genuinely conflict with the protagonist's
+- Operating from their own misbelief, which makes their actions feel internally logical
+- Capable of making the protagonist question whether they are in the right
+- Forcing the protagonist to confront aspects of themselves they'd rather not face
+
+## Withholding and the Big Reveal
+
+Strategic withholding of information creates tension. The rules:
+
+1. Whatever you withhold must still produce a story that makes complete logical sense
+2. When the reveal comes, the story must make even more sense
+3. The reader should experience not confusion but retroactive recognition — "of course"
+4. Withholding must serve the story's needs, not the author's desire to be clever
+
+## Conflict Diagnostic
+
+- [ ] Is there a clear "versus" — a specific rock and hard place?
+- [ ] Does the conflict arise from the protagonist's own character?
+- [ ] Does each complication escalate — raising stakes higher than before?
+- [ ] Does each apparent solution create a bigger problem?
+- [ ] Is the protagonist earning every gain and paying for every loss?
+- [ ] Is the force of opposition specific, present, active, and credible?
+- [ ] Are the protagonist's deepest secrets and guarded flaws being exposed?
+- [ ] Has everything that can go wrong gone wrong?

package/payload/platform/plugins/writer-craft/skills/reader-engagement/references/hooking-readers.md

@@ -0,0 +1,67 @@
+# Hooking Readers from Page One
+
+## The Brain's Survival Filter
+
+The brain is bombarded with 11 million bits of sensory data per second. It consciously processes approximately forty. The cognitive unconscious ruthlessly filters out everything that doesn't matter for survival. Story bypasses this filter because it speaks the brain's native language for evaluating threats, opportunities, and social dynamics.
+
+## What Readers Hunt for on Page One
+
+### 1. Whose Story Is It?
+The protagonist must appear immediately. Readers need a surrogate — someone through whose eyes they will experience everything. Without this anchor, the reader has no reason to care about anything that happens.
+
+### 2. What's Happening Here?
+Something must already be in motion. Not the preamble to the ball — the ball itself. Not the character waking up and having breakfast before something interesting happens. The interesting thing is already happening when we arrive.
+
+### 3. What's at Stake?
+Conflict specific to the protagonist's quest must be visible from the opening. The reader must sense that something matters — that something can be gained or lost.
+
+## Dopamine and the Forward Pull
+
+When the brain senses that significant information is incoming, it releases dopamine — the anticipation neurochemical. This is what makes readers compelled to turn pages. The first sentence must trigger this response.
+
+The tool is not beautiful language. It is the suggestion that something is already wrong and about to get worse.
+
+### The Elizabeth George Example
+"Joel Campbell, eleven years old at the time, began his descent into murder with a bus ride."
+
+In a single sentence:
+- Protagonist identified (Joel Campbell)
+- Something happening (a bus ride)
+- Stakes visible (descent into murder)
+- Yardstick for the entire novel established
+- Dopamine circuit fired (how does a bus ride lead to murder?)
+
+## The Beautiful Writing Myth
+
+Storytelling always trumps beautiful writing. Dan Brown's prose is widely mocked, but The Da Vinci Code works because from page one the reader desperately wants to know what happens next. Beautiful writing is gravy. Story is the meal.
+
+This does not mean prose doesn't matter — it matters enormously. But prose in service of story creates engagement. Beautiful prose without story creates admiration that quickly fades.
+
+## The Story Yardstick
+
+Page one should establish a "yardstick" — a framework that helps the reader evaluate everything that follows. The reader should begin to understand:
+- What kind of story this is
+- What question will drive the narrative
+- Roughly what the stakes are
+- What world they're entering
+
+This doesn't mean spelling everything out. It means planting enough for the reader's pattern-recognition engine to start building expectations.
+
+## Page One Diagnostic Checklist
+
+- [ ] Is there a protagonist present from the first page?
+- [ ] Is something already happening that affects the protagonist?
+- [ ] Is there conflict with a direct impact on the protagonist's quest?
+- [ ] Is something at stake — something that can be gained or lost?
+- [ ] Can the reader glimpse the "big picture" — the yardstick?
+- [ ] Does the first sentence suggest something is wrong or about to go wrong?
+- [ ] Would a reader who knows nothing about this book want to read page two?
+
+## Common Opening Failures
+
+1. **The weather opening** — beginning with atmospheric description before introducing a character or conflict
+2. **The alarm clock opening** — the character wakes up and goes through their morning routine
+3. **The information dump** — pages of world-building or backstory before the story begins
+4. **The action without context** — explosions and car chases with no character to care about
+5. **The philosophical meditation** — the author musing about life before getting to the point
+6. **Starting too early** — the story begins before the interesting thing, not at the moment it arrives

package/payload/platform/plugins/writer-craft/skills/reader-engagement/references/neurochemistry-of-engagement.md

@@ -0,0 +1,94 @@
+# The Neurochemistry of Story Engagement
+
+## Three Neurochemicals of Story
+
+Story activates three interlocking neurochemical responses. Understanding them helps writers diagnose why a passage works or fails.
+
+### Dopamine — The Curiosity Chemical
+**Triggered by:** Broken patterns, unanswered questions, the suggestion that significant information is incoming
+**Reader experience:** "What happens next?" — the forward pull, the inability to stop reading
+**Story mechanism:** Surprise, mystery, unresolved tension, the gap between what the reader knows and what they want to know
+
+**How writers trigger dopamine:**
+- Plant questions the reader needs answered
+- Break expected patterns — the thing that should happen doesn't
+- Create information gaps — the reader knows something is significant but doesn't know what
+- End scenes with unresolved tension
+- Introduce surprising details that reframe what the reader thought they understood
+
+**How writers kill dopamine:**
+- Answer every question as soon as it's raised
+- Maintain predictable patterns without variation
+- Tell the reader everything up front — no gaps, no mystery
+- Resolve tension prematurely
+
+### Cortisol — The Tension Chemical
+**Triggered by:** Conflict, hard choices, consequences, the sense that something bad might happen
+**Reader experience:** "Will they get through this?" — anxiety on the protagonist's behalf
+**Story mechanism:** Stakes, danger, dilemmas, ticking clocks, the escalation of obstacles
+
+**How writers trigger cortisol:**
+- Put the protagonist in genuine danger (physical, emotional, social)
+- Create dilemmas where all options have costs
+- Establish ticking clocks with real consequences
+- Escalate complications — each setback raising stakes higher
+- Force the protagonist to risk what they value most
+
+**How writers kill cortisol:**
+- Remove real consequences — the protagonist can fail without cost
+- Provide easy escape routes — the danger isn't genuinely threatening
+- Make the antagonist incompetent or absent
+- Let the protagonist succeed without sacrifice
+
+### Oxytocin — The Empathy Chemical
+**Triggered by:** Vulnerability, connection, the sense of shared humanity with the protagonist
+**Reader experience:** "I'm on their side" — emotional investment, caring what happens
+**Story mechanism:** The protagonist's internal life made visible; moments of honesty, weakness, courage, and connection
+
+**How writers trigger oxytocin:**
+- Show the protagonist's vulnerability — their fears, doubts, and longings
+- Give the protagonist moments of genuine human connection
+- Let the protagonist make mistakes and admit them
+- Show the protagonist caring about something deeply
+- Reveal the protagonist's inner world — not just what they do, but what it means to them
+
+**How writers kill oxytocin:**
+- Keep the protagonist emotionally opaque — no internal life visible
+- Make the protagonist invulnerable — no weaknesses, no fears
+- Have the protagonist respond to everything with competence and cool
+- Skip the protagonist's emotional reactions to events
+
+## The Interplay
+
+The three neurochemicals work together:
+- **Dopamine** (curiosity) gets the reader to start
+- **Oxytocin** (empathy) makes the reader care
+- **Cortisol** (tension) makes the reader unable to stop
+
+A story that triggers only one is flat:
+- Dopamine alone = a puzzle with no heart
+- Cortisol alone = stress without investment
+- Oxytocin alone = sentimentality without stakes
+
+A story that triggers all three simultaneously is virtually impossible to put down.
+
+## Emotion as the Engine of Reason
+
+### The Platonic Error
+Western thought since Plato has treated emotion as the enemy of reason. Neuroscience has established the opposite: emotion is the prerequisite for rational decision-making.
+
+### The Case of Elliot
+Neurologist Antonio Damasio's patient Elliot had a brain tumour removed, along with some frontal lobe tissue. His IQ tested at the 97th percentile. He could enumerate every possible solution to any problem. But he couldn't choose between them. Without the ability to feel which option mattered more, he couldn't decide anything — not even what to have for lunch. He lost his job, family, and savings.
+
+**Without emotion, reason is paralysed.** Emotion doesn't cloud judgment; it provides the experiential data that judgment requires.
+
+### For Writers
+Every decision in a story must be emotionally motivated. Not because emotion is decoration, but because emotion is how decisions are actually made — in fiction and in life. If the reader can't feel why a character makes a choice, the choice is inert.
+
+## Mirror Neurons
+
+When we observe someone in pain or joy, the same neural circuits fire as when we experience it ourselves. The brain does not fully distinguish between observed and directly experienced emotion.
+
+This is why fiction works: the reader literally simulates the protagonist's experience. The same brain regions that would activate if the reader were living through the events activate while reading about them.
+
+This is also why the protagonist must react to everything: if the protagonist doesn't react emotionally, the reader's mirror neurons have nothing to mirror. The emotional simulation stops. The reader is cast out of the story.

package/payload/platform/plugins/writer-craft/skills/review-manuscript/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: review-manuscript
+description: "Performs a comprehensive multi-level review of a manuscript, chapter, or long passage — covering story architecture, reader engagement, prose craft, and editorial quality. Use this skill whenever the user asks to review a manuscript, critique a chapter, give feedback on their writing, assess whether their story is working, provide a manuscript assessment, do a full editorial review, or says 'what's wrong with this'. Also use when a writer submits a substantial piece of text and asks for comprehensive feedback rather than feedback on a specific aspect."
+---
+
+# Review Manuscript
+
+This skill performs a comprehensive, multi-level manuscript review. It examines the text through four lenses — story architecture, reader engagement, prose craft, and editorial quality — producing both inline observations and a structured summary report.
+
+## Review Process
+
+### Step 1: Read the Full Text
+Read the entire submitted text before making any observations. First impressions are valuable — note where you are engaged, confused, bored, or delighted. These instinctive responses are data.
+
+### Step 2: Identify the Story's Core
+
+Before critiquing anything, establish what is there:
+- What is the story about (not the plot — the internal journey)?
+- Who is the protagonist and what do they want?
+- What is the misbelief or inner issue?
+- What is the story question the reader is tracking?
+
+If these cannot be identified, that itself is the primary finding.
+
+### Step 3: Apply the Four Lenses
+
+Work through each lens in order. The order matters — structural problems should be addressed before prose problems, because structural surgery changes the prose landscape.
+
+#### Lens 1: Story Architecture
+- Is the misbelief specific, earned, and active?
+- Is the desire in conflict with the misbelief?
+- Does every scene touch the third rail (internal struggle)?
+- Is there a clear cause-and-effect chain through the internal story?
+- Does the opening begin at the last possible moment?
+- For the portion reviewed: is the trajectory toward the Aha moment visible?
+
+For the full story architecture framework, read `references/review-manuscript-checklist.md`.
+
+#### Lens 2: Reader Engagement
+- Does the opening hook? Are protagonist, stakes, and situation present from the first page?
+- Is urgency sustained? Where does momentum flag?
+- Does the cause-and-effect chain hold scene to scene?
+- Are setups paid off? Are there inadvertent setups?
+- Does conflict escalate? Is the opposition specific and active?
+- Does the protagonist react emotionally to events?
+
+#### Lens 3: Prose Craft
+- Does the prose sound right when read with the mind's ear?
+- Is there sentence variety?
+- Are adjectives and adverbs earning their place, or fattening the prose?
+- Is repetition deliberate or accidental?
+- Is the POV consistent? Are there unintended shifts?
+- Is exposition integrated or lumped?
+- Is crowding and leaping balanced — enough density, enough white space?
+
+#### Lens 4: Editorial Quality
+- Are there structural issues (pacing, missing sections, unnecessary sections)?
+- Line-level clarity and flow?
+- Internal consistency (names, timeline, details)?
+- Are there passages where the reader would disengage?
+
+### Step 4: Produce the Report
+
+Structure the output in two parts:
+
+#### Part A: Inline Observations
+Walk through the text noting specific observations at the point where they occur. For each observation:
+- Quote or reference the specific passage
+- Name the issue precisely
+- Explain why it matters to the reader's experience
+- Where possible, suggest a direction for revision
+
+#### Part B: Summary Report
+
+Use this structure:
+
+```
+## Manuscript Review: [Title or Description]
+
+### What Works
+[Specific, genuine praise — what the writer is doing well and should keep doing]
+
+### Story Architecture
+[Findings from Lens 1 — the internal story, misbelief, desire, third rail]
+
+### Reader Engagement
+[Findings from Lens 2 — hooks, urgency, cause-and-effect, stakes]
+
+### Prose Craft
+[Findings from Lens 3 — sound, rhythm, POV, word economy]
+
+### Editorial Notes
+[Findings from Lens 4 — structure, pacing, consistency]
+
+### Priority Recommendations
+[The 3-5 most important things to address, in order of impact]
+```
+
+## Review Principles
+
+- **Start with what works.** Every manuscript has strengths. Name them specifically.
+- **Address the biggest issues first.** If the story architecture is broken, don't spend pages on comma placement.
+- **Be specific.** "The pacing feels off in the middle" is useless. "Chapters 4-6 lose momentum because the protagonist has no active goal — she's reacting to events without pursuing anything" is actionable.
+- **Explain why.** Don't just flag problems — explain what they do to the reader's experience.
+- **Preserve the author's voice.** Never suggest changes that would make the writing sound like you instead of them.
+- **Frame as possibilities.** "What if..." and "Consider..." rather than "You must..."
+- **The book belongs to the author.** Your job is to help them write the best version of *their* book.
+
+## When to Read Reference Files
+
+- **For the full review checklist with detailed criteria** — read `references/review-manuscript-checklist.md`