chapter-review

Reviews a devbook chapter and records findings as annotation fences with a verdict in its meta block.

Updated Sep 2, 2026
One-click install
npx skills add https://github.com/JSdotNet/devbook --skill chapter-review-jsdotnet
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: chapter-review
Source: https://github.com/JSdotNet/devbook/tree/main/plugins/devbook-collaboration/skills/chapter-review
Command: npx skills add https://github.com/JSdotNet/devbook --skill chapter-review-jsdotnet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Devbook chapters drift out of sync with the code and product they describe, and review feedback left in chat disappears with the session. This Skill reviews one chapter against its folder's rules, linked neighbours, and claimed evidence, then records every unresolved finding as an annotation fence beside the passage it concerns so the verdict survives. ## Core Features & Use Cases - Seven-lens review: Checks truth, evidence, edges, vocabulary, status, scope, and gaps against the chapter and its related/depends-on neighbours. - Recorded findings: Writes each unresolved objection as an annotation fence via annotations.mjs with kind, author, and passage anchor, and replies to and resolves open notes it settles. - Verdict in metadata: Sets review: cleared or review: changes-requested plus reviewer and review-at in the chapter's meta block, without ever writing status: approved. - Use Case: A teammate asks "is the domain model chapter still accurate?" — the Skill walks the chapter and its neighbours, answers two open questions left by a previous reviewer, files one flag about a stale depends-on edge, and marks the review changes-requested. ## Quick Start Review the domain model chapter and record any findings as annotations on it.

Frequently Asked Questions about chapter-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a devbook chapter?▼

Load the chapter and the chapters one step away through its related and depends-on edges, list existing annotations with annotations.mjs, then check it through the truth, evidence, edges, vocabulary, status, scope, and gaps lenses. Record remaining findings as annotation fences and write the verdict into the meta block.

How are review findings recorded on a chapter?▼

Each unresolved finding is written as an annotation fence beside the passage it concerns using annotations.mjs add with a kind of question, flag, suggestion, or comment. Settled notes get a reply and are resolved so the exchange stays readable in the pull request.

Can a chapter review approve the chapter itself?▼

No. The review only writes review: cleared or review: changes-requested plus reviewer and review-at. Writing status: approved is reserved for the separate chapter-approve step so a review cannot approve itself.

What is the difference between chapter-review and chapter-review-queue?▼

chapter-review is scoped to one chapter and its direct neighbours through related and depends-on links. A folder-wide sweep across many chapters is the job of chapter-review-queue, and widening a single review to the folder is explicitly out of scope.

When should an annotation be a flag instead of a question?▼

Use question when the chapter cannot be judged until somebody answers, and flag when the objection should be the first thing the approver reads. The approval gate shows flags first but never blocks on one; suggestion or comment covers everything else.