$npx -y skills add yha9806/academic-writing-toolkit --skill logic-reviewReview chapter drafts for paragraph-level flow, transitions, and argument continuity before editing.
| 1 | # /logic-review — Paragraph Logic Review |
| 2 | |
| 3 | ## Purpose |
| 4 | |
| 5 | 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. |
| 6 | |
| 7 | ## Trigger Words |
| 8 | |
| 9 | This skill activates on: `logic review`, `flow check`, `paragraph logic`, `/logic-review`. |
| 10 | |
| 11 | ## Workflow |
| 12 | |
| 13 | 1. Run: |
| 14 | `python3 scripts/audit-logic.py --base-dir . --json` |
| 15 | 2. Read the flagged paragraphs and nearby context. |
| 16 | 3. Present a numbered review table with location, issue type, why it matters, and a proposed edit. |
| 17 | 4. Wait for user approval before editing chapter files. |
| 18 | 5. Apply only approved edits, then re-run the audit. |
| 19 | |
| 20 | ## Constraints |
| 21 | |
| 22 | 1. Never auto-fix chapter logic without user approval. |
| 23 | 2. Preserve the author's argument and section structure. |
| 24 | 3. Keep edits local to the flagged paragraph unless the user approves a broader rewrite. |
| 25 | 4. No emoji. |