| 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
- 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
- Read the flagged paragraphs and nearby context.
- Present a numbered review table with location, issue type, why it matters, and a proposed edit.
- Wait for user approval before editing chapter files.
- Apply only approved edits, then re-run the audit.
Constraints
- Never auto-fix chapter logic without user approval.
- Preserve the author's argument and section structure.
- Keep edits local to the flagged paragraph unless the user approves a broader rewrite.
- No emoji.
