validate-bib

Validate bibliography citation keys in Quarto reports and Stata do-files.

220|358|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/maxwell2732/codex-stata-for-economists --skill validate-bib-maxwell2732
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-bib
Source: https://github.com/maxwell2732/codex-stata-for-economists/tree/main/.claude/skills/validate-bib
Command: npx skills add https://github.com/maxwell2732/codex-stata-for-economists --skill validate-bib-maxwell2732

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents broken or incorrect scholarly citations by verifying that every citation used across your Quarto reports and Stata do-files exists in the project’s bibliography source.

Core Features & Use Cases

  • Missing entries detection (critical): Flags citation keys referenced in reports or do-files that are absent from references.bib, stopping downstream rendering issues.
  • Unused entries review (informational): Identifies bib entries that are never cited so you can clean or prioritize your bibliography.
  • Likely typo discovery: Detects probable key mistakes by finding near matches (edit distance ≤ 2), helping you fix chetty-like vs chetty-like errors quickly.
  • Entry quality checks: Verifies required fields (e.g., author/title/year plus appropriate container fields), author formatting, year plausibility, and malformed characters/braces.

Quick Start

Ask Codex to run validate-bib on your repository to report missing citation keys, likely typos, quality issues, and unused bibliography entries.

Frequently Asked Questions about validate-bib

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

FAQPage Schema
How do I validate citation keys in my Quarto reports against my references.bib file?

To validate citation keys in Quarto reports, you cross-reference @key patterns and cite{...} markers in your files against the canonical references.bib to detect missing entries, unused references, and formatting issues before rendering.

Why does my Quarto document fail to render with broken bibliography citations?

Quarto rendering fails when citation keys referenced in your document are missing from references.bib. Bibliography validation flags these absent entries and detects near-match typos with an edit distance of 2 or fewer to prevent rendering issues.

Can I check for citation key typos in Stata do-files using bibliography validation?

Yes, bibliography validation extracts cite markers from inline comments within notes() and Stata do-files, then checks them against references.bib to discover probable key mistakes using near-match typo detection with an edit distance threshold.

What is the best way to find unused entries in my references.bib file?

The best way to find unused entries in references.bib is to run a bibliography validation check that identifies bib entries never cited across your Quarto reports and Stata do-files, allowing you to clean and prioritize your bibliography.

Does bibliography validation check the quality and formatting of bib entries?

Yes, bibliography validation verifies required fields like author, title, and year, checks author formatting, validates year plausibility, and detects malformed characters or braces in your references.bib file entries.

What file types and citation patterns does bibliography validation support for academic replication workflows?

Bibliography validation supports academic replication workflows by extracting citation keys from Quarto reports using @key patterns and cite{...} markers, as well as inline cite comments within Stata do-files notes() statements.