---
name: hashgraph-online/reader-experience-edit
source: https://app.decimal.ai/s/hashgraph-online-reader-experience-edit@1/SKILL.md
source_sha256: 2b1771e1b58a
---

# 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:

```text
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.