Skip to content
Back to search

write-like-a-reader

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/educatorsrlearners--write-like-a-reader-skill/badge.svg)](/listings/educatorsrlearners--write-like-a-reader-skill)

HTML

<a href="/listings/educatorsrlearners--write-like-a-reader-skill"><img src="/api/listings/educatorsrlearners--write-like-a-reader-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Plugin marketplace:**

/plugin marketplace add educatorsRlearners/write-like-a-reader-skill
/plugin install write-like-a-reader@write-like-a-reader

**Script:** run `./install.sh` to copy the skill to `~/.claude/skills/`. Run `./install.sh --project` to copy it to `./.claude/skills/` instead. Running it twice leaves one clean copy.

**Manual:**

cp -R skills/write-like-a-reader ~/.claude/skills/

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines
  1. {
  2. "name": "write-like-a-reader",
  3. "owner": {
  4. "name": "Evan Simpson",
  5. "url": "https://github.com/educatorsRlearners"
  6. },
  7. "plugins": [
  8. {
  9. "name": "write-like-a-reader",
  10. "source": "./",
  11. "description": "Claude reads its own expository prose as the reader would, and closes the gaps before delivering the text.",
  12. "version": "0.1.2"
  13. }
  14. ]
  15. }
README.md · README · 64 lines
  1. # Write Like a Reader
  2. A Claude Code skill that makes Claude read its own prose as the reader would, and close the gaps, before it delivers the text.
  3. ## What it does
  4. When Claude writes or substantially revises expository prose, it reads the draft one sentence at a time. After each sentence it asks what the reader would now want to know. Where the next sentence does not answer, Claude adds the missing reason or example, moves the answer closer, restructures, or cuts the claim. The review is silent: you see only the improved text.
  5. ## Install
  6. **Plugin marketplace:**
  7. ```
  8. /plugin marketplace add educatorsRlearners/write-like-a-reader-skill
  9. /plugin install write-like-a-reader@write-like-a-reader
  10. ```
  11. **Script:** run `./install.sh` to copy the skill to `~/.claude/skills/`. Run `./install.sh --project` to copy it to `./.claude/skills/` instead. Running it twice leaves one clean copy.
  12. **Manual:**
  13. ```
  14. cp -R skills/write-like-a-reader ~/.claude/skills/
  15. ```
  16. ## How it triggers
  17. Ask Claude for any longer piece of explanation, argument, or instruction:
  18. - "Write a blog post about why small teams should write design docs."
  19. - "Draft a proposal for moving our builds to a remote cache."
  20. - "Write a 600-word guide to setting up the staging environment."
  21. - "Tighten this draft so a reader isn't left with questions."
  22. - "Write a README for this project."
  23. The skill applies to any expository text of more than a couple of paragraphs, whatever the file format.
  24. ## How it works
  25. 1. Name the reader and what they need from the text.
  26. 2. Draft as usual.
  27. 3. Read the draft one sentence at a time. After each, list the questions the reader would now ask.
  28. 4. Check the next sentence only. If it answers, drop the question. Otherwise it is a gap.
  29. 5. Close each gap that matters, by the lightest fix.
  30. 6. Re-read the changed passages. Stop after two passes.
  31. 7. Deliver the text.
  32. ## What it does not do
  33. - It does not show questions, notes, or reports.
  34. - It does not touch code, configuration, commit messages, short replies, or creative writing.
  35. - It does not check grammar or spelling as a separate pass.
  36. - It does not invent facts. When a gap needs a fact Claude cannot find, Claude asks one plain question or cuts the claim.
  37. - It has no options.
  38. ## Credits
  39. - The classroom exercise: [Learning to Write Like a Reader](https://teachinglearninglearningteaching.wordpress.com/2015/01/26/learning-to-write-like-a-reader-teaching-students-how-to-edit-and-do-peer-review/).
  40. - The student-facing demo app: [write-like-a-reader](https://github.com/educatorsRlearners/write-like-a-reader). In the app, a second model checks the answers and the student closes the gaps. In this skill, Claude does both.
  41. - Author: Evan Simpson ([educatorsRlearners](https://github.com/educatorsRlearners)).
  42. ## License
  43. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.