---
name: brycewang-stanford/bib-check
source: https://app.decimal.ai/s/brycewang-stanford-bib-check@1/SKILL.md
source_sha256: dbbabe05da31
---

# 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.