| name | validate-bib |
| description | Validate bibliography entries against citations in all document files (.tex, .qmd, .typ). 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 document files for citation keys:
.tex files: look for \cite{, \citet{, \citep{, \citeauthor{, \citeyear{.qmd files: look for @key, [@key], [@key1; @key2].typ files: look for @key references (Typst uses @key syntax, no \citet/\citep distinction)- Also check for
#bibliography("refs.bib") or #bibliography("refs.yml") (Hayagriva format) in .typ files
- Note: some Typst projects use inline links instead of bibliography — detect and report
- 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
**/*.typ
Bibliography location:
Bibliography_base.bib (repo root)
