Collection of arXiv paper management skills including CLI tool integration for fetching/searching papers and converting papers to Markdown documentation

GitHub stars
49

Install

/plugin install arxiv-skills@arxiv-skills

Run it inside Claude Code after adding the marketplace with /plugin marketplace add ultimatile/arxiv-skills.

Contents

Discovered from source

Skills 2

arXiv Document Builder

Procedure

  1. Run the converter:

    # Using global command (recommended)
    convert-paper ARXIV_ID [--output-dir DIR]
    
    # Using script directly
    uv run --project "SKILL_DIR" "SKILL_DIR/arxiv_doc_builder/convert_paper.py" ARXIV_ID [--output-dir DIR]
    
    • SKILL_DIR: replace with the absolute path of the directory this SKILL.md is in. It is a placeholder, not a shell variable. Keep the double quotes around it, so a path containing spaces stays one argument. The command then runs from any working directory.
    • --output-dir: Directory where {SAFE_ID}/{SAFE_ID}.md will be created. Default: current working directory (not a papers/ subdirectory). {SAFE_ID}, here and below, is ARXIV_ID with / replaced by _, as in hep-th/9711200 → hep-th_9711200. A new-style ID contains no /, so it is used unchanged.
    • Use absolute paths to control output location precisely.

    convert-paper does the metadata lookup, downloads, extraction, and directory creation itself; do not run curl, tar, or mkdir for them.

  2. On success, convert-paper prints the Markdown file's path on its Output: line. The file opens with a YAML frontmatter block of provenance metadata; references/output-format.md documents its fields, including what metadata_status records. The File Organization section of references/output-format.md shows the layout of the paper's directory, {SAFE_ID}/.

When Conversion Fails or Falls Back to PDF

If you edited a file under {SAFE_ID}/source/ and re-ran convert-paper, read references/source-edits.md first and follow it before any line below.

When you made no such edit, or once that file no longer tells you to edit again or re-run, read the file that the line matching the output points to. For an output not listed here, act on what the output itself says.

Whichever file you follow, change the source only as it directs. Do NOT attempt broad preprocessing (replacing documentclass, expanding \newcommand, removing environments, etc.) — pandoc handles revtex4/revtex4-2, custom commands, picture environments, and theorem environments correctly.

  • convert-paper exits with code 2 after printing Error: Found N files with \documentclass → references/multiple-documentclass.md
  • It prints Pandoc conversion failed:, and the pandoc message after it contains unexpected ( or unexpected [ → references/unknown-arity-macros.md
  • It prints Pandoc conversion failed:, and the pandoc message after it contains neither → references/pandoc-failures.md
  • It prints Pandoc did not finish within or Pandoc exceeded the <N> MB memory watchdog, or a pandoc run has not returned → references/pandoc-runaway.md
  • It prints No LaTeX source, falling back to naive PDF conversion... → references/pdf-conversion.md

arXiv Lookup

Lightweight scripts for querying the arXiv API directly via arxiv.py.

Scripts

In the commands below, SKILL_DIR is a placeholder, not a shell variable: replace it with the absolute path of the directory this SKILL.md is in. Keep the double quotes around the path, so a path containing spaces stays one argument. --no-project keeps uv from building the environment from a project in your working directory. The commands then run from any working directory.

Get Journal DOI from arXiv ID

uv run --no-project --with arxiv "SKILL_DIR/scripts/get_doi.py" <arxiv_id>
  • Returns the journal DOI if available (exit 0), or exits with error (exit 1) if not found
  • This is the journal-assigned DOI, not the arXiv-assigned DOI (10.48550/arXiv.{id})
  • arXiv-assigned DOI can be constructed mechanically: 10.48550/arXiv.<id> — no API call needed

Search arXiv and Get IDs

uv run --no-project --with arxiv "SKILL_DIR/scripts/search_id.py" <query> [max_results]
  • Searches the arXiv API directly (no local database)
  • Returns tab-separated arxiv_id\ttitle lines
  • Default: 5 results, sorted by relevance
  • Query supports arXiv API field prefixes: ti: (title), au: (author), abs: (abstract), cat: (category)
  • Use quotes for exact phrases: ti:"Attention Is All You Need"
  • Combine with AND/OR/ANDNOT: ti:transformer AND cat:cs.CL

Integration Notes

  • OpenAlex: Use get_doi.py to obtain journal DOIs for OpenAlex queries
  • arxiv-doc-builder: Use search_id.py to find arXiv IDs, then pass to arxiv-doc-builder

Sponsors

Details

Marketplace
ultimatile/arxiv-skills
Category
Community