/literature-search
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.
$ npx -y skills add lingzhi227/agent-research-skills --skill literature-search --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/literature-search
Context preview
The summary Claude sees to decide when to auto-load this skill.
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.
SKILL.md
literature-search.SKILL.mdname: literature-search
description: 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.
argument-hint: [search-query]
Literature Search
Search multiple academic databases to find relevant papers.
Input
- `$ARGUMENTS` — The search query (natural language)
Scripts
Semantic Scholar (primary — best for ML/AI, has BibTeX)
python ~/.claude/skills/deep-research/scripts/search_semantic_scholar.py \
--query "QUERY" --max-results 20 --year-range 2022-2026 \
--api-key "$(grep S2_API_Key /Users/lingzhi/Code/keys.md 2>/dev/null | cut -d: -f2 | tr -d ' ')" \
-o results_s2.jsonl
Key flags: `--peer-reviewed-only`, `--top-conferences`, `--min-citations N`, `--venue NeurIPS ICML`
arXiv (latest preprints)
python ~/.claude/skills/deep-research/scripts/search_arxiv.py \
--query "QUERY" --max-results 10 -o results_arxiv.jsonl
OpenAlex (broadest coverage, free, no API key)
python ~/.claude/skills/literature-search/scripts/search_openalex.py \
--query "QUERY" --max-results 20 --year-range 2022-2026 \
--min-citations 5 -o results_openalex.jsonl
Merge & Deduplicate
python ~/.claude/skills/deep-research/scripts/paper_db.py merge \
--inputs results_s2.jsonl results_arxiv.jsonl results_openalex.jsonl \
--output merged.jsonl
CrossRef (DOI-based lookup, broadest type coverage)
python ~/.claude/skills/literature-search/scripts/search_crossref.py \
--query "QUERY" --rows 10 --output results_crossref.jsonl
Key flags: `--bibtex` (output .bib format), `--rows N`
Download arXiv Source (get .tex files)
python ~/.claude/skills/literature-search/scripts/download_arxiv_source.py \
--title "Paper Title" --output-dir arxiv_papers/
Key flags: `--arxiv-id 1706.03762`, `--metadata`, `--max-results N`
Generate BibTeX from results
python ~/.claude/skills/deep-research/scripts/bibtex_manager.py \
--jsonl merged.jsonl --output references.bib
Workflow
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
Venue Quality Tiers
**Tier 1:** NeurIPS, ICML, ICLR, ACL, EMNLP, NAACL, CVPR, ICCV, ECCV, KDD, AAAI, IJCAI, SIGIR, WWW **Tier 2:** AISTATS, UAI, COLT, COLING, EACL, WACV, JMLR, TACL **Tier 3:** Workshops, arXiv preprints — mark with `(preprint)`
Output Format
Present results as a table + detailed entries with BibTeX keys. Always note preprint status.
Related Skills
- Downstream: [citation-management](../citation-management/), [literature-review](../literature-review/), [related-work-writing](../related-work-writing/)
- See also: [deep-research](../deep-research/), [novelty-assessment](../novelty-assessment/)
Read more
name: literature-search description: 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. argument-hint: [search-query]
Literature Search
Search multiple academic databases to find relevant papers.
Input
- `$ARGUMENTS` — The search query (natural language)
Scripts
Semantic Scholar (primary — best for ML/AI, has BibTeX)
python ~/.claude/skills/deep-research/scripts/search_semantic_scholar.py \ --query "QUERY" --max-results 20 --year-range 2022-2026 \ --api-key "$(grep S2_API_Key /Users/lingzhi/Code/keys.md 2>/dev/null | cut -d: -f2 | tr -d ' ')" \ -o results_s2.jsonl
Key flags: `--peer-reviewed-only`, `--top-conferences`, `--min-citations N`, `--venue NeurIPS ICML`
arXiv (latest preprints)
python ~/.claude/skills/deep-research/scripts/search_arxiv.py \ --query "QUERY" --max-results 10 -o results_arxiv.jsonl
OpenAlex (broadest coverage, free, no API key)
python ~/.claude/skills/literature-search/scripts/search_openalex.py \ --query "QUERY" --max-results 20 --year-range 2022-2026 \ --min-citations 5 -o results_openalex.jsonl
Merge & Deduplicate
python ~/.claude/skills/deep-research/scripts/paper_db.py merge \ --inputs results_s2.jsonl results_arxiv.jsonl results_openalex.jsonl \ --output merged.jsonl
CrossRef (DOI-based lookup, broadest type coverage)
python ~/.claude/skills/literature-search/scripts/search_crossref.py \ --query "QUERY" --rows 10 --output results_crossref.jsonl
Key flags: `--bibtex` (output .bib format), `--rows N`
Download arXiv Source (get .tex files)
python ~/.claude/skills/literature-search/scripts/download_arxiv_source.py \ --title "Paper Title" --output-dir arxiv_papers/
Key flags: `--arxiv-id 1706.03762`, `--metadata`, `--max-results N`
Generate BibTeX from results
python ~/.claude/skills/deep-research/scripts/bibtex_manager.py \ --jsonl merged.jsonl --output references.bib
Workflow
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
Venue Quality Tiers
**Tier 1:** NeurIPS, ICML, ICLR, ACL, EMNLP, NAACL, CVPR, ICCV, ECCV, KDD, AAAI, IJCAI, SIGIR, WWW **Tier 2:** AISTATS, UAI, COLT, COLING, EACL, WACV, JMLR, TACL **Tier 3:** Workshops, arXiv preprints — mark with `(preprint)`
Output Format
Present results as a table + detailed entries with BibTeX keys. Always note preprint status.
Related Skills
- Downstream: [citation-management](../citation-management/), [literature-review](../literature-review/), [related-work-writing](../related-work-writing/)
- See also: [deep-research](../deep-research/), [novelty-assessment](../novelty-assessment/)
31 skills for Claude Code covering the full academic research paper lifecycle — from literature search to slide generation — plus GitHub repository analysis for research topics. Extracted from 17 GitHub repos studying LLM-agent-driven research automation.
Other skills on agent-research-skills.
- /algorithm-design
Design algorithms with LaTeX pseudocode and UML diagrams. Generate algorithmic environments, Mermaid class/sequence diagrams, and ensure consistency between pseudocode and implementation. Use when formalizing methods for a paper.
Open skill - /atomic-decomposition
Decompose research ideas into atomic, self-contained concepts with bidirectional math-code mapping. For each concept, extract the math formula from papers and find code implementations. Use for complex system papers requiring formal grounding.
Open skill - /backward-traceability
Make every number in the final PDF traceable to the exact code line that produced it. Uses \hypertarget/\hyperlink LaTeX commands and \num{formula} evaluated at compile time. Use for reproducibility and data integrity verification.
Open skill - /citation-management
Manage BibTeX citations for LaTeX papers. Harvest missing citations from a draft using Semantic Scholar, validate cite keys against .bib files, deduplicate entries, and format bibliography. Use when working with references, BibTeX, or citations.
Open skill - /code-debugging
Debug experiment code with structured error analysis. Categorize errors, apply targeted fixes with retry logic, and use reflection to prevent recurring issues. Use when experiment code fails or produces incorrect results.
Open skill - /data-analysis
Generate statistical analysis code with 4-round review. Select appropriate statistical tests, interpret results, and produce analysis reports with p-values, effect sizes, and confidence intervals. Use when analyzing experimental data for a paper.
Open skill