lvtd-llc/skills

reader-experience-edit

Audit and revise practical nonfiction drafts for reader experience, value pacing, front-loaded insight, value-per-page, boredom, and beta-readiness.

First seen Jun 21, 2026

Installation

$ npx skills add lvtd-llc/skills --skill reader-experience-edit

Summary

  • Audit and revise practical nonfiction drafts for reader experience, value pacing, front-loaded insight, value-per-page, boredom, and beta-readiness.
  • Use when editing, restructuring, shortening, or reviewing a book, guide, manual, course-like manuscript, or long-form educational draft so readers receive useful value quickly and keep reading.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from lvtd-llc/skills · top by installs.

npx skills add lvtd-llc/skills

Browse all from lvtd-llc/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1
License LICENSE
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version0.1.0
LicenseMIT
CompatibilityCodex, Claude Code, and other Agent Skills-compatible clients.
Declared agents claude-code codex
More metadata
version
0.1.0
displayName
Reader Experience Edit
category
Writing
tags
writing,books,nonfiction,editing,reader-experience

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,283 B
  • docs SUMMARY.md 372 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 61 installs

SKILL.md

Reader Experience Edit

Core Lens

Treat reader experience as value received over time spent. Practical nonfiction does not keep readers engaged through suspense; it keeps them engaged by regularly delivering the outcome promised by the book.

Use this skill to diagnose and improve:

  • Slow starts.
  • Long stretches of theory before payoff.
  • Low value-per-page.
  • Sections whose value is unclear.
  • Drafts that need to be coherent enough for beta readers, not polished enough for publication.

Reference Routing

Need Read
Core concepts and terminology references/core/knowledge.md
Revision rules and decision criteria references/core/rules.md
Before/after patterns references/core/examples.md
Fast audit checklist references/core/checklist.md
Step-by-step manuscript audit workflows/audit-manuscript.md

Workflow

1. Anchor On The Promise

Identify:

  • Target reader.
  • Book promise.
  • First meaningful piece of value.
  • What the reader should be able to do, decide, or understand after each major section.

If the promise is unclear, use book-toc-lab before editing the manuscript.

2. Create A Value Map

Build a table:

Section | Word count | Reader takeaway | Value type | Risk

Use it to find:

  • Slow start: too many words before first value.
  • Long slog: back-to-back sections without strong takeaways.
  • Fluff: high word count relative to reader value.

3. Front-Load Value

Look for ways to deliver the first useful result earlier:

  • Cut front matter.
  • Insert real value into theory sections.
  • Start with the main insight, tool, checklist, example, or result.
  • Move background after the reader has a reason to care.

4. Increase Value-Per-Page

Prefer deletion before addition.

  • Cut anything outside the target reader's scope.
  • Replace general motivation with concrete examples.
  • Compress explanations that do not change reader behavior.
  • Save deleted material in a separate cutting-room-floor note when useful.

5. Prepare For Beta Readers

Do not aim for perfect prose yet. Aim for a draft that is coherent enough for motivated readers to identify real problems.

Return:

  1. Main reader-experience diagnosis.
  2. Value map or section-by-section risk table.
  3. Highest-leverage cuts, moves, and rewrites.
  4. Revised opening or TOC recommendations when relevant.
  5. Beta-readiness note: what must be fixed before readers see it.

Quality Bar

Recommendations should be structural and specific. Prefer "move this section after X", "cut this setup", or "turn this theory into a worked example" over generic writing advice.