Awesome-Agent-Skills-for-Empirical-Research bib-check

Cross-checks citation keys in index.qmd against references.bib, reporting missing, orphaned, and duplicate entries. Use when verifying citations.

install
source · Clone the upstream repo
git clone https://github.com/brycewang-stanford/Awesome-Agent-Skills-for-Empirical-Research
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/brycewang-stanford/Awesome-Agent-Skills-for-Empirical-Research "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/29-quarcs-lab-project20XXy/dot-claude/skills/bib-check" ~/.claude/skills/brycewang-stanford-awesome-agent-skills-for-empirical-research-bib-check && rm -rf "$T"
manifest: skills/29-quarcs-lab-project20XXy/dot-claude/skills/bib-check/SKILL.md
source content

Audit Citations and References

Cross-check all citation keys in the manuscript against

references.bib
and report mismatches.

Steps

  1. Read

    index.qmd
    and extract every citation key:

    • Narrative citations:
      @key
    • Parenthetical citations:
      [@key]
      ,
      [@key1; @key2]
    • Ignore email addresses and
      @sec-
      ,
      @fig-
      ,
      @tbl-
      cross-references
  2. Read

    references.bib
    and extract every entry key (the identifier after
    @article{
    ,
    @book{
    , etc.)

  3. Check for duplicate keys within

    references.bib
    (same key defined more than once)

  4. Report three categories:

    Errors — cited in manuscript but missing from

    .bib
    :

    • List each missing key with the line number in
      index.qmd
      where it appears
    • For each, suggest running
      /project:cite <key>
      to add the entry

    Orphaned — in

    .bib
    but never cited in manuscript:

    • List each unused key (informational, not necessarily a problem)

    Duplicates — same key appears multiple times in

    .bib
    :

    • List each duplicate with line numbers in
      references.bib
  5. Print a summary: total cited keys, total

    .bib
    entries, errors, orphaned, duplicates

Error handling

  • If
    references.bib
    does not exist, report the error and stop.
  • If
    index.qmd
    contains no citations, report "No citations found" and stop.