validate-bib

Run the default structural mode, which scans .tex, .qmd, and .md files for citation commands like \cite, \citep, and @key, then cross-references them against the .bib file. Missing entries are reported as critical issues in quality_reports/bib_audit_structural.md.

Use the --semantic flag to enable citation-drift detection. It flags entries sharing the same DOI, identical normalized titles, matching author-year-journal combinations, or high title-token similarity, and recommends a canonical key for each duplicate pair.

Yes, the --semantic mode fetches https://api.crossref.org/works/{doi} for each entry and compares author, year, title, and journal. Lookups are capped at 50 per run with caching, and --skip-doi disables network calls for offline use.

Yes, structural checks run entirely offline. For semantic mode, pass --skip-doi to skip Crossref verification while still running duplicate detection and style-consistency checks locally.

The skill does not judge whether a citation fits its context, does not auto-fix the .bib file, and does not check non-DOI identifiers like ISBN, arXiv, or SSRN. All findings are recommendations requiring human review.