scholar-search

Other Community

Repo stars 12
Author repo agent-skills

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: Find academic papers, explore citations, and export BibTeX. Use when asked about research papers, references, citations, bibliog…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “Finding Papers”, “s2cli (Semantic Scholar)”, “openalexcli (OpenAlex)”, “arxivy (arXiv)”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name scholar-search directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “Finding Papers / s2cli (Semantic Scholar) / openalexcli (OpenAlex)” before expanding.

Boundaries And Review

Dependencies: Prepare Vendor-specific API keys before running a full task.
Permissions: Declared permissions include read; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

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 json
```
The key field in results (e.g., conf/nips/VaswaniSPUJGKP17) is what you need.

Export BibTeX:

uvx dblpcli bibtex conf/nips/VaswaniSPUJGKP17

Batch export (multiple keys):

uvx dblpcli bibtex conf/nips/VaswaniSPUJGKP17 journals/jmlr/KingmaB14

Custom citation key:

uvx dblpcli bibtex conf/nips/VaswaniSPUJGKP17 --key vaswani2017attention

Save 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" --json or uvx 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

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: Other
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 88 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @mrshu · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Guided setup
External API key: Required · Vendor-specific
Detected OS requirements: Unspecified
Runtime requirements: Unspecified
Detected file/system behavior: Read-only
Detected network behavior: External requests
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview scholar-search.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# 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.

```bash
# 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.

```bash
# 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

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> Finding Papers → s2cli (Semantic Scholar) → openalexcli (OpenAlex) → arxivy (arXiv) → Which tool to pick → Getting BibTeX
terms    -> s2cli · openalexcli · arxivy · dblpcli · Note on output
files/cmd -> uvx · --json · s2cli recommend · s2cli citations · s2cli references · s2cli paper · arxivy paper · arxivy search
body sha256 -> aa375a6ac9ad