mcpField
P
paper-compilation

paper-compilation

github.com/lingzhi227Documents4401.6k installsUpdated 35w ago
Repository

About paper-compilation

paper-compilation is a skill for compiling LaTeX papers to PDF and checking the results. It validates citations and figures, reports compilation and style issues, and can attempt automatic error fixes with retries.

Key features

  1. 01Compiles LaTeX papers to PDF
  2. 02Validates citations and figure files
  3. 03Reports warnings and style issues
  4. 04Automatically fixes selected errors
  5. 05Retries compilation after fixes

Use cases

  1. 01Building a paper PDF
  2. 02Checking citations and figure references
  3. 03Diagnosing and correcting compilation errors

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/lingzhi227/agent-research-skills --skill paper-compilation

After installing, type/paper-compilationin Claude Code to confirm it loaded.

Bundled filesscripts/compile_paper.pyscripts/fix_latex_errors.py

Details

From the project README

Paper Compilation

Compile a LaTeX paper to PDF with error detection and correction.

Input

  • $ARGUMENTS — Path to the main .tex file

Scripts

Compile paper
python ~/.claude/skills/paper-compilation/scripts/compile_paper.py paper/main.tex
python ~/.claude/skills/paper-compilation/scripts/compile_paper.py paper/main.tex --check-style
python ~/.claude/skills/paper-compilation/scripts/compile_paper.py paper/main.tex --output paper/output.pdf

Reports: compilation status, page count, warnings, citation/reference stats, style issues.

Validate citations before compiling
python ~/.claude/skills/citation-management/scripts/validate_citations.py \
  --tex paper/main.tex --bib paper/references.bib --check-figures --figures-dir paper/figures/
Auto-fix LaTeX errors
python ~/.claude/skills/paper-compilation/scripts/fix_latex_errors.py \
  --tex paper/main.tex --log compile.log --output paper/main_fixed.tex

Fixes: HTML tags in LaTeX, mismatched environments, missing figures. Key flags: --dry-run, --auto-detect

Compile with auto-fix retry
python ~/.claude/skills/paper-compilation/scripts/compile_paper.py paper/main.tex --auto-fix

Runs fix_latex_errors.py + recompile up to 3 rounds until compilation succeeds.

Workflow

Step 1: Pre-Compilation Validation

Run validate_citations.py to catch issues before compiling:

  • Every \cite{key} has a matching .bib entry
  • Every \includegraphics{file} exists
  • No duplicate labels or sections
Step 2: Compile

Run compile_paper.py which executes: pdflatex → bibtex → pdflatex → pdflatex

Step 3: Error Correction Loop (up to 5 rounds)

If compilation fails, read the error output and fix:

  • ! Undefined control sequence → Add missing package or fix typo
  • ! Missing $ inserted → Wrap math in $...$
  • ! Missing } inserted → Fix unmatched brace
  • Citation 'key' undefined → Add to .bib or fix \cite
  • </end{figure}> → Replace with \end{figure} (HTML syntax in LaTeX)

Apply minimal fixes. Do not remove packages unnecessarily. Recompile after each fix.

Step 4: Post-Compilation Report

Check: page count vs venue limit, remaining warnings, chktex style issues.

Troubleshooting

pdflatex not found
# macOS
brew install --cask mactex-no-gui
# Ubuntu
sudo apt install texlive-full
Alternative: latexmk (auto-handles multiple passes)
latexmk -pdf -interaction=nonstopmode main.tex

Related Skills

Comments

Markdown supported