paper-compilation — скилл для Claude Code: сборка LaTeX в PDF
Собирает LaTeX-статью в PDF, ловит ошибки компиляции и проверяет ссылки с цитатами. Пригодится, когда pdflatex сыпет ошибками, а разбираться в логе не хочется.
npx skills add lingzhi227/agent-research-skills --skill paper-compilation -a claude-codeЧто делает 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 передаётся аргументом.
Какие задачи решает
- собрать PDF из LaTeX-статьи одной командой
- найти причину падения pdflatex по логу
- проверить, что все цитаты есть в .bib
- починить HTML-теги и несогласованные окружения в .tex
- сверить число страниц с лимитом площадки
Примеры запросов агенту
- собери paper/main.tex в PDF и покажи отчёт
- прогони paper/main.tex с проверкой стиля chktex
- пересобери с автоисправлением ошибок: paper/main.tex --auto-fix
Как установить paper-compilation
1Через Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill paper-compilation -a claude-code2Вручную: положить файлы
~/.claude/skills/paper-compilation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/paper-compilation/
1Через Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill paper-compilation -a codex2Вручную: положить файлы
.agents/skills/paper-compilation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill paper-compilation -a cursor2Вручную: положить файлы
.cursor/skills/paper-compilation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install lingzhi227/agent-research-skills paper-compilation2Вручную: положить файлы
.github/skills/paper-compilation/SKILL.md1Через Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill paper-compilation -a gemini-cli2Командой платформы
gemini skills install https://github.com/lingzhi227/agent-research-skills --path skills/paper-compilationВручную: положить файлы
.devin/skills/paper-compilation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill paper-compilation -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о paper-compilation
Как установить paper-compilation в Claude?
Выполните npx skills add lingzhi227/agent-research-skills --skill paper-compilation -a claude-code. После этого файл скилла лежит в ~/.claude/skills/paper-compilation/SKILL.md.
Что делает paper-compilation?
Собирает LaTeX-статью в PDF через pdflatex и bibtex, проверяет цитаты и ссылки, а при ошибках правит .tex и пересобирает.
Что нужно, чтобы скилл заработал?
Установленный pdflatex. На macOS его ставят через brew install --cask mactex-no-gui, на Ubuntu — через sudo apt install texlive-full.
