overleaf-check

Audit Overleaf LaTeX projects for compilation errors and generate markdown reports.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/naj2r/claude-econ-paper-template --skill overleaf-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: overleaf-check
Source: https://github.com/naj2r/claude-econ-paper-template/tree/main/.claude/skills/overleaf-check
Command: npx skills add https://github.com/naj2r/claude-econ-paper-template --skill overleaf-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates auditing an Overleaf LaTeX project to surface compilation blockers such as missing bibliography entries, broken table inputs, unresolved cross-references, and common LaTeX syntax issues so you can fix them before attempting a full compile.

Core Features & Use Cases

  • Bibliography integrity checks: validates .bib entry types and required fields, detects duplicate or orphaned keys, and cross-checks all \cite-like citations against the bibliography.
  • Table and file reference validation: verifies that all \input references to table files exist, that tables include labels, and that table environments are properly delimited.
  • Cross-reference and syntax scanning: finds unmatched \ref/\label pairs, checks for unbalanced braces and common typos, and verifies graphics and table path macros align with actual files.
  • Actionable output: produces a dated markdown quality report with categorized issues (Error/Warning/Info), missing citations, orphaned bibliography entries, and suggested fixes for each problem.
  • Use case: useful for researchers and editors who want an automated preflight check of their Overleaf project before final compilation or submission.

Quick Start

Run the overleaf-check skill with the argument full to audit the entire Overleaf project and write a dated markdown quality report to quality_reports/.

Frequently Asked Questions about overleaf-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check my LaTeX project for missing citations and broken references before compiling?

To check a LaTeX project for missing citations and broken references, you can audit your .tex and .bib files to validate citation keys, cross-reference pairs, and file inputs. This process generates a markdown report listing categorized errors and suggested fixes to resolve issues before compilation.

How do I find orphaned bibliography entries in an Overleaf project?

Finding orphaned bibliography entries in an Overleaf project involves cross-checking all \cite-like commands against your .bib file to detect unused keys. Auditing tools validate .bib entry fields and identify duplicate or orphaned entries, outputting a dated markdown quality report for reference.

What causes broken table inputs and cross-reference errors in LaTeX documents?

Broken table inputs and cross-reference errors in LaTeX documents are caused by missing \input files, unresolved \ef/\label pairs, and unbalanced braces. Scanning your project structure verifies file existence, checks table environment delimiters, and ensures all referenced paths align with actual files.

Does the Overleaf project audit work with a specific repository folder structure?

Yes, the Overleaf project audit works with repositories organized using main.tex, a Sections/ directory, files/tab/ for tables, and a bibliography .bib file. Scanning reads these specific paths to validate section files, table inputs, figure paths, and labels for missing files or mismatches.

What is the best way to automate LaTeX syntax checks for compilation problems?

The best way to automate LaTeX syntax checks for compilation problems is running a preflight audit that greps citation and label commands, validates brace balance, and verifies graphics paths. This produces a categorized markdown quality report detailing errors, warnings, and suggested fixes.

Why does my Overleaf document fail to compile with undefined reference warnings?

Overleaf documents fail to compile with undefined reference warnings due to unmatched \ef/\label pairs or missing bibliography entries. Scanning the .tex files detects these mismatches and validates all cross-references against existing labels, providing suggested fixes in a quality report.