citation-audit

Verifies every bibliographic entry in a LaTeX paper for existence, metadata accuracy, and citation context.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/Lingjie-wang/autoRL --skill citation-audit-lingjie-wang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: citation-audit
Source: https://github.com/Lingjie-wang/autoRL/tree/main/Auto-claude-code-research-in-sleep/skills/citation-audit
Command: npx skills add https://github.com/Lingjie-wang/autoRL --skill citation-audit-lingjie-wang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Academic papers often contain hallucinated references, wrong-context citations, author name errors, year mismatches, and phantom DOIs that survive manual review and can sink a submission. This Skill audits every \cite{...} in a LaTeX manuscript against real web sources (DBLP, arXiv, ACL Anthology, OpenReview) before submission. ## Core Features & Use Cases - Three-layer verification: checks each cited entry for existence at the claimed arXiv ID/DOI/venue, metadata correctness (authors, year, venue, title), and context appropriateness (whether the cited paper actually supports the surrounding claim). - Cross-model independent review: sends each entry to a fresh gpt-5.5 reviewer thread via Codex MCP with mandatory web lookups, producing per-entry KEEP / FIX / REPLACE / REMOVE verdicts. - Structured artifacts: always emits CITATION_AUDIT.md (human-readable report) and CITATION_AUDIT.json (machine-readable ledger with verdict, reason codes, and input hashes) for downstream verifier gates. - Optional modes: --uncited detects bib entries never cited (detect-only), and --soft-only freezes the bib file and proposes sentence rewrites in the .tex files instead of bib mutations. - Use Case: Before submitting a paper, run the audit to catch a citation of Self-Refine used to support a claim it actually contradicts, an anonymous-author placeholder entry, and an arXiv preprint that should now cite the NeurIPS version. ## Quick Start Run the citation audit on my paper directory to verify every reference in references.bib against real sources and generate the audit report.

Frequently Asked Questions about citation-audit

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

FAQPage Schema
How do I check citations in a LaTeX paper for hallucinated references?

Run the citation audit on the paper directory containing the .bib file and .tex sources. It extracts every \cite{...} with its surrounding sentence, then verifies each entry's existence, metadata, and context via web lookups, producing KEEP, FIX, REPLACE, or REMOVE verdicts per entry.

What is a wrong-context citation and how is it detected?

A wrong-context citation is a real paper cited to support a claim it does not actually establish. The audit sends the surrounding sentence of each \cite to an independent reviewer with web access, which judges whether the cited paper supports, weakly supports, or contradicts the claim.

Can I audit citations without modifying my bib file?

Yes, pass the --soft-only flag. The audit still runs all three verification layers and emits the same verdicts, but instead of bib mutations it proposes sentence rewrites in the citing .tex files, and any downstream bib edit is refused.

Does the citation audit check uncited bib entries?

Only when you pass --uncited. It then reports bib entries never referenced by any \cite with a prune or check suggestion, but these are advisory only and never change the top-level verdict or block submission.

When should I run a citation audit during paper writing?

Run it once after the LaTeX draft and bib file are finalized and numerical claims are verified, but before final compilation for submission. Running it on a half-written draft wastes effort because context checking depends on finished sentences.

What are the limitations of automated citation verification?

Very recent papers may not yet appear in DBLP, so the reviewer falls back to arXiv. When both a preprint and published version exist, the published venue is preferred but both are flagged, and unverifiable entries are marked UNCERTAIN rather than guessed.