Proofread Academic Writing
Run the mandatory proofreading protocol on papers or manuscripts. Produces a report of all issues WITHOUT editing any source files.
Steps
Identify files to review:
- If
$ARGUMENTSis a specific filename: review that file only - If
$ARGUMENTSisall: review all files inmanuscripts/andQuarto/(if it exists) - If
$ARGUMENTSis a file inmanuscripts/: treat as manuscript (not slides) - If
$ARGUMENTSis empty or ambiguous and multiple files exist, use AskUserQuestion:- header: "Files"
- question: "Which files should I proofread?"
- multiSelect: true
- options: list up to 4 found files (label: filename, description: directory and file type). User can select multiple or choose "Other" to specify a path.
- If
For each file, launch the proofreader agent that checks for:
GRAMMAR: Subject-verb agreement, articles (a/an/the), prepositions, tense consistency TYPOS: Misspellings, search-and-replace artifacts, duplicated words LAYOUT ISSUES: Overfull hbox (LaTeX slides/manuscripts), content exceeding slide boundaries (Quarto), table/column overflow in manuscripts CONSISTENCY: Citation format, notation, terminology, variable names matching table column names ACADEMIC QUALITY: Informal language, missing words, awkward constructions
Produce a detailed report for each file listing every finding with:
- Location (line number or section heading)
- Current text (what's wrong)
- Proposed fix (what it should be)
- Category and severity
Save each report to
quality_reports/:- For
.texslide files:quality_reports/FILENAME_report.md - For
.qmdslide files:quality_reports/FILENAME_qmd_report.md - For manuscript files:
quality_reports/FILENAME_proofread.md
- For
IMPORTANT: Do NOT edit any source files. Only produce the report. Fixes are applied separately after user review (see
rules/proofreading-protocol.md).Present summary to the user:
- Total issues found per file
- Breakdown by category
- Most critical issues highlighted