paper-compilation

Q: How do I install paper-compilation?

Run npx skills add https://github.com/lingzhi227/agent-research-skills --skill paper-compilation in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/paper-compilation/ (personal) or .claude/skills/paper-compilation/ (project).

by lingzhi227Education & Science

Compile LaTeX papers to PDF with automatic error detection, chktex style checking, and citation/reference validation. Runs the full pdflatex + bibtex pipeline. Use when the user wants to compile a paper, fix compilation errors, or debug LaTeX.

Installs: 1.6K
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

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

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads paper-compilation automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

Upstream: latex-formatting, citation-management, figure-generation, table-generation
Downstream: self-review
See also: paper-assembly

FAQ

What does the paper-compilation skill do?

How do I install paper-compilation?

Run npx skills add https://github.com/lingzhi227/agent-research-skills --skill paper-compilation in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/paper-compilation/ (personal) or .claude/skills/paper-compilation/ (project).

Which AI agents can use paper-compilation?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is paper-compilation safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains paper-compilation?

It is published by lingzhi227 in lingzhi227/agent-research-skills. It has 1,605 recorded installs.