fatihguner/foreman/reader-psychology
Claude Code and agent skill by fatihguner/foreman
- community
Checking that the SKILL.md file is still in the repository.
Teaches the cognitive science behind how busy readers actually process written communications. Covers working memory limits, the F-pattern scanning behaviour, selective attention, and the four-stage triage process readers apply to every message. Use when diagnosing why communications fail to land, designing high-stakes messages for distracted audiences, auditing existing copy for cognitive overload, or training a team to write with the reader's brain in mind.
Install
npx vskill@latest install fatihguner/foreman/reader-psychologySKILL.md
Read runtime and advisory rules before applying this skill. Other Foreman layers and the catalog are in ../../content/, relative to this SKILL.md.
Reader Psychology
F-PATTERN. Eye-tracking research reveals that readers do not read -- they scan in an F shape, spending most attention on the first two lines and the left margin. Everything else is a gamble. Psychologist George Miller's landmark study established that human working memory holds approximately seven items, plus or minus two, at any given moment. Between that hard cognitive ceiling and the 121 emails the average manager receives daily, the arithmetic is unforgiving: every sentence a writer produces competes against a reader's finite neural budget. Understanding that budget -- its size, its depletion rate, its failure modes -- is the prerequisite for writing that actually gets through.
The Framework
The Busy Brain: Three Constraints
The limited capacity of the human attention system produces three consequences that shape every act of reading.
Constraint 1: We Cannot Process Everything in Front of Us
At any moment, the brain confronts more information than it can absorb. Its attention system responds by acting as a filter -- selecting what to notice and suppressing the rest. A 1999 Harvard study demonstrated this vividly: when participants were asked to count basketball passes in a video, nearly half failed to notice a person in a gorilla costume strolling through the scene. The brain's suppression of irrelevant stimuli is so aggressive that even conspicuous objects vanish when they fall outside the current focus. For writers, the implication is stark: information that is present in a message but not actively foregrounded may as well not exist.
Constraint 2: Focus Exhausts Quickly
Directing attention is effortful, and the resource depletes faster than most people assume. In a study by psychologist Brandon Schmeichel, participants who spent six minutes resisting the urge to look at flashing words on screen subsequently scored 20% lower on a graduate-level reading comprehension test. Six minutes of attentional control was enough to measurably impair later cognitive performance. Physical fatigue compounds the effect -- athletes under physical exhaustion show impaired attention and decision-making, and information scientist Gloria Mark found that workers need an average of 23 minutes to fully return to a task after a single interruption. One study estimated that minds wander a full third of the time while people attempt to read, with the rate climbing further when the material is complicated.
Constraint 3: Multitasking Fails
Strictly speaking, the brain cannot think about two tasks simultaneously. What people call "multitasking" is rapid task-switching, and it is cognitively expensive. A study at Butler University and Eli Lilly found that pharmacists asked to answer questions while filling prescriptions took longer and made substantially more errors. US government statistics attribute thousands of road deaths each year to texting while driving -- yet by some estimates, 22% of drivers report doing it daily. The Latin writer Publilius Syrus captured the principle in the first century BCE: "To do two things at once is to do neither." Modern survey data confirms that 63% of professionals report regularly working on two or three tasks simultaneously -- and modern research confirms they are worse at all of them when they do.
The Stroop effect offers a vivid demonstration. When participants are asked to name the formatting applied to a word (e.g., say "bold" when they see the word "italicise" printed in bold), performance collapses. The brain cannot suppress the automatic reading of the word while simultaneously identifying the formatting -- two trivially simple tasks that become agonising in combination. The relevance for writers: any message that requires the reader to hold one piece of information in mind while processing a second is exploiting a cognitive capacity that barely exists.
How Readers Triage: The Four-Stage Filter
Every time a reader encounters a written communication -- even a text message or a Slack notification -- they pass through four rapid, often unconscious decisions.
| Stage | Question the Reader Asks | What Determines the Answer | |
|---|---|---|---|
| 1. Whether to engage | "Is this worth my time?" | Sender recognition, subject line, apparent length. In surveys, working professionals estimate they delete roughly half their emails without reading them. | |
| 2. When to engage | "Now or later?" | Perceived effort. In one survey, 99% of professionals said they would respond first to the message that appeared easier. People prefer easy tasks now and defer hard tasks to "later" -- and "later" frequently means "never." | |
| 3. How to engage | "Read closely, skim, or scan?" | Expected utility per second. Nearly 40% of emails and 20% of text messages are skimmed. Readers maximise information extraction while minimising time spent. | |
| 4. Whether to respond | "Is the requested action worth the cost?" | Clarity of the request, ease of compliance, and perceived importance. Even willing readers fail to act when the steps are unclear or burdensome. |
The preference for easy, short messages is not laziness -- it is a hardwired bias toward present-moment gratification. MRI research shows that limbic reward regions activate when the brain considers desirable outcomes available now, but remain largely dormant for outcomes deferred to the future. A classic experiment found that most people prefer $100 today over $101 in a week, despite the latter representing a 68% annualised return. A survey of the book's own participants revealed that respondents would rather sit in traffic for 31 minutes a week from now than 30 minutes right now -- paying an extra minute of misery for the privilege of deferring. The same bias applies to reading: if a message looks like it will be an unpleasant slog, the reader will push it off until "later," which, for practical purposes, means never.
This temporal myopia shapes not just whether people read but what they read first. When presented with a mix of easy and hard tasks, people consistently tackle the easy ones first -- even when offered financial incentives to prioritise the hard ones. The implication for writers: your message is not competing solely against other messages. It is competing against every easier, more pleasant alternative in the reader's immediate environment.
How Readers Actually Read: Skimming, Scanning, and the F-Pattern
Eye-tracking studies reveal a consistent scanning pattern across web pages, emails, and documents. Readers fixate most heavily on the first two lines, then scan down the left margin, occasionally darting rightward -- forming the shape of the letter F. Anchor points that attract fixation include headings, first sentences of paragraphs, visually contrasting elements (bold text, bullet points), and images. Text that falls outside these anchor points is routinely skipped.
Psychologists Keith Rayner and Monica Castelhano mapped the difference between close reading and skimming: during close reading, the eyes move word by word in sequence; during skimming, fixations drop sharply and the eyes jump across entire lines. Since busy readers default to skimming, any information not positioned at a natural anchor point is statistically unlikely to be absorbed.
Scanning is the companion strategy to skimming. Where skimming moves linearly but fast, scanning involves jumping between sections of a text, guided by selective attention and rules of thumb about where valuable information is most likely to reside. Readers often expect the first sentence of a paragraph to orient them to the rest of it. They spend more time on those opening sentences and use them to decide whether to read, skim, or skip what follows. Headings serve the same function at a higher structural level: readers use them as a table of contents for the document, zooming into sections that seem relevant and bypassing the rest entirely.
The combined effect is sobering. In surveys conducted by the researchers, participants reported skimming nearly 40% of their emails and 20% of their text messages. These are not long-form documents -- they are the shortest, most urgent forms of written communication available. If readers skim a two-paragraph email, the probability that they will closely read a five-page memo is negligible without deliberate navigational architecture.
A Carnegie Mellon study found that being interrupted by a phone call while taking a reading test decreased performance by 20%. The modern workplace is essentially a continuous interruption environment. The effective writer designs for this reality rather than against it -- placing critical information at the anchor points where even a scanning, distracted, cognitively depleted reader will land.
The Distracted Driver Analogy
The book's authors draw a useful parallel between busy reading and distracted driving. Most adults are experienced drivers and experienced phone-talkers -- both tasks are individually routine. Yet psychologists have suggested that talking on the phone while driving has as bad an effect on performance as being legally drunk. The explanation returns to the attention system: even two well-practised tasks compete for the same finite cognitive bandwidth when performed simultaneously. Reading a work email while mentally preparing for a meeting, while a Slack notification pulses in the peripheral vision, creates an analogous collision. The reader is not stupid or careless. The reader is a cognitive system operating at capacity, and the writer who fails to account for that capacity is the one whose message gets lost.
The Writer's Blind Spot
Writers systematically overestimate how much of their message readers will consume. This is a variant of the "curse of knowledge" -- having written every word, the writer assumes the reader will encounter every word. The data says otherwise. Readers skip paragraphs, jump backward to find missed details, and abandon messages mid-sentence when the expected value of the next second of reading drops below the value of doing something else.
A Pew Research Center survey found that 60% of US adults -- and 74% of parents -- report feeling too busy to enjoy life at least some of the time. The writers' own surveys corroborate the figure: 60% of respondents said they often do not have enough time to get everything done in a typical month. Against that backdrop of chronic time scarcity, the writer's job is not to produce comprehensive text but to survive a brutal triage process. The writing that gets through is the writing that respects the reader's constraints -- not the writing that tests them.
Prompts
Prompt 1 -- Cognitive Load Audit:
Analyse the following message as though you are a busy reader with seven-plus-or-minus-two working memory slots and a strong bias toward skimming. Identify: (a) where the reader's F-pattern scan would likely fixate, (b) what information would be missed during a five-second skim, and (c) which elements create unnecessary cognitive load. Then suggest specific revisions. Message: [paste text]
Prompt 2 -- Triage Simulation:
Imagine you are a [describe recipient: e.g., Series A investor reviewing 40 pitch emails per day]. Walk through the four-stage reader triage for the following message: (1) Would you engage? (2) Would you engage now or later? (3) Would you skim or read closely? (4) Would you respond? At each stage, explain what would tip the decision, and flag where the message fails. Message: [paste text]
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingplugins/foreman/skills/reader-psychology/SKILL.md
Popularity
- Repository stars
- 13
- Repository forks
- 1
- Repository npm downloads, 7 days
- 7
- 7-day trend score
- 23
Stars and forks are for the whole GitHub repository, not this skill alone. Downloads are for the repository's npm package. Refreshed 28 Apr 2026, 6 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/fatihguner/foreman/reader-psychology)