Citation Management

Input

• $0

  — Action:

  harvest

  ,

  validate

  ,

  add

  ,

  format

• $1

  — Path to

  .tex

  or

  .bib

  file

Scripts

Validate citations (check all cite keys resolve)

python ~/.claude/skills/citation-management/scripts/validate_citations.py \
  --tex paper/main.tex --bib paper/references.bib --check-figures --figures-dir paper/figures/

Generate BibTeX from paper database

python ~/.claude/skills/deep-research/scripts/bibtex_manager.py \
  --jsonl paper_db.jsonl --output references.bib

Search for a specific paper to add

python ~/.claude/skills/deep-research/scripts/search_semantic_scholar.py \
  --query "attention is all you need" --max-results 5 \
  --api-key "$(grep S2_API_Key /Users/lingzhi/Code/keys.md 2>/dev/null | cut -d: -f2 | tr -d ' ')"

Harvest missing citations automatically

python ~/.claude/skills/citation-management/scripts/harvest_citations.py \
  --tex paper/main.tex --bib paper/references.bib --output candidates.bib --max-rounds 10

--dry-run

--verbose

--api-key

Auto-fix missing citation placeholders

python ~/.claude/skills/citation-management/scripts/validate_citations.py \
  --tex paper/main.tex --bib paper/references.bib --fix

references_fixed.bib

Action:

harvest

— Iterative Citation Harvesting

1. Read the current

   .tex

   draft
2. Identify the most important missing citation
3. Search Semantic Scholar via script
4. Select the most relevant paper from results
5. Extract BibTeX and generate a clean key (

   lastNameYearWord

   )
6. Append to

   .bib

   (skip if key exists)
7. Insert

   \cite{key}

   at the appropriate location
8. Stop when no more gaps or 20 rounds reached

• DO NOT add a citation that already exists
• Only add citations found via API — never fabricate
• Cite broadly — not just popular papers
• Do not copy verbatim from prior literature

Action:

validate

— Pre-Compilation Check

validate_citations.py

Action:

add

— Add Specific Paper

.bib

firstAuthorLastNameYearFirstContentWord

vaswani2017attention

Action:

format

— Standardize .bib

• Sort entries alphabetically by key
• Ensure consistent indentation (2 spaces)
• Remove empty fields
• Protect proper nouns with

  {Braces}

  in titles
• Ensure required fields per entry type

Related Skills

• Upstream: literature-search, deep-research
• Downstream: paper-compilation, latex-formatting
• See also: related-work-writing