skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
willoscar/research-units-pipeline-skills149 installs

latex-compile-qa

Compile a LaTeX project and run basic QA (missing refs, bib errors, broken citations), producing `latex/main.pdf` and a build report.

How do I install this agent skill?

npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill latex-compile-qa
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is safe. It provides automated LaTeX compilation and quality checks using standard system tools like latexmk and xelatex. The implementation follows security best practices for executing external commands by avoiding shell evaluation, and no malicious behaviors, obfuscation, or data exfiltration attempts were detected.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerpass

    2/2 files flagged

What does this agent skill do?

LaTeX Compile + QA

Triggers & routing

  • Trigger: latex compile, build PDF, LaTeX errors, missing refs, 编译PDF, 引用错误.
  • Use when: 已有 latex/main.tex（通常来自 latex-scaffold），需要确认可编译并输出失败原因报告。

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

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

Quality checklist

  • latex/main.pdf exists only when compilation succeeds; failed builds must remove stale PDFs and explain the failure in output/LATEX_BUILD_REPORT.md.
  • For arxiv-survey-latex deliverables: latex/main.pdf is >= 8 pages and has no undefined citations/references (strict gate).

Script

Quick Start

  • uv run python .codex/skills/latex-compile-qa/scripts/run.py --help
  • uv run python .codex/skills/latex-compile-qa/scripts/run.py --workspace <workspace>

All Options

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

Examples

  • Compile + produce report:
    • uv run python .codex/skills/latex-compile-qa/scripts/run.py --workspace <workspace>

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

Symptom:

  • Report shows missing citations/refs or BibTeX errors.

Causes:

  • citations/ref.bib missing/miswired, or draft contains invalid cite keys.

Solutions:

  • Ensure latex/main.tex points to ../citations/ref.bib (or the correct relative path).
  • Ensure all citation keys exist in citations/ref.bib.

Recovery Checklist

  • Read output/LATEX_BUILD_REPORT.md tail for the first actionable error.
  • Confirm latex/main.tex exists and bibliography path is correct.

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/willoscar/research-units-pipeline-skills/latex-compile-qa">View latex-compile-qa on skillZs</a>