MCPInstall

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
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads cw-reader automatically when relevant.

  3. 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:

ReactionDiagnostic question
I don't understandIs a term, reference, relationship, transition, or logical step unclear?
I'm missing somethingWhat setup or context does the passage require?
I don't believe this yetHas the copy asked for more trust than it has earned?
I don't know why I'm hereAre the stakes, relevance, or direction unclear?
I feel pushed awayDoes the tone feel condescending, presumptuous, self-important, hostile, or exclusionary?
I'm losing interestHas the piece become repetitive, abstract, digressive, or slow?
I expected something elseDid 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-mom for a supportive non-expert accessibility read. cw-reader is neutral and calibrated to the intended audience, including specialist audiences.
  • Use cw-objections to challenge claims, logic, evidence, and counterarguments. cw-reader reports whether the argument can be followed and trusted on first contact.
  • Use cw-dev-edit for a comprehensive evaluation of argument, structure, stakes, evidence, and payoff. cw-reader stays 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

View all →

cw-sedaris

everyinc/compound-writing

Open the skill to read its SKILL.md instructions.

Docs & Writing216 installs

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.

Docs & Writing212 installs

cw-onboarding

everyinc/compound-writing

Open the skill to read its SKILL.md instructions.

Docs & Writing210 installs

cw-simplify

everyinc/compound-writing

Open the skill to read its SKILL.md instructions.

Docs & Writing210 installs

cw-final-pass

everyinc/compound-writing

Open the skill to read its SKILL.md instructions.

Docs & Writing210 installs

Popular docs & writing skills

View category →

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.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs