lingzhi227/agent-research-skills

paper-compilation

Compile LaTeX papers to PDF with automatic error detection, chktex style checking, and citation/reference validation.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/lingzhi227/agent-research-skills --skill paper-compilation

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Paper Compilation

Compile a LaTeX paper to PDF with error detection and correction.

Input

  • $ARGUMENTS — Path to the main .tex file

Scripts

Compile paper

bash
python ~/.claude/skills/paper-compilation/scripts/compile_paper.py paper/main.tex
python ~/.claude/skills/paper-compilation/scripts/compile_paper.py paper/main.tex --check-style
python ~/.claude/skills/paper-compilation/scripts/compile_paper.py paper/main.tex --output paper/output.pdf

Reports: compilation status, page count, warnings, citation/reference stats, style issues.

Validate citations before compiling

bash
python ~/.claude/skills/citation-management/scripts/validate_citations.py \
  --tex paper/main.tex --bib paper/references.bib --check-figures --figures-dir paper/figures/

Auto-fix LaTeX errors

bash
python ~/.claude/skills/paper-compilation/scripts/fix_latex_errors.py \
  --tex paper/main.tex --log compile.log --output paper/main_fixed.tex

Fixes: HTML tags in LaTeX, mismatched environments, missing figures. Key flags: --dry-run, --auto-detect

Compile with auto-fix retry

bash
python ~/.claude/skills/paper-compilation/scripts/compile_paper.py paper/main.tex --auto-fix

Runs fixlatexerrors.py + recompile up to 3 rounds until compilation succeeds.

Workflow

Step 1: Pre-Compilation Validation

Run validate_citations.py to catch issues before compiling:

  • Every \cite{key} has a matching .bib entry
  • Every \includegraphics{file} exists
  • No duplicate labels or sections

Step 2: Compile

Run compile_paper.py which executes: pdflatex → bibtex → pdflatex → pdflatex

Step 3: Error Correction Loop (up to 5 rounds)

If compilation fails, read the error output and fix:

  • ! Undefined control sequence → Add missing package or fix typo
  • ! Missing $ inserted → Wrap math in $...$
  • ! Missing } inserted → Fix unmatched brace
  • Citation 'key' undefined → Add to .bib or fix \cite
  • </end{figure}> → Replace with \end{figure} (HTML syntax in LaTeX)

Apply minimal fixes. Do not remove packages unnecessarily. Recompile after each fix.

Step 4: Post-Compilation Report

Check: page count vs venue limit, remaining warnings, chktex style issues.

Troubleshooting

pdflatex not found

bash
# macOS
brew install --cask mactex-no-gui
# Ubuntu
sudo apt install texlive-full

Alternative: latexmk (auto-handles multiple passes)

bash
latexmk -pdf -interaction=nonstopmode main.tex

Related Skills

관련 작업

같은 저장소의 Skills

더 많은 Skills

모든 Skills