
arxiv-skills
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-skillsRun it inside Claude Code after adding the marketplace with /plugin marketplace add ultimatile/arxiv-skills.
Contents
Discovered from sourceSkills 2
arXiv Document Builder
Procedure
-
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}.mdwill be created. Default: current working directory (not apapers/subdirectory).{SAFE_ID}, here and below, isARXIV_IDwith/replaced by_, as inhep-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-paperdoes the metadata lookup, downloads, extraction, and directory creation itself; do not run curl, tar, or mkdir for them. -
On success,
convert-paperprints the Markdown file's path on itsOutput:line. The file opens with a YAML frontmatter block of provenance metadata;references/output-format.mddocuments its fields, including whatmetadata_statusrecords. The File Organization section ofreferences/output-format.mdshows 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-paperexits with code 2 after printingError: Found N files with \documentclass→references/multiple-documentclass.md- It prints
Pandoc conversion failed:, and the pandoc message after it containsunexpected (orunexpected [→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 withinorPandoc 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\ttitlelines - 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.pyto obtain journal DOIs for OpenAlex queries - arxiv-doc-builder: Use
search_id.pyto find arXiv IDs, then pass to arxiv-doc-builder
Sponsors
Details
- Marketplace
- ultimatile/arxiv-skills
- Category
- Community