Repository Public Research preview
1# latex-manuscript-qa23An Agent Skill for getting a LaTeX paper or Beamer deck to a state you can send: a build from4scratch, no undefined reference or citation, no overfull box above a threshold, no slide running5off the bottom, every float referenced, numbering you can check, and a Word version that keeps the6numbers.78## Contents910| Path | Purpose |11|---|---|12| `SKILL.md` | Ground rules, the procedure, commands, limits |13| `references/qa-procedure.md` | Each check: pass criterion and fixes |14| `references/beamer-overflow.md` | How overflowing frames are found, and what is not detected |15| `references/latex-to-word.md` | The conversion recipe and what does not survive |16| `references/costly-errors.md` | Package order, Biber against BibTeX, fonts, encoding, pgfplots, floats |17| `scripts/latex.mjs` | Command-line tool, JSON output, exit code 0 / 1 / 2 |18| `scripts/lib/` | The engine (shared with the `latex-build-mcp` server) |1920No dependencies beyond Node.js 20+ and a TeX distribution. latexmk, biber, pandoc, texcount,21chktex and pdftotext are used when present; `node scripts/latex.mjs status` shows what is missing.2223## Install2425```bash26skills install @spboucher/latex-manuscript-qa --client claude-code # or codex, cursor, generic-agent-skills27```2829## Quick start3031```bash32node scripts/latex.mjs qa paper/main.tex33```3435## Safety3637The tool compiles with shell escape off and ignores project `latexmkrc` files, reads and writes38only inside `LATEX_MCP_ROOT` (default: the current directory), writes build products to a39`.latex-build/` directory it marks as its own, and deletes nothing else.4041## Tested4243On macOS with TeX Live 2026, pandoc 3.9 and Node 26: fixtures with known defects are compiled and44each diagnostic is asserted by file and line. Not tested on Windows or with MiKTeX.4546## License4748MIT49