scholar-search
- Repo stars 12
- Author updated Live
- Author repo agent-skills
- Domain
- Other
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 88 / 100 · community maintained
- Author / version / license
- @mrshu · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Required · Vendor-specific
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No special requirements
- Permissions
-
- Read-only
- Write / modify
- Network behavior
- External requests
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: scholar-search
description: Find academic papers, explore citations, and export BibTeX. Use when asked about research papers…
category: other
runtime: no special runtime
---
# scholar-search output preview
## PART A: Task fit
- Use case: Find academic papers, explore citations, and export BibTeX. Use when asked about research papers, references, citations, bibliography, or scholarly information. Find papers with s2cli (Semantic Scholar), openalexcli (OpenAlex), and arxivy (arXiv), get high-quality BibTeX with dblpcli (DBLP). All tools run via uvx — no installation needed. requires Vendor-….
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “Finding Papers / s2cli (Semantic Scholar) / openalexcli (OpenAlex)” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “Find academic papers, explore citations, and export BibTeX. Use when asked about research papers, references, citations, bibliography, or scholarly information. Find papers with s2cli (Semantic Scholar), openalexcli (OpenAlex), and arxivy (arXiv), get high-quality BibTeX with dblpcli (DBLP). All tools run via uvx — no installation needed. requires Vendor-…”.
- **02** When the source has headings, the agent prioritizes “Finding Papers / s2cli (Semantic Scholar) / openalexcli (OpenAlex)” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, write/modify files; may access external network resources; requires Vendor-specific API keys.
## Running Rules
- read files, write/modify files; may access external network resources; requires Vendor-specific API keys.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options. The source does not require a stable slash command. After installation, invoke the skill by name and describe the task.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, write/modify files.
Start with a small task and check whether the result follows “Finding Papers / s2cli (Semantic Scholar) / openalexcli (OpenAlex)”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: scholar-search
description: Find academic papers, explore citations, and export BibTeX. Use when asked about research papers…
category: other
source: mrshu/agent-skills
---
# scholar-search
## When to use
- Find academic papers, explore citations, and export BibTeX. Use when asked about research papers, references, citation…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “Finding Papers / s2cli (Semantic Scholar) / openalexcli (OpenAlex)” and keep inference separate from source facts.
- read files, write/modify files; may access external network resources; requires Vendor-specific API keys.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies. The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "scholar-search" {
input -> user goal + target files + boundaries + acceptance criteria
context -> Finding Papers / s2cli (Semantic Scholar) / openalexcli (OpenAlex)
rules -> SKILL.md triggers / order / output contract
runtime -> no special runtime | read files, write/modify files | may access external network resources
guardrails -> requires Vendor-specific API keys + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
} Academic Scholar Search
Find papers with s2cli (Semantic Scholar), openalexcli (OpenAlex), and arxivy (arXiv), get high-quality BibTeX with dblpcli (DBLP). All tools run via uvx — no installation needed.
Finding Papers
Three tools for paper discovery, each with different strengths.
s2cli (Semantic Scholar)
Best for: paper recommendations, citation/reference networks, arXiv/DOI lookups, citation count filtering.
# Search by keyword
uvx s2cli search "attention mechanism" --limit 10 --json
uvx s2cli search "transformers" --year 2020-2024 --min-citations 100 --json
# Filter options: --year, --venue, --field, --min-citations, --open-access
# Get paper details by ID (supports S2 ID, DOI, arXiv, CorpusId)
uvx s2cli paper ARXIV:1706.03762 --json
uvx s2cli paper DOI:10.18653/v1/N18-3011 --json
# Citation network
uvx s2cli citations ARXIV:1706.03762 --limit 20 --json # papers citing this
uvx s2cli references ARXIV:1706.03762 --limit 20 --json # papers cited by this
# Recommendations based on a seed paper
uvx s2cli recommend ARXIV:1706.03762 --limit 10 --json
uvx s2cli recommend ARXIV:1706.03762 --pool all-cs --json # pool: 'recent' or 'all-cs'
# Author search and papers
uvx s2cli author search "Yoshua Bengio" --json
uvx s2cli author papers <author_id> --json
openalexcli (OpenAlex)
Best for: broadest coverage (260M+ works), institution/journal queries, group-by aggregation, ORCID lookups, date range filtering.
# Search by keyword
uvx openalexcli search "attention mechanism" --limit 10 --json
uvx openalexcli search "transformers" --from-date 2020-01-01 --min-citations 100 --json
# Filter options: --filter, --from-date, --to-date, --min-citations, --open-access, --type, --sort, --group-by
# Get work by OpenAlex ID
uvx openalexcli work W2741809807 --json
# Citation network
uvx openalexcli citations W2741809807 --limit 20 --json
uvx openalexcli references W2741809807 --limit 20 --json
# Author search and works
uvx openalexcli author search "Yoshua Bengio" --json
uvx openalexcli author works <author_id> --json
# Institution queries
uvx openalexcli institution search "MIT" --json
uvx openalexcli institution works <institution_id> --json
# Journal/source queries
uvx openalexcli source search "Nature" --json
uvx openalexcli source works <source_id> --json
# Aggregation (unique to OpenAlex)
uvx openalexcli search "deep learning" --group-by publication_year --json
arxivy (arXiv)
Best for: searching arXiv directly, getting paper details by arXiv ID, browsing recent submissions in a category. No API key needed.
# Search by keyword
uvx arxivy search "attention mechanism" --limit 10
uvx arxivy search "transformers" -c cs.CL -n 20
uvx arxivy search "diffusion models" --sort submittedDate
# Include abstracts in results
uvx arxivy search "RLHF" -c cs.AI --abstract
# Get paper details by arXiv ID (accepts bare IDs, versioned IDs, or full URLs)
uvx arxivy paper 1706.03762
uvx arxivy paper 1706.03762 2010.11929 1810.04805 # compare multiple
uvx arxivy paper 1706.03762 --json
# Browse recent submissions in a category
uvx arxivy new cs.AI
uvx arxivy new cs.CL -n 20 --abstract
# BibTeX export (fallback — prefer dblpcli for curated entries)
uvx arxivy bibtex 1706.03762
uvx arxivy bibtex 1706.03762 2010.11929 > refs.bib
Note on output: arxivy auto-detects whether stdout is a terminal. In a terminal it shows Rich tables; when piped it outputs JSON. Use --json to force JSON in a terminal.
Which tool to pick
| Need | Use |
|---|---|
| Recommendations for a paper | s2cli recommend |
| Citation/reference graph traversal | s2cli citations / s2cli references |
| arXiv ID or DOI lookup | s2cli paper or arxivy paper |
| Search arXiv directly (by category, recency) | arxivy search |
| Browse new arXiv submissions | arxivy new |
| Broadest search coverage | openalexcli search |
| Filter by institution or journal | openalexcli institution / openalexcli source |
| Aggregate stats (group-by) | openalexcli search --group-by |
| ORCID-based author lookup | openalexcli author get |
Getting BibTeX
Use dblpcli for high-quality BibTeX sourced directly from DBLP (curated, consistent formatting). If a paper isn't in DBLP (e.g. a very recent arXiv preprint), fall back to uvx arxivy bibtex <arxiv_id>.
Workflow
Find the paper's DBLP key by searching:
uvx dblpcli search "attention is all you need" --format jsonThe
keyfield in results (e.g.,conf/nips/VaswaniSPUJGKP17) is what you need.Export BibTeX:
uvx dblpcli bibtex conf/nips/VaswaniSPUJGKP17Batch export (multiple keys):
uvx dblpcli bibtex conf/nips/VaswaniSPUJGKP17 journals/jmlr/KingmaB14Custom citation key:
uvx dblpcli bibtex conf/nips/VaswaniSPUJGKP17 --key vaswani2017attentionSave to file:
uvx dblpcli bibtex conf/nips/VaswaniSPUJGKP17 --output refs.bib
Full dblpcli command reference
# Search publications (supports AND/OR operators, author: prefix)
uvx dblpcli search "transformer attention" --format json
uvx dblpcli search "deep learning" --year 2020-2024 --format json
uvx dblpcli search "author:Vaswani" --limit 10 --format json
# Get publication details
uvx dblpcli pub conf/nips/VaswaniSPUJGKP17 --format json
# Author workflow
uvx dblpcli author search "Geoffrey Hinton" --format json # find PID
uvx dblpcli author get <pid> --format json # author details
uvx dblpcli author pubs <pid> --format json # list publications
uvx dblpcli author bibtex <pid> # BibTeX for ALL papers
# Venue queries
uvx dblpcli venue search "NeurIPS" --format json
uvx dblpcli venue pubs conf/nips --year 2023 --format json
Common Workflows
Literature survey
- Search broadly:
uvx s2cli search "topic" --jsonoruvx openalexcli search "topic" --json - Find key papers, explore their citations:
uvx s2cli citations <id> --json - Get recommendations:
uvx s2cli recommend <id> --json - For each paper, find the DBLP key:
uvx dblpcli search "paper title" --format json - Export BibTeX:
uvx dblpcli bibtex <key1> <key2> <key3> --output refs.bib
Build a bibliography from a list of papers
- For each paper title, search DBLP:
uvx dblpcli search "title" --format json - Collect DBLP keys from results
- Batch export:
uvx dblpcli bibtex <key1> <key2> ... --output refs.bib
Citation network exploration
- Start with a seed paper:
uvx s2cli paper ARXIV:1706.03762 --json - Get citing papers:
uvx s2cli citations ARXIV:1706.03762 --limit 20 --json - Get referenced papers:
uvx s2cli references ARXIV:1706.03762 --limit 20 --json - Find related work:
uvx s2cli recommend ARXIV:1706.03762 --json
Get all papers by an author
- From DBLP:
uvx dblpcli author search "Name" --format json→uvx dblpcli author bibtex <pid> - From Semantic Scholar:
uvx s2cli author search "Name" --json→uvx s2cli author papers <id> --json - From OpenAlex:
uvx openalexcli author search "Name" --json→uvx openalexcli author works <id> --json
Configuration
| Variable | Purpose | Required |
|---|---|---|
S2_API_KEY |
Semantic Scholar API key (higher rate limits) | No |
OPENALEX_EMAIL |
OpenAlex polite pool (faster responses) | No |
Both tools work without these but may hit rate limits on heavy use.
When to Use
Use this skill when the user asks about:
- Finding academic papers or research on a topic
- Citations, references, or bibliography
- BibTeX entries or .bib files
- Paper recommendations or related work
- Author publication lists
- Literature reviews or surveys
- DOI, arXiv, or paper lookups
- Browsing recent arXiv submissions in a category
Decide Fit First
Design Intent
How To Use It
Boundaries And Review