chapter-review-queue

Sweeps devbook folders for pending reviews, approvals, and unresolved notes grouped by owner.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams using devbook chapters lose track of who owes the next move: which chapters await a named reviewer, which carry unresolved notes, which are cleared and waiting for approval, and which approvals went stale after content changed. This Skill scans every adopted devbook folder and reports one queue grouped by the person responsible. ## Core Features & Use Cases - Cross-folder review sweep: Reads meta and annotation fences across all adopted devbook folders (from .devbook/config.json or disk) without loading chapter prose. - State-based routing table: Sorts each chapter into one of eleven rows — stale approval, changes requested, awaiting review, unsigned approval, notes to sweep, and more — each mapped to who owes the next move. - Exact staleness detection: Compares approved-hash/accepted-hash fingerprints via chapter-hash.mjs, falling back to git line-range history only when no fingerprint exists. - Use Case: Before a sprint review, ask what is waiting on approval across the repository and get a grouped queue showing each pending chapter, its wait time, and its open notes verbatim. ## Quick Start Ask the assistant to show the review queue across the devbook folders, including stale approvals and whose turn it is.

Frequently Asked Questions about chapter-review-queue

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

FAQPage Schema
How do I find chapters awaiting review in a devbook repository?▼

Run the review queue sweep, which scans every adopted devbook folder for chapters with `review: requested`, `review: cleared`, or `review: changes-requested` in their meta fences. Results are grouped by who owes the next move, with wait times and open notes.

How to detect stale approvals after documentation changes?▼

The sweep compares a chapter's `approved-hash` or `accepted-hash` fingerprint against the current hash from chapter-hash.mjs — a mismatch means the approval is stale. Without a fingerprint, it falls back to git history over the chapter's heading range.

Does the review queue read generated _meta indexes?▼

No. The queue is built only from meta and annotation fences in the chapter files themselves. The `_meta/` directory is generated tool input with no review or approval fields, and sessions are denied reading it.

Can the review queue fix or lift a stale approval?▼

No. This skill is read-only and only reports the queue. Lifting a stale approval is a per-chapter decision handled by chapter-approve, and sweeping resolved notes belongs to the annotation-sweep skill.

Why is a chapter missing from the review queue report?▼

Chapters with no review state, no approval, and no notes are intentionally excluded — silence is the normal case, not a queue entry. Only chapters matching one of the eleven routing-table conditions appear.