Book TOC Lab
Baseline
Treat a useful nonfiction book as a problem-solving product for a specific reader. The table of contents is the product design, not a decorative outline. Build and test the promise, scope, recommendation loop, and TOC before drafting so the manuscript has a clear job and a useful progression.
Use this skill to produce or improve a book plan that answers:
- Who is this book for?
- What painful or valuable problem does it help them solve?
- What should be different for the reader after each chapter?
- What does the book deliberately leave out?
- Why would a satisfied reader recommend it to a specific person in a specific situation?
Reference Routing
Load only the files needed for the task:
| Need |
Read |
| Core model, DEEP, promise, scope, recommendation loop |
references/core/knowledge.md |
| Concrete planning and validation rules |
references/core/rules.md |
| Before/after examples for scope and TOC titles |
references/core/examples.md |
| Quick planning and review checklist |
references/core/checklist.md |
| Step-by-step TOC validation with readers |
workflows/validate-toc.md |
Workflow
1. Lock The Reader Promise
Start with a one-paragraph book brief:
- Target reader: one recognizable type of person, not a broad market.
- Current struggle: the problem, confusion, risk, or opportunity that makes the book worth reading.
- Book promise: the useful outcome the book can credibly help create.
- Starting assumptions: what the reader already knows, has, or believes.
- Success evidence: what the reader can do, decide, avoid, or build after reading.
If these are vague, stop and refine them before outlining. A weak promise creates a weak TOC.
2. Set Scope Boundaries
Define both sides of the scope:
- In scope: what the book must cover to deliver the promise.
- Out of scope: adjacent topics that are tempting but distract from the promise.
- Prerequisites: what should be taught, assumed, or linked elsewhere.
- Depth line: where the book should go deep versus where a concise pointer is enough.
Prefer a narrow book that fully solves one reader problem over a broad book that surveys many topics without changing the reader's life.
3. Check Recommendability
Write the recommendation story:
- What situation makes the reader complain, search, ask for help, or give advice?
- Who hears that problem and naturally recommends this book?
- Why is this book the obvious solution for that person, not merely one option among many?
- What outcome would make the reader confident enough to recommend it?
If the story is weak, adjust the reader, promise, or scope before drafting.
4. Draft A Takeaway-First TOC
Create chapters as reader takeaways, not clever titles. For each chapter, capture:
- Chapter title.
- Reader question or problem.
- Main takeaway.
- Practical output, decision, habit, checklist, model, or skill the reader gains.
- Why this chapter belongs here.
- What confusion or objection it resolves.
Use this table while designing:
Chapter | Reader problem | Takeaway | Reader output | Why now? | Risk if missing
5. Shape The Reader Journey
Order chapters by reader progress, not author knowledge. A strong sequence usually moves through:
- Orientation: help the reader recognize the problem and adopt the right mental model.
- Foundation: teach the few concepts needed for later action.
- Action: walk through the core work.
- Judgment: show how to make tradeoffs, avoid mistakes, and adapt.
- Integration: help the reader apply, maintain, or extend what they learned.
Avoid front-loading background that the reader does not need yet. Put value early enough that the reader feels progress in the first chapter.
6. Pressure-Test The TOC
Run these checks before drafting:
- Promise check: every chapter directly supports the book promise.
- Reader check: the TOC uses reader problems and outcomes, not only author categories.
- Missing step check: no chapter assumes a concept, decision, or tool the reader has not received.
- Boredom check: remove or compress chapters whose payoff is delayed, obvious, or mostly throat-clearing.
- Confusion check: identify where a reader may ask "why does this matter?" or "what do I do with this?"
- Skepticism check: mark claims that will need proof, examples, or caveats.
- Recommendation check: describe the exact person a happy reader would recommend the book to and the sentence they would use.
Revise until each chapter earns its place.
7. Test Before Drafting
When practical, validate the TOC with real or simulated readers before writing full chapters:
- Teach from the TOC in a short call, workshop, article series, or outline review.
- Ask readers where they get confused, bored, skeptical, or excited.
- Ask what they expected to see but did not.
- Ask which chapter they would read first and which they might skip.
- Ask what outcome would make the book worth recommending.
Treat negative feedback as design data. Update the TOC before turning it into prose.
Output Format
When asked to create or improve a TOC, return:
- Book brief: reader, problem, promise, scope, out-of-scope.
- Recommendation story: trigger, recommender, recommended reader, why this book.
- Recommended TOC with chapter-level reader problems and takeaways.
- Reader journey notes explaining the order.
- Risk list: missing prerequisites, vague chapters, likely confusion, likely boredom.
- Validation plan: 3-7 concrete ways to test the TOC before drafting.
Quality Bar
A good TOC should feel useful even before the book exists. A reader should be able to scan it and understand what the book helps them accomplish, whether it is for them, and why the chapter sequence makes sense.
Do not optimize for literary cleverness before usefulness. Clever titles are acceptable only after the reader promise and chapter takeaways are obvious.
1---2name: book-toc-lab3description: Design and pressure-test useful nonfiction book promises, scopes, recommendation loops, and takeaway-first tables of contents before drafting. Use when planning, outlining, scoping, restructuring, validating, or testing a practical book, guide, manual, course-like book, or other reader-outcome-focused long-form nonfiction.4license: MIT5compatibility: Codex, Claude Code, and other Agent Skills-compatible clients.6metadata:7 version: "0.1.0"8 displayName: Book TOC Lab9 category: Writing10 tags: writing,books,nonfiction,outlining,toc11---1213# Book TOC Lab1415## Baseline1617Treat a useful nonfiction book as a problem-solving product for a specific reader. The table of contents is the product design, not a decorative outline. Build and test the promise, scope, recommendation loop, and TOC before drafting so the manuscript has a clear job and a useful progression.1819Use this skill to produce or improve a book plan that answers:2021- Who is this book for?22- What painful or valuable problem does it help them solve?23- What should be different for the reader after each chapter?24- What does the book deliberately leave out?25- Why would a satisfied reader recommend it to a specific person in a specific situation?2627## Reference Routing2829Load only the files needed for the task:3031| Need | Read |32|------|------|33| Core model, DEEP, promise, scope, recommendation loop | `references/core/knowledge.md` |34| Concrete planning and validation rules | `references/core/rules.md` |35| Before/after examples for scope and TOC titles | `references/core/examples.md` |36| Quick planning and review checklist | `references/core/checklist.md` |37| Step-by-step TOC validation with readers | `workflows/validate-toc.md` |3839## Workflow4041### 1. Lock The Reader Promise4243Start with a one-paragraph book brief:4445- **Target reader:** one recognizable type of person, not a broad market.46- **Current struggle:** the problem, confusion, risk, or opportunity that makes the book worth reading.47- **Book promise:** the useful outcome the book can credibly help create.48- **Starting assumptions:** what the reader already knows, has, or believes.49- **Success evidence:** what the reader can do, decide, avoid, or build after reading.5051If these are vague, stop and refine them before outlining. A weak promise creates a weak TOC.5253### 2. Set Scope Boundaries5455Define both sides of the scope:5657- **In scope:** what the book must cover to deliver the promise.58- **Out of scope:** adjacent topics that are tempting but distract from the promise.59- **Prerequisites:** what should be taught, assumed, or linked elsewhere.60- **Depth line:** where the book should go deep versus where a concise pointer is enough.6162Prefer a narrow book that fully solves one reader problem over a broad book that surveys many topics without changing the reader's life.6364### 3. Check Recommendability6566Write the recommendation story:6768- What situation makes the reader complain, search, ask for help, or give advice?69- Who hears that problem and naturally recommends this book?70- Why is this book the obvious solution for that person, not merely one option among many?71- What outcome would make the reader confident enough to recommend it?7273If the story is weak, adjust the reader, promise, or scope before drafting.7475### 4. Draft A Takeaway-First TOC7677Create chapters as reader takeaways, not clever titles. For each chapter, capture:7879- Chapter title.80- Reader question or problem.81- Main takeaway.82- Practical output, decision, habit, checklist, model, or skill the reader gains.83- Why this chapter belongs here.84- What confusion or objection it resolves.8586Use this table while designing:8788```text89Chapter | Reader problem | Takeaway | Reader output | Why now? | Risk if missing90```9192### 5. Shape The Reader Journey9394Order chapters by reader progress, not author knowledge. A strong sequence usually moves through:95961. Orientation: help the reader recognize the problem and adopt the right mental model.972. Foundation: teach the few concepts needed for later action.983. Action: walk through the core work.994. Judgment: show how to make tradeoffs, avoid mistakes, and adapt.1005. Integration: help the reader apply, maintain, or extend what they learned.101102Avoid front-loading background that the reader does not need yet. Put value early enough that the reader feels progress in the first chapter.103104### 6. Pressure-Test The TOC105106Run these checks before drafting:107108- **Promise check:** every chapter directly supports the book promise.109- **Reader check:** the TOC uses reader problems and outcomes, not only author categories.110- **Missing step check:** no chapter assumes a concept, decision, or tool the reader has not received.111- **Boredom check:** remove or compress chapters whose payoff is delayed, obvious, or mostly throat-clearing.112- **Confusion check:** identify where a reader may ask "why does this matter?" or "what do I do with this?"113- **Skepticism check:** mark claims that will need proof, examples, or caveats.114- **Recommendation check:** describe the exact person a happy reader would recommend the book to and the sentence they would use.115116Revise until each chapter earns its place.117118### 7. Test Before Drafting119120When practical, validate the TOC with real or simulated readers before writing full chapters:121122- Teach from the TOC in a short call, workshop, article series, or outline review.123- Ask readers where they get confused, bored, skeptical, or excited.124- Ask what they expected to see but did not.125- Ask which chapter they would read first and which they might skip.126- Ask what outcome would make the book worth recommending.127128Treat negative feedback as design data. Update the TOC before turning it into prose.129130## Output Format131132When asked to create or improve a TOC, return:1331341. Book brief: reader, problem, promise, scope, out-of-scope.1352. Recommendation story: trigger, recommender, recommended reader, why this book.1363. Recommended TOC with chapter-level reader problems and takeaways.1374. Reader journey notes explaining the order.1385. Risk list: missing prerequisites, vague chapters, likely confusion, likely boredom.1396. Validation plan: 3-7 concrete ways to test the TOC before drafting.140141## Quality Bar142143A good TOC should feel useful even before the book exists. A reader should be able to scan it and understand what the book helps them accomplish, whether it is for them, and why the chapter sequence makes sense.144145Do not optimize for literary cleverness before usefulness. Clever titles are acceptable only after the reader promise and chapter takeaways are obvious.