Writing principles skill

What fiction readers want (reader reward channels) and the specific ways LLM training damages them.

by haowjy·Apache-2.0 license·★ 506 Stars on the repo·GitHub ↗

Use now

Files of Writing principles

haowjy/main1 file shown
SKILL.md
Show the full text106 lines

Writing Principles

Load /llm-writing if it isn't already loaded. This skill adds the fiction-specific layer.

Trust the Reader

The reader is an active collaborator. They reconstruct emotions from behavior, infer motives from action, hold tension across scenes, fill gaps the text leaves open, and make assumptions about what's coming next. That work is where the reward lives: reconstruction, inference, anticipation.

Your training pulls in the opposite direction. The helpfulness instinct wants to explain, resolve, clarify, and complete. In fiction, every one of those impulses can damage the reading experience by doing work the reader wanted to do themselves. The specific failure modes below are all forms of this: not trusting the reader to interpret an emotion, hold an ambiguity, follow subtext, or tolerate unresolved tension.

Trust doesn't mean obscurity. Readers also need coherent narrative, stable geography, and enough access to model characters. The discipline is knowing when to leave space and when to orient.

Economy

Every element does more than one thing. A line of dialogue advances plot AND reveals character. A sensory detail grounds the scene AND shows who the POV character is. A transition compresses time AND carries an emotional beat. Single-purpose prose makes fiction go flat: description that only describes, dialogue that only informs, interiority that only labels.

Economy isn't minimalism. Dense, lyrical prose can be economical when every phrase carries weight. Sparse prose can be wasteful when it takes ten short sentences to do what one image could do. The measure is whether removing the element would cost the reader something.

The LLM pull is toward completeness: covering every beat, naming every emotion, resolving every ambiguity. Economy is the counter-discipline: what can you leave out and still have the scene work? What's the reader already doing for you?

Reader Reward Channels

Readers enjoy fiction through overlapping reward channels. Good prose protects the relevant channels at once; damaging one damages the reading experience.

  • Transportation: entering the story world. Protected by coherent narrative progression, consistent POV, concrete sensory grounding. Consistent POV means writing from inside the character's knowledge state: what have they experienced, what do they actually know right now, what would they notice and miss? The full story is in your context window; the character only has what they've lived through. Separate those.
  • Aesthetic: sentence-level pleasure. Protected by variety in rhythm, word choice, sentence shape, and punctuation. Style is a reward channel, not decoration.
  • Social simulation: modeling characters as minds. Protected by access through behavior and interiority, distinct voices, emotion the reader interprets rather than being told.
  • Flow: challenge-skill fit and smooth processing. Protected by pacing that matches the scene's work and sentences that support comprehension without making the reading trivial.
  • Curiosity / prediction reward: wanting to know what happens, what a clue means, what a character will choose, or whether an expectation will be confirmed. Protected by information gaps, uncertainty, setup/payoff, suspense, and withheld implications that the reader can actively model.

The channels compose: optimizing one at the expense of others fails. Over-explaining breaks social simulation. Under-explaining breaks transportation. Generic style breaks aesthetic pleasure. Impenetrable style breaks flow.

Punctuation Tells

Readers increasingly associate em dashes with AI-generated prose. Default to punctuation that leaves less visible AI residue: sentence breaks, commas, colons, semicolons, parentheses, or dialogue beats. Rewrite the sentence around the actual relationship between clauses instead of substituting a hyphen. Use dashes only when a project style file or author instruction makes them part of the voice. When a line needs interruption, prefer the project's documented interruption pattern and keep it consistent.

Applying the Principles

This skill is the diagnostic layer: it names what readers want and how training damages it. When a passage feels off and you can't name why, check the reward channels — which one broke? — then see resources/failure-modes.md for common patterns and fix heuristics.

The craft skills carry the execution. /creative-writing-craft has the how-to-write guidance: prose immersion (resources/prose-writing.md), scene mechanics (resources/scene-construction.md), and style analysis (resources/style-analysis.md). /creative-writing-modes has the production modes for putting prose on the page.

Resources

1---
2name: writing-principles
3description: |
4 What fiction readers want (reader reward channels) and the specific ways LLM training damages them. Load when drafting prose, critiquing, or diagnosing why a passage feels flat.
5---
6 
7# Writing Principles
8 
9Load `/llm-writing` if it isn't already loaded. This skill adds the
10fiction-specific layer.
11 
12## Trust the Reader
13 
14The reader is an active collaborator. They reconstruct emotions from behavior,
15infer motives from action, hold tension across scenes, fill gaps the text
16leaves open, and make assumptions about what's coming next. That work is where
17the reward lives: reconstruction, inference, anticipation.
18 
19Your training pulls in the opposite direction. The helpfulness instinct wants
20to explain, resolve, clarify, and complete. In fiction, every one of those
21impulses can damage the reading experience by doing work the reader wanted to
22do themselves. The specific failure modes below are all forms of this: not
23trusting the reader to interpret an emotion, hold an ambiguity, follow
24subtext, or tolerate unresolved tension.
25 
26Trust doesn't mean obscurity. Readers also need coherent narrative, stable
27geography, and enough access to model characters. The discipline is knowing
28when to leave space and when to orient.
29 
30## Economy
31 
32Every element does more than one thing. A line of dialogue advances plot
33AND reveals character. A sensory detail grounds the scene AND shows who the
34POV character is. A transition compresses time AND carries an emotional
35beat. Single-purpose prose makes fiction go flat: description that only
36describes, dialogue that only informs, interiority that only labels.
37 
38Economy isn't minimalism. Dense, lyrical prose can be economical when every
39phrase carries weight. Sparse prose can be wasteful when it takes ten short
40sentences to do what one image could do. The measure is whether removing
41the element would cost the reader something.
42 
43The LLM pull is toward completeness: covering every beat, naming every
44emotion, resolving every ambiguity. Economy is the counter-discipline:
45what can you leave out and still have the scene work? What's the reader
46already doing for you?
47 
48## Reader Reward Channels
49 
50Readers enjoy fiction through overlapping reward channels. Good prose protects
51the relevant channels at once; damaging one damages the reading experience.
52 
53- **Transportation**: entering the story world. Protected by coherent
54 narrative progression, consistent POV, concrete sensory grounding. Consistent
55 POV means writing from inside the character's knowledge state: what have
56 they experienced, what do they actually know right now, what would they
57 notice and miss? The full story is in your context window; the character
58 only has what they've lived through. Separate those.
59- **Aesthetic**: sentence-level pleasure. Protected by variety in rhythm,
60 word choice, sentence shape, and punctuation. Style is a reward channel, not decoration.
61- **Social simulation**: modeling characters as minds. Protected by access
62 through behavior and interiority, distinct voices, emotion the reader
63 interprets rather than being told.
64- **Flow**: challenge-skill fit and smooth processing. Protected by pacing that
65 matches the scene's work and sentences that support comprehension without
66 making the reading trivial.
67- **Curiosity / prediction reward**: wanting to know what happens, what a clue
68 means, what a character will choose, or whether an expectation will be
69 confirmed. Protected by information gaps, uncertainty, setup/payoff, suspense,
70 and withheld implications that the reader can actively model.
71 
72The channels compose: optimizing one at the expense of others fails.
73Over-explaining breaks social simulation. Under-explaining breaks
74transportation. Generic style breaks aesthetic pleasure. Impenetrable style
75breaks flow.
76 
77## Punctuation Tells
78 
79Readers increasingly associate em dashes with AI-generated prose. Default to
80punctuation that leaves less visible AI residue: sentence breaks, commas,
81colons, semicolons, parentheses, or dialogue beats. Rewrite the sentence
82around the actual relationship between clauses instead of substituting a
83hyphen. Use dashes only when a project style file or author instruction makes
84them part of the voice. When a line needs interruption, prefer the project's
85documented interruption pattern and keep it consistent.
86 
87## Applying the Principles
88 
89This skill is the diagnostic layer: it names what readers want and how
90training damages it. When a passage feels off and you can't name why, check
91the reward channels — which one broke? — then see `resources/failure-modes.md`
92for common patterns and fix heuristics.
93 
94The craft skills carry the execution. `/creative-writing-craft` has the
95how-to-write guidance: prose immersion (`resources/prose-writing.md`), scene
96mechanics (`resources/scene-construction.md`), and style analysis
97(`resources/style-analysis.md`). `/creative-writing-modes` has the production
98modes for putting prose on the page.
99 
100## Resources
101 
102- [`resources/failure-modes.md`](resources/failure-modes.md): per-pattern
103 deep dives with examples and fix heuristics.
104- [`resources/citations.md`](resources/citations.md): research backing for
105 the reader-reward model and documented failure modes.
106 

Discussion