latex-manuscript-qa
An Agent Skill for getting a LaTeX paper or Beamer deck to a state you can send: a build from
scratch, no undefined reference or citation, no overfull box above a threshold, no slide running
off the bottom, every float referenced, numbering you can check, and a Word version that keeps the
numbers.
Contents
| Path | Purpose |
|---|
SKILL.md | Ground rules, the procedure, commands, limits |
references/qa-procedure.md | Each check: pass criterion and fixes |
references/beamer-overflow.md | How overflowing frames are found, and what is not detected |
references/latex-to-word.md | The conversion recipe and what does not survive |
references/costly-errors.md | Package order, Biber against BibTeX, fonts, encoding, pgfplots, floats |
scripts/latex.mjs | Command-line tool, JSON output, exit code 0 / 1 / 2 |
scripts/lib/ | The engine (shared with the latex-build-mcp server) |
No dependencies beyond Node.js 20+ and a TeX distribution. latexmk, biber, pandoc, texcount,
chktex and pdftotext are used when present; node scripts/latex.mjs status shows what is missing.
Install
skills install @spboucher/latex-manuscript-qa --client claude-code
Quick start
node scripts/latex.mjs qa paper/main.tex
Safety
The tool compiles with shell escape off and ignores project latexmkrc files, reads and writes
only inside LATEX_MCP_ROOT (default: the current directory), writes build products to a
.latex-build/ directory it marks as its own, and deletes nothing else.
Tested
On macOS with TeX Live 2026, pandoc 3.9 and Node 26: fixtures with known defects are compiled and
each diagnostic is asserted by file and line. Not tested on Windows or with MiKTeX.
License
MIT