latex-build

Name: latex-build
Author: terrylica

github.com/terrylicaDocuments1232 installsUpdated 1d ago

About latex-build

A skill for compiling and managing LaTeX document builds, intended for writers and developers handling single- or multi-file projects. It centers on latexmk commands for repeat builds, file watching, SyncTeX, and cleanup.

Key features

01One-time PDF compilation with latexmk
02Watch mode with automatic rebuilds
03SyncTeX build options
04Multi-file dependency handling
05Build artifact cleanup

Use cases

01Compile a LaTeX document to PDF
02Preview edits through automatic rebuilds
03Clean auxiliary build files

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/terrylica/cc-skills --skill latex-build

After installing, type/latex-buildin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/

advanced-patterns.md

common-commands.md

configuration.md

evolution-log.md

multi-file-projects.md

troubleshooting.md

Details

From the project README

LaTeX Build Automation

Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

When to Use This Skill

Use this skill when:

Compiling LaTeX documents
Setting up live preview with auto-rebuild
Managing multi-file projects
Troubleshooting build failures
Cleaning build artifacts
Automating compilation workflows

Quick Reference

Why latexmk?

Industry standard build tool:

Auto-detects dependencies (bibliography, index, etc.)
Runs correct number of times (handles cross-references)
Live preview mode watches for file changes
Works with Skim for SyncTeX auto-reload
Bundled with MacTeX (no separate install needed)

Basic Usage

One-Time Build

latexmk -pdf document.tex
# Result: document.pdf created

Live Preview (Watch Mode)

latexmk -pvc -pdf document.tex

# What happens:
# - Compiles document initially
# - Watches for file changes
# - Auto-recompiles when files change
# - Auto-reloads PDF in Skim viewer

Stop watching: Press Ctrl+C

Quick Reference Card

# Build once
latexmk -pdf document.tex

# Live preview (watch mode)
latexmk -pvc -pdf document.tex

# Build with SyncTeX
latexmk -pdf -synctex=1 document.tex

# Clean artifacts
latexmk -c              # Keep PDF
latexmk -C              # Remove PDF too

# Force rebuild
latexmk -gg -pdf document.tex

# Non-interactive (for CI)
latexmk -pdf -interaction=nonstopmode document.tex

Build Checklist

Verify latexmk installed: which latexmk
Test basic build: latexmk -pdf document.tex
Enable SyncTeX: Add -synctex=1 flag
Test live preview: latexmk -pvc -pdf document.tex
Configure Skim for auto-reload
Create Makefile for common tasks (optional)
Create .latexmkrc for project-specific settings (optional)
Test clean: latexmk -c removes artifacts

Reference Documentation

For detailed information, see:

Common Commands - Build options and output formats
Multi-File Projects - Automatic dependency tracking for complex documents
Configuration - .latexmkrc and Makefile integration
Troubleshooting - Common build issues and solutions
Advanced Patterns - Parallel builds and CI/CD integration

Official Docs: Run man latexmk or latexmk -help for complete reference

See Also:

Use latex/setup skill for installing LaTeX and configuring environment
Use latex/tables skill for creating tables with tabularray

Troubleshooting

Issue	Cause	Solution
latexmk not found	Not in PATH	Add `/Library/TeX/texbin` to PATH
Undefined control sequence	Missing package	Check `\usepackage` statements for required packages
References show ??	Need multiple runs	latexmk handles this automatically; ensure no errors
Live preview not updating	Skim auto-reload disabled	Skim Preferences → Sync → Check for file changes
Build hangs	Input prompt in nonstop mode	Use `-interaction=nonstopmode` flag
PDF not updating	Build error preventing output	Check .log file for specific error
SyncTeX not working	Missing -synctex=1 flag	Add `-synctex=1` to build command
Too many aux files	Normal build artifacts	Run `latexmk -c` to clean (keeps PDF)

Post-Execution Reflection

After this skill completes, check before closing:

Did the command succeed? — If not, fix the instruction or error table that caused the failure.
Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.

Comments

Markdown supported

Details

Author: terrylica
Repository: terrylica/cc-skills
Category: Documents
Installs: 232
GitHub stars: 1

Report

More skills

All skills

handoff

github.com/mattpocock

1.1M

Compact the current conversation into a handoff document for another agent to pick up

lark-doc

open.feishu.cn

831.4k

Operate on Feishu cloud documents (Docx / Wiki): read, create, and edit documents; insert or download image attachments; and work with mind notes. Use when the user provides a document URL/token (including /docx/ or /wiki/ on doubao.com); route by URL path/token rather than domain. `/page/<token>` is a Miaoda app, not a Feishu cloud document. Route embedded document resources according to the unified rules in the reading reference. Use lark-drive for standalone comment operations; use docs +fetch to read comments alongside the main text. Operations on spreadsheet or Base internal data are outside this skill.

lark-drive

open.feishu.cn

830.7k

Feishu cloud storage (Drive): manage Drive files and folders, including uploads/downloads, folder creation, copying/moving/deleting, viewing metadata, checking permission settings, comments/permissions/subscriptions, titles, versions, Feishu document security labels (secure labels), and local file imports. Use when users need to organize Drive folders, handle cloud storage resource URLs/tokens, identify link types/actual tokens/titles, or import Word/Markdown/Excel/CSV/PPTX/.base as docx/sheet/bitable/slides. Route doubao.com cloud storage URLs/tokens by resource path and token too; do not fall back to WebFetch. Not responsible for: editing document content (use lark-doc), spreadsheet/Base table data operations (use lark-sheets/lark-base), knowledge space node/member management (use lark-wiki), or native Markdown file read/write/patch/diff (use lark-markdown).

lark-sheets

open.feishu.cn

829.3k

Feishu Spreadsheets: create and operate spreadsheets. Supports worksheets and row/column structures (add/delete/merge/size/hide/freeze/group), cell read/write (values/formulas/styles/comments/cell images), range copy/move/sort/fill, find and replace, bulk updates, and creating and maintaining objects such as charts, pivot tables, conditional formatting, filters and filter views, dropdown lists, sparklines, and floating images. Also supports formula validation, restoring historical versions, and importing/exporting local Excel/CSV files and Feishu spreadsheets. Use when users need to create or edit spreadsheets, summarize and visualize data, format spreadsheets, calculate formulas (including migrating Excel formulas), or build financial models (DCF, three statements, budgets, Sensitivity, etc.). For multidimensional tables (Base/bitable), use lark-base. If users want to search for spreadsheet files in cloud storage (Drive/cloud storage) by name or keyword, use lark-drive's drive +search to locate resources first. When users provide a doubao.com /sheets/ URL/token, use this skill directly; do not fall back to WebFetch because the domain is not Feishu. Routing is based on the URL path pattern and token, not the domain.