bib-validate

Validate citation keys and bibliography metadata against OpenAlex and Crossref before rendering documents.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/cameronbracken/waterology-research --skill bib-validate-cameronbracken
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bib-validate
Source: https://github.com/cameronbracken/waterology-research/tree/main/skills/bib-validate
Command: npx skills add https://github.com/cameronbracken/waterology-research --skill bib-validate-cameronbracken

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Broken citation keys and fabricated or incorrect bibliography metadata cause Quarto and LaTeX renders to fail or silently produce wrong references. This Skill catches missing keys, likely typos, and unverifiable DOIs before a paper is rendered or released. ## Core Features & Use Cases - Citation Key Validation: Extracts citation keys from .tex, .qmd, .md, and .rmd sources and compares them against .bib entries, reporting likely typos at edit distance 1 and possible typos at distance 2. - DOI and Fabrication Checks: With --verify-doi, resolves DOIs through OpenAlex and searches Crossref for entries without DOIs, reporting a match matrix across title, first author, and year. - Safe Auto-Fix: --fix corrects only unambiguous citation key typos in source files and never rewrites bibliography metadata automatically. - Use Case: Before submitting a Quarto manuscript, run the validator on paper.qmd and references.bib with --verify-doi to confirm every cited key exists and every DOI resolves to the intended work. ## Quick Start Ask the AI to validate the citations in your Quarto or LaTeX document against your .bib file, optionally verifying DOIs and fixing unambiguous key typos.

Frequently Asked Questions about bib-validate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check for missing citation keys in a Quarto or LaTeX document?▼

Run the validate_bib.py script with your source document and .bib file as arguments. It extracts citation keys from .tex, .qmd, .md, and .rmd files, compares them to bibliography entries, and reports missing keys with likely typo suggestions.

How to verify DOIs in a BibTeX file against OpenAlex and Crossref?▼

Add the --verify-doi flag when running the script. Entries with DOIs are resolved through OpenAlex and compared on title, first author, and year; entries without DOIs are searched in Crossref, with candidates shown but never inserted automatically.

Can the script automatically fix citation key typos?▼

Yes, the --fix flag corrects a source citation only when exactly one bibliography key is at edit distance 1. Ambiguous matches are left unresolved, and the .bib file itself is never modified.

Does bib-validate require any Python packages to install?▼

No external packages are required. The script uses only the Python standard library, including urllib for API requests and difflib for title similarity, so it runs with a plain python3 installation.

What happens when OpenAlex or Crossref is unreachable during verification?▼

A network failure is reported as UNVERIFIED, not FAIL, and the script exits with code 2. Only a DOI that OpenAlex explicitly cannot resolve or metadata mismatches count as failures.