paper-compile

Compile LaTeX projects into submission-ready PDFs with latexmk and auto-fix errors.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill paper-compile-kyrie66nb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paper-compile
Source: https://github.com/KYRIE66nb/codex-omx-public-config/tree/main/home/.codex/skills/paper-compile
Command: npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill paper-compile-kyrie66nb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool automates the compilation of LaTeX projects into a submission-ready PDF, handling common build errors and ensuring a clean final document.

Core Features & Use Cases

  • Automated LaTeX build: runs latexmk with pdflatex (and optional engines) to produce main.pdf.
  • Error diagnosis & auto-fix: detects missing packages, undefined references, missing figures, and common BibTeX errors, attempting fixes and re-compiling.
  • Validation & readiness checks: verifies required files exist, checks page count against MAX_PAGES, and prepares a clean artifact for submission.
  • Use Case: use when preparing conference submissions or theses that require a reliable, repeatable build pipeline.

Quick Start

Provide your LaTeX project in the paper/ directory and run the skill to build, fix, and verify a submission-ready PDF.

Frequently Asked Questions about paper-compile

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate compiling a LaTeX project into a PDF?

Automating LaTeX compilation involves using latexmk with pdflatex to run multi-pass builds, diagnose missing packages or undefined references, and auto-fix common errors to produce a submission-ready PDF.

Why does my LaTeX build fail due to undefined references and missing packages?

LaTeX builds often fail due to missing packages, undefined references, or BibTeX errors. An automated build loop can detect these issues, apply fixes, and re-compile the project up to three attempts for a successful PDF.

Can I use xelatex or lualatex instead of pdflatex to build my academic paper?

Yes, you can use xelatex or lualatex instead of pdflatex. The compilation process supports these alternative engines alongside latexmk to handle your academic paper or thesis source files and generate the final document.

What is the best way to ensure my thesis PDF stays within a maximum page limit?

To ensure a thesis PDF stays within page limits, use an automated build pipeline that checks the final page count against a defined MAX_PAGES threshold during compilation to validate submission readiness before outputting the document.

What LaTeX files do I need before running an automated PDF build pipeline?

You need your LaTeX source files organized under a paper/ directory. The build pipeline specifically checks for required files like main.tex and references.bib to validate the project structure before starting the latexmk compilation process.

LaTeX compilation not working after multiple attempts, what are the limitations?

LaTeX compilation limitations include an auto-fix loop restricted to a maximum of three compile attempts. If missing figures or complex BibTeX errors persist beyond these tries, the build will stop and report the issue via compile logs.