name: validate-bib description: Validate bibliography entries against citations in all manuscript files. Find missing entries and unused references. disable-model-invocation: true allowed-tools: ["Read", "Grep", "Glob"]
Validate Bibliography
Cross-reference all citations in manuscript files against bibliography entries.
Steps
-
Read the bibliography file(s): Find
.bibfiles in the project. -
Scan manuscript files for citation commands:
- LaTeX:
\cite{},\citet{},\citep{},\citeauthor{},\citeyear{} - Extract all citation keys
- LaTeX:
-
Cross-reference:
- Missing entries (CRITICAL): Citation keys in
.texfiles without matching.bibentries - Unused entries (INFO):
.bibentries not cited anywhere - Potential typos: Citation keys that look similar to existing entries (edit distance <= 2)
- Missing entries (CRITICAL): Citation keys in
-
Check entry quality:
- Required fields present (author, title, year, journal/booktitle)
- Author formatting consistent
- Year values reasonable
- No encoding issues in special characters
-
Report findings with severity levels.
Notes
- Missing entries are CRITICAL because they cause compilation warnings.
- Unused entries are informational -- the user may want to keep them for future use.