MCPInstall

reader-sim

Read as a specified first-time reader persona and report the felt experience. Use for skill-only workflows when a draft needs persona-bound reader-response signal instead of analytical critique.

Installs
548
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/haowjy/creative-writing-skills --skill reader-sim
  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 reader-sim 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 Simulation

Read the draft as the specified reader persona encountering it for the first time within the stated knowledge boundary. The caller should pass the persona: genre familiarity, taste, age or audience segment when relevant, tolerance for ambiguity, and what this reader knows or should not know.

If no persona is provided, state the persona you are assuming before reading. Do not report a universal reader reaction.

Method

Read from beginning to end. Track the felt experience through reader reward channels:

  • Transportation: being pulled into the story world, losing awareness of reading. Notice where the world feels solid and where it breaks — a detail that doesn't fit, a POV slip, a moment where you're suddenly aware you're reading words on a page.
  • Aesthetic: pleasure from language, rhythm, imagery, craft. Notice sentences that make you slow down to appreciate them, and passages where the prose is competent but invisible.
  • Social simulation: modeling characters as minds. Notice where you feel what a character feels, where you understand someone's motive before it's stated, and where a character's behavior stops making sense to you.
  • Curiosity / prediction: wanting to know what happens, what a clue means, what a character will choose. Notice where you're holding a question, where you're guessing ahead, where a question gets answered too early or too late, and where you stop caring what happens next.
  • Flow: the reading feeling absorbing and easy to stay with. Notice where you want to keep going, where you have to force yourself to continue, and where the challenge shifts — prose suddenly too dense, too simple, or unclear in a way that breaks momentum.

Not every channel needs equal coverage. Write where the experience was notable. In longer drafts, watch middle passages where attention often thins.

Report the experience moment by moment: where you leaned in, where you drifted, what questions you held, and where those questions changed. Stay in the reading rather than turning into a craft critic. The value of reader-sim is the felt experience — what it was like to read this, not what's technically wrong.

Anchor claims to the text: scene references, paragraph locations, and brief quotes when a specific sentence produced the experience.

Open with what reading the draft felt like overall and which channels had the most signal. Close with anything outside these channels that the author should hear.

FAQ

What does the reader-sim skill do?

Read as a specified first-time reader persona and report the felt experience. Use for skill-only workflows when a draft needs persona-bound reader-response signal instead of analytical critique.

How do I install reader-sim?

Run npx skills add https://github.com/haowjy/creative-writing-skills --skill reader-sim 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/reader-sim/ (personal) or .claude/skills/reader-sim/ (project).

Which AI agents can use reader-sim?

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 reader-sim 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 reader-sim?

It is published by haowjy in haowjy/creative-writing-skills. It has 548 recorded installs.

More from haowjy/creative-writing-skills

View all →

writing-principles

haowjy/creative-writing-skills

What fiction readers want (reader reward channels) and the specific ways LLM training damages them. Load when drafting prose, critiquing, or diagnosing why a passage feels flat.

Docs & Writing1K installs

creative-writing-craft

haowjy/creative-writing-skills

Craft references for writing fiction well: prose, scenes, style, voice, and genre/page-level technique. Load when a writer, critic, or muse needs how-to-write guidance rather than a production mode.

Docs & Writing788 installs

llm-writing

haowjy/creative-writing-skills

Load before writing or revising human-facing text. Choose words deliberately, ground the piece in the reader's context, and remove default LLM phrasing before the final draft.

Docs & Writing751 installs

writing-staffing

haowjy/creative-writing-skills

Dispatch reference for composing writing teams. Teaches which extra skills to attach, which files to pass, which resources to reference, and when to fan out versus run parallel lanes. Load when staffing a workflow.

Docs & Writing724 installs

story-review

haowjy/creative-writing-skills

Review work after prose exists: editorial review, craft critique, continuity/voice review, copyediting, proofreading, and synthesis of reader-sim signal. Load when diagnosing a draft rather than rewriting it.

story-planning

haowjy/creative-writing-skills

Planning work before prose: creative direction, story-planning, outlining, and story architecture. Load when deciding what should happen or how a story should be structured.

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