Skill

Document Review

Blind expert review, section by section, with a whole-document editor

Use in Claude Code
/attune:review-doc

Review-doc orchestrates a full review by splitting a document at its own headings, briefing one blind expert per section with the section's 5W1H, and running all experts in parallel alongside a senior editor that reviews the whole document. Each expert sees only its own section and brief, keeping reviews independent. Findings are written to a timestamped .reviews/ file with exact quotes, issues, fixes, kinds, severities, and pending outcomes.

Key Insights

Blind section experts

One expert per section sees only its section and a 5W1H brief, so no section review leaks context from the rest of the document.

Whole-document senior editor

A separate editor reviews order, repetition, contradictions, missing sections, and whether the opening promise is delivered.

Structured findings file

Findings are written to .reviews/ with exact quotes, issue, fix, kind, severity, and pending outcome for later triage.

Faithful workflow fallback

When the Workflow tool is absent, the same prompts run as background Fable agent calls per section plus the whole document.

How It Works

1

Resolve the document

Ask for a file if none is supplied and resolve the path.

Stops on empty argument, uses paths as given, searches bare names from project root via git ls-files or find, and puts multiple matches to the user.

2

Split the document

Read the full document and split at its headings.

Merge fragments shorter than a paragraph, record each section's title and line range, and merge smallest neighboring sections when the count exceeds the session workflow guideline.

3

Brief each section

Write Who, What, When, Where, Why, How, and the required expert.

Describe audience, claims, reader position, file path/lines, purpose, form and evidence, then choose a technical editor, domain specialist, or both.

4

Run the experts

Call the Workflow tool with the pinned script and section briefs.

One blind Fable expert per section plus a whole-document senior editor run in parallel; fall back to background agent calls when the Workflow tool is absent, and wait for completion.

5

Write the review

Stamp and write findings to .reviews/.

Use date -u, write .reviews/<stamp>-<stem>.md, number section findings and whole-document findings, mark every finding pending, and report the path and counts.