# 02 Bib Verify

Verify a BibTeX file for hallucinated or fabricated references by cross-checking every...

- Repository: https://github.com/agentscope-ai/OpenJudge (1020 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentscope-ai/OpenJudge --skill 02-bib-verify -g -a claude-code -y`
Codex: `npx skills add agentscope-ai/OpenJudge --skill 02-bib-verify -g -a codex -y`
Cursor: `npx skills add agentscope-ai/OpenJudge --skill 02-bib-verify -g -a cursor -y`
Gemini CLI: `npx skills add agentscope-ai/OpenJudge --skill 02-bib-verify -g -a gemini-cli -y`

## Description

Verify a BibTeX file for hallucinated or fabricated references by cross-checking every entry against CrossRef, arXiv, and DBLP. Reports each reference as verified, suspect, or not found, with field-level mismatch details (title, authors, year, DOI). Use when the user wants to check a .bib file for fake citations, validate references in a paper, or audit bibliography entries for accuracy.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# BibTeX Verification Skill

Check every entry in a `.bib` file against real academic databases using the
OpenJudge `PaperReviewPipeline` in BibTeX-only mode:

1. **Parse**, extract all entries from the `.bib` file
2. **Lookup**, query CrossRef, arXiv, and DBLP for each reference
3. **Match**, compare title, authors, year, and DOI
4. **Report**, flag each entry as `verified`, `suspect`, or `not_found`

## Prerequisites

```bash
pip install py-openjudge litellm
```

## Gather from user before running

| Info | Required? | Notes |
|------|-----------|-------|
| BibTeX file path | Yes | `.bib` file to verify |
| CrossRef email | No | Improves CrossRef API rate limits |

## Quick start

```bash
# Verify a standalone .bib file
python -m cookbooks.paper_review --bib_only references.bib

# With CrossRef email for better rate limits
python -m cookbooks.paper_review --bib_only references.bib --email your@email.com

# Save report to a custom path
python -m cookbooks.paper_review --bib_only references.bib \
  --email your@email.com --output bib_report.md
```

## Relevant options

| Flag | Default | Description |
|------|---------|-------------|
| `--bib_only` |, | Path to `.bib` file (required for standalone verification) |
| `--email` |, | CrossRef mailto, improves rate limits, recommended |
| `--output` | auto | Output `.md` report path |
| `--language` | `en` | Report language: `en` or `zh` |

## Interpreting results

Each reference entry is assigned one of three statuses:

| Status | Meaning |
|--------|---------|
| `verified` | Found in CrossRef / arXiv / DBLP with matching fields |
| `suspect` | Title or authors do not match any real paper, likely hallucinated or mis-cited |
| `not_found` | No match in any database, treat as fabricated |

The rest: https://github.com/agentscope-ai/OpenJudge/blob/HEAD/skills/academic-eval/02-bib-verify/SKILL.md