latex-rescue

latex-rescue is a skill for Codex from Calix-L/awesome-latex-skills. It costs 41 tokens per session (1,120 once invoked), scanned A, original, MIT.

A LaTeX troubleshooting tool for finding and fixing errors that stop a document from compiling. Compilation is the process that turns LaTeX source files into a finished PDF.

In plain words
What is it for?
Use it when a LaTeX paper will not compile, especially to diagnose control-sequence errors, math-mode mistakes, package conflicts, undefined references, and mismatched environments.
Why use it?
It helps explain cryptic error messages and locate problems such as missing brackets, conflicting packages, broken references, or commands used in the wrong context.

Skill for Codex

Written for Codex: agents/openai.yaml present.

Good fit Use it when a LaTeX paper will not compile, especially to diagnose control-sequence errors, math-mode mistakes, package conflicts, undefined references, and mismatched environments.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/calix-l/awesome-latex-skills/latex-rescue
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Calix-L/awesome-latex-skills --skill latex-rescue
Clone the repo
git clone --depth 1 https://github.com/Calix-L/awesome-latex-skills

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for latex-rescue

README.md
[![agentmods](https://agentmods.dev/badge/skills/calix-l/awesome-latex-skills/latex-rescue/github.svg)](https://agentmods.dev/skills/calix-l/awesome-latex-skills/latex-rescue)
Your own site
<a href="https://agentmods.dev/skills/calix-l/awesome-latex-skills/latex-rescue"><img src="https://agentmods.dev/badge/skills/calix-l/awesome-latex-skills/latex-rescue/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for latex-rescue

Your own site · 80×15
<a href="https://agentmods.dev/skills/calix-l/awesome-latex-skills/latex-rescue"><img src="https://agentmods.dev/badge/skills/calix-l/awesome-latex-skills/latex-rescue.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 41 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,120 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00041 $0.01120
Opus 5.5 $0.00016 $0.00448
Sonnet 5.5 $0.00008 $0.00224
Haiku 4.5 $0.00004 $0.00112

Measured 19d ago against content hash 30e3195567df, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

latex-rescue scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 19d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/check_build.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

latex-rescue/SKILL.md · 104 lines

How it starts

The opening of the file, as written. The whole thing — 104 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Purpose

Repair the requested project with the smallest change that addresses the actual failure. Compilation success does not establish mathematical correctness.

Establish the failing build

  • For a pasted error, give a diagnosis using the supplied context. Request source or logs only when they are needed to distinguish plausible fixes; a project directory is not required for a useful diagnosis.
  • For a local project, identify its root document from the build command, configuration, magic comments, and \documentclass. A file named main.tex is a candidate, not proof that it is the root. Resolve ambiguous roots before editing.
  • Respect the engine, auxiliary/output directories, bibliography backend, and any custom build steps. fontspec requires XeLaTeX or LuaLaTeX. Check biblatex's backend option rather than assuming Biber in every project.
  • Reproduce the failure with the existing build command where available. Retain exit codes and the final engine/backend logs. A stale PDF is not build evidence. Missing tools or project files mean compilation remains unverified.

For manual builds, use the actual root and engine, for example:

pdflatex -no-shell-escape -interaction=nonstopmode -file-line-error main.tex

Use the shell's own exit-status handling when capturing output. Bash pipelines need set -o pipefail; do not assume Bash syntax works in PowerShell. Do not enable shell escape merely to silence an error; follow the project's actual requirements and the user's execution permissions.

Diagnose and repair

Read the first causal error, its source context, and subsequent diagnostics. File-line diagnostics may appear as file.tex:line: rather than starting with !. Undefined references and overfull boxes are generally warnings, not syntax failures.

Consult only the relevant resources:

  • Error catalog: known typos, missing packages, encoding, references, and environment errors.
  • Package conflicts: option clashes or competing definitions; preserve the official template's package choices.
  • Debug workflow: cascading errors and failures that remain after an initial contextual fix.

Read the full file on GitHub · 104 lines

Files

What ships with it

7 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 19d ago Changed 30e3195567df
  2. 21d ago Changed d50caa10008d
  3. 22d ago Changed · +3 lines 77609e881d1f
  4. 23d ago Changed 621b16d72e5b
  5. 24d ago Changed · -201 lines · +4 tokens per session 39d026e150ae
  6. 1mo ago First seen · 302 lines · 37 tokens per session scan A 84a0d825c49e

Subscribe to this mod's changes

latex-rescue is a skill published in the GitHub repository Calix-L/awesome-latex-skills (184 stars, last pushed 20d ago), licensed MIT. It adds 41 tokens to every session and 1,120 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

overleaf

Sync and manage Overleaf LaTeX projects from the command line. Pull projects locally, push changes back, compile PDFs, and download compile outputs like .bbl files for arXiv submissions. Use when working with LaTeX, Overleaf, academic papers, or arXiv.

aloth/olcli · 62 tokens

fetch-paper

Fetches a legal open-access copy of a paper from its DOI or arXiv ID — resolves through Unpaywall, arXiv PDF/HTML, and the open-access ACM Digital Library. Use when the user wants to fetch, download, read, or get the PDF or full text of a specific paper. Single polite fetch, transient processing only: it never stores…

ShaishavMaisuria/research-paper-lifecycle-skills · 117 tokens

figure-drawing

MANDATORY skill for creating any figure, diagram, chart, table visualization, or TikZ graphic in a paper. Must be activated BEFORE writing any drawing code. Produces standalone .tex → compiled PDF/PNG → \includegraphics in paper. Never inline TikZ code directly into paper sections.

nanoAgentTeam/research-claw · 62 tokens

read-paper-to-notes

Read an academic-paper PDF or supplied full text and turn it into a faithful, structured Markdown deep-reading note. Use when the user provides a research paper and asks to read, explain, summarize, take notes, extract its problem, method, equations, experiments, results, limitations, or research implications, or fill…

yujie-jason-zhang/polish_skill · 116 tokens

user-preview

Compile the current project's LaTeX files and send the generated PDF to the user for preview. Use when the user wants to check typesetting results or confirm the effect of recent edits.

nanoAgentTeam/research-claw · 42 tokens

awesome-ieee-report

Generates IEEE-format LaTeX technical reports from project requirements and codebase evidence, using academic prose, pseudocode-only explanations, BibTeX references, and IEEEtran formatting.

EnesDemir143/awesome-ieee-report · 41 tokens