Agent skill

Literature Search

by lingzhi227 in lingzhi227/agent-research-skills

Search academic literature using Semantic Scholar, arXiv, and OpenAlex APIs.

No licenceAuto-check passedResearch & Science

Install Literature Search

skills CLI
$ npx skills add lingzhi227/agent-research-skills --skill literature-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install lingzhi227/agent-research-skills literature-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/lingzhi227/agent-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/literature-search .claude/skills/literature-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
literature-search
GitHub stars
390
Token cost
~805 tokens
SKILL.md length
199 words
Files
4 (incl. scripts)
Skills in repo
31
Repo updated
First seen
Licence
None found

At a glance

Search academic literature using Semantic Scholar, arXiv, and OpenAlex APIs.

  • Works in 7 steps: Expand the user's query into 2-4… → Run Semantic Scholar search (primary)… → Run arXiv for very recent preprints (< 3… → …
  • The user needs to find papers
  • SKILL.md covers Input, Scripts, Workflow and Venue Quality Tiers, plus 2 more sections
  • Runs Python scripts from its folder; calls python

What it does

Literature Search is an agent skill from lingzhi227/agent-research-skills. Search academic literature using Semantic Scholar, arXiv, and OpenAlex APIs. Returns structured JSONL with title, authors, year, venue, abstract, citations, and BibTeX. Use when the user needs to find papers, check related work, or build a bibliography.

Its SKILL.md is about 810 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `scripts/download_arxiv_source.py`, `scripts/search_crossref.py` and `scripts/search_openalex.py`).

It sits in Research & Science, covering Academic paper search, Citation management and Literature review. It works with arXiv, LaTeX and Semantic Scholar. The repository describes itself as: Skills for Claude Code — deep-research: systematic academic literature review.

When your agent uses it

  • The user needs to find papers
  • Check related work
  • Build a bibliography

Example prompts

  • “/literature-search”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Expand the user's query into 2-4 complementary search queries
  2. Run Semantic Scholar search (primary) with expanded queries
  3. Run arXiv for very recent preprints (< 3 months)
  4. Optionally run OpenAlex for broader coverage
  5. Merge and deduplicate results
  6. Rank by: citations (0.3) + recency (0.3) + venue quality (0.2) + relevance (0.2)
  7. Present structured results table

What it can do on your machine

Read from SKILL.md and the folder at commit 9e6c085. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Literature Search loads about 805 tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 199 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~805

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 199 words (~805 tokens).

“Search multiple academic databases to find relevant papers.”

— opening of SKILL.md by lingzhi227
name
literature-search
argument-hint
search-query

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (scripts) in skills/literature-search of lingzhi227/agent-research-skills.

  • SKILL.md
  • scripts/download_arxiv_source.py
  • scripts/search_crossref.py
  • scripts/search_openalex.py

Open the folder on GitHubat commit 9e6c085

Compare with similar skills

Literature Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Literature Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Literature Search this skilllingzhi227/agent-research-skills390—~805Automated safety check: PassNone
Literature Review AgentAr9av/PaperOrchestra6791 repos~5.2kAutomated safety check: PassCustom licence
Literature ReviewNorman-bury/research-writing-skill3.4k—~2.2kAutomated safety check: NotesMIT
Literature Reviewneflibata-feng/MyArxiv-Agent12620 repos~5.9kAutomated safety check: NotesMIT
Paper Research on arXivXiaomiMiMo/MiMo-Code14k—~1.5kAutomated safety check: PassMIT
Arxiv MCP Serverblazickjp/arxiv-mcp-server3.2k—~353Automated safety check: PassApache-2.0

Similar skills

  • Literature Review Agent

    Ar9av/PaperOrchestra

    Step 3 of the PaperOrchestra pipeline (arXiv:2604.05018). An agent skill from Ar9av/PaperOrchestra.

    679 GitHub starsUsed in 1 repo~5.2k tokens
    Research & ScienceAuto-check passed
  • Literature Review

    Norman-bury/research-writing-skill

    A skill your agent uses when writing literature review sections - guides searching, organizing, and synthesizing academic sources

    3.4k GitHub stars~2.2k tokensUpdated 4 mo ago
    Research & ScienceAuto-check: notes
  • Literature Review

    neflibata-feng/MyArxiv-Agent

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).

    126 GitHub starsUsed in 20 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Paper Research on arXiv

    XiaomiMiMo/MiMo-Code

    Searches arXiv, fetches metadata, generates BibTeX, downloads PDFs and finds citations and related papers using a bundled Python script.

    14k GitHub stars~1.5k tokensUpdated 2 days ago
    Research & ScienceAuto-check passed
  • Arxiv MCP Server

    blazickjp/arxiv-mcp-server

    A skill your agent uses when finding, comparing, reading, or monitoring arXiv papers, including requests for abstracts, citation graphs, original LaTeX, section-level technical details, or…

    3.2k GitHub stars~353 tokensUpdated 3 days ago
    Research & ScienceAuto-check passed
  • Arxiv Paper Writer

    appautomaton/latex-arxiv-SKILL

    Write LaTeX ML/AI review articles for arXiv using the IEEEtran template and verified BibTeX citations.

    458 GitHub stars~2.3k tokensUpdated 27 days ago
    Research & ScienceAuto-check passed

More from lingzhi227/agent-research-skills

All 31 skills in this repo
  • Backward Traceability

    lingzhi227/agent-research-skills

    Makes each number in a LaTeX paper link back to the code line that produced it, using hypertarget and hyperlink tags and compile-time `\num` formulas.

    390 GitHub stars~802 tokensUpdated 7 mo ago
    Auto-check passed
  • Statistical Data Analysis

    lingzhi227/agent-research-skills

    Writes statistical analysis code for experimental data, runs it through a four-round review, and reports effect sizes, p-values and confidence intervals.

    390 GitHub stars~886 tokensUpdated 7 mo ago
    Auto-check passed
  • Excalidraw Canvas Toolkit

    lingzhi227/agent-research-skills

    Draws and refines Excalidraw diagrams on a live canvas through MCP tools or a REST API, with screenshots, file import and export, snapshots and Mermaid conversion.

    390 GitHub stars~3.8k tokensUpdated 7 mo ago
    Auto-check passed
  • Research Experiment Designer

    lingzhi227/agent-research-skills

    Plans research experiments in four progressive stages, from a first working implementation through baseline tuning and creative research to ablation studies.

    390 GitHub stars~752 tokensUpdated 7 mo ago
    Auto-check passed
  • Scientific Figure Generation

    lingzhi227/agent-research-skills

    Generates publication-quality scientific figures with matplotlib or seaborn through query expansion, a run-and-retry coding loop and a visual check of the rendered PNG.

    390 GitHub stars~809 tokensUpdated 7 mo ago
    Auto-check passed
  • Research Idea Generation

    lingzhi227/agent-research-skills

    Generates and iteratively refines research ideas for a given area, checking each one's novelty against Semantic Scholar and arXiv, and scoring it on interestingness, feasibility and novelty.

    390 GitHub stars~747 tokensUpdated 7 mo ago
    Auto-check passed

Questions about Literature Search

What does Literature Search do?

Search academic literature using Semantic Scholar, arXiv, and OpenAlex APIs. Literature Search is an agent skill from lingzhi227/agent-research-skills. Search academic literature using Semantic Scholar, arXiv, and OpenAlex APIs.

When should I use Literature Search?

Literature Search fits situations like: the user needs to find papers; check related work; build a bibliography.

How do I install Literature Search in Claude Code?

Run `npx skills add lingzhi227/agent-research-skills --skill literature-search -a claude-code`. Or copy the skill folder (skills/literature-search in lingzhi227/agent-research-skills) into .claude/skills/literature-search in your project. Claude Code loads it when a task matches its description.

How do I install Literature Search in Codex?

Run `npx skills add lingzhi227/agent-research-skills --skill literature-search -a codex`. Or copy the skill folder (skills/literature-search in lingzhi227/agent-research-skills) into .agents/skills/literature-search in your project. Codex loads it when a task matches its description.

Can I use Literature Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add lingzhi227/agent-research-skills --skill literature-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/literature-search, .gemini/skills/literature-search, .github/skills/literature-search and .opencode/skills/literature-search in your project.

What does Literature Search need to run?

Going by SKILL.md and its folder, Literature Search needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Literature Search access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Literature Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Literature Search use?

No licence was found for Literature Search or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Literature Search use?

About 805 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Literature Search?

Skills that share tags, products or a category with Literature Search: Literature Review Agent (Ar9av/PaperOrchestra, 679 stars), Literature Review (Norman-bury/research-writing-skill, 3.4k stars), Literature Review (neflibata-feng/MyArxiv-Agent, 126 stars) and Paper Research on arXiv (XiaomiMiMo/MiMo-Code, 14k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Literature Search?

lingzhi227 (a GitHub user) maintains it in lingzhi227/agent-research-skills, which has 390 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on February 27, 2026.

Source: lingzhi227/agent-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.