# paper-compilation

Собирает LaTeX-статью в PDF, ловит ошибки компиляции и проверяет ссылки с цитатами. Пригодится, когда pdflatex сыпет ошибками, а разбираться в логе не хочется.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1600 установок · ★ 433
- Автор: lingzhi227
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/lingzhi227/agent-research-skills/tree/HEAD/skills/paper-compilation/SKILL.md
- Обновлён: 2026-02-27
- HTML: https://affpapa.org/nevibecode/skills/paper-compilation

## Что делает

Скилл запускает полный конвейер `pdflatex → bibtex → pdflatex → pdflatex` и возвращает отчёт: статус сборки, число страниц, предупреждения, статистику по цитатам и ссылкам. Перед сборкой можно прогнать проверку: у каждой `\cite{key}` находится запись в `.bib`, каждый `\includegraphics{file}` существует, дубликатов меток нет.

Внутри три скрипта. `compile_paper.py` собирает PDF, умеет `--check-style` для chktex и `--auto-fix` — тогда он вызывает `fix_latex_errors.py` и пересобирает до 3 раундов. Сам `fix_latex_errors.py` правит HTML-теги в LaTeX, несогласованные окружения и пропавшие картинки, есть флаги `--dry-run` и `--auto-detect`. Если сборка всё равно падает, скилл читает лог и правит по одной ошибке за проход, до 5 раундов.

Нужен установленный `pdflatex`: на macOS это `brew install --cask mactex-no-gui`, на Ubuntu — `sudo apt install texlive-full`. Без него скрипты просто не стартуют, так что проверьте это до первого запуска. Путь к главному `.tex` передаётся аргументом.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingzhi227/agent-research-skills --skill paper-compilation -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/paper-compilation/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/paper-compilation/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingzhi227/agent-research-skills --skill paper-compilation -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/paper-compilation/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingzhi227/agent-research-skills --skill paper-compilation -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/paper-compilation/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install lingzhi227/agent-research-skills paper-compilation
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/paper-compilation/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingzhi227/agent-research-skills --skill paper-compilation -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/lingzhi227/agent-research-skills --path skills/paper-compilation
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/paper-compilation/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add lingzhi227/agent-research-skills --skill paper-compilation -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/lingzhi227/agent-research-skills/tree/HEAD/skills/paper-compilation/SKILL.md

## Когда брать
- собрать PDF из LaTeX-статьи одной командой
- найти причину падения pdflatex по логу
- проверить, что все цитаты есть в .bib
- починить HTML-теги и несогласованные окружения в .tex
- сверить число страниц с лимитом площадки

## Примеры запросов агенту
- собери paper/main.tex в PDF и покажи отчёт
- прогони paper/main.tex с проверкой стиля chktex
- пересобери с автоисправлением ошибок: paper/main.tex --auto-fix

## Похожие
- [paper-writing](https://affpapa.org/nevibecode/skills/paper-writing.md) — скилл · 561 установка
- [paper-compile](https://affpapa.org/nevibecode/skills/paper-compile.md) — скилл · 507 установок
- [paper-2-web](https://affpapa.org/nevibecode/skills/paper-2-web.md) — скилл · 133 установки
- [read-arxiv-paper](https://affpapa.org/nevibecode/skills/read-arxiv-paper.md) — скилл · 2800 установок
- [nature-paper-card](https://affpapa.org/nevibecode/skills/nature-paper-card.md) — скилл · 10500 установок
- [latex-posters](https://affpapa.org/nevibecode/skills/k-dense-ai-latex-posters.md) — скилл · 2000 установок

Из того же набора: [lingzhi227/agent-research-skills](https://affpapa.org/nevibecode/by/lingzhi227/agent-research-skills.md) — 23 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md