---
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"]
enabled: false
source: github:clearsmog/claude-skills
imported-from: github:clearsmog/claude-skills
---

# Validate Bibliography

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

## Steps

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

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

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

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

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