validate-bib

---
name: validate-bib
description: "Validate bibliography entries against citations in source files. Find missing entries and unused references. Use when concerned about bibliography completeness or citation keys."
when_to_use: "validate bib, check citations, find missing references, undefined citation errors, all citations in bib, check unused references, bibliography broken, missing bib entries, citation not found, after lit review, before submission"
argument-hint: "[bib file path, or leave blank to auto-detect]"
allowed-tools: ["Read", "Grep", "Glob"]
---

# Validate Bibliography

Cross-reference all citations in source files against bibliography entries.

## Steps

1. **Read the bibliography file** and extract all citation keys

2. **Scan all source 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

3. **Cross-reference:**
   - **Missing entries:** Citations used in source files but NOT in bibliography
   - **Unused entries:** Entries in bibliography not cited anywhere
   - **Potential typos:** Similar-but-not-matching keys

4. **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

5. **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:
```
manuscripts/**/*.tex
Quarto/**/*.qmd
```

## Bibliography location:
```
Bibliography_base.bib  (repo root)
```