SPB Git

Repository Public Research preview

README.md 1.8 KB

# 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

bash
skills install @spboucher/latex-manuscript-qa --client claude-code   # or codex, cursor, generic-agent-skills

# Quick start

bash
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

Files main
Menu

Theme