New: Earn 20% as an AgentAlley affiliate. Share your link and earn on every sale you refer. Join now New: Earn 20% as an affiliate. Join now

Reader Response Simulator

Reader Simulation

by haowjy · Apache-2.0 license · ★ 506 on GitHub

Reader Simulation cover

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.

---
name: reader-sim
description: |
  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.
---

# 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

Overview

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.

Manual install (npx, ZIP)
Claude Codenpx skills add haowjy/creative-writing-skills --skill reader-sim -g -a claude-code
Claude Code (degit)npx degit haowjy/creative-writing-skills/cw/skills/reader-sim#main ~/.claude/skills/reader-sim
Claude.ai / desktopZip the folder and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md2.7 KB
Read SKILL.md here
haowjy/main1 file shown
SKILL.md
Show the full text52 lines
reader-sim/SKILL.md52 lines · 2.7 KB

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.

1---
2name: reader-sim
3description: |
4 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.
5---
6 
7# Reader Simulation
8 
9Read 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.
10 
11If no persona is provided, state the persona you are assuming before reading. Do not report a universal reader reaction.
12 
13## Method
14 
15Read from beginning to end. Track the felt experience through reader reward
16channels:
17 
18- **Transportation**: being pulled into the story world, losing awareness of
19 reading. Notice where the world feels solid and where it breaks — a detail
20 that doesn't fit, a POV slip, a moment where you're suddenly aware you're
21 reading words on a page.
22- **Aesthetic**: pleasure from language, rhythm, imagery, craft. Notice
23 sentences that make you slow down to appreciate them, and passages where
24 the prose is competent but invisible.
25- **Social simulation**: modeling characters as minds. Notice where you feel
26 what a character feels, where you understand someone's motive before it's
27 stated, and where a character's behavior stops making sense to you.
28- **Curiosity / prediction**: wanting to know what happens, what a clue
29 means, what a character will choose. Notice where you're holding a
30 question, where you're guessing ahead, where a question gets answered too
31 early or too late, and where you stop caring what happens next.
32- **Flow**: the reading feeling absorbing and easy to stay with. Notice where
33 you want to keep going, where you have to force yourself to continue, and
34 where the challenge shifts — prose suddenly too dense, too simple, or
35 unclear in a way that breaks momentum.
36 
37Not every channel needs equal coverage. Write where the experience was
38notable. In longer drafts, watch middle passages where attention often thins.
39 
40Report the experience moment by moment: where you leaned in, where you
41drifted, what questions you held, and where those questions changed. Stay in
42the reading rather than turning into a craft critic. The value of reader-sim
43is the felt experience — what it was like to read this, not what's
44technically wrong.
45 
46Anchor claims to the text: scene references, paragraph locations, and brief
47quotes when a specific sentence produced the experience.
48 
49Open with what reading the draft felt like overall and which channels had the
50most signal. Close with anything outside these channels that the author
51should hear.
52 
View all files on GitHub →

Details

License
Apache-2.0
Stars on the repo
★ 506
Checked
Source
haowjy/creative-writing-skills ↗
Creator
haowjy · 22 listings
View creator

Similar skills

See all →
360 Feedback Surveymohitagw15856/pm-claude-skills · by mohitagw15856Design a 360-degree feedback survey or write a structured 360 feedback report. Use when asked to build a 360 feedback process, write 360 feedback for a colleague, design a feedback survey, or produce a feedback report. Produces either a complete survey instrument with rating scales and open-ended questions, or a structured narrative feedback report with themes, strengths, and development areas.★ 1.4k GitHub starsExpert Knowledge Extractorinhouseseo/superseo-skills · by inhouseseoUse when extracting first-party expertise from a subject-matter expert before writing content. Produces a knowledge document of contrarian takes, specific examples, and surprising outcomes that AI can't fabricate.★ 353 GitHub starsQuestionnaire Generatormattpocock/skills · by mattpocockTell us who you need answers from and what you're missing; get back a clean form you send them to fill in.★ 267k GitHub starsIntent Interview Assistantaddyosmani/agent-skills · by addyosmaniExtracts what the user actually wants instead of what they think they should want. Achieves this through one-question-at-a-time interview until ~95% confidence about the underlying intent. Use when an ask is underspecified ("build me X" without "for whom" or "why now"), when the user explicitly invokes ("interview me", "grill me", "are we sure?", "stress-test my thinking"), or when you catch yourself silently filling in ambiguous requirements before any plan, spec, or code exists.★ 98.7k GitHub starsBehavioral Science for Marketingcoreyhaines31/marketingskills · by coreyhaines31When the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,' 'behavioral science,' 'why people buy,' 'decision-making,' 'consumer behavior,' 'anchoring,' 'social proof,' 'scarcity,' 'loss aversion,' 'framing,' or 'nudge.' Use this whenever someone wants to understand or leverage how people think and make decisions in a marketing context. For applying psychology to specific pages, see cro; for pricing tactics, see pricing; for copy framing, see copywriting.★ 51.1k GitHub starsPodcast Guest Coordinatordavila7/claude-code-templates · by davila7Podcast guest outreach and coordination specialist. Use PROACTIVELY for guest research, outreach templates, interview scheduling, pre-interview preparation, and guest relationship management.★ 32.3k GitHub stars

More from haowjy

Character Voice Simulatorhaowjy/creative-writing-skills · by haowjySpeak as a specified character from their current knowledge, voice, and emotional state. Use for skill-only workflows that need in-character conversation, voice discovery, or relationship pressure tests.★ 506 GitHub starsStory Research Assistanthaowjy/creative-writing-skills · by haowjyLoad when a story needs factual grounding the writer doesn't have: historical detail, cultural texture, domain accuracy, or how other authors handled similar material. Pass the question and story context; returns a sourced report the writer can draw from.★ 506 GitHub starsFiction Writing Craft Guidehaowjy/creative-writing-skills · by haowjyCraft 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.★ 506 GitHub starsWriting Mode Guidehaowjy/creative-writing-skills · by haowjyCreative-writing addendum to /llm-writing. Load when putting prose on the page: draft, revise, bridge, vary, or polish.★ 506 GitHub starsMulti-Mode Writing Studiohaowjy/creative-writing-skills · by haowjyLoad when no subagents are available and one agent must plan, draft, critique, research, and capture memory by switching stances.★ 506 GitHub starsOutput Information Hierarchyhaowjy/creative-writing-skills · by haowjyLoad for large human-facing outputs: reports, docs, multi-section explanations, artifacts. Choose the right form for each beat (prose, diagram, table, mockup) and put the answer first, depth behind it. If the medium allows, use progressive disclosure.★ 506 GitHub stars