К основному содержанию
скилл CX Codex

latex-setup — скилл для Claude Code: настройка LaTeX

Скилл latex-setup помогает установить и проверить LaTeX на macOS, настроить Skim и SyncTeX. Пригодится при подготовке новой машины или поиске проблем с пакетами.

MIT 146 установок ★ 3 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add terrylica/cc-skills --skill latex-setup -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/latex-setup/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/latex-setup/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Наука и исследования» →
latex-paper-en bahayonghang Скилл latex-paper-en для Claude Code работает с готовой англоязычной статьёй в .tex: чинит сборку и проверяет формат площадки, библиографию и язык. Ведёт по модулям до сдачи. CX Codex +1 6 200установок latex-posters K-Dense-AI Скилл latex-posters собирает научные постеры через три LaTeX-пакета, компилирует PDF и проверяет шрифты перед отправкой в типографию. CX Codex +1 2 300установок latex-formatting lingzhi227 Скилл latex-formatting для Claude Code: готовит LaTeX-шаблоны конференций, чинит форматирование и проверяет статью перед сдачей — до закрытия дедлайна. CX Codex +1 2 300установок latex-document-skill ndpvt-web Скилл latex-document-skill верстает резюме, научные статьи, презентации и формы в LaTeX, собирает их в PDF через скрипты и отдаёт превью страниц в PNG. CX Codex +1 608установок latex-conference-template-organizer Galaxy-Dawn Скилл latex-conference-template-organizer распаковывает перегруженные zip-архивы с шаблонами научных конференций и превращает их в чистую структуру для Overleaf. Пригодится перед подачей статьи, когда нужно убрать лишний код. CX Codex +1 403установок latex-econ-model Awesome Econ AI Community Скилл latex-econ-model генерирует теоретические разделы экономических статей в LaTeX со стандартными обозначениями, задачами оптимизации и уравнениями равновесия. CX Codex +1 147установок

Из того же набора79

Весь набор →
imessage-query Скилл imessage-query читает ~/Library/Messages/chat.db через SQLite: достаёт переписку с контактом, ищет по ключевым словам и вытаскивает текст из бинарного attributedBody. CX Codex +1 159установок clickhouse-architect Скилл clickhouse-architect проектирует схемы ClickHouse v24.4+, подбирает кодеки сжатия и настраивает ключи сортировки под облачные и серверные развёртывания. CX Codex +1 157установок dead-code-detector Скилл dead-code-detector ищет неиспользуемые функции, импорты и файлы в проектах на Python, TypeScript и Rust. Помогает подготовить кодовую базу к релизу и почистить зависимости. CX Codex +1 150установок plotext-financial-chart Скилл plotext-financial-chart строит текстовые финансовые графики в ASCII для Markdown-файлов через plotext. Помогает наглядно показать ценовые уровни прямо в документации на GitHub. CX Codex +1 146установок adaptive-wfo-epoch Скилл adaptive-wfo-epoch подбирает число эпох обучения на каждом фолде walk-forward оптимизации и ранжирует кандидатов по walk-forward efficiency, а не по одному фиксированному значению. CX Codex +1 146установок log-reader Скилл log-reader читает логи MetaTrader 5 и вызовы Print() напрямую из файлов UTF-16LE без ручной проверки вкладки Experts в терминале. CX Codex +1 145установок adr-code-traceability Скилл adr-code-traceability для Claude Code добавляет ссылки на Architecture Decision Records в заголовки новых файлов и комментарии к нетривиальным решениям. Связывает код с архитектурным решением. CX Codex +1 144установок mlflow-python Скилл mlflow-python для Claude Code записывает параметры и метрики бэктестов в MLflow. Ищет эксперименты и получает историю метрик через Python API. CX Codex +1 139установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой