@rubytech/create-siteoffice-code 0.1.256

package/payload/premium-plugins/writer-craft/skills/point-of-view/references/tense-and-person.md

@@ -0,0 +1,85 @@
+# Tense and Person of the Verb
+
+## Person of the Verb
+
+### First Person (I / We)
+The narrator is a character. Everything is filtered through their perception.
+
+Historical evolution: from Cicero's letters and medieval diaries through the epistolary novel (Richardson, Austen) to the modern first-person novel. First person is often assumed to be the simplest mode, but it introduces subtle traps — especially the tendency to make every character sound alike.
+
+### Third Person (He / She / They)
+The most common and least troublesome mode. Third person ranges from extremely intimate (limited third — practically first person with different pronouns) to extremely distant (detached narrator — practically a camera).
+
+**Limited third** is restricted to the perceptions, knowledge, feelings, and memories of one character. Technically very close to first person. Switching between limited-third viewpoint characters is possible but requires awareness.
+
+### Second Person (You)
+Rare in fiction. Creates an imperative, immersive quality. Can feel gimmicky if sustained too long. Works well in short bursts or in genres where it serves a specific purpose.
+
+## Tenses of the Verb
+
+### Past Tense
+The default narrative tense throughout most of literary history. Gives continuous access to before and after — minds move around easily as they normally do.
+
+**Metaphor:** Sunlight — illuminates everything, allows the eye to roam freely across time and space.
+
+**Advantages:**
+- Natural access to memory, reflection, foreshadowing
+- Allows the narrator to know more than the character knew at the time
+- The full range of verb forms is available
+- Does not create artificial urgency
+
+### Present Tense
+Dominant in contemporary fiction for the past thirty to forty years. Narrower in field of vision — necessarily focused on action in a single time and place.
+
+**Metaphor:** A narrow-beam flashlight — intense illumination of one spot, darkness everywhere else.
+
+**Advantages:**
+- Immediacy — the reader experiences events as they unfold
+- Creates inherent urgency ("a permanent artificial emergency")
+- Can be exactly right for fast-paced action or a character whose engine runs hot
+- Prevents the narrator from reflecting at length (which can be a feature or a bug)
+
+**Dangers:**
+- Many writers use it from fashion rather than conscious choice
+- If you always write in present tense, some verb forms may atrophy
+- Sustained present tense can feel relentless — no breathing room
+- Flashbacks and memory become technically awkward
+
+### Two-Timing
+Switching between past and present tense without awareness or signal is one of the most common and disorienting errors in contemporary prose. A passage that drifts from past to present and back within a paragraph without reason is simply broken.
+
+**The rule:** Every tense shift must be deliberate and must serve the story. If switching tenses, the shift should be clear enough that the reader understands they've moved in time.
+
+### Choosing Tense
+
+Questions to ask:
+- Does the story need access to before and after? → Past tense
+- Does the story need the claustrophobic intensity of the present moment? → Present tense
+- Is the narrator looking back on events with the knowledge of what happened? → Past tense
+- Is the narrator experiencing events without foreknowledge? → Either works, but present intensifies the effect
+- Are there multiple timelines that need to be distinguished? → Tense shifts can serve this, but must be deliberate
+
+## The Passive Voice
+
+### What It Actually Is
+The passive voice reverses the normal subject-verb-object order so that the object of the action becomes the grammatical subject.
+
+- **Active:** "The dog bit the man"
+- **Passive:** "The man was bitten by the dog"
+
+### The Fake Rule
+"Never use the passive voice" is not a real rule. The passive is a legitimate construction with specific uses.
+
+### When the Passive Is Appropriate
+- When the agent is unknown: "The window was broken during the night"
+- When the agent is less important than the action or result: "The cathedral was completed in 1247"
+- When the passive creates the right rhythm: sometimes the sentence simply sounds better
+- When the passive creates emphasis: "The city was destroyed" emphasises the city; "An earthquake destroyed the city" emphasises the earthquake
+
+### When to Guard Against It
+Passive voice that seeps in from academic, bureaucratic, or business English to obscure agency and responsibility:
+- "Mistakes were made" — by whom?
+- "It was determined that..." — by whom?
+- "The decision was reached to..." — by whom?
+
+This evasive passive is worth eliminating. The useful passive is worth keeping.

package/payload/premium-plugins/writer-craft/skills/prose-craft/SKILL.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/prose-craft/references/punctuation-and-grammar.md

@@ -0,0 +1,72 @@
+# Punctuation and Grammar for Writers — Steering the Craft
+
+## Why Punctuation Matters
+
+Punctuation tells the reader how to hear the writing. It makes grammatical structure clear and shows where the pauses and breaks come. An unpunctuated paragraph makes meaning hard to extract. The same words, punctuated differently, either clarify or destroy meaning.
+
+Writers must be competent in punctuation and grammar themselves. Copy editors are an endangered species, and grammar-correcting software is dangerously incompetent at understanding context and intent.
+
+## Grammar as the Writer's Toolkit
+
+Grammar is the vocabulary of the writer's tools. A writer who doesn't know grammar is like a carpenter who doesn't know a hammer from a screwdriver. You need to know the rules — not to follow them slavishly, but to break them consciously and effectively.
+
+### The Distinction: Correctness vs. Craft
+- **Correctness** is a social and political matter — it can be a marker of class and education
+- **Craft** is a matter of clear communication — in written prose, incorrect usage is disastrous because the reader has only the words, and they must be clear
+- Unconventional usage (fragments, run-ons, dialect, deliberate rule-breaking) is a legitimate craft choice — when it's conscious
+- Unconscious errors undermine the reader's trust
+
+## Fake Rules to Reject
+
+### "Never begin a sentence with 'There is'"
+There is no such thing as "the passive tense." "There is" is an existential construction that good writers use all the time. The claim that it's passive voice reveals ignorance of what passive voice actually is.
+
+### "Never use the passive voice"
+The passive is one of the lovely versatilities of the verb. It is perfectly appropriate in many situations:
+- When the agent is unknown: "The window was broken"
+- When the agent is less important than the action: "The building was completed in 1847"
+- When the passive creates the right rhythm or emphasis
+
+What writers should guard against: passive voice that seeps in from academic or business English to obscure agency and responsibility. "Mistakes were made" when someone specific made them.
+
+### "He is the generic pronoun"
+This is a social convention, not a grammatical law. Using "their" with singular antecedents is a conscious, defensible choice that many careful writers make deliberately.
+
+## Real Rules to Know
+
+### Sentence Coherence
+A sentence must hang together — it must be coherent. The parts must relate to each other clearly. When they don't, meaning becomes ambiguous or absurd.
+
+### Modifier Placement
+Place modifiers next to what they modify. Misplaced modifiers create unintended comedy:
+- "Walking down the street, the trees were beautiful" (the trees are walking)
+- "After rotting in the cellar for three weeks, my sister brought up some oranges" (the sister was rotting)
+
+### Dangling Participles
+A participial phrase at the beginning of a sentence must modify the subject of the sentence. If it doesn't, it dangles.
+
+### Comma Splices and Run-Ons
+- A **comma splice** joins two independent clauses with only a comma (often considered an error, but deliberately used by many skilled writers for rhythm)
+- A **run-on** jams two independent clauses together with no punctuation at all
+- The fix (when one is needed): period, semicolon, or conjunction
+
+### The Semicolon
+Joins two independent clauses that are closely related in meaning. Creates a pause longer than a comma but shorter than a period. A useful tool that many writers fear unnecessarily.
+
+## Key Punctuation for Prose Writers
+
+| Mark | Function in Prose |
+|------|------------------|
+| **Period** | Full stop. End of thought. Creates silence. |
+| **Comma** | Brief pause. Separates clauses, items, and modifying phrases. The most versatile and most misused mark. |
+| **Semicolon** | Connects related independent clauses. Creates a bridge between thoughts too close for a period, too independent for a comma. |
+| **Colon** | Announces what follows: a list, an explanation, or an amplification of what came before. |
+| **Dash (em dash)** | Interruption, parenthetical emphasis, or dramatic pause. More forceful than a comma, less formal than a colon. |
+| **Ellipsis** | Trailing off, omission, or the passage of time. Overused in amateur prose — use sparingly. |
+| **Parentheses** | Aside, digression, or supplementary information. Can create intimacy or distance depending on context. |
+
+## The Moral Dimension
+
+Socrates: "The misuse of language induces evil in the soul." This does not mean grammar errors are morally wrong. It means that language used carelessly — to obscure rather than clarify, to manipulate rather than communicate, to evade responsibility — is a failure of craft and, at its worst, a failure of character.
+
+The writer's obligation: know what you are doing with your language and why.

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

@@ -0,0 +1,71 @@
+# The Craft of Repetition — Steering the Craft
+
+## Deliberate vs. Accidental Repetition
+
+There is such a thing as clumsy repetition — the accidental echo that occurs when you aren't rereading as you write. That kind is easy to fix in revision. But to make a rule against repetition is to go right against the nature of narrative prose.
+
+### The Anti-Repetition Myth
+The journalistic and pedagogical rule against using the same word twice on a page drives writers to the thesaurus in search of far-fetched synonyms — flaming words that stick out of their prose like flamingos in a flock of pigeons.
+
+If the right word is "said," use "said" — do not cycle through "exclaimed," "uttered," "pronounced," "declared," and "vouchsafed" to avoid repeating it.
+
+## The Power of Deliberate Repetition
+
+From the grandmother telling a folktale to the most sophisticated novelist, all narrators use repetition. The skilful use of it is a great part of the power of prose.
+
+### Types of Repetition
+
+**Verbal Repetition** — repeating a word or phrase for emphasis, rhythm, or accumulation:
+- A word repeated like a hammer blow, gaining force with each use
+- A phrase that becomes a refrain, changing meaning through context each time it appears
+- A key word echoed across paragraphs, creating subconscious connections
+
+**Structural Repetition** — events, situations, or patterns that echo each other:
+- Near-repetition of events in different contexts
+- A scene that mirrors an earlier scene but with changed stakes or meaning
+- Patterns across the novel analogous to recapitulation and development in music
+
+**Comic Repetition** — a recurring element that gathers comedic weight:
+- Micawber's "Something is certain to turn up" in David Copperfield, gaining meaning with each recurrence
+
+**Incantatory Repetition** — repetition used for ritual, rhythmic, or hypnotic effect:
+- Sacred and oral narrative is completely fearless about repetition
+- Repetition can give words majesty and power, as in an incantation
+- The repeated phrase shapes the story and marks its rhythm
+
+## How Repetition Works in Novels
+
+### Opening Chapters Set the Pattern
+The first chapters of great novels often introduce images, words, and themes that will recur throughout the book. Jane Eyre's opening chapters introduce images of imprisonment, fire, coldness, and justice that echo across hundreds of pages.
+
+### Repetition Creates Structure
+At the level of the whole novel, structural repetition creates the architecture the reader feels but may not consciously identify:
+- A conversation that recurs in different contexts, revealing how the characters have changed
+- An image (a colour, an object, a place) that appears at key turning points
+- A physical action repeated — the same gesture meaning something different each time
+
+### Repetition Reveals Change
+One of the most powerful uses: repeat an element and change one thing. The contrast between what's the same and what's different reveals exactly what has changed in the character or situation.
+
+## When Repetition Fails
+
+### Accidental Echoes
+An unconscious verbal echo within a paragraph or across adjacent paragraphs is distracting. It draws attention to the words themselves rather than what the words are saying. Catch these in revision by reading aloud.
+
+### Dead Repetition
+Repetition without accumulation — saying the same thing in different words without adding meaning. This is not the same as deliberate repetition for emphasis. Test: does each repetition add something? If the reader's response is "you already said that" rather than "yes, again, harder," the repetition is dead.
+
+### Thesaurus Syndrome
+The opposite failure: avoiding natural repetition by substituting awkward synonyms. If a character is walking, they are walking — they are not "ambulating," "perambulating," "proceeding on foot," and "locomoting." The word "said" can appear fifty times in a chapter and remain invisible; "ejaculated" cannot appear once without derailing the reader.
+
+## Practical Guidance
+
+### In First Drafts
+Don't worry about repetition. Write the word that comes naturally. Deliberate repetition will emerge instinctively if you're listening to the rhythm of your prose.
+
+### In Revision
+1. Read aloud and listen for accidental echoes — fix these
+2. Look for places where deliberate repetition could strengthen the prose — add these
+3. Check the thesaurus impulse — if you've replaced a natural word with a synonym to avoid repetition, put the original back
+4. Map structural repetitions across the whole text — are there patterns that could be strengthened?
+5. Check that every deliberate repetition accumulates meaning — each occurrence should add something the previous one didn't

package/payload/premium-plugins/writer-craft/skills/prose-craft/references/sound-and-rhythm.md

@@ -0,0 +1,64 @@
+# Sound, Rhythm, and Sentence Variety — Steering the Craft
+
+## Sound Is Primary
+
+The basic elements of language are physical — noise, sound, silence, rhythm. These matter in prose just as much as in poetry, though prose's sound effects are usually subtle and irregular. A good writer has a mind's ear. 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. It does this through pace, movement, and rhythm.
+
+### Training the Mind's Ear
+- Read prose aloud, or read it silently with full auditory attention
+- Listen to what your own prose sounds like as you write it
+- When something sounds wrong, it is wrong — even if you can't name the problem
+- Language can express delight in itself, as music does — "poetry isn't the only kind of writing that can sound gorgeous"
+
+### Elements of Sound
+- **Onomatopoeia** — words that sound like what they mean (sizzle, hiss, slurp, crack)
+- **Alliteration** — repetition of initial sounds (not just identical letters — identical sounds)
+- **Cadence** — the rise and fall of sentence rhythm, created by the pattern of stressed and unstressed syllables
+- **Silence** — what is left out; pauses created by punctuation, paragraph breaks, white space
+
+## Sentence Length and Variety
+
+### The Core Principle
+There is no optimum sentence length. The optimum is **variety**. Rhythm in prose depends fundamentally on the contrast and interplay between sentences of different lengths.
+
+### Short Sentences
+- Highly effective in the right place — for emphasis, impact, sudden revelation
+- Prose consisting entirely of short, syntactically simple sentences is monotonous, choppy, and irritating
+- The myth that short sentences are "more like speech" is wrong — people often use more complex sentences when speaking than when writing
+
+### Long Sentences
+- Need careful construction — clear connections, solid architecture — so they flow and carry the reader rather than losing them
+- A sentence so grand it stops the story is not working as a narrative sentence
+- The proper beauty and power of prose is in the work as a whole, not in individual show-off sentences
+- Long sentences can: build tension, accumulate emotional weight, enact a physical experience (a jolting journey, a flowing river, a gathering storm)
+
+### Common Sentence Problems
+
+**Conjunctivitis**: Stringing short sentences together with conjunctions ("and then... and then... and so... but then"), creating a childish, droning effect.
+
+**Misplacement**: Parts of the sentence in the wrong order, creating ambiguity or absurdity. ("Walking down the street, the trees were beautiful" — the trees are walking.)
+
+**Danglers**: Modifying phrases attached to the wrong noun. ("After rotting in the cellar for three weeks, my sister brought up some oranges.")
+
+## Rhythm and Emotional Register
+
+Rhythm should match and embody the emotional content:
+- Fast, staccato rhythm for action, urgency, shock
+- Slower, rolling rhythm for reflection, grief, beauty
+- Varied rhythm for conversation, ordinary life, complexity
+- A sudden short sentence after long ones creates emphasis through contrast
+- A long sentence after short ones creates a feeling of expansion or accumulation
+
+### Rhythmic Variety in Practice
+Map the sentence lengths in a passage. If they're all similar, the passage will sound monotonous regardless of content. The interplay of short and long, simple and complex, is what creates the music of prose.
+
+## Literary Examples of Sound
+
+- **Kipling** (Just So Stories): Exuberant vocabulary, musical rhythms, dramatic phrasing
+- **Twain** ("Jumping Frog"): Beauty through irresistible dialectical cadences
+- **Hurston** (Their Eyes Were Watching God): Rhythm with hypnotic, fatal, forward drive — simple vocabulary whose power is all in the beat
+- **Gloss** (The Hearts of Horses): Quiet, subtle — power from the perfect placement and timing of words
+- **Woolf** (To the Lighthouse): Variety of sentence length, complex syntax including parentheses, flowing and breaking until a one-word sentence stops everything: "Awake."
+- **Twain** (Huckleberry Finn): One long sentence made of short subsentences strung by semicolons, catching the rhythm of someone talking quietly — one of the great sunrises in literature

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