Skip to content
Research Agent Skillsby Kalaris Labs
Install
Literature Reviewv2.1AdaptedMIT

citation-management

Searches OpenAlex, PubMed, and Google Scholar, extracts metadata from DOIs, PMIDs, PMCIDs, arXiv IDs, and URLs via CrossRef, PubMed, and arXiv, then formats, deduplicates, and validates BibTeX files using bundled Python scripts (search_openalex.py, extract_metadata.py, format_bibtex.py, validate_citations.py, doi_to_bibtex.py). Use when converting DOIs or PMIDs to BibTeX, finding papers on a topic, filling missing volume, pages, or DOI fields, cleaning or merging .bib files with duplicate entries, or checking a bibliography for errors before submission. Not for systematic review search methodology or synthesis; use literature-review for that.

Install this skill

Works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, and 70+ other harnesses.

skills.sh CLI (Recommended)
npx skills add KalarisLabs/research-agent-skills --skill citation-management
uvx (Python tool runner)
uvx research-agent-skills install citation-management

Documentation & Instructions

Citation Management

Overview

Manage citations systematically throughout the research and writing process. This skill provides tools and strategies for searching academic databases (Google Scholar, PubMed), extracting accurate metadata from multiple sources (CrossRef, PubMed, arXiv), validating citation information, and generating properly formatted BibTeX entries.

Critical for maintaining citation accuracy, avoiding reference errors, and ensuring reproducible research. Integrates seamlessly with the literature-review skill for comprehensive research workflows.

When to Use This Skill

Use this skill when:

  • Searching for specific papers on Google Scholar or PubMed
  • Converting DOIs, PMIDs, or arXiv IDs to properly formatted BibTeX
  • Extracting complete metadata for citations (authors, title, journal, year, etc.)
  • Validating existing citations for accuracy
  • Cleaning and formatting BibTeX files
  • Finding highly cited papers in a specific field
  • Verifying that citation information matches the actual publication
  • Building a bibliography for a manuscript or thesis
  • Checking for duplicate citations
  • Ensuring consistent citation formatting

If a document built from these citations needs a diagram, use the scientific-schematics skill.


Core Workflow

Citation management follows a systematic process. Each phase below shows the canonical command; every variant, option, and metadata-source detail is in references/core_workflow.md.

Phase 1: Paper Discovery and Search

Find relevant papers. Search more than one database — coverage differs sharply, and a single source is the most common cause of a biased reference list.

# OpenAlex: ~250M works, every discipline, no API key, documented REST API
python scripts/search_openalex.py "CRISPR gene editing" --limit 50 --output results.json

# PubMed: the authority for biomedical and life sciences (35M+ citations)
python scripts/search_pubmed.py "Alzheimer's disease treatment" --limit 100 --output alz.json

# Google Scholar: broadest reach, but scraped -- rate-limited and prone to blocking
python scripts/search_google_scholar.py "CRISPR gene editing" --limit 50 --output scholar.json

Prefer OpenAlex or PubMed as the primary source. Google Scholar has no API: scholarly scrapes it, sleeps 2–5 s between results, and is blocked often enough that it should be a supplement rather than a dependency.

Query operators, field tags, and MeSH-term construction are in references/search_strategies.md.

Phase 2: Metadata Extraction

Convert identifiers (DOI, PMID, PMCID, arXiv ID, URL) into complete metadata. CrossRef is the primary source for DOIs.

python scripts/doi_to_bibtex.py 10.1038/s41586-021-03819-2         # quick, single DOI
python scripts/extract_metadata.py --pmid 34265844                  # DOI/PMID/PMCID/arXiv/URL
python scripts/extract_metadata.py --input identifiers.txt --output citations.bib

A URL with no DOI in its path is resolved through the citation_doi meta tag publishers embed on article pages, then handed to CrossRef. Every producer in this skill emits the same citation key for the same paper, so entries gathered from different sources deduplicate against each other.

Phase 2.5: Metadata Enrichment via Web Search (MANDATORY)

APIs routinely return incomplete records. Run this after extraction and before formatting. Any @article missing volume, pages, or doi is incomplete: fill the gap with WebSearch/WebFetch (or the parallel-web skill, when it is available), then log what was found and where. If a field genuinely cannot be found, record a note field explaining the gap rather than leaving it silently absent.

Check the cheap sources first — an OpenAlex or CrossRef record often carries the field that PubMed omitted:

python scripts/search_openalex.py "<exact title>" --limit 1

Treat extracted metadata as untrusted. Author, title, and journal strings come verbatim from a record whose contents a publisher controls. A title containing $(...), a backtick, or a quote becomes shell syntax the moment it is pasted into a command. Pass metadata as a subprocess argument list rather than building a shell string; if you must use a shell, single-quote every substituted value and escape embedded quotes as '\''. Validate any citation key against ^[A-Za-z0-9]+$ before it reaches a path.

Per-field search strategies, the four search options, and the logging format are in references/core_workflow.md.

Phase 3: BibTeX Formatting

Produce clean, consistent entries. Entry types and required fields are in references/bibtex_formatting.md.

python scripts/format_bibtex.py references.bib --output clean.bib --deduplicate
python scripts/format_bibtex.py references.bib --output clean.bib --rekey --deduplicate

Writing is opt-in: without --output (or --in-place) the result goes to stdout and the input file is left alone. Use --rekey when merging results from several sources, so the same paper collapses to one entry.

Phase 4: Citation Validation

Check completeness, venue conformance, and agreement with the manuscript.

python scripts/validate_citations.py references.bib --report report.json
python scripts/validate_citations.py references.bib --venue nature
python scripts/validate_citations.py references.bib --manuscript paper.tex
python scripts/validate_citations.py references.bib --check-dois     # slow; hits CrossRef

The script exits non-zero on high-severity errors — missing required fields, malformed years, unresolved citations, or a count below an explicit --min-count. Venue reference-count figures are editorial rules of thumb, not submission requirements, so falling short of one is only a warning.

Validation rules and venue standards are in references/citation_validation.md.

Phase 5: Integration with Writing Workflow

Search, extract, format, validate, then cite. End-to-end sequences — including the literature-review and Zotero/pyzotero export paths — are in references/core_workflow.md and references/example_workflows.md.

Reference Files

Common Pitfalls to Avoid

  1. Single source bias: Only using one database

    • Solution: Search at least OpenAlex and PubMed, then merge with format_bibtex.py --rekey --deduplicate
  2. Accepting metadata blindly: Not verifying extracted information

    • Solution: Spot-check extracted metadata against original sources
  3. Ignoring DOI errors: Broken or incorrect DOIs in bibliography

    • Solution: Run validation before final submission
  4. Inconsistent formatting: Mixed citation key styles, formatting

    • Solution: Use format_bibtex.py to standardize
  5. Duplicate entries: Same paper cited multiple times with different keys

    • Solution: Use duplicate detection in validation
  6. Missing required fields: Incomplete BibTeX entries (volume, pages, DOI missing)

    • Solution: Run Phase 2.5 metadata enrichment — web search for every missing field before proceeding. NEVER leave an @article entry without volume, pages, and DOI.
  7. Outdated preprints: Citing preprint when published version exists

    • Solution: Check if preprints have been published, update to journal version
  8. Special character issues: Broken LaTeX compilation due to characters

    • Solution: Use proper escaping or Unicode in BibTeX
  9. No validation before submission: Submitting with citation errors

    • Solution: Always run validation as final check
  10. Manual BibTeX entry: Typing entries by hand

    • Solution: Always extract from metadata sources using scripts

Integration with Other Skills

Literature Review Skill

Citation Management provides the technical infrastructure for Literature Review:

  • Literature Review: Multi-database systematic search and synthesis
  • Citation Management: Metadata extraction and validation

Combined workflow:

  1. Use literature-review for systematic search methodology
  2. Use citation-management to extract and validate citations
  3. Use literature-review to synthesize findings
  4. Use citation-management to ensure bibliography accuracy

Scientific Writing Skill

Citation Management ensures accurate references for Scientific Writing:

  • Export validated BibTeX for use in LaTeX manuscripts
  • Verify citations match publication standards
  • Format references according to journal requirements

Venue Templates Skill

Citation Management works with Venue Templates for submission-ready manuscripts:

  • Different venues require different citation styles
  • Generate properly formatted references
  • Validate citations meet venue requirements

Resources

Bundled Resources

References (in references/):

  • google_scholar_search.md: Complete Google Scholar search guide
  • pubmed_search.md: PubMed and E-utilities API documentation
  • metadata_extraction.md: Metadata sources and field requirements
  • citation_validation.md: Validation criteria and quality checks
  • bibtex_formatting.md: BibTeX entry types and formatting rules

Scripts (in scripts/):

  • search_openalex.py: OpenAlex search client (no API key)
  • search_pubmed.py: PubMed E-utilities API client
  • search_google_scholar.py: Google Scholar search automation
  • extract_metadata.py: Universal metadata extractor
  • validate_citations.py: Citation validation and verification
  • format_bibtex.py: BibTeX formatter and cleaner
  • doi_to_bibtex.py: Quick DOI to BibTeX converter
  • _common.py: shared BibTeX parser, renderer, and citation-key scheme

Assets (in assets/):

  • bibtex_template.bib: Example BibTeX entries for all types
  • citation_checklist.md: Quality assurance checklist

External Resources

Search Engines:

Metadata APIs:

Tools and Validators:

Citation Styles:

Dependencies

Required Python Packages

uv pip install requests  # HTTP access to CrossRef, PubMed, OpenAlex, arXiv

BibTeX parsing, rendering, deduplication, and validation are standard library (scripts/_common.py), so format_bibtex.py and validate_citations.py run with no third-party packages at all.

Optional

uv pip install scholarly  # only for search_google_scholar.py

Where credentials are sent

This skill needs no API key. The two environment variables it reads are optional identifiers, each sent to the one service it belongs to and nowhere else; no script bundles environment variables together.

Variable Sent only to Purpose
NCBI_API_KEY eutils.ncbi.nlm.nih.gov Raises Entrez rate limits
NCBI_EMAIL eutils.ncbi.nlm.nih.gov Entrez caller identification (requested by NCBI)
OPENALEX_EMAIL api.openalex.org Joins the faster OpenAlex polite pool

api.openalex.org, api.crossref.org, api.datacite.org, export.arxiv.org, and eutils.ncbi.nlm.nih.gov are all queried without credentials when these are unset.

Summary

The citation-management skill provides:

  1. Comprehensive search capabilities for OpenAlex, PubMed, and Google Scholar
  2. Automated metadata extraction from DOI, PMID, PMCID, arXiv ID, URLs
  3. Citation validation with DOI verification and completeness checking
  4. BibTeX formatting with standardization and cleaning tools
  5. Quality assurance through validation and reporting
  6. Integration with scientific writing workflow
  7. Reproducibility through documented search and extraction methods

Use this skill to maintain accurate, complete citations throughout your research and ensure publication-ready bibliographies.

Related skills

  • bibtex-hygiene: Clean, deduplicate and validate BibTeX/BibLaTeX bibliographies before submission.
  • citation-verification: Verify that every reference in a manuscript really exists and matches its metadata, catching hallucinated, corrupted, mismatched or retract…
  • literature-review: Runs systematic literature reviews by searching PubMed, arXiv, bioRxiv, and Semantic Scholar (plus web search via parallel-cli), screening…

Trigger Prompts & Evaluation Corpus

These evaluation prompts test that the agent correctly selects citation-management for relevant tasks and leaves it out for near misses.

Should trigger (3)

  • should trigger

    “turn these into bibtex: 10.1038/s41586-021-03819-2, PMID 31452104, arXiv:1706.03762”

    expects Uses the skill's extraction scripts (extract_metadata.py or doi_to_bibtex.py) to resolve the DOI via CrossRef, the PMID via PubMed and the arXiv ID via arXiv, and returns well-formed BibTeX entries. Checks that @article entries have volume, pages and doi, and does not type entries by hand.

  • should trigger

    “My refs.bib has ~120 entries merged from Zotero and a PubMed export, and I'm seeing the same paper under keys like smith2020 and Smith2020deep. Several @article entries have no volume or pages. Can you merge/dedupe it, fill in the gaps, and make sure it's clean before I submit to Bioinformatics? Don't overwrite the original file.”

    expects Runs format_bibtex.py with --rekey --deduplicate writing to a new file via --output rather than modifying refs.bib in place. Fills missing volume, pages and DOI from OpenAlex/CrossRef or web search, logging sources and adding a note field where a value can't be found. Then runs validate_citations.py and reports remaining errors.

  • should trigger

    “I'm writing a background section on single-cell foundation models and need a starter set of the most-cited recent papers on that topic, with entries I can drop straight into my LaTeX bibliography.”

    expects Searches more than one database (OpenAlex via search_openalex.py and PubMed, with Google Scholar only as a supplement), and merges the results into deduplicated BibTeX with consistent keys. Extracts complete metadata for the chosen papers and validates the resulting .bib file.

Near misses (2)

  • near miss

    “I drafted my bibliography with ChatGPT and I'm worried some references are fabricated or that DOIs point to the wrong paper. Can you check whether each citation in my manuscript really exists and matches the real publication?”

    expects Recognizes this as a check that references exist and match their real metadata, which belongs to citation-verification rather than general citation management, and routes the task there.

  • near miss

    “Help me design a PRISMA-compliant systematic review of SGLT2 inhibitors in heart failure: write the search strings for each database, set up the screening criteria, and plan the data extraction and synthesis.”

    expects Recognizes this as systematic review methodology (search protocol, screening, extraction, synthesis), which belongs to literature-review rather than citation-management.