# citation-check

An Agent Skill that cross-checks the citations of a manuscript against its bibliography. It reports

• keys cited in the text that have no bibliography entry, and
• bibliography entries that are never cited.

It supports LaTeX (\cite, natbib and biblatex commands) and Pandoc Markdown ([@key], @key), with BibTeX/BibLaTeX or CSL JSON bibliographies. The patterns are listed in references/patterns.md.

# Install

skills install @spboucher/citation-check --client claude-code

Then ask your agent: "Check the citations of paper.tex against references.bib."

# The script

scripts/check_citations.py needs Python 3.8+ and nothing else. It reads only the files you pass and never uses the network or writes files.

python3 scripts/check_citations.py paper.tex --bib references.bib
python3 scripts/check_citations.py chapter1.md chapter2.md --bib refs.json --json

Exit code 0 means consistent, 1 means problems were found, 2 means a file could not be read.

# Permissions

filesystem:read: the skill reads the manuscript and bibliography files you name.

# Limits

Keys are compared case-sensitively. Citations produced by custom macros are not detected.