logic-review

name	logic-review
description	Review chapter drafts for paragraph-level flow, transitions, and argument continuity before editing.
allowed-tools	Read, Glob, Bash, Edit

/logic-review — Paragraph Logic Review

Purpose

Find paragraphs that may need a topic sentence, a clearer transition, merging, or re-ordering. The deterministic script flags candidates; the agent explains and proposes edits.

Trigger Words

This skill activates on: logic review, flow check, paragraph logic, /logic-review.

Workflow

1. Resolve the bundled helper at scripts/audit-logic.py relative to this SKILL.md, then run it from the project root: python3 {skill_dir}/scripts/audit-logic.py --base-dir . --json
2. Read the flagged paragraphs and nearby context.
3. Present a numbered review table with location, issue type, why it matters, and a proposed edit.
4. Wait for user approval before editing chapter files.
5. Apply only approved edits, then re-run the audit.

Constraints

1. Never auto-fix chapter logic without user approval.
2. Preserve the author's argument and section structure.
3. Keep edits local to the flagged paragraph unless the user approves a broader rewrite.
4. No emoji.