| name | validate-bib |
| description | Validate bibliography entries against citations in all lecture files. Find missing entries and unused references. |
| allowed-tools | ["Read","Grep","Glob"] |
Validate Bibliography
Cross-reference all citations in lecture files against bibliography entries.
Steps
-
Read the bibliography file and extract all citation keys
-
Scan all lecture files for citation keys:
.tex files: look for \cite{, \citet{, \citep{, \citeauthor{, \citeyear{
.qmd files: look for @key, [@key], [@key1; @key2]
- Extract all unique citation keys used
-
Cross-reference:
- Missing entries: Citations used in lectures but NOT in bibliography
- Unused entries: Entries in bibliography not cited anywhere
- Potential typos: Similar-but-not-matching keys
-
Check entry quality for each bib entry:
- Required fields present (author, title, year, journal/booktitle)
- Author field properly formatted
- Year is reasonable
- No malformed characters or encoding issues
-
Report findings:
- List of missing bibliography entries (CRITICAL)
- List of unused entries (informational)
- List of potential typos in citation keys
- List of quality issues
Files to scan:
Slides/*.tex
Quarto/*.qmd
Bibliography location:
paper/references.bib (repo root)