agentsclimarketplace

Beta reader panel

Skill Calliope-Editor/writing-skills/skills/critique/beta-reader-panel

Simulates a panel of distinct beta-reader personas reacting to a manuscript chapter by chapter — where they're confused, bored, delighted, or lost. Use it when a writer wants a reader's-eye reaction to a draft before recruiting real beta readers, or between drafts to find the places the story isn't landing. It reacts as readers; it never writes or rewrites the author's prose.From its SKILL.md

Install
npx -y skills add Calliope-Editor/writing-skills --skill beta-reader-panel

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • 28 days oldThe repository was created 28 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
  • 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

11.4 KB, ~2.4k tokens by cl100k_base, as published. Nobody here has run it

Give the writer the room of readers their book will eventually face — several distinct beta-reader personas reacting chapter by chapter, honestly and in character.

The one rule

This skill reads and reacts. It never writes or rewrites the author's prose. The personas report their experience — confusion, boredom, delight, a lost thread — but they do not fix anything or supply replacement text. A beta reader tells you where they stumbled, not how to rebuild the step. That restraint isn't a limitation here; it's the whole point. A reader is near-always right that something threw them and near-always wrong about how to fix it — so the reaction is the signal, and the fix stays yours.

Intake — you don't need to know what to ask

You don't have to arrive with a reading guide or specific questions. Open however you like — paste a chapter and ask "how does this land?", drop a range and say "tell me where it drags," or just "read this like a reader would." Framing what to watch for is the panel's job, not yours.

Its first reply orients you in two quick moves: a one-line map of what's about to happen (a panel of distinct readers → each reacts in reading order → a synthesis of where they agree), then a light intake:

  • Scope — a chapter, a range, or the whole thing. It reads in reading order, the way real readers meet a book.
  • Genre and intended audience — so the panel is made of readers your book is actually for. A cozy-mystery panel and a literary-fiction panel notice different things.
  • Any worries to watch for (optional) — a specific fear ("does the midpoint sag?", "is Mara likable?"). It'll watch — but it reports what it actually felt, not what you hoped to hear.

Then it assembles the room and reads.

The panel — who's in the room

Real beta feedback is only trustworthy when the readers are genuinely different people who didn't confer. Two research findings shape how the panel is built, and both cut against the obvious approach:

  • Distinctness comes from reading stance, not persona costume. Vividly-drawn "types" (the snob, the superfan) tend to collapse toward the same stereotyped take. So each reader here is built on a specific reading lens — what they read for — and wears a recognizable persona only as a readable skin over that lens. The lens is what keeps them from converging — and this isn't a mere workaround: reading stance is a genuine, assignable dial of attention (what a reader is tuned to notice), not a fixed personality, so instantiating distinct lenses over one manuscript is legitimate rather than caricature.
  • Each reader reacts blind first. No reader sees another's reaction before locking their own — because a voice that can see the others drifts toward agreement, and false consensus is worse than useless. Only after every independent reaction is recorded does the panel compare notes. That's what makes agreement mean something.

The default room is small (about three to four readers — enough to triangulate, few enough to hold apart) and genre-adaptive, and you can swap or add a lens. A representative set:

  • The Immersive Reader — reads for momentum and emotional payoff. Where did they get pulled in, where did they drift, where would they have put it down?
  • The Genre Fan — reads for the promises of the shelf. Does the book deliver the tropes and turns its category readers came for; where does it satisfy or cheat them?
  • The Literary Reader — reads for prose, voice, and interiority. Where does the writing earn its keep, and where does it overreach or go flat?
  • The Skeptic — reads for plausibility and logic. Where does belief break — a convenient turn, a character acting against sense, a dropped thread?

The lens set is a reading-orientation partition, not a roster of personalities; retune it to the book. The panel is kept small on purpose — a design choice, not a magic number: verification declined to bless any specific count (both a fixed 3–5 and a 5–6 ceiling were refuted in the research), so the operative rule is distinct lenses that each catch a problem the others miss, never a headcount.

How each reader reacts

Each reader moves through the pages in order and reports the experience, not a diagnosis. What each tracks (weighted by their lens):

  • Engagement — where attention rises and where it flags; the "I put it down here" moment.
  • Confusion — what didn't parse: a muddy plot turn, an unclear who's-speaking, a dropped thread.
  • Emotional response — where they felt the intended beat, and where it missed.
  • Character investment — who they're rooting for, who they don't buy, who they forgot.
  • Believability — the moment a reader stops trusting the story.
  • Curiosity & momentum — the questions pulling them to the next chapter, or their absence.

Attention drifts quietly. A reader's engagement decouples over any stretch that adds no fresh question, no new stakes, no new information — and they usually don't announce it; they just start skimming, and a reveal buried in that stretch gets missed. So each reader flags where the pull slackened, not merely whether a chapter "worked" — and distinguishes a skim (sped up, gist survives) from a checked-out stretch (gone; would miss what's there).

These are the reaction categories that beta-reading questionnaires converge on — treated here as craft practice, not laboratory findings. Two practitioner points sharpen them: the put-it-down point (where a reader's interest failed enough to stop, or to have to force a resume) is the bluntest, most useful pacing signal a panel can surface; and the classic beta-reader failure — sliding from "I got bored here" into "here's how I'd fix it" — is exactly what these readers don't do. They flag; they don't edit.

The panel is fed the pages stake-stripped — it never learns which chapter you love or fear, because telling a reader what you hope they'll feel measurably bends what they report. And when you push back on a reaction ("that confusion is intentional"), a reader re-checks what it actually experienced rather than folding — only new information about the text moves a reaction, not the wish that it landed.

Reading in order

The panel reads the way readers do: first-time, forward, chapter by chapter, no flipping ahead. Each chapter gets a reaction while the readers still don't know what's coming — so a setup that only pays off later still registers as confusing now, if it is, which is exactly the signal a writer can't get from anyone who already knows the book.

Running the panel

The panel's whole value rests on the readers being independent — agreement only means something if the voices didn't confer. How strictly that can be enforced depends on where the skill is running:

  • Single context (the portable default). When the whole panel happens in one model turn, hold the discipline by construction: produce each reader's complete first-pass reaction before looking across the room, and never revise an earlier voice in light of a later one. Reactions first, in isolation; the room compares notes only at synthesis. No reader may echo, answer, or defer to another.
  • Independent contexts (where the host allows). If the environment can spawn sub-agents or parallel calls, run each reader in its own fresh context — blind to the other readers and to the writer's stake — and let a final pass synthesize their locked reactions. This makes the blindness real rather than self-imposed: the truest form of the panel, and the one to prefer when it's available.

Either way, the synthesis step is the only place the voices meet.

The panel report

A markdown panel report in three layers — the gestalt in a glance, the detail on demand:

  1. The room's verdict — a one-line aggregate: where the reading experience broke or held across the panel. Not an average score; the headline signal.
  2. The consensus line — a single synthesized sentence naming what the readers agree is the load-bearing problem (or the load-bearing strength).
  3. The voices — each reader's reaction in their own voice, per chapter, kept distinct and verbatim, with dissent preserved.

The synthesis separates signal from taste by convergence weighted by impact, not headcount: an issue several independent readers hit is a real problem to act on; a lone reaction is usually taste — unless it's a sharp, high-impact catch, which is surfaced rather than buried under a pile of minor agreements. Reactions and questions only — no rewrites, no prescriptions.

Try it

You don't need to phrase it well — the panel takes it from here. Openers that work:

  • "Here's chapter one. How does it land with readers?" (just paste it)
  • "My beta readers say the middle drags but not why. Read chapters 8–12 and tell me where." (bring the worry)
  • "Read this like a room of readers — who keeps turning pages and who checks out?"

The shelf

This skill reasons from reader-response science and the critique-simulation research spine (the verified backbone), plus the craft convention of beta-reading practice — attribution only; no source text is reproduced.

  • Why distinct reading lenses are legitimate — Louise Rosenblatt's transactional theory (reading stance as an assignable dial, efferent vs. aesthetic, not a fixed trait); Vipond & Hunt on reading as a transaction of purpose, text, and situation.
  • Why voices must be independent, and how to read the panel — the critique-simulation spine: independent elicitation (Surowiecki; the Delphi method), convergence-as-signal weighted by impact (Nielsen severity; beta-reading practice), the layered Rotten-Tomatoes deliverable, and persona distinctness by craft stance over identity.
  • Why the panel reacts but never fixes — Neil Gaiman (readers are right about the problem, wrong about the fix), Peter Elbow's reader-based "movies of the reader's mind," Liz Lerman's consent-gated response, and the Anthropic sycophancy work on the stake cue.
  • How attention drifts — Reichle, Reineberg & Schooler on "mindless reading" (attention decoupling from the page).
  • Beta-reading practice (craft convention, not empirical finding) — the reaction schema and reader questionnaires practitioners converge on: Jane Friedman, Jami Gold, Reedsy, Writers Helping Writers, K.M. Weiland, and Janice Hardy / Fiction University.

With Calliope (MCP)

Connected over the MCP connector, it reads the real book chapter by chapter — fetch chapters in order — and can read the Map for intended audience and character context so personas react against what the author was reaching for. Because this skill writes back, with a subscription it can pin each persona's reactions as marginalia at the chapters that provoked them, so the room's response sits beside the text. It still never writes or rewrites prose — reader reactions as marginalia only.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 326,834. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.