Review a file for grammar, typos, formatting issues, and academic writing quality.
Input: $ARGUMENTS — path to a .tex, .qmd, or .md file, or a section name.
Steps
- Read the file end-to-end
- Check for:
- Spelling and grammar errors
- Awkward phrasing or unclear sentences
- Passive voice overuse
- Inconsistent terminology (e.g., "{{term variant A}}" vs "{{term variant B}}")
- LaTeX issues: undefined commands, unbalanced braces, overfull hbox triggers
- QMD issues: broken YAML, malformed code chunks, missing cross-refs
- Citation formatting:
\cite{} vs \citep{} vs \citet{} consistency
- Number formatting: consistent use of commas, decimal places
- Table/figure references match actual labels
- Report findings by severity:
- Errors (must fix): typos, grammar mistakes, broken formatting
- Style (should fix): passive voice, wordiness, inconsistency