cite

name	cite
description	Finds a paper by title, author, or DOI, adds BibTeX to references.bib, and shows citation syntax. Use when adding a reference.
argument-hint	<paper or DOI>
allowed-tools	Bash, Read, Write, Edit, Glob, Grep, WebSearch, WebFetch
version	1.0.0
workflow_stage	writing
tags	["citations","bibliography","BibTeX"]

Add Citation

Find a paper, create a BibTeX entry, add it to references.bib, and provide the citation syntax.

Arguments

• $ARGUMENTS — a paper description, title, author name, or DOI (e.g., "Acemoglu 2001 colonial origins" or "10.1257/aer.91.5.1369")

Steps

1. Parse the argument to determine if it is a DOI or a descriptive search query.

2. Search for the paper:

   • If a DOI is provided, fetch the metadata directly (use web search or CrossRef)
   • If a description is provided, search the web to identify the paper and its DOI/metadata

3. Construct a valid BibTeX entry with these fields (at minimum):

   • @article{key, (or @book, @incollection, etc. as appropriate)
   • author, title, journal (or booktitle), year, volume, number, pages, doi
   • Use a citation key in the format: lastname_yearword (e.g., acemoglu2001colonial)

4. Read references.bib and check for duplicate keys:

   • If the exact key already exists, inform the user and show the existing entry
   • If a similar key exists (same author and year), warn the user

5. Append the new entry to references.bib (add a blank line before the new entry)

6. Show the user the citation syntax for use in index.qmd:

   • Narrative: @key → "Author (Year)"
   • Parenthetical: [@key] → "(Author, Year)"
   • Multiple: [@key1; @key2]

7. Ask if the user wants to create an annotation note in references/ (see /project:literature-note)

Error handling

• If the paper cannot be found, report the search results and ask the user to provide more details or a DOI.
• If references.bib does not exist, create it with the new entry.