latex-setup
Installs and configures complete LaTeX development environment on macOS with MacTeX, Skim viewer, and SyncTeX support. Use when setting up new machine, installing LaTeX, or configuring PDF viewer.
When & Why to Use This Skill
This Claude skill automates the comprehensive setup of a LaTeX development environment specifically for macOS. It streamlines the installation of the MacTeX distribution, configures the Skim PDF viewer for seamless SyncTeX integration, and provides automated verification steps to ensure a production-ready document preparation workflow.
Use Cases
- New Workstation Provisioning: Rapidly install and configure the full 4.5GB MacTeX distribution and essential tools on a fresh macOS machine using automated commands.
- Academic Workflow Optimization: Setting up the Skim PDF viewer with SyncTeX to enable bidirectional navigation between LaTeX source code and the rendered PDF output.
- Installation Troubleshooting & Health Checks: Verifying TeX Live versions, PATH environment variables, and testing PDF compilation to identify and fix configuration issues.
- LaTeX Package Management: Utilizing the TeX Live Manager (tlmgr) to search for, install, and update specific LaTeX packages required for complex document formatting.
| name | latex-setup |
|---|---|
| description | Installs and configures complete LaTeX development environment on macOS with MacTeX, Skim viewer, and SyncTeX support. Use when setting up new machine, installing LaTeX, or configuring PDF viewer. |
| allowed-tools | Read, Edit, Bash |
LaTeX Environment Setup
Quick Reference
When to use this skill:
- Installing LaTeX on a new machine
- Setting up MacTeX distribution
- Configuring Skim PDF viewer with SyncTeX
- Verifying LaTeX installation
- Troubleshooting missing packages
Recommended Stack
| Component | Purpose | Status |
|---|---|---|
| MacTeX 2025 | Full LaTeX distribution (TeX Live 2025) | ✅ Recommended |
| Skim 1.7.11 | PDF viewer with SyncTeX support | ✅ macOS only |
| TeXShop 5.57 | Integrated LaTeX IDE (optional) | ✅ Native macOS |
Quick Start
Install MacTeX
brew install --cask mactex
# Size: ~4.5 GB (includes everything)
Verify Installation
tex --version
# Expected: TeX 3.141592653 (TeX Live 2025)
pdflatex --version
latexmk --version
Test Compilation
echo '\documentclass{article}\begin{document}Hello World!\end{document}' > test.tex
pdflatex test.tex
ls test.pdf # Verify PDF created
Post-Installation Checklist
- Verify
tex --versionshows TeX Live 2025 - Verify
latexmk --versionshows 4.86a+ - Verify
pdflatex test.texcreates PDF - Install Skim if using mactex-no-gui
- Test SyncTeX: compile with
-synctex=1flag - Configure Skim preferences for editor integration
- Add
/Library/TeX/texbinto PATH if needed - Test package installation:
sudo tlmgr install <package>
Reference Documentation
For detailed information, see:
- Installation - Full MacTeX vs lightweight options, Skim installation
- Verification - Check installation, verify PATH, test compilation
- Package Management - Check, install, search for packages with tlmgr
- Skim Configuration - Enable SyncTeX, configure preferences for editor integration
- Troubleshooting - PATH issues, tlmgr problems, permissions
See Also:
- Build Workflows: Use
latex/buildskill for latexmk automation - Table Creation: Use
latex/tablesskill for tabularray usage