mcpField
C
compile-latex

compile-latex

github.com/pedrohcgsDocuments1.7k64 installsUpdated 4w ago
Repository

About compile-latex

A skill for compiling Beamer slide decks with XeLaTeX and resolving citations and references. It also checks compilation warnings and reports PDF output details.

Key features

  1. 01Three-pass XeLaTeX compilation
  2. 02BibTeX citation resolution
  3. 03latexmk alternative
  4. 04Warnings for overflow and unresolved references
  5. 05PDF compilation results

Use cases

  1. 01Compiling a Beamer deck with bibliography
  2. 02Checking for overflow or unresolved citations
  3. 03Reporting compilation status and PDF page count

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/pedrohcgs/claude-code-my-workflow --skill compile-latex

After installing, type/compile-latexin Claude Code to confirm it loaded.

Details

From the project README

Compile Beamer LaTeX Slides

Compile a Beamer slide deck using XeLaTeX with full citation resolution.

Steps

  1. Navigate to Slides/ directory and compile with 3-pass sequence:
cd Slides
TEXINPUTS=../Preambles:$TEXINPUTS xelatex -interaction=nonstopmode $ARGUMENTS.tex
BIBINPUTS=..:$BIBINPUTS bibtex $ARGUMENTS
TEXINPUTS=../Preambles:$TEXINPUTS xelatex -interaction=nonstopmode $ARGUMENTS.tex
TEXINPUTS=../Preambles:$TEXINPUTS xelatex -interaction=nonstopmode $ARGUMENTS.tex

Alternative (latexmk):

cd Slides
TEXINPUTS=../Preambles:$TEXINPUTS BIBINPUTS=..:$BIBINPUTS latexmk -xelatex -interaction=nonstopmode $ARGUMENTS.tex

  1. Check for warnings:

    • Grep output for Overfull \\hbox warnings
    • Grep for undefined citations or Label(s) may have changed
    • Report any issues found

  2. Open the PDF for visual verification:

    open Slides/$ARGUMENTS.pdf          # macOS
# xdg-open Slides/$ARGUMENTS.pdf    # Linux

  3. Report results:

    • Compilation success/failure
    • Number of overfull hbox warnings
    • Any undefined citations
    • PDF page count

Why 3 passes?

  1. First xelatex: Creates .aux file with citation keys
  2. bibtex: Reads .aux, generates .bbl with formatted references
  3. Second xelatex: Incorporates bibliography
  4. Third xelatex: Resolves all cross-references with final page numbers

Important

  • Always use XeLaTeX, never pdflatex
  • TEXINPUTS is required: your Beamer theme lives in Preambles/
  • BIBINPUTS is required: your .bib file lives in the repo root

Comments

Markdown supported