lingzhi227Install Paper Compilation
Pick your agent. Every command is ready to paste.
npx skills add lingzhi227/agent-research-skills --skill paper-compilationThe open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads paper-compilation when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the paper-compilation skill”. In Codex, type $paper-compilation.
Paper Compilation
Compile a LaTeX paper to PDF with error detection and correction.
Input
$ARGUMENTS— Path to the main.texfile
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.bibentry - 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 braceCitation '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
Tips for Paper Compilation
- • Start a fresh session after installing so your agent picks up the new skill.
- • This skill ships scripts. Read them before the first run, and run it in a project without secrets first.
- • It is part of a pack with 30 skills. Install only the ones you need with --skill to keep triggers precise.
- • If two skills overlap, mention the one you want by name.
Questions about Paper Compilation
What does the Paper Compilation skill do?
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.
How do I install Paper Compilation?
Run "npx skills add lingzhi227/agent-research-skills --skill paper-compilation" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does Paper Compilation work in Cursor and Codex?
Yes. Paper Compilation uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
Is Paper Compilation free?
Paper Compilation is open source on GitHub. It is free to install; check the license before commercial use.
Who made Paper Compilation?
Paper Compilation is published by lingzhi227 in the lingzhi227/agent-research-skills repository, together with 29 other skills.
