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枠、ファイルへのアクセス許可は含まれません。
  • スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

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
lingzhi227
コミュニティ

backward-traceability

Make every number in the final PDF traceable to the exact code line that produced it. Uses \hypertarget/\hyperlink LaTeX commands and \num{formula} evaluated at compile time. Use for reproducibility and data integrity verification.

1時間の導入数
2
GitHub Stars
451
更新日
2月27日
lingzhi227
コミュニティ

experiment-code

Write ML experiment code with iterative improvement. Generate training/evaluation pipelines, debug errors, and optimize results through code reflection. Use when implementing experiments for a research paper.

1時間の導入数
1
GitHub Stars
420
更新日
2月27日
lingzhi227
コミュニティ

paper-assembly

Orchestrate the full paper pipeline end-to-end. Manage state propagation between phases (literature → plan → code → experiments → figures → tables → writing → review), support checkpointing and resumption. Use for assembling a complete paper from components.

1時間の導入数
1
GitHub Stars
420
更新日
2月27日
lingzhi227
コミュニティ

literature-review

Conduct comprehensive literature reviews using multi-perspective dialogue simulation. Generate diverse expert personas, conduct grounded Q&A conversations, and synthesize findings into structured knowledge. Use when starting a new research project or writing a survey section.

1時間の導入数
1
GitHub Stars
414
更新日
2月27日