How to install literature-search
npx skills add https://github.com/lingzhi227/agent-research-skills --skill literature-searchFull instructions (SKILL.md)
Source of truth, from lingzhi227/agent-research-skills.
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
- Expand the user's query into 2-4 complementary search queries
- Run Semantic Scholar search (primary) with expanded queries
- Run arXiv for very recent preprints (< 3 months)
- Optionally run OpenAlex for broader coverage
- Merge and deduplicate results
- Rank by: citations (0.3) + recency (0.3) + venue quality (0.2) + relevance (0.2)
- 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, literature-review, related-work-writing
- See also: deep-research, novelty-assessment
Related skills
More from lingzhi227/agent-research-skills and the wider catalog.
literature-review
Conduct comprehensive literature reviews using multi-perspective dialogue simulation. Generate diverse expert personas, conduct grounded Q&A conversations, and synthesize findings into structured knowledge. Use when starting a new research project or writing a survey section.
figure-generation
Generate publication-quality scientific figures using matplotlib/seaborn with a three-phase pipeline (query expansion, code generation with execution, VLM visual feedback). Handles bar charts, line plots, heatmaps, training curves, ablation plots, and more. Use when the user needs figures, plots, or visualizations for a paper.
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.
latex-formatting
Handle LaTeX formatting, templates, and styling for academic papers. Set up conference templates (ICML, ICLR, NeurIPS, AAAI, ACL), fix formatting issues, manage packages, and ensure venue-specific compliance. Use when the user needs to set up a paper template, fix LaTeX formatting, or prepare for submission.
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.
math-reasoning
Formal mathematical reasoning for research papers — derive equations, write proofs, formalize problem settings, select statistical tests, and generate LaTeX math notation. Use when the user needs mathematical derivations, theorem proofs, notation tables, or statistical analysis formalization.