tex-environment-check

star 0

Verify and document local TeX/LaTeX installations (especially BasicTeX on macOS) with smoke tests, package checks, and reproducibility notes. Use when you need to confirm whether LaTeX is available, diagnose engine-specific issues (for example LuaLaTeX cache paths), or generate a Markdown report for project setup docs.

arivero By arivero schedule Updated 2/14/2026

name: tex-environment-check description: Verify and document local TeX/LaTeX installations (especially BasicTeX on macOS) with smoke tests, package checks, and reproducibility notes. Use when you need to confirm whether LaTeX is available, diagnose engine-specific issues (for example LuaLaTeX cache paths), or generate a Markdown report for project setup docs.

TeX Environment Check

Run a deterministic audit and generate a report.

Workflow

  1. Run the checker script:
python3.12 skills/tex-environment-check/scripts/check_tex_env.py docs/tex-env-report.md
  1. Review key sections in the report:
  • Binary paths and versions.
  • TeX Live root (basic vs full install).
  • Package availability.
  • Smoke test results for pdflatex, xelatex, and lualatex.
  1. If LuaLaTeX fails with cache errors, rerun builds with a writable cache:
TEXMFVAR="$PWD/.texmf-var" lualatex -interaction=nonstopmode -halt-on-error file.tex
  1. Keep the report in version control when reproducibility matters.

Notes

  • Treat pdflatex + xelatex success as baseline viability for this repo.
  • Treat missing packages as install-time requirements and record them in project docs.
Install via CLI
npx skills add https://github.com/arivero/firstProof --skill tex-environment-check
Repository Details
star Stars 0
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator