latex-setup — Claude Code skill: LaTeX setup
The latex-setup skill sets up and verifies LaTeX on macOS, then configures Skim and SyncTeX. It supports Mac preparation and TeX package troubleshooting.
MIT 146 installs ★ 3 updated 2026-10-25
npx skills add terrylica/cc-skills --skill latex-setup -a claude-codeWhat latex-setup does
The skill walks through installing MacTeX, checking tex, pdflatex and latexmk, and compiling a test PDF. It also points to BasicTeX when the full TeX Live distribution takes too much disk space.
To view PDFs in Skim, configure SyncTeX and compile with the -synctex=1 flag. If the shell cannot find tex, add /Library/TeX/texbin to PATH; otherwise LaTeX commands may not run from that shell.
The instructions cover finding and installing packages with tlmgr, plus common setup errors. System package installs use sudo. TeXShop is included as an optional IDE.
What it helps with
- install MacTeX on a new Mac
- check that LaTeX can compile a PDF
- configure Skim to use SyncTeX
- find and install a TeX Live package with
tlmgr - fix a shell that cannot find
tex
Example prompts for the agent
- Set up LaTeX on my Mac and check that it can compile a PDF.
- Configure Skim for SyncTeX and show me how to test source-to-PDF navigation.
- Find the TeX Live package I need and install it with
tlmgr.
How to install latex-setup
1Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill latex-setup -a claude-code2Manually: put the files in place
~/.claude/skills/latex-setup/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/latex-setup/
1Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill latex-setup -a codex2Manually: put the files in place
.agents/skills/latex-setup/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill latex-setup -a cursor2Manually: put the files in place
.cursor/skills/latex-setup/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install terrylica/cc-skills plugins/doc-tools/skills/latex-setup2Manually: put the files in place
.github/skills/latex-setup/SKILL.md1Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill latex-setup -a gemini-cli2Platform CLI
gemini skills install https://github.com/terrylica/cc-skills --path plugins/doc-tools/skills/latex-setupManually: put the files in place
.devin/skills/latex-setup/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill latex-setup -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about latex-setup
How do I install latex-setup in Claude Code?
Run npx skills add terrylica/cc-skills --skill latex-setup -a claude-code. The skill file is at ~/.claude/skills/latex-setup/SKILL.md.
What does latex-setup do?
It guides LaTeX installation and verification on macOS, Skim and SyncTeX configuration, and troubleshooting for packages and PATH.
How do I use SyncTeX with Skim?
Compile the document with -synctex=1, then configure Skim preferences for editor integration.
Source text
SKILL.md · MIT
---
name: latex-setup
description: LaTeX environment setup on macOS. TRIGGERS - install LaTeX, MacTeX, Skim viewer, SyncTeX setup.
allowed-tools: Read, Edit, Bash
disable-model-invocation: false
---
# LaTeX Environment Setup
> **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:
- Installing LaTeX on a new machine
- Setting up MacTeX distribution
- Configuring Skim PDF viewer with SyncTeX
- Verifying LaTeX installation
- Troubleshooting missing packages
## Quick Reference
## 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
```bash
brew install --cask mactex
# Size: ~4.5 GB (includes everything)
```
### Verify Installation
```bash
tex --version
# Expected: TeX 3.141592653 (TeX Live 2025)
pdflatex --version
latexmk --version
```
### Test Compilation
```bash
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:
- [Installation](./references/installation.md) - Full MacTeX vs lightweight options, Skim installation
- [Verification](./references/verification.md) - Check installation, verify PATH, test compilation
- [Package Management](./references/package-management.md) - Check, install, search for packages with tlmgr
- [Skim Configuration](./references/skim-configuration.md) - Enable SyncTeX, configure preferences for editor integration
- [Troubleshooting](./references/troubleshooting.md) - PATH issues, tlmgr problems, permissions
**See Also**:
- Build Workflows: Use `latex/build` skill for latexmk automation
- Table Creation: Use `latex/tables` skill for tabularray usage
---
## Troubleshooting
| Issue | Cause | Solution |
| ------------------------- | ----------------------------- | -------------------------------------------------- |
| tex command not found | PATH not configured | Add `/Library/TeX/texbin` to PATH in shell profile |
| Permission denied (tlmgr) | Need sudo for system packages | Use `sudo tlmgr install <package>` |
| Package not found | Missing from TeX Live | Run `tlmgr search <package>` to find correct name |
| Skim not showing PDF | SyncTeX not enabled | Compile with `-synctex=1` flag |
| Outdated TeX Live | Old MacTeX version | Run `sudo tlmgr update --self --all` |
| Compilation hangs | Infinite loop in document | Check for circular includes or missing \end{} |
| Missing font error | Font not in TeX distribution | Install with `tlmgr install <font-package>` |
| Disk space error | Full TeX Live too large | Consider BasicTeX (smaller) if space limited |
## Post-Execution Reflection
After this skill completes, check before closing:
1. **Did the command succeed?** — If not, fix the instruction or error table that caused the failure.
2. **Did parameters or output change?** — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. **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.
© terrylica · MIT · terrylica/cc-skills