Recently Written · git

ai-config

One canonical AI agent config (rules, skills, MCP servers) rendered into Claude Code, Codex, Copilot CLI and Antigravity by acsync

git clone https://github.com/equwal/ai-config

Log | Files | Refs


skills/impactful-writing/references/clarity-science.md (8240 bytes)

1 # The Science of Writing Clarity
2 
3 Research-backed principles for maximum comprehension and readability.
4 
5 ## Contents
6 - Sentence Length Research
7 - Readability Metrics
8 - Cognitive Load Theory
9 - Plain Language Studies
10 - Active vs Passive Voice
11 - Word Complexity Research
12 
13 ## Sentence Length Research
14 
15 ### American Press Institute Study
16 
17 Comprehension rates by sentence length:
18 - **8 words or less**: Very easy (near 100% comprehension)
19 - **14 words**: 90%+ comprehension (optimal)
20 - **17 words**: Standard difficulty
21 - **21 words**: Fairly difficult
22 - **25 words**: Difficult (comprehension drops significantly)
23 - **43 words**: Less than 10% comprehension
24 
25 ### Screen Reader Accessibility Study (2020)
26 
27 21 blind participants tested sentence lengths with screen readers:
28 - **16-20 words**: Highest comprehension, lowest cognitive workload
29 - **Over 25 words**: Significant comprehension impairment
30 
31 ### Practical Guidelines
32 
33 **Target Averages:**
34 - General audience: 15-20 words
35 - Professional audience: 18-22 words
36 - Technical content: 20-25 words maximum
37 
38 **Variation is key**: Mix short (5-10), medium (15-20), and occasional longer sentences (25-30) for rhythm.
39 
40 ## Readability Metrics
41 
42 ### Flesch Reading Ease (FRE)
43 
44 Scale: 0-100 (higher = easier)
45 
46 | Score | Reading Level | Example |
47 |-------|--------------|---------|
48 | 90-100 | 5th grade | Very easy, understood by 11-year-old |
49 | 80-90 | 6th grade | Easy, conversational |
50 | 70-80 | 7th grade | Fairly easy |
51 | 60-70 | 8th-9th grade | Standard (optimal for most content) |
52 | 50-60 | 10th-12th grade | Fairly difficult |
53 | 30-50 | College | Difficult |
54 | 0-30 | College graduate | Very difficult |
55 
56 **Formula factors:**
57 - Average sentence length (words per sentence)
58 - Average syllables per word
59 
60 ### Flesch-Kincaid Grade Level
61 
62 Estimates US grade level required to understand text.
63 
64 **Targets by audience:**
65 - General public: 6th-8th grade
66 - Business communication: 8th-10th grade
67 - Technical professional: 10th-12th grade
68 - Academic: 12th+ grade
69 
70 ### Validation
71 
72 70+ years of research confirms these formulas work because:
73 - Syllable complexity correlates with word familiarity
74 - Sentence length correlates with cognitive load
75 - Both are measurable and actionable
76 
77 ## Cognitive Load Theory
78 
79 ### Core Principles (John Sweller, 1980s)
80 
81 Three types of cognitive load:
82 
83 1. **Intrinsic load**: Inherent complexity of the content (unavoidable)
84 2. **Extraneous load**: Mental effort from poor presentation (reducible)
85 3. **Germane load**: Productive effort building understanding (desirable)
86 
87 **Goal**: Minimize extraneous load to maximize comprehension.
88 
89 ### Working Memory Constraints
90 
91 George Miller's research (1956):
92 - Working memory holds 5-9 "chunks" of information
93 - Each clause or phrase competes for limited slots
94 - Complex sentences overload working memory
95 
96 **Practical implications:**
97 - One idea per sentence
98 - Chunk related information together
99 - Use headings to create mental categories
100 
101 ### Application to Writing
102 
103 **High extraneous load (avoid):**
104 - Complex sentence structures
105 - Jargon requiring mental translation
106 - Dense paragraphs without visual breaks
107 - Passive voice requiring agent identification
108 
109 **Low extraneous load (prefer):**
110 - Simple subject-verb-object structure
111 - Familiar vocabulary
112 - Visual hierarchy with headings and lists
113 - Active voice with clear actors
114 
115 ## Plain Language Studies
116 
117 ### Joseph Kimble's Research (50+ studies, 18 on legal documents)
118 
119 **Study 1: Judicial Opinions (251 lawyers)**
120 - 61% preferred plain language versions
121 - Average sentence reduction: 25 → 19 words (24%)
122 - Rating improvement: 6/10 → 7/10
123 
124 **Study 2: Lawsuit Papers (292 judges)**
125 - 66% preferred plain English
126 - 58% preferred informal plain English
127 - Page reduction: 3.25 → 2.5 pages (23%)
128 - Sentence reduction: 25.2 → 17.8 words (29%)
129 
130 **Study 3: Court Forms (controlled experiment, 60 participants)**
131 - Plain language proof of service: 81% vs 61% accuracy (+33%)
132 - Plain language subpoena: 95% vs 65% accuracy (+46%)
133 - Document length reduction: ~40%
134 
135 **Study 4: FCC Marine Radio Rules (Government regulation)**
136 - Correct answers: 10.66/20 → 16.85/20 (+58%)
137 - Response time: 2.97 → 1.62 minutes (-45%)
138 - Difficulty rating: 4.59/5 → 1.88/5 (-59%)
139 
140 ### Key Finding
141 
142 Plain language consistently outperforms complex prose across all reader types—including lawyers, judges, and specialists who work with complex language daily.
143 
144 ## Active vs Passive Voice
145 
146 ### Experimental Evidence
147 
148 Systematic review (2024) analyzing 9 studies:
149 
150 **Consistent findings:**
151 - Active voice = reduced readability scores (easier)
152 - Active voice = faster processing (15-20% improvement)
153 - Active voice = higher comprehension scores
154 - Active voice = fewer grammatical errors by readers
155 - Active voice = rated as more coherent
156 
157 ### Cognitive Explanation
158 
159 Active voice matches natural language processing:
160 - Brain expects: subject → verb → object
161 - Passive requires mental reordering to identify agent
162 - Additional transformation step consumes working memory
163 
164 ### When Passive is Acceptable
165 
166 Use passive voice only when:
167 - Actor is unknown: "The window was broken"
168 - Actor is irrelevant: "The experiment was conducted"
169 - Object emphasis needed: "The proposal was rejected"
170 - Hedging is appropriate: "Mistakes were made"
171 
172 **Default to active** in all other cases.
173 
174 ### Conversion Examples
175 
176 | Passive | Active |
177 |---------|--------|
178 | The report was written by the team | The team wrote the report |
179 | Errors were found in the code | We found errors in the code |
180 | The meeting was scheduled for 3pm | I scheduled the meeting for 3pm |
181 | A decision was made to proceed | The board decided to proceed |
182 
183 ## Word Complexity Research
184 
185 ### Ohio State Jargon Study (2019, N=650)
186 
187 **Key finding**: Jargon reduced processing fluency by 76% even when definitions were provided.
188 
189 **Effects of jargon:**
190 - Greater resistance to persuasion
191 - Increased risk perceptions
192 - Lower support for proposals
193 - Effect persisted across multiple topics
194 
195 **Mechanism**: Jargon creates disfluency (difficult processing experience). Brain misattributes difficulty from jargon to the content itself, triggering skepticism.
196 
197 ### Syllable Reduction Impact
198 
199 Each syllable reduction improves readability scores:
200 
201 | Complex | Simple | Syllable Reduction |
202 |---------|--------|-------------------|
203 | utilize | use | 3 → 1 |
204 | commence | start | 2 → 1 |
205 | terminate | end | 3 → 1 |
206 | demonstrate | show | 3 → 1 |
207 | facilitate | help | 4 → 1 |
208 | subsequent | later | 3 → 2 |
209 | approximately | about | 5 → 2 |
210 | endeavor | try | 3 → 1 |
211 
212 ### Compound Effect
213 
214 Small edits compound across documents:
215 - 8,000-word document
216 - Replace 50 complex words
217 - Reduce 100 syllables
218 - Improve readability by 1-2 grade levels
219 - Increase comprehension by 10-20%
220 
221 ## Line Length Research
222 
223 ### Optimal Character Count
224 
225 **Desktop**: 50-75 characters per line (66 optimal)
226 **Mobile**: 30-50 characters per line
227 **WCAG Standard**: Maximum 80 characters
228 
229 ### Eye-Tracking Evidence (Baymard Institute)
230 
231 **Too long (100+ characters):**
232 - Hard to focus on text
233 - Difficult to find next line
234 - Eye fatigue increases 43%
235 - Comprehension drops 20%
236 
237 **Too short (<40 characters):**
238 - Breaks reading rhythm
239 - Causes premature line jumps
240 - Increases cognitive load
241 
242 **Optimal range (50-75 characters):**
243 - Natural eye movement
244 - Subconscious energized at each line start
245 - 28% improvement in reading speed
246 
247 ## Practical Application
248 
249 ### Before Writing
250 
251 1. Define target audience reading level
252 2. Set readability goal (FRE 60-70 for general)
253 3. Plan average sentence length (15-20 words)
254 
255 ### During Writing
256 
257 1. Write in active voice by default
258 2. Use familiar words over jargon
259 3. Limit sentences to one main idea
260 4. Break complex ideas into multiple sentences
261 
262 ### After Writing
263 
264 1. Run readability analysis
265 2. Identify sentences over 25 words → split
266 3. Find passive constructions → convert
267 4. Replace complex words → simplify
268 5. Re-check readability score
269 
270 ### Validation Metrics
271 
272 Your content is optimized when:
273 - Average sentence length: 15-20 words
274 - Maximum sentence length: 25-30 words
275 - Passive voice: <10% of sentences
276 - Flesch Reading Ease: 60-70 (adjust for audience)
277 - Flesch-Kincaid Grade: 8-9 (adjust for audience)