@rubytech/create-realagent 1.0.406

package/payload/premium-plugins/writer-craft/skills/editorial-practice.md

@@ -0,0 +1,108 @@
+---
+name: editorial-practice
+description: "Guides professional editing methods: developmental editing, line editing, copyediting, the editorial letter, author-editor dynamics, self-editing, and genre-specific editing considerations. Use this skill whenever the user asks about developmental editing, line editing, copyediting, editorial feedback, the editing process, self-editing, manuscript editing, editorial letters, structural editing, how editors work, what to look for when editing, giving feedback on writing, manuscript assessment, or any question about how professional editors approach manuscripts. Also use when a writer wants to edit their own work more effectively or when someone is providing editorial feedback to another writer."
+---
+
+# Editorial Practice
+
+Editing is not correcting prose. It spans three fundamental functions — acquisition (finding the right book), text development (making it the best it can be), and publication (bringing it to readers). The editor is a connector between writer and reader, simultaneously representing the author's creative vision and the reader's experience of encountering the book cold.
+
+This skill covers the text development function: the three layers of editing that transform a manuscript into the best version of itself.
+
+## The Three Layers of Editing
+
+### 1. Developmental Editing
+The big picture. Structure, pacing, argument, character development, narrative arc. The editor reads the complete draft and writes a detailed editorial letter addressing large-scale issues.
+
+This is intellectually the most demanding phase. It requires holding the entire book in mind while diagnosing weaknesses and imagining solutions. Three qualities are required that cannot be taught: judgment, taste, and empathy.
+
+**What developmental editors look for:**
+- Does the book know what it's about? Is the central argument or story question clear?
+- Is the structure serving the material, or is the material forced into an ill-fitting structure?
+- Are there pacing problems — sections that drag, sections that rush?
+- In fiction: is the protagonist's internal arc driving the plot? Are subplots connected to the main story?
+- In nonfiction: is the argument persuasive? Does it build? Are there logical gaps?
+- Is anything missing that should be there? Is anything there that should be cut?
+
+**The editorial letter:**
+- Opens with genuine, specific praise (what works and why)
+- Addresses structural issues in order of importance
+- Proposes solutions constructively — "what if" rather than "you must"
+- Maintains the author's ownership — the book belongs to them, not the editor
+
+### 2. Line Editing
+Sentence by sentence, paragraph by paragraph. Clarity, flow, word choice, syntax, tonal consistency. Line editing is harder to define than developmental editing because it is more holistic — a good line editor restructures paragraphs, queries plot points, ensures tonal consistency, and serves as the author's most attentive first reader.
+
+**What line editors look for:**
+- Hedging adverbs, empty intensifiers, passive constructions
+- Cliches and throat-clearing phrases
+- Tonal inconsistency — shifts in register that break the reader's trust
+- Paragraphs that need restructuring for clarity or impact
+- Places where the author tells when they should show (or shows when context is needed first)
+- Logical gaps — missing steps in reasoning or narrative
+- Repetition that isn't serving a purpose
+
+**Calibration:** Line editing must be calibrated to what each individual author needs and can tolerate. Aggressive editing of an author who needs reassurance damages confidence. The editor's job is to help the author become the best version of themselves, not to impose the editor's preferences.
+
+### 3. Copyediting
+Grammar, spelling, punctuation, capitalisation, consistency, and factual accuracy. The quality-control phase. Copyeditors apply house style and query anything unclear.
+
+**What copyeditors check:**
+- Grammar and spelling errors
+- Punctuation consistency
+- Internal consistency (character names, timeline, physical descriptions)
+- Factual accuracy where checkable
+- Style guide compliance
+
+**Key distinction:** Copyeditors typically do not undertake structural revision or work directly with the author. But good copyeditors frequently catch line-editing problems that earlier passes missed.
+
+## The Self-Editing Process
+
+Professional editing is irreplaceable — authors cannot see their own work objectively. But self-editing done well makes every subsequent editorial pass more productive.
+
+### Successive Passes at Decreasing Scale
+1. **Structure** — Does the whole thing work? Are the parts in the right order? Is anything missing or superfluous?
+2. **Chapter/section** — Does each chapter earn its place? Does it advance the story or argument?
+3. **Scene/paragraph** — Does each scene touch the third rail? Does each paragraph lead to the next?
+4. **Sentence** — Is each sentence clear, necessary, and well-constructed?
+5. **Word** — Is each word earning its place?
+
+### Self-Editing Techniques
+- **Read aloud** — reveals awkwardness invisible to the eye
+- **Print and read on paper** — changes the visual relationship to the text
+- **Read backwards** (sentence by sentence) — breaks the flow of expectation, forcing you to evaluate each sentence on its own
+- **Time away** — the longer you can leave between writing and revising, the more clearly you see
+- **Beta readers** — seek honest developmental feedback before line editing
+
+## Genre-Specific Considerations
+
+Different genres demand different editorial attention:
+
+- **Literary fiction**: Form and content are inseparable. The editor must resist imposing their own aesthetic — serve the author's vision, never substitute your own.
+- **Genre fiction**: Must entertain above all. Boredom is the cardinal sin. Readers don't just follow the protagonist — they become them.
+- **Memoir**: The author's subjectivity is a feature, not a problem. But the story must impose narrative shape on messy chronology.
+- **General nonfiction**: Must be persuasive — it must carry the reader along. The editor's most useful note is often "I'm bored here."
+- **Biography**: Why does this life matter, and to whom? Every detail must serve that question.
+
+## Editorial Practice Checklist
+
+When editing or providing editorial feedback:
+
+- [ ] Start with what works — genuine, specific praise
+- [ ] Address the biggest structural issues first (developmental)
+- [ ] Then prose-level issues (line editing)
+- [ ] Leave mechanical corrections for last (copyediting)
+- [ ] Frame suggestions as possibilities, not commands
+- [ ] Maintain the author's voice — never substitute your own
+- [ ] Check internal consistency (names, timeline, descriptions)
+- [ ] Identify where the reader is likely to disengage ("I'm bored here")
+- [ ] Note where exposition is lumped rather than integrated
+- [ ] Flag where the author assumes knowledge the reader doesn't have
+
+## When to Read Reference Files
+
+- **For developmental editing in depth** — read `references/developmental-editing.md`
+- **For line editing techniques** — read `references/line-editing.md`
+- **For copyediting standards** — read `references/copyediting.md`
+- **For genre-specific editing guidance** — read `references/genre-specific-editing.md`
+- **For self-editing and self-publishing** — read `references/self-editing.md`

package/payload/premium-plugins/writer-craft/skills/persuasive-storytelling.md

@@ -0,0 +1,114 @@
+---
+name: persuasive-storytelling
+description: "Guides persuasive storytelling for nonfiction, speeches, marketing, and advocacy: audience analysis, misbelief targeting, the four-stage transformation framework, and emotional persuasion through narrative. Use this skill whenever the user mentions persuasive writing, nonfiction storytelling, audience analysis, changing minds, marketing narrative, speechwriting, persuasion through story, call to action, audience resistance, 'how do I convince', content marketing, advocacy storytelling, campaign narrative, or wants to use story to change behaviour or belief. Also use when a nonfiction writer needs to make facts land emotionally or when someone wants to understand why their message isn't getting through."
+---
+
+# Persuasive Storytelling
+
+Facts without context produce resistance, not persuasion. The brain processes 11 million bits of sensory data per second and consciously handles about forty. The filter is the cognitive unconscious — it evaluates every incoming piece of information against one question: *Will this help me or hurt me, given my agenda?* Facts that fail this test are discarded instantly. Story bypasses the filter because story already speaks the language the cognitive unconscious uses.
+
+No one hears you unless they feel heard.
+
+## Why Facts Fail
+
+### The Four Types of Facts
+
+| Type | Example | Brain's Response |
+|------|---------|-----------------|
+| **Neutral** | "Bubble gum contains rubber" | Ignored |
+| **Warning** | "Lion — run!" | Immediate action |
+| **Validating** | "Chocolate is good for you" | Absorbed — confirms existing belief |
+| **Conflicting** | Climate science to a denier | Defensive response — position hardens |
+
+Only warning facts (imminent danger) and validating facts (confirms belief) produce automatic action. All other facts require story to give them meaning.
+
+### The Boomerang Effect
+When facts directly challenge a person's belief, the brain doesn't update — it mounts a defence. Presenting contradictory information can actually strengthen the original position. The brain routes challenges to beliefs through the same system it uses to handle physical threats.
+
+### The Curse of Knowledge
+Once you know something, it becomes nearly impossible to imagine not knowing it. What you hear as music, your audience hears as noise.
+
+## The Four-Stage Transformation
+
+Every persuasive story moves through four stages:
+
+### 1. Misbelief
+The erroneous belief your audience holds that prevents them from heeding your call to action. This is not what they say their reason is — it's the emotional core beneath the surface objection.
+
+### 2. Truth
+What the story's events will reveal as actually true. This is not your logical argument — it's the emotional reality your story will make the audience experience.
+
+### 3. Realization
+The moment the protagonist (and by extension, the audience) sees the misbelief for what it is. This must come at the last possible second, belong to the protagonist, be transparent in its logic, and be liberating.
+
+### 4. Transformation
+The protagonist is freed from the misbelief and can now act. The audience, having vicariously lived the experience, is freed too.
+
+## Understanding Your Audience
+
+### Who They Are Not
+- **Not you.** Your audience doesn't share your priorities.
+- **Not everyone.** Different groups have different misbeliefs. A story can only target one.
+
+### Research Questions
+- What matters most to them right now?
+- What do they aspire to be?
+- What do they fear?
+- What would they have to give up to follow your call to action?
+- What internal (emotional) cost would that trade carry?
+- What misbelief keeps them from seeing how your call to action serves them?
+
+### Finding the Real Resistance
+The stated reason for not adopting a behaviour is almost never the real reason. People don't know their own misbeliefs, or admitting the real reason feels too vulnerable.
+
+Use the drilling technique — start with the surface behaviour and keep asking "why" or "and so?" until you reach the emotional core.
+
+**Example**: Teenager texting while driving
+- "It's safe, I'm good at multitasking" → surface
+- "I need to reply quickly or they'll think I don't care" → social anxiety
+- "If they think I don't care, they'll text someone else" → fear of exclusion
+- "If Becky texts Malik instead, I'll lose her" → fear of abandonment
+
+This isn't about driving. It's about belonging. No amount of crash statistics addresses that.
+
+## Crafting the Story
+
+### One Protagonist, One Point
+The protagonist represents your audience. One specific external problem forces one internal struggle, leading to one "aha" moment. Everything serves the single point.
+
+### The Rule of Threes
+Three escalating twists. Two failed attempts, then the breakthrough. Each attempt must be distinct and escalate — giving the protagonist more to lose with each failure.
+
+### Specificity Creates Meaning
+The general is a category; the specific is the thing being categorised. "Our friends were supportive" is noise. "The church neighbours brought covered dishes" is a world.
+
+Every specific detail must do two things: make the world visible and carry meaning. Details that don't do both are noise.
+
+### The "Aha" Moment Conditions
+1. **Timing** — at the last possible second
+2. **Agency** — the protagonist makes the discovery themselves
+3. **Transparency** — the audience understands why the change happened
+4. **Liberation** — the protagonist is freer, more authentically themselves
+
+### End at the Transformation
+Don't add a coda. The emotional transformation is the story's end. Everything after dilutes it.
+
+## Persuasive Story Checklist
+
+- [ ] Can you name your audience's specific misbelief?
+- [ ] Is your call to action concrete, specific, and actionable?
+- [ ] Have you drilled past the surface resistance to the emotional core?
+- [ ] Does your story have one protagonist (representing your audience)?
+- [ ] One unavoidable external problem?
+- [ ] Three escalating twists?
+- [ ] One "aha" moment meeting all four conditions?
+- [ ] Does it end at the transformation — no coda?
+- [ ] Is everything specific, not general?
+- [ ] Does the story speak to the audience's self-narrative rather than threatening it?
+
+## When to Read Reference Files
+
+- **For audience analysis and finding real resistance** — read `references/audience-analysis.md`
+- **For the four-stage transformation framework in detail** — read `references/transformation-framework.md`
+- **For crafting the story (specificity, cause-effect, aha moment)** — read `references/crafting-persuasive-story.md`
+- **For case studies showing these principles in action** — read `references/persuasion-case-studies.md`

package/payload/premium-plugins/writer-craft/skills/point-of-view.md

@@ -0,0 +1,97 @@
+---
+name: point-of-view
+description: "Guides point of view, narrative voice, tense, person, and indirect narration in fiction and nonfiction. Use this skill whenever the user asks about POV, first person, third person, omniscient narrator, limited third, detached narrator, observer-narrator, narrative voice, tense choice (present vs past), person of the verb, changing viewpoint, POV shifts, unreliable narrator, indirect narration, polyphony, or 'whose head am I in'. Also use when a writer's POV is inconsistent, when diagnosing tense problems, or when helping choose the right narrative perspective for a story."
+---
+
+# Point of View and Voice
+
+Point of view is who tells the story and what their relation to it is. Voice is the sound of the telling. They are so intimately connected as to be the same thing. POV is also the single most common source of unconscious errors in fiction — writers shift viewpoint without knowing they've done it, and readers feel the wobble without being able to name it.
+
+## The Five Principal Points of View
+
+### 1. First Person
+"I" is the viewpoint character, centrally involved. Only what "I" knows, feels, perceives, thinks, guesses, hopes, and remembers can be told. The reader infers others only from what "I" observes.
+
+**Strengths**: Intimacy, voice, immediacy.
+**Dangers**: Can become claustrophobic; tempts the writer to make every character sound the same; limits information delivery.
+
+### 2. Limited Third Person
+"He" or "she" as viewpoint character, with the same essential limitation as first person — nothing is seen or known except what this character sees and knows. Switching from first to limited third is not as simple as changing pronouns; the imaginative energy is different for both writer and reader.
+
+**Strengths**: Intimacy without the constraints of "I"; can shift between characters (with care).
+**Dangers**: Accidental POV slips into other characters' thoughts; one-sentence incursions that break the contract.
+
+### 3. Involved Author (often called "Omniscient")
+No single viewpoint character. The author can enter any character's mind, describe things no character is present to see, make judgments, interpret behaviour. The oldest, most widely used, and most versatile POV — and probably the most difficult for contemporary writers to handle well.
+
+**Strengths**: Maximum flexibility; can provide context no character possesses; allows authorial commentary.
+**Dangers**: Can feel distant; requires a strong, confident authorial voice; easy to handle clumsily.
+
+### 4. Detached Author ("Fly on the Wall")
+No viewpoint character. The narrator reports only what a neutral observer could infer from behaviour and speech, never entering a character's mind. The least overtly but most covertly manipulative POV — everything is controlled by what the narrator chooses to show.
+
+**Strengths**: Creates mystery; forces the reader to interpret; can produce powerful understatement.
+**Dangers**: Emotional coldness; readers may not connect with characters.
+
+### 5. Observer-Narrator
+The narrator is a character but not the principal one — a witness rather than an actor. Available in both first and third person.
+
+**Strengths**: Can observe the protagonist from outside while maintaining a personal voice; creates natural mystery about the protagonist's inner life.
+**Dangers**: The observer can upstage the protagonist; limits access to the protagonist's thoughts.
+
+## Tense
+
+### Past Tense
+Gives continuous access to before and after. Minds move around easily as they normally do. Like sunlight — illuminates everything.
+
+### Present Tense
+Narrower field of vision. Focused on action in a single time and place. Sets up a permanent artificial emergency. Like a narrow-beam flashlight.
+
+Present tense can be exactly right for fast-paced action or a character whose engine runs hot. But many writers use it from fashion rather than choice. If you always write in present tense, some verb forms in your head may not have been activated for a long time.
+
+### Two-Timing
+Switching between past and present tense without awareness or signal is one of the most common and disorienting errors. Every tense shift must be deliberate and serve the story.
+
+## POV Shifts: The Rules
+
+You can change point of view. It is your right as a fiction writer. All that is required: **know that you're doing it**.
+
+The hierarchy of difficulty:
+1. **First ↔ third person** — enormously difficult in a short piece; uncommon even in novels
+2. **Detached ↔ involved author** — essentially impossible within a single piece
+3. **Between viewpoint characters in limited third** — possible but must be handled with awareness
+
+The final rule: you can shift from one viewpoint character to another any time you like, **if** you know why and how, **if** you're cautious about doing it frequently, and **if** you never do it for a moment only. One-sentence POV shifts are always uncomfortable.
+
+## Indirect Narration
+
+Not all storytelling is direct scene and action. Indirect narration includes:
+- **Exposition** — necessary information delivered without dumping it as lectures. Break it up, grind it fine, and make it into bricks to build the story with.
+- **Polyphony** — letting characters speak in their own voices, not as mouthpieces for the author.
+- **Character by indirection** — describing a place to reveal its inhabitant; describing an aftermath to reveal an event.
+
+## POV Diagnostic Checklist
+
+- [ ] Can you name the POV type being used? (first, limited third, involved author, detached, observer)
+- [ ] Is the POV consistent within scenes?
+- [ ] Are there accidental one-sentence slips into another character's thoughts?
+- [ ] Is the tense consistent? Are any shifts deliberate and signaled?
+- [ ] Does the chosen POV serve the story? (Would another POV work better?)
+- [ ] If the protagonist's subjective filter is the POV, does it color everything?
+- [ ] Is exposition integrated into the narrative, or dumped in lectures?
+- [ ] Do secondary characters have their own voices, or do they all sound like the author?
+
+## When to Read Reference Files
+
+- **For detailed POV types and voice guidance** — read `references/pov-types-and-voice.md`
+- **For tense, person, and the passive voice** — read `references/tense-and-person.md`
+- **For indirect narration and polyphony** — read `references/indirect-narration.md`
+- **For the protagonist's subjective filter and emotional POV** — read `references/protagonist-filter.md`
+
+## Exercises to Offer Writers
+
+1. **Points of View** — Devise a situation with several people. Write it five times: limited third (character A), limited third (character B), detached narrator, observer-narrator, involved author. Feel how each changes the story.
+2. **The Old Woman** — An old woman doing a task while thinking about a past event. Version 1: one tense throughout. Version 2: the other person, switching tenses between "now" and "then". Do not search-and-replace pronouns — rewrite, because changing person and tense changes the story.
+3. **Changing Voices** — Write a 300-600 word narrative shifting POV between characters with marked changes. Then rewrite it shifting POV without obvious signals. The ice is thin.
+4. **Pure Dialogue** — Two people in a crisis, written as A and B with no description or stage directions. Everything about character, setting, and situation must emerge from what they say.
+5. **Being the Stranger** — Write from the viewpoint of someone you dislike or find alien. Suspend judgment. Inhabit them. See the world through their eyes.

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

@@ -0,0 +1,100 @@
+---
+name: prose-craft
+description: "Reviews and teaches prose technique: sound and rhythm, sentence variety, punctuation, repetition, adjectives and adverbs, word economy, crowding and leaping. Use this skill whenever the user asks about prose style, sentence rhythm, sentence length, punctuation choices, grammar for writers, repetition in prose, adjective and adverb usage, word economy, crowding, leaping, prose polish, 'how does my writing sound', 'my prose feels flat/clunky/wordy', or any question about the craft of writing at the sentence and paragraph level. Also use when reviewing a passage for prose quality or when a writer wants to improve their style."
+---
+
+# Prose Craft
+
+The sound of language is where it all begins. A good writer has a mind's ear — they hear their prose as they write it. The common critical terms for weak prose (dull, choppy, droning, jerky, feeble) are all faults of sound. The chief duty of a narrative sentence is to lead to the next sentence, and it does this through pace, movement, and rhythm.
+
+This skill covers prose at the sentence and paragraph level: the physical material of writing.
+
+## Core Principles
+
+### 1. Sound and Rhythm
+Prose has musical properties. Not meter (that turns prose into poetry), but rhythm — the irregular, varying cadence created by sentence length, word choice, stress patterns, and silence. Train the mind's ear. Read prose aloud. If it sounds wrong, it is wrong, regardless of whether you can name the problem.
+
+The elements of sound:
+- **Onomatopoeia** — words that sound like what they mean
+- **Alliteration** — repetition of initial sounds
+- **Cadence** — the rise and fall of sentence rhythm
+- **Silence** — what is left out; the white space around the word
+
+### 2. Sentence Length and Variety
+There is no optimum sentence length. The optimum is **variety**. Rhythm in prose depends on the contrast between sentences of different lengths. A passage of all short sentences is choppy and monotonous. A passage of all long sentences is exhausting. The interplay is what creates music.
+
+Short sentences are highly effective in the right place. Complex sentences need clear construction so they carry the reader rather than losing them. A sentence so grand it stops the story is not working as a narrative sentence.
+
+Common problems:
+- **Conjunctivitis** — stringing short sentences together with "and" and "but", creating childish droning
+- **Misplacement** — sentence parts in the wrong order, creating ambiguity
+- **Danglers** — modifying phrases attached to the wrong noun
+
+### 3. Punctuation
+Punctuation tells the reader how to hear the writing. It makes grammatical structure clear and shows where the pauses and breaks come. Writers must be competent themselves — grammar-correcting software is dangerously incompetent.
+
+Know real rules from fake ones:
+- **Fake rule**: Never begin a sentence with "There is" (it's a legitimate existential construction)
+- **Fake rule**: Never use the passive voice (the passive is one of the lovely versatilities of the verb — guard against it only when it obscures agency)
+- **Real rule**: Know what you are doing with your language and why
+
+### 4. Repetition
+Deliberate repetition is one of the great powers of prose. Accidental repetition is clumsy. Learn to distinguish them.
+
+Repetition can be:
+- **Incantatory** — building rhythm and emotional weight
+- **Structural** — events echoing events across the novel
+- **Comic** — a recurring phrase gathering weight with each appearance
+- **Hammering** — a word repeated like a blow for emphasis
+
+The journalistic rule against using the same word twice on a page drives writers to the thesaurus for far-fetched synonyms that stick out like flamingos in a flock of pigeons. Reject it.
+
+### 5. Adjectives and Adverbs
+Rich, good, and nourishing — they cause obesity only when used lazily or overused. The key principle: when the quality can be put directly in the verb or noun, the prose will be stronger.
+
+- *They ran quickly* → *They raced*
+- *A growling voice* → *A growl*
+- *She said loudly* → *She shouted*
+
+Watch for:
+- **Qualifiers** (rather, a little, just, very, kind of, sort of) — bloodsuckers in prose
+- **Empty intensifiers** — "great", "suddenly", "somehow" — meaningless through overuse
+- **Hedging adverbs** — weakening statements the writer should commit to
+
+### 6. Crowding and Leaping
+**Crowding**: loading every rift with ore. Vivid, exact, concrete, accurate, dense, rich. Keep the story full of what's happening, moving, interconnected.
+
+**Leaping**: 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. Listing is not describing. Only the relevant belongs.
+
+Crowd in the first draft. Then cut. Decide what counts, what tells, and cut and recombine until what's left is what counts.
+
+## Prose Review Checklist
+
+When reviewing a passage for prose quality:
+
+- [ ] Read it aloud (or with the mind's ear). Does it sound right?
+- [ ] Is there sentence length variety? Or monotonous uniformity?
+- [ ] Are long sentences clearly constructed and easy to follow?
+- [ ] Is punctuation doing its job — clarifying, not cluttering?
+- [ ] Is repetition deliberate and effective, or accidental and clumsy?
+- [ ] Can any adjective be absorbed into a stronger noun? Any adverb into a stronger verb?
+- [ ] Are there qualifier ticks (just, very, kind of, sort of, rather)?
+- [ ] Does every sensory detail serve the story — or is some of it travelogue?
+- [ ] Is the passage crowded enough (vivid, dense, moving)?
+- [ ] Has enough been leaped over (no listing, no unnecessary explanation)?
+- [ ] Does each sentence lead to the next?
+
+## When to Read Reference Files
+
+- **For sound, rhythm, and sentence variety** — read `references/sound-and-rhythm.md`
+- **For adjectives, adverbs, and word economy** — read `references/word-economy.md`
+- **For punctuation and grammar guidance** — read `references/punctuation-and-grammar.md`
+- **For the craft of deliberate repetition** — read `references/repetition.md`
+
+## Exercises to Offer Writers
+
+1. **Being Gorgeous** — Write a paragraph of narrative meant to be read aloud: use onomatopoeia, alliteration, repetition, rhythmic effects. Show off. Use the whole orchestra.
+2. **Am I Saramago** — Write 150-350 words of narrative with no punctuation and no paragraphing (a hectic group activity). Discover what punctuation does by forbidding it.
+3. **Short and Long** — Part 1: Write 100-150 words in sentences of seven words or fewer, each with subject and verb. Part 2: Write up to 350 words that is all one sentence.
+4. **Chastity** — Write 200-350 words of descriptive narrative with no adjectives or adverbs. Only verbs, nouns, pronouns, and articles. The most enlightening exercise there is.
+5. **A Terrible Thing to Do** — Take a piece over 400 words and cut it by half. Not trimming — counting words and reducing to half. Discover which words are Styrofoam and which are heavy gold.

package/payload/premium-plugins/writer-craft/skills/reader-engagement.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/premium-plugins/writer-craft/skills/review-manuscript.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`