@rubytech/create-siteoffice-code 0.1.256

package/payload/premium-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/premium-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/premium-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/premium-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/premium-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`

package/payload/premium-plugins/writer-craft/skills/review-manuscript/references/review-manuscript-checklist.md

@@ -0,0 +1,119 @@
+# Comprehensive Manuscript Review Checklist
+
+This checklist synthesises criteria from neuroscience-based story theory, professional editing practice, and prose craft technique into a single review framework.
+
+## Lens 1: Story Architecture
+
+### Protagonist's Internal World
+- [ ] Can you identify the protagonist's misbelief? Is it specific, earned, and active?
+- [ ] Can you identify the protagonist's desire? Is it in conflict with the misbelief?
+- [ ] Does the protagonist's worldview visibly filter their interpretation of events?
+- [ ] Is the origin of the misbelief traceable to a specific past experience?
+- [ ] Does every scene touch the third rail (the protagonist's internal struggle)?
+
+### Story Structure
+- [ ] Does the story begin at the last possible moment — when avoidance becomes impossible?
+- [ ] Does the inciting event directly threaten the protagonist's misbelief?
+- [ ] Is there a ticking clock creating urgency?
+- [ ] Is there a clear cause-and-effect chain through the internal story?
+- [ ] Does the ending (if present) represent a genuine internal transformation — the Aha moment?
+- [ ] Is the Aha moment earned, specific, and tied to the third rail?
+
+### What If Premise
+- [ ] Does the premise contain context, conflict, and a thematic point?
+- [ ] Does the premise imply the collision between the protagonist's inner world and external reality?
+
+## Lens 2: Reader Engagement
+
+### Opening / Hook
+- [ ] Is the protagonist present from page one?
+- [ ] Is something already happening that affects them?
+- [ ] Are stakes visible immediately?
+- [ ] Does the first page make the reader want to read the second?
+- [ ] Is there a "yardstick" — a framework for understanding what kind of story this will be?
+
+### Cause and Effect
+- [ ] Does every scene follow from the previous one (therefore/because, not and-then)?
+- [ ] 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 decision the protagonist makes traceable through the text?
+
+### Setup and Payoff
+- [ ] Is every setup paid off?
+- [ ] Is every payoff set up?
+- [ ] Are there inadvertent setups — details that promise significance but deliver nothing?
+- [ ] Is there enough distance between setups and payoffs to create anticipation?
+
+### Conflict and Escalation
+- [ ] Is there a clear "versus" — a specific rock and hard place?
+- [ ] Does conflict escalate with each complication?
+- [ ] Is the force of opposition specific, present, active, and credible?
+- [ ] Is the protagonist earning every gain and paying for every loss?
+- [ ] Have the protagonist's deepest flaws been exposed and tested?
+
+### Emotional Resonance
+- [ ] Does the protagonist react emotionally to events?
+- [ ] Are reactions specific and embodied, not generic?
+- [ ] Can the reader mirror the protagonist's emotions?
+- [ ] Is the story triggering all three engagement chemicals (dopamine, cortisol, oxytocin)?
+
+## Lens 3: Prose Craft
+
+### Sound and Rhythm
+- [ ] Does the prose sound right when read with the mind's ear?
+- [ ] Is there sentence length variety?
+- [ ] Does rhythm match emotional register?
+- [ ] Are long sentences clearly constructed?
+
+### Word Economy
+- [ ] Are adjectives and adverbs earning their place?
+- [ ] Are there qualifier ticks (just, very, kind of)?
+- [ ] Can weak verb + adverb combinations be replaced with strong verbs?
+- [ ] Is the prose crowded enough (vivid, dense) and leaped enough (no listing, no over-explanation)?
+
+### POV and Voice
+- [ ] Is the POV consistent? Are there accidental slips?
+- [ ] Is the tense consistent? Are shifts deliberate?
+- [ ] Does the narrative voice maintain a consistent register?
+- [ ] If character POV, does the language reflect how that character thinks?
+
+### Repetition
+- [ ] Is repetition deliberate and effective, or accidental?
+- [ ] Has natural repetition been replaced with awkward synonyms?
+
+### Exposition
+- [ ] Is exposition integrated or dumped in blocks?
+- [ ] Are there "As you know, Bob" moments?
+- [ ] Does necessary information arrive when the reader needs it?
+
+## Lens 4: Editorial Quality
+
+### Developmental
+- [ ] Is the structure serving the material?
+- [ ] Are there pacing problems — sections that drag or rush?
+- [ ] In fiction: are subplots connected to the main story?
+- [ ] In nonfiction: is the argument clear and building?
+- [ ] Is anything missing? Is anything unnecessary?
+
+### Line Level
+- [ ] Are there clichés, throat-clearing, or hedging?
+- [ ] Is tonal consistency maintained?
+- [ ] Are there logical gaps where the reader needs a bridge?
+- [ ] Does each paragraph lead naturally to the next?
+
+### Consistency
+- [ ] Character names consistent throughout?
+- [ ] Physical descriptions consistent?
+- [ ] Timeline consistent?
+- [ ] Geography and setting details consistent?
+
+## Report Priority Framework
+
+After completing the review, prioritise findings by impact:
+
+1. **Story architecture problems** — if the internal story is broken, everything built on it is compromised
+2. **Engagement problems** — if readers disengage, nothing else matters
+3. **Structural and pacing problems** — these change the prose landscape
+4. **POV and voice problems** — these affect every page
+5. **Prose craft problems** — important but addressable once larger issues are resolved
+6. **Consistency and mechanical errors** — last in priority, first in visibility

package/payload/premium-plugins/writer-craft/skills/review-prose/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: review-prose
+description: "Performs a prose-level review of a passage, analyzing sound, rhythm, sentence variety, POV consistency, word economy, repetition, and the balance of crowding and leaping. Use this skill whenever the user asks to check their writing style, review prose quality, assess how a passage reads, give style feedback, asks 'how does this sound', 'is this well written', 'check my prose', or submits a passage specifically for craft-level feedback rather than story-level feedback. Also use when a writer wants to improve the music and economy of their sentences."
+---
+
+# Review Prose
+
+Prose review examines writing at the level of sound, sentence, and word — the physical material of the text. This is distinct from story review (which examines internal architecture) and scene review (which examines a scene's structural function). Prose review asks: does this *sound* right? Is every word earning its place?
+
+## Review Process
+
+### Step 1: Read with the Mind's Ear
+Read the passage as if hearing it aloud. Note rhythm, flow, stumbles, beauty, and dullness. Do not analyze yet — just listen. Mark passages that sound wrong, passages that sound right, and passages where you lose the thread.
+
+### Step 2: Analyze Sound and Rhythm
+
+**Sentence variety:**
+- Map the sentence lengths. Is there variety, or monotonous uniformity?
+- Are short sentences deployed for emphasis in the right places?
+- Are long sentences clearly constructed — does the reader glide through, or get lost?
+- Is there conjunctivitis (strings of short sentences joined by "and" / "but")?
+
+**Rhythm:**
+- Does the rhythm match the emotional register of the content? (Fast rhythm for action, slower rhythm for reflection, etc.)
+- Are there accidental rhythmic patterns that create unintended effects?
+- Does the prose have moments of beauty — places where language takes pleasure in itself?
+
+### Step 3: Analyze Word Economy
+
+**Adjectives and adverbs:**
+- Can any adjective be absorbed into a stronger noun?
+- Can any adverb be absorbed into a stronger verb?
+- Are there qualifier ticks? (just, very, kind of, sort of, rather, a little, somewhat)
+- Are there empty intensifiers? (great, suddenly, somehow, really, absolutely)
+
+**Verbs:**
+- Are verbs active and specific? Or weak and generic?
+- Is the passive voice being used where active would be stronger? (And is it being used well where it belongs?)
+- Are there unnecessary "to be" constructions?
+
+**Crowding and leaping:**
+- Is the passage vivid, exact, concrete, dense, rich? (Crowded enough?)
+- Is there white space — things left unsaid, leaps the reader can make? (Leaped enough?)
+- Are there passages that list rather than describe?
+- Is every sensory detail earning its place — serving story, character, or theme?
+
+### Step 4: Analyze POV and Voice
+
+- Is the POV consistent throughout the passage?
+- Are there accidental slips into another character's thoughts?
+- Is the narrative voice consistent in register and tone?
+- If there's a strong character POV, does the language reflect how that character would think and perceive?
+- Is exposition delivered through the character's filter, or does the author step in?
+
+### Step 5: Check for Repetition
+
+- Is there accidental repetition — unintentional echoes that create clumsiness?
+- Is there deliberate repetition — purposeful echoes creating emphasis or rhythm?
+- Has the writer reached for the thesaurus to avoid natural repetition, producing awkward synonyms?
+
+### Step 6: Check Punctuation and Grammar
+
+- Is punctuation clarifying the prose or cluttering it?
+- Are there grammar errors that will break the reader's trust?
+- Are unconventional choices (fragments, run-ons, comma splices) deliberate and effective?
+
+## Prose Review Report Structure
+
+```
+## Prose Review: [Passage Description]
+
+### Overall Impression
+[How the passage reads as a whole — the mind's ear verdict]
+
+### Strengths
+[What the writer is doing well at the prose level]
+
+### Sound and Rhythm
+[Sentence variety, rhythmic patterns, flow]
+
+### Word Economy
+[Adjectives/adverbs, verb strength, qualifiers, crowding/leaping]
+
+### POV and Voice
+[Consistency, register, character filter]
+
+### Repetition
+[Accidental vs. deliberate; awkward synonym hunting]
+
+### Specific Line Notes
+[Passage-by-passage observations with specific suggestions]
+
+### Priority Recommendations
+[The 3-5 most impactful prose improvements to make]
+```
+
+## When to Read Reference Files
+
+- **For the complete prose review criteria** — read `references/prose-review-checklist.md`