book-auditorlisted
Install: claude install-skill tarvanitis/ai-prose-tools
# Book Auditor
Check a book-length technical manuscript against the conventions a finished book has to hold,
and report what is broken. This skill inspects. It does not rewrite.
It pairs with **prose-linter**, which audits the words. This one audits everything around them:
the numbering, the references, the scaffolding, and the arc.
## The two halves
**Mechanical.** `scripts/check-structure.py` catches what a human reliably misses. Figure and
table numbers are hard-coded literals in Markdown. Nothing renumbers them automatically, so
inserting a table into Chapter 12 silently leaves the rest of that chapter mis-numbered and every
reference to it stale. The checker makes that loud.
```bash
python3 scripts/check-structure.py chapters/*.md # report
python3 scripts/check-structure.py chapters/*.md && make # gate a build
```
It checks figure and table numbering sequence, captions present on every figure, cross-references
that resolve to a chapter that exists, dated claims older than a threshold, and bibliography
entries whose line breaks will collapse on render. Exit code is non-zero when something fails, so
it drops straight into a Makefile or CI.
Conventions it assumes, which you can change in the script: chapter files are named `ch-NN-*.md`,
appendices `appendix-a-*.md` and `appendix-b-*.md`, and a dated claim is stale after 90 days.
**Editorial.** The rest needs judgment. Work through the rubrics below and report findings rather
than silently fixing them. An a