| name | latex-build |
| description | LaTeX builds with latexmk and live preview. TRIGGERS - latexmk, LaTeX build, live preview, compilation. |
| allowed-tools | Read, Edit, Bash |
LaTeX Build Automation
Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.
When to Use This Skill
Use this skill when:
- Compiling LaTeX documents
- Setting up live preview with auto-rebuild
- Managing multi-file projects
- Troubleshooting build failures
- Cleaning build artifacts
- Automating compilation workflows
Quick Reference
Why latexmk?
Industry standard build tool:
- Auto-detects dependencies (bibliography, index, etc.)
- Runs correct number of times (handles cross-references)
- Live preview mode watches for file changes
- Works with Skim for SyncTeX auto-reload
- Bundled with MacTeX (no separate install needed)
Basic Usage
One-Time Build
latexmk -pdf document.tex
Live Preview (Watch Mode)
latexmk -pvc -pdf document.tex
Stop watching: Press Ctrl+C
Quick Reference Card
latexmk -pdf document.tex
latexmk -pvc -pdf document.tex
latexmk -pdf -synctex=1 document.tex
latexmk -c
latexmk -C
latexmk -gg -pdf document.tex
latexmk -pdf -interaction=nonstopmode document.tex
Build Checklist
Reference Documentation
For detailed information, see:
Official Docs: Run man latexmk or latexmk -help for complete reference
See Also:
- Use
latex/setup skill for installing LaTeX and configuring environment
- Use
latex/tables skill for creating tables with tabularray
Troubleshooting
| Issue | Cause | Solution |
|---|
| latexmk not found | Not in PATH | Add /Library/TeX/texbin to PATH |
| Undefined control sequence | Missing package | Check \usepackage statements for required packages |
| References show ?? | Need multiple runs | latexmk handles this automatically; ensure no errors |
| Live preview not updating | Skim auto-reload disabled | Skim Preferences → Sync → Check for file changes |
| Build hangs | Input prompt in nonstop mode | Use -interaction=nonstopmode flag |
| PDF not updating | Build error preventing output | Check .log file for specific error |
| SyncTeX not working | Missing -synctex=1 flag | Add -synctex=1 to build command |
| Too many aux files | Normal build artifacts | Run latexmk -c to clean (keeps PDF) |
Post-Execution Reflection
After this skill completes, check before closing:
- Did the command succeed? — If not, fix the instruction or error table that caused the failure.
- Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
- Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.
Only update if the issue is real and reproducible — not speculative.