Citation Management

Overview

This skill manages the project's references.bib directly, using the CrossRef API to resolve DOIs into complete BibTeX entries. It does not require Zotero, any external CLI, or any desktop application. Everything happens through standard tools: curl (or equivalent HTTP client) and text editing of the .bib file.

When to Use

• "Add this paper to the bibliography"
• "Import this DOI"
• "Clean up the .bib file"
• "Are there duplicates in my references?"
• "Fix the citation keys"
• Before submission: validate that all cited papers have complete entries

Mandatory Steps

1. Resolve every DOI via CrossRef. Call https://api.crossref.org/works/{doi}. Extract: title, full author list, year, journal, volume, issue, pages, publisher, and DOI. Do not invent fields missing from the API response — leave them out instead.

2. Generate a BibTeX entry with complete fields. Required for articles: author, title, year, journal, volume, pages, doi. For books: author (or editor), title, year, publisher, doi. For chapters: add booktitle and editor.

3. Citation key format: FirstAuthorLastnameYear, e.g., Santos2024. Disambiguate collisions with lowercase letters: Santos2024a, Santos2024b. Strip accents and non-ASCII characters from the key — BibTeX tooling does not always handle Unicode in keys.

4. Check for duplicates before adding. Duplicate definition: same DOI, OR same title (case-insensitive, normalized whitespace) AND same first author AND same year. If duplicate, skip and report the existing key.