AGENT SKILL

beta-reader-feedback

Plan beta reading rounds for practical nonfiction and turn reader comments, abandonment, confusion, skepticism, and negative feedback into manuscript revisions. Use when recruiting beta readers, preparing reader instructions, synthesizing feedback, deciding whether a book is ready, or improving a draft from real reader data.

License 许可
MIT
最近更新
2026-11-14
Stars
★ 1.6k
Forks
490

01 前言 Front Matter

name
beta-reader-feedback
license
MIT
metadata
{ "tags": "writing,books,nonfiction,beta-readers,feedback", "version": "0.1.0", "category": "Writing", "displayName": "Beta Reader Feedback" }
description
Plan beta reading rounds for practical nonfiction and turn reader comments, abandonment, confusion, skepticism, and negative feedback into manuscript revisions. Use when recruiting beta readers, preparing reader instructions, synthesizing feedback, deciding whether a book is ready, or improving a draft from real reader data.
compatibility
Codex, Claude Code, and other Agent Skills-compatible clients.

02 资源文件 6

03 SKILL.md 正文

Beta Reader Feedback

Core Lens

Beta reading is product testing for a useful nonfiction manuscript. The goal is not praise, proofreading, or opinion collection. The goal is to discover whether readers want the promise, receive the value, stay engaged, and know what to do next.

Use this skill to:

  • Plan beta reader rounds.
  • Recruit the right readers.
  • Write reader instructions.
  • Classify and synthesize comments.
  • Detect hidden boredom from abandonment.
  • Decide what to revise next.
  • Decide when the manuscript is ready for polishing.

Reference Routing

Need Read
Core beta-reading model and terminology references/core/knowledge.md
Operating rules and decision criteria references/core/rules.md
Example instructions, feedback classes, and synthesis patterns references/core/examples.md
Quick checklist for setup and review references/core/checklist.md
Run a beta iteration workflows/run-beta-iteration.md
Synthesize comments into revision decisions workflows/synthesize-feedback.md

Workflow

1. Confirm Beta-Readiness

Start beta reading after the draft is coherent enough for motivated readers, but before it has been polished so heavily that major changes feel costly.

If the draft is still a vague TOC, use book-toc-lab. If it needs structural pacing work first, use reader-experience-edit.

2. Choose The Reader Batch

For each iteration, define:

  • Target reader profile.
  • Desired number of deeply engaged readers.
  • Invitation list, usually larger than the desired reader count.
  • Any influential readers to save for a later, stronger draft.

3. Prepare The Feedback Surface

Use a tool that supports live comments and engagement visibility.

  • Prefer cloud-hosted commenting.
  • Do not email PDFs around as the main workflow.
  • Tell readers what feedback matters now.
  • Ask for confusion, skepticism, missing information, boredom, value, and applicability.

4. Classify Feedback

Group feedback by signal:

  • Evidence of value.
  • Confusion or missing information.
  • Skepticism or weak proof.
  • Factual issues, overgeneralization, or oversimplification.
  • Unnecessary drama or distracting sentences.
  • Boredom, abandonment, or comment drop-off.
  • Application problems after reading.

5. Revise By Signal Strength

Prioritize changes that unblock more readers.

  • Treat abandonment as data.
  • Treat negative feedback as a lens, not a command.
  • Do not argue with readers in the document.
  • Follow up when the book is supposed to change behavior after reading.

Output Format

When helping with beta feedback, return:

  1. Beta-readiness or setup diagnosis.
  2. Reader recruitment and instruction plan.
  3. Feedback taxonomy or synthesis table.
  4. Ordered revision priorities.
  5. Finish criteria: what evidence would make the manuscript ready for polish.

Quality Bar

Separate reader signals from author defensiveness. Do not merely summarize comments. Convert them into revision decisions, open questions, and next beta-round tests.

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

migrate-to-e2e

Moves an existing Playwright, Cypress, Selenium, Appium, Detox, Maestro, or TesterArmy suite to e2e one slice at a time, with the old suite running beside the new one until each ported test is proven. Keeps a MIGRATION.md progress file so any later session resumes where the last stopped. Optionally plants a defect to show both suites catch it. Use for /migrate-to-e2e, "migrate our tests to e2e", "port these Maestro flows", "move our TesterArmy tests", or when a project has an e2e config and an older suite still running.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

e2e

Writes, runs, and debugs end-to-end tests for web and mobile apps with e2e, the agentic test runner, which mixes agent.act goals with exact locator assertions on a Playwright browser or an iOS or Android device. Also drives a project's running app live over the e2e MCP server to look at a screen, check a UI change, take a screenshot or record a video, and try a locator; and runs bug bashes, parallel e2e explore runs with each bug proven by a repro test. Use when a project depends on e2e or has an e2e.config.ts, when asked for end-to-end, browser, mobile, or agentic UI tests, to check a change in the running app, to QA or bug bash an app or branch, or when an e2e run fails.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

create-verification-skill

Generate a project-local verify-<app> skill on top of e2e, so any coding agent can launch the app, check it is worth driving, exercise a feature the way a user does, keep evidence, and bug bash it. Writes the skill, a feature map with one explore charter per feature, and proves it once. Use for /create-verification-skill, "make a verification skill for this repo", or when a project has no scripted way to prove UI behavior.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

deja-search

deja-vu memory — search the user's past AI coding sessions with the deja CLI. Holds what they already settled and never wrote into the repo (naming rules, banned or already-tried tools, required checks before merge, preferred values, who owns what). Use before your first edit in a task, before you call a change done or ready to merge, before you recommend a tool, library, design or reviewer, before re-debugging an error that may already be solved, when they say 'didn't we fix this before', 'what did we decide about X' or 'I already have that', and before telling them something on this machine does not exist.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

deja-reflect

End-of-session reflection and memory curation with deja-vu. Review what was decided, what commands broke and what repaired them, and record durable project rules or decisions with deja remember so the next session starts with them.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

revid

Make, edit, export and post AI videos with Revid (revid.ai) through the Revid MCP server. Use whenever the user wants a short-form or long-form video made (from an idea, a script, a URL, an article, a PDF, a tweet, a product page, their own clips, or a song), wants to find what is going viral on TikTok, YouTube, Instagram or X before making something, wants to edit or re-export an existing Revid project, generate a standalone AI image or clip, make a series episode, or publish and schedule a finished video to connected social accounts. Covers setup (hosted MCP with OAuth, or an API key), the 36 tools, credits, polling and the rules for publishing. Routes to the more specific revid-* skills when one fits.

图像与多媒体Skill与智能体开发
★ 1.6k