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.

⭐4stars🔀0forks📁View on GitHub🕐Updated Jan 4, 2026⬇️2downloads

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.
namelatex-setup
descriptionInstalls 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-toolsRead, 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
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 --version shows TeX Live 2025
  • Verify latexmk --version shows 4.86a+
  • Verify pdflatex test.tex creates PDF
  • Install Skim if using mactex-no-gui
  • Test SyncTeX: compile with -synctex=1 flag
  • Configure Skim preferences for editor integration
  • Add /Library/TeX/texbin to PATH if needed
  • Test package installation: sudo tlmgr install <package>

Reference Documentation

For detailed information, see:

See Also:

  • Build Workflows: Use latex/build skill for latexmk automation
  • Table Creation: Use latex/tables skill for tabularray usage