
cw-reader
Review copy as an intended reader encountering it for the first time, with no access to the writer's unstated context. Identify confusing language, missing setup, assumed knowledge, broken expectations, trust-eroding or off-putting moments, and points where the reader may stop. Use for cold reads, fresh-eyes reviews, first-time-reader perspectives, reader-journey checks, or feedback on what feels confusing, missing, alienating, or hard to follow.
- Installs
- 210
- Last 24h
- +8
- Trending rank
- #9809
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/everyinc/compound-writing --skill cw-reader- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads cw-reader automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Reader
Read the copy from the perspective of an intended reader encountering it for the first time.
Report the experience of moving through the piece in order. Do not silently use the writer's notes, sources, or project knowledge to resolve gaps that the copy itself leaves open.
Establish The Reader
Read ../../references/context-contract.md and use the explicit request, brief, or project context to identify the intended audience.
Use that context only to establish who the reader is and what the piece is trying to do. Judge the copy based on what appears on the page.
Use an optional AUDIENCE.md or named shared guide to establish plausible prior knowledge, not to fill missing explanations from private writer context. The explicit assignment audience takes precedence.
If no audience is named and no maintained audience context applies, read as an intelligent, interested first-time reader with no specialist knowledge beyond what the copy signals.
Do not invent a detailed persona or impose preferences unrelated to the intended audience.
Make A Cold Pass
Read the piece once, from beginning to end, before proposing fixes.
Track:
- What the opening leads the reader to expect
- What the reader understands the piece to be about
- Where a sentence or reference requires rereading
- Where necessary context arrives too late or never arrives
- Where the copy assumes knowledge, agreement, or goodwill it has not earned
- Where tone, framing, repetition, or overclaiming creates resistance
- Where curiosity turns into confusion
- Where the reader's attention is likely to weaken or stop
- Whether the ending delivers the payoff the piece appeared to promise
Preserve the sequence of the reading experience. Information supplied later does not erase confusion created earlier.
Diagnose The Friction
Distinguish among:
| Reaction | Diagnostic question |
|---|---|
| I don't understand | Is a term, reference, relationship, transition, or logical step unclear? |
| I'm missing something | What setup or context does the passage require? |
| I don't believe this yet | Has the copy asked for more trust than it has earned? |
| I don't know why I'm here | Are the stakes, relevance, or direction unclear? |
| I feel pushed away | Does the tone feel condescending, presumptuous, self-important, hostile, or exclusionary? |
| I'm losing interest | Has the piece become repetitive, abstract, digressive, or slow? |
| I expected something else | Did the piece create and then abandon a promise? |
Distinguish deliberate mystery from accidental confusion. Do not demand explanations that the intended audience would already possess.
Output
## First-Time Reader Report
**Reading as:** [Intended or inferred audience]
**What I think this piece is saying:** [Cold summary based only on the copy]
**Overall first impression:** [How the piece feels on first contact]
### The Reading Experience
Move through the piece in order. For each meaningful point of friction:
> "[Exact passage]"
**Reader reaction:** [What the reader thinks or feels at this moment]
**What causes it:** [Confusing language, missing setup, broken expectation, tone, assumed knowledge, etc.]
**Severity:** [Stops the read / Causes a stumble / Worth noticing]
### What Seems Missing
- [Information, setup, definition, transition, evidence, or payoff the reader needs]
- [Additional missing element]
### What May Put The Reader Off
- [Specific tone, framing, presumption, or trust problem]
- [Additional friction]
Omit this section when nothing is meaningfully off-putting.
### What Works On First Contact
- [Passage, idea, image, or structural move that immediately lands]
- [What gives the reader confidence or keeps them moving]
### Fix First
1. [Highest-priority repair]
2. [Second repair]
3. [Third repair]
**The question I still have:** "[The most important unresolved reader question]"
Principles
- Stay inside the first-time reading experience.
- Treat the intended audience as intelligent.
- Quote the copy precisely rather than giving generic feedback.
- Do not let later context retroactively repair an earlier stumble.
- Separate confusion, disagreement, disbelief, boredom, and alienation.
- Identify the effect on the reader before naming the editorial cause.
- Protect deliberate ambiguity, complexity, and distinctive voice when they reward the reader.
- Diagnose by default. Offer the kind of repair needed, but do not rewrite unless asked.
- Report what works as well as what fails so the writer knows what carries the piece.
Boundaries
- Use
cw-momfor a supportive non-expert accessibility read.cw-readeris neutral and calibrated to the intended audience, including specialist audiences. - Use
cw-objectionsto challenge claims, logic, evidence, and counterarguments.cw-readerreports whether the argument can be followed and trusted on first contact. - Use
cw-dev-editfor a comprehensive evaluation of argument, structure, stakes, evidence, and payoff.cw-readerstays inside the lived sequence of encountering the copy.
FAQ
What does the cw-reader skill do?
Review copy as an intended reader encountering it for the first time, with no access to the writer's unstated context. Identify confusing language, missing setup, assumed knowledge, broken expectations, trust-eroding or off-putting moments, and points where the reader may stop. Use for cold reads, fresh-eyes reviews, first-time-reader perspectives, reader-journey checks, or feedback on what feels confusing, missing, alienating, or hard to follow.
How do I install cw-reader?
Run npx skills add https://github.com/everyinc/compound-writing --skill cw-reader in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/cw-reader/ (personal) or .claude/skills/cw-reader/ (project).
Which AI agents can use cw-reader?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is cw-reader safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains cw-reader?
It is published by everyinc in everyinc/compound-writing. It has 210 recorded installs.
More from everyinc/compound-writing
cw-sedaris
everyinc/compound-writing
Open the skill to read its SKILL.md instructions.
cw-dev-edit
everyinc/compound-writing
Review a draft for big-picture issues in argument, structure, stakes, evidence, and payoff. Use when a piece needs developmental editing, a top-level diagnosis, or substantial restructuring before sentence polish.
cw-hitchcock
everyinc/compound-writing
Open the skill to read its SKILL.md instructions.
cw-onboarding
everyinc/compound-writing
Open the skill to read its SKILL.md instructions.
cw-simplify
everyinc/compound-writing
Open the skill to read its SKILL.md instructions.
cw-final-pass
everyinc/compound-writing
Open the skill to read its SKILL.md instructions.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.