chapter-approve

Records human approval decisions on devbook domain chapters with metadata and annotation handling.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Devbook chapters need a recorded, human-made approval decision before they become work, and that decision must be written consistently — with the approver, date, and content hash — while clearing stale review state and resolved annotations. ## Core Features & Use Cases - Approval gate: Shows the full chapter with open annotation fences (questions, flags, suggestions) and blocks approval while any open question remains. - Three explicit outcomes: Approve, revise (records change requests as annotations and sets review state), or decline (records nothing), with no default and no inferred approval from silence. - Stale approval handling: Detects content changes after approval via chapter-hash comparison and lifts lapsed approvals, including any dependent acceptance. - Use Case: A specification chapter has passed review and a tech lead says "sign off on this" — the skill presents the chapter and open notes, takes the decision, and writes status, approved-by, approved-at, and approved-hash in one change. ## Quick Start Ask the assistant to approve the devbook chapter at a given path, for example: approve the chapter docs/specs/checkout.md and record who signed off.

Frequently Asked Questions about chapter-approve

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

FAQPage Schema
How do I approve a devbook chapter?▼

Run the chapter-approve flow on the chapter path: it shows the full chapter with open annotations, asks for an approve, revise, or decline decision, and on approval writes status, approved-by, approved-at, and approved-hash in one change.

What blocks a chapter approval in devbook?▼

An open annotation fence of kind question blocks approval, because devbook's check reports it as an error. Open flags and other notes are shown first and weighed by the person but do not block the decision.

Can a chapter be approved automatically or by the AI?▼

No. Approval is never inferred from silence, a cleared review, or the chapter looking fine. If nobody answers, the run stops and reports the chapter as awaiting approval.

What happens when an approved chapter changes afterward?▼

The approval is stale and gets lifted: status returns to the ordinary rung and approved-by, approved-at, and approved-hash are deleted. If the chapter was also accepted, the acceptance fields are removed in the same change.

Which chapters can be approved with this workflow?▼

Only chapters under the domain/ folder, since the approved rung exists on that folder's status ladder. Asked to approve a chapter elsewhere, the skill stops because writing it there fails devbook's check.