| name | validate-bib |
| description | Validate bibliography entries against citations in all project files. Find missing entries and unused references. |
| disable-model-invocation | true |
Validate Bibliography
Cross-reference all citations in project files against bibliography entries.
Steps
-
Read the bibliography file and extract all citation keys
-
Scan all project 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 documents 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:
manuscript/**/*.tex
**/*.qmd
Bibliography location:
manuscript/references.bib (or check YAML bibliography: field in .qmd files)
