paper-search-usage — Claude Code skill: what it does, how to install
paper-search-usage guides coding agents to query academic databases, fetch citation graphs, and download research papers via Paper Search CLI.
Apache-2.0 1 installs ★ 1,216 updated 2026-10-24
npx skills add fcakyon/claude-codex-settings --skill paper-search-usage -a claude-codeWhat paper-search-usage does
This skill instructs the agent on executing commands with the paper-search CLI. It defines how to query repositories like arXiv, PubMed, or Crossref, retrieve active sources, and handle structured JSON outputs while checking for partial API failures.
The prompt covers downloading PDF files to local directories, extracting paper content, and exploring citation networks. Operations for citing or referenced literature accept only a DOI or OpenAlex work ID, meaning paper titles will cause citation lookup errors.
The underlying paper-search tool must be accessible in your shell environment. Querying Scopus, IEEE, or Web of Science requires credentials configured beforehand. In addition, the instructions warn the agent not to treat plain text search snippets as final proof for numerical claims.
What it helps with
- query arXiv, PubMed, and Crossref from the command line
- download academic papers into a designated local directory
- inspect citing and referenced papers using a DOI or OpenAlex ID
- validate scientific results directly against published PDF tables
Example prompts for the agent
- Search for object detection papers on arXiv and Crossref, limit to 5
- Download arXiv paper 1706.03762 into ./downloads and read it
- Find all citing papers for DOI 10.1038/nature12373
How to install paper-search-usage
1Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill paper-search-usage -a claude-code2Manually: put the files in place
~/.claude/skills/paper-search-usage/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/paper-search-usage/
1Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill paper-search-usage -a codex2Manually: put the files in place
.agents/skills/paper-search-usage/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill paper-search-usage -a cursor2Manually: put the files in place
.cursor/skills/paper-search-usage/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install fcakyon/claude-codex-settings plugins/paper-search-tools/skills/paper-search-usage2Manually: put the files in place
.github/skills/paper-search-usage/SKILL.md1Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill paper-search-usage -a gemini-cli2Platform CLI
gemini skills install https://github.com/fcakyon/claude-codex-settings --path plugins/paper-search-tools/skills/paper-search-usageManually: put the files in place
.devin/skills/paper-search-usage/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill paper-search-usage -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about paper-search-usage
How to install paper-search-usage in Claude Code?
Run npx skills add fcakyon/claude-codex-settings --skill paper-search-usage -a claude-code in your terminal.
What does paper-search-usage do?
It gives coding agents standard instructions to search academic databases, download PDFs, and trace citations via the paper-search CLI.
Do all search sources work without credentials?
Public sources work freely, but querying IEEE, Scopus, or Web of Science (wos) requires preconfigured credentials.
Source text
SKILL.md · Apache-2.0
--- name: paper-search-usage description: This skill should be used when the user asks to "search for papers", "find research papers", "search arXiv", "search PubMed", "look up a DOI", "download a paper", "search IEEE", or "search Scopus". --- # Search and read papers Run [Paper Search CLI](https://github.com/fcakyon/paper-search-cli) through the shell. If `paper-search` is unavailable, follow [setup](../setup/SKILL.md). ## Find papers ```bash paper-search search 'object detection' -s fast -n 5 paper-search search 'object detection' -s arxiv,crossref -n 5 paper-search sources ``` Search returns JSON. Check `errors` for partial failures and retain source identifiers and URLs. Try alternate terms and multiple sources before concluding that no papers exist. Discover source names with `paper-search sources`; use explicit `-s ieee`, `-s scopus`, or `-s wos` only with configured credentials. ## Look up, download, and read ```bash paper-search tool get_crossref_paper_by_doi 10.1038/nature12373 paper-search download arxiv 1706.03762 -o ./downloads paper-search read arxiv 1706.03762 -o ./downloads paper-search tool get_citing_papers 10.1038/nature12373 paper-search tool get_referenced_papers 10.1038/nature12373 ``` Citation commands accept a DOI or OpenAlex work ID, not a title. Check pagination and truncation metadata before treating a citation list as complete. Use `paper-search tool --help` and `paper-search tool <operation> --help` to discover other operations and their arguments. Verify author names, venue, and year against the published paper or official record. For numerical claims, inspect the PDF's actual table or figure; extracted text can lose layout. Do not treat a search snippet as evidence for a result.
© fcakyon · Apache-2.0 · fcakyon/claude-codex-settings