latex-compile-qa

Original：🇺🇸 English

Translated

1 scriptsChecked / no sensitive code detected

Compile a LaTeX project and run basic QA (missing refs, bib errors, broken citations), producing `latex/main.pdf` and a build report. **Trigger**: latex compile, build PDF, LaTeX errors, missing refs, 编译PDF, 引用错误. **Use when**: 已有 `latex/main.tex`（通常来自 `latex-scaffold`），需要确认可编译并输出失败原因报告。 **Skip if**: 还没有 LaTeX scaffold（先跑 `latex-scaffold`）。 **Network**: none. **Guardrail**: 编译失败也要落盘 `output/LATEX_BUILD_REPORT.md`；不做“内容改写”，只做编译/QA。

1installs

Sourcewilloscar/research-units-pipeline-skills

Added on2026-02-04

NPX Install

npx skill4agent add willoscar/research-units-pipeline-skills latex-compile-qa

SKILL.md Content

View Translation Comparison →

LaTeX Compile + QA

Compile the LaTeX project and produce a PDF (when the toolchain is available), plus a short build report.

This step is deterministic; if compilation fails, record actionable diagnostics rather than guessing.

Inputs

```
latex/main.tex
```
```
citations/ref.bib
```

Outputs

```
latex/main.pdf
```
(if compilation succeeds)
```
output/LATEX_BUILD_REPORT.md
```
(recommended)

Workflow

Run a LaTeX build (e.g.,
```
latexmk
```
) if available.
Fix missing packages, missing bib entries, and unresolved references.
Record remaining issues in a build report.

Quality checklist

Either
```
latex/main.pdf
```
exists, or
```
output/LATEX_BUILD_REPORT.md
```
explains why compilation failed.
For
```
arxiv-survey-latex
```
deliverables:
```
latex/main.pdf
```
is >= 8 pages and has no undefined citations/references (strict gate).

Script

Quick Start

python .codex/skills/latex-compile-qa/scripts/run.py --help

python .codex/skills/latex-compile-qa/scripts/run.py --workspace <workspace_dir>

All Options

See
```
--help
```
(inputs/outputs are taken from the unit runner when used via pipeline)

Examples

Compile + produce report:

python .codex/skills/latex-compile-qa/scripts/run.py --workspace <ws>

Notes

Uses
```
latexmk -xelatex -bibtex
```
when available.
Always writes
```
output/LATEX_BUILD_REPORT.md
```
(success or failure).
Report includes page count + warning summary when available.

Troubleshooting

Common Issues

Issue:

latexmk

not found

Symptom:

Build report says “latexmk not found in PATH”.

Causes:

LaTeX toolchain is not installed.

Solutions:

Install a TeX distribution that includes
```
latexmk
```
.
If you can’t install tools, still use
```
latex-scaffold
```
to generate
```
latex/main.tex
```
and compile elsewhere.

Issue: Build fails with bib/ref errors