latex-setup — скилл для Claude Code: настройка LaTeX
Скилл latex-setup помогает установить и проверить LaTeX на macOS, настроить Skim и SyncTeX. Пригодится при подготовке новой машины или поиске проблем с пакетами.
MIT 146 установок ★ 3 обновлён 2026-10-25
npx skills add terrylica/cc-skills --skill latex-setup -a claude-codeЧто делает latex-setup
Скилл проводит через установку MacTeX, проверку команд tex, pdflatex и latexmk, а также тестовую сборку PDF. В инструкции есть и вариант BasicTeX для случаев, когда полный TeX Live занимает слишком много места.
Для просмотра PDF можно настроить Skim и проверить SyncTeX: документ нужно скомпилировать с флагом -synctex=1. Если команда tex не находится, добавьте /Library/TeX/texbin в PATH — без этого LaTeX-команды могут не запускаться из shell.
Скилл также описывает поиск и установку пакетов через tlmgr и разбор типичных ошибок. Для системных пакетов инструкция использует sudo; TeXShop упомянут как необязательная IDE.
Какие задачи решает
- установить MacTeX на новый Mac
- проверить, что LaTeX собирает PDF
- настроить просмотр PDF в Skim с SyncTeX
- найти пакет в TeX Live и установить его через
tlmgr - разобраться, почему shell не находит
tex
Примеры запросов агенту
- Помоги установить LaTeX на моём Mac и проверить сборку PDF.
- Настрой Skim для SyncTeX и подскажи, как проверить переход между исходником и PDF.
- Найди нужный пакет TeX Live и установи его через
tlmgr.
Как установить latex-setup
1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill latex-setup -a claude-code2Вручную: положить файлы
~/.claude/skills/latex-setup/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/latex-setup/
1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill latex-setup -a codex2Вручную: положить файлы
.agents/skills/latex-setup/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill latex-setup -a cursor2Вручную: положить файлы
.cursor/skills/latex-setup/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install terrylica/cc-skills plugins/doc-tools/skills/latex-setup2Вручную: положить файлы
.github/skills/latex-setup/SKILL.md1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill latex-setup -a gemini-cli2Командой платформы
gemini skills install https://github.com/terrylica/cc-skills --path plugins/doc-tools/skills/latex-setupВручную: положить файлы
.devin/skills/latex-setup/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill latex-setup -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о latex-setup
Как установить latex-setup в Claude Code?
Выполните npx skills add terrylica/cc-skills --skill latex-setup -a claude-code. Файл скилла находится по пути ~/.claude/skills/latex-setup/SKILL.md.
Что делает latex-setup?
Помогает установить и проверить LaTeX на macOS, настроить Skim с SyncTeX и решать проблемы с пакетами и путём PATH.
Что нужно для работы SyncTeX со Skim?
Скомпилируйте документ с флагом -synctex=1 и настройте параметры Skim для интеграции с редактором.
Исходный текст
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