brycewang-stanford

validate-bib

Validate bibliography entries against citations in all lecture files. Find missing entries and unused references.

brycewang-stanford 3,622 464 Updated 5mo ago
GitHub

Install

npx skillscat add brycewang-stanford/auto-empirical-research-skills/validate-bib

Install via the SkillsCat registry.

About this skill

We need to produce a 2-3 sentence plain-text summary, objective, factual, no marketing language, no bullet points, no headings, no markdown formatting, no quotes, at most 60 words. Must be only the summary text. So produce maybe 2-3 sentences, within 60 words. Let's craft: "The skill reads a bibliography file and scans all lecture files for citation keys, then identifies citations that refer to missing bibliography entries, entries that are unused, and possible key mismatches.

SKILL.md

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 lecture 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 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

Bibliography location:

Bibliography_base.bib  (repo root)

Categories