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
- Run the checker script:
python3.12 skills/tex-environment-check/scripts/check_tex_env.py docs/tex-env-report.md
- Review key sections in the report:
- Binary paths and versions.
- TeX Live root (
basicvs full install). - Package availability.
- Smoke test results for
pdflatex,xelatex, andlualatex.
- If LuaLaTeX fails with cache errors, rerun builds with a writable cache:
TEXMFVAR="$PWD/.texmf-var" lualatex -interaction=nonstopmode -halt-on-error file.tex
- Keep the report in version control when reproducibility matters.
Notes
- Treat
pdflatex+xelatexsuccess as baseline viability for this repo. - Treat missing packages as install-time requirements and record them in project docs.