Agent skill

Aris Semantic Scholar

by OpenLAIR in OpenLAIR/dr-claw

Search published venue papers (IEEE, ACM, Springer, etc.) via Semantic Scholar API.

MITAuto-check: notesResearch & Science

Install Aris Semantic Scholar

skills CLI
$ npx skills add OpenLAIR/dr-claw --skill aris-semantic-scholar -a claude-code

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

GitHub CLI
$ gh skill install OpenLAIR/dr-claw aris-semantic-scholar --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/OpenLAIR/dr-claw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/aris-semantic-scholar .claude/skills/aris-semantic-scholar && 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
aris-semantic-scholar
GitHub stars
1.2k
Used in
1 other repo
Token cost
~2k tokens
SKILL.md length
710 words
Files
1
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

Search published venue papers (IEEE, ACM, Springer, etc.) via Semantic Scholar API.

  • Works in 7 steps: Parse Arguments → Search Papers → Fetch Details for a Specific Paper → …
  • User says search semantic scholar
  • SKILL.md covers Role & Positioning, Constants, Workflow and Key Rules
  • Calls python3; reaches api.semanticscholar.org and doi.org; needs SEMANTIC_SCHOLAR_API_KEY

What it does

Aris Semantic Scholar is an agent skill from OpenLAIR/dr-claw. Search published venue papers (IEEE, ACM, Springer, etc.) via Semantic Scholar API. Complements /aris-arxiv (preprints) with citation counts, venue metadata, and TLDR. Use when user says "search semantic scholar", "find IEEE papers", "find journal papers", "venue papers", "citation search", or wants published literature beyond arXiv preprints.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science, covering Academic paper search. It works with Semantic Scholar and arXiv. The repository describes itself as: A Super AI Lab with massive AI Doctors as Assistants. Best IDE for Research via AI Power. The licence is MIT.

When your agent uses it

  • User says search semantic scholar
  • Find IEEE papers
  • Find journal papers
  • Citation search

Example prompts

  • “search semantic scholar”
  • “find IEEE papers”
  • “find journal papers”
  • “/aris-semantic-scholar”

Requirements

  • Python 3
  • A credential in SEMANTIC_SCHOLAR_API_KEY
  • Pre-approved tools (allowed-tools): Bash(*), Read, Write

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Parse Arguments
  2. Search Papers
  3. Fetch Details for a Specific Paper
  4. De-duplicate Against arXiv
  5. Present Results
  6. Detailed Summary
  7. Final Output

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(*)
    • Read
    • Write

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.semanticscholar.org
    • doi.org

    Also links to:

    • semanticscholar.org

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • SEMANTIC_SCHOLAR_API_KEY

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

Context cost

Aris Semantic Scholar loads about 2k tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 710 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash(*), Read, Write

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from OpenLAIR/dr-claw at commit d51b64e, republished under its MIT licence (© OpenLAIR). 710 words, ~2,027 tokens.

Download SKILL.mdSave it as .claude/skills/aris-semantic-scholar/SKILL.md (or your agent's skills folder).
name
aris-semantic-scholar
description
Search published venue papers (IEEE, ACM, Springer, etc.) via Semantic Scholar API. Complements /aris-arxiv (preprints) with citation counts, venue metadata, and TLDR. Use when user says "search semantic scholar", "find IEEE papers", "find journal papers", "venue papers", "citation search", or wants published literature beyond arXiv preprints.
allowed-tools
Bash(*), Read, Write
argument-hint
query-or-paper-id
license
MIT
metadata.author
wanshuiyin/ARIS
metadata.version
1.0.0

Search topic or paper ID: $ARGUMENTS

Role & Positioning

This skill is the published venue counterpart to /aris-arxiv:

SkillSourceBest for
/aris-arxivarXiv APILatest preprints, cutting-edge unrefereed work
/aris-semantic-scholarSemantic Scholar APIPublished journal/conference papers (IEEE, ACM, Springer, etc.) with citation counts, venue info, TLDR

Do NOT duplicate arXiv's job. If results contain an externalIds.ArXiv field, the paper is also on arXiv — note this but do not re-fetch from arXiv.

Constants

  • MAX_RESULTS = 10 — Default number of search results.
  • FETCH_SCRIPT — tools/semantic_scholar_fetch.py relative to the project root. Fall back to inline Python if not found.
  • DEFAULT_FILTERS — For general research queries, apply these by default to reduce noise:
    • --fields-of-study "Computer Science,Engineering"
    • --publication-types JournalArticle,Conference

Overrides (append to arguments):

  • /aris-semantic-scholar "topic" - max: 20 — return up to 20 results
  • /aris-semantic-scholar "topic" - type: journal — only journal articles
  • /aris-semantic-scholar "topic" - type: conference — only conference papers
  • /aris-semantic-scholar "topic" - min-citations: 50 — only highly-cited papers
  • /aris-semantic-scholar "topic" - year: 2022- — papers from 2022 onward
  • /aris-semantic-scholar "topic" - fields: all — remove default field-of-study filter
  • /aris-semantic-scholar "topic" - sort: citations — bulk search sorted by citation count
  • /aris-semantic-scholar "DOI:10.1109/..." — fetch a single paper by DOI

Workflow

Step 1: Parse Arguments

Parse $ARGUMENTS for directives:

  • Query or ID: main search term, or a paper identifier:
    • DOI: 10.1109/TWC.2024.1234567
    • Semantic Scholar ID: f9314fd99be5f2b1b3efcfab87197d578160d553
    • ArXiv: ARXIV:2006.10685
    • Corpus: CorpusId:219792180
  • - max: N: override MAX_RESULTS
  • - type: journal|conference|review|all: map to --publication-types
  • - min-citations: N: map to --min-citations
  • - year: RANGE: map to --year (e.g. 2022-, 2020-2024)
  • - fields: FIELDS: override --fields-of-study (use all to remove filter)
  • - sort: citations|date: use search-bulk with --sort citationCount:desc or publicationDate:desc

If the argument matches a DOI pattern (10.XXXX/...), a Semantic Scholar ID (40-char hex), or a prefixed ID (ARXIV:..., CorpusId:...), skip search and go directly to Step 3.

Step 2: Search Papers

Locate the fetch script:

bash
SCRIPT=$(find tools/ -name "semantic_scholar_fetch.py" 2>/dev/null | head -1)
[ -z "$SCRIPT" ] && SCRIPT=$(find ~/.claude/skills/semantic-scholar/ -name "semantic_scholar_fetch.py" 2>/dev/null | head -1)

Standard search (default — relevance-ranked):

bash
python3 "$SCRIPT" search "QUERY" --max MAX_RESULTS \
  --fields-of-study "Computer Science,Engineering" \
  --publication-types JournalArticle,Conference

Bulk search (when - sort: is specified, or MAX_RESULTS > 100):

bash
python3 "$SCRIPT" search-bulk "QUERY" --max MAX_RESULTS \
  --sort citationCount:desc \
  --fields-of-study "Computer Science" \
  --year "2020-"

If semantic_scholar_fetch.py is not found, fall back to inline Python using urllib against https://api.semanticscholar.org/graph/v1/paper/search.

Recommended filter combos (from testing):

GoalFlags
High-quality journal papers--publication-types JournalArticle --min-citations 10
CS/EE papers, recent--fields-of-study "Computer Science,Engineering" --year "2022-"
Foundational / high-impactsearch-bulk --sort citationCount:desc --fields-of-study "Computer Science"
Conference papers only--publication-types Conference

Note: --venue requires exact venue names (e.g. "IEEE Transactions on Signal Processing"), not partial matches like "IEEE". Avoid using --venue in automated flows — prefer --publication-types + --fields-of-study.

Step 3: Fetch Details for a Specific Paper

When a single paper ID is requested:

bash
python3 "$SCRIPT" paper "PAPER_ID"

Where PAPER_ID can be:

  • DOI: 10.1109/TSP.2021.3071210
  • ArXiv: ARXIV:2006.10685
  • CorpusId: CorpusId:219792180
  • S2 ID: f9314fd99be5f2b1b3efcfab87197d578160d553
Show full SKILL.md (306 more words)Show less
Step 4: De-duplicate Against arXiv

For each result, check externalIds.ArXiv:

  • If present → paper is also on arXiv. Note this in output but do NOT re-fetch via /aris-arxiv.
  • If absent → paper is venue-only (e.g. IEEE without preprint). This is the unique value of this skill.
Step 5: Present Results

Present results as a table:

text
| # | Title | Venue | Year | Citations | Authors | Type |
|---|-------|-------|------|-----------|---------|------|
| 1 | Deep Learning Enabled... | IEEE Trans. Signal Process. | 2021 | 1364 | Xie et al. | Journal |

For each paper, also show:

  • DOI link: https://doi.org/DOI (for IEEE/ACM papers, this is the canonical link)
  • Open Access PDF: if openAccessPdf.url is non-empty, show it
  • TLDR: if available, show the one-line summary
  • Also on arXiv: if externalIds.ArXiv exists, note the arXiv ID
Step 6: Detailed Summary

For each paper (or top 5 if many results):

markdown
## [Title]

- **Venue**: [venue name] ([publicationVenue.type]: journal/conference)
- **Year**: [year] | **Citations**: [citationCount]
- **Authors**: [full author list]
- **DOI**: [doi link]
- **Fields**: [fieldsOfStudy]
- **TLDR**: [tldr.text if available]
- **Abstract**: [abstract]
- **Open Access**: [openAccessPdf.url or "Not available"]
- **Also on arXiv**: [ArXiv ID if exists, else "No"]
Step 7: Final Output

Summarize what was done:

  • Found N published papers for "query"
  • Filters applied: [publication types, fields, year range, etc.]
  • N papers are venue-only (not on arXiv)

Suggest follow-up skills:

text
/aris-arxiv "topic"           - search arXiv preprints (complements this search)
/aris-research-lit "topic"    - multi-source review: Zotero + local PDFs + arXiv + S2
/aris-novelty-check "idea"    - verify novelty against literature

Key Rules

  • Default to filtered search: Always apply --fields-of-study and --publication-types unless user says - fields: all. Without filters, S2 returns cross-discipline noise (linguistics, psychology, etc.).
  • Citation count is gold: S2's citation data is its main advantage over arXiv. Always show citationCount prominently and use it to rank/prioritize results.
  • Venue metadata matters: Show venue and publicationVenue.type (journal vs conference) — this helps users assess paper quality.
  • DOI is the canonical ID for published papers: Always show DOI links for IEEE/ACM/Springer papers.
  • Rate limiting: S2 API without key is heavily rate-limited (~1 req/s, strict cooldown). If HTTP 429 occurs, wait and retry. Recommend users set SEMANTIC_SCHOLAR_API_KEY env var for higher limits (free at https://www.semanticscholar.org/product/api#api-key-form).
  • TLDR may be null: Some publishers (notably IEEE) elide the TLDR field. Fall back to showing the first sentence of the abstract.
  • openAccessPdf may be empty: Many IEEE papers are closed access. Always provide the DOI link as fallback.
  • If the S2 API is unreachable, suggest using /aris-arxiv or /aris-research-lit "topic" - sources: web as fallback.

© OpenLAIR, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/aris-semantic-scholar of OpenLAIR/dr-claw.

Open the folder on GitHubat commit d51b64e

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in OpenLAIR/dr-claw, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Aris Semantic Scholar 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.

Aris Semantic Scholar compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Aris Semantic Scholar this skillOpenLAIR/dr-claw1.2k1 repos~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
Paper Searchopenags/paper-search-mcp2.8k—~1.2kAutomated safety check: NotesMIT
Literature Review AgentAr9av/PaperOrchestra6791 repos~5.2kAutomated safety check: PassCustom licence
Nature Academic Searchwp-a/nature-academic-search304—~1.4kAutomated safety check: PassMIT

Similar skills

  • 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
  • Paper Search

    openags/paper-search-mcp

    Search, download, and read academic papers from 20+ sources (arXiv, PubMed, Semantic Scholar, CrossRef, etc).

    2.8k GitHub stars~1.2k tokensUpdated 9 days ago
    Research & ScienceAuto-check: notes
  • 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
  • Nature Academic Search

    wp-a/nature-academic-search

    A skill your agent uses when users ask to 找文献、做文献检索、查论文、查临床试验、核验引用、去重文献、设计 PubMed/MeSH 检索式、追踪上下游引文、解析 DOI/PMID/PMCID/arXiv/OpenAlex/Semantic Scholar/NCT ID, 或导出 RIS、BibTeX、NBIB、ENW;also use for…

    304 GitHub stars~1.4k tokensUpdated 9 days ago
    Research & ScienceAuto-check passed
  • Paper Search

    openags/paper-search-mcp

    Search, download, and read academic papers through the paper-search MCP tools (mcppaper-search), covering arXiv, PubMed, bioRxiv, Semantic Scholar, Crossref, OpenAlex and 15+ other sources.

    2.8k GitHub stars~794 tokensUpdated 9 days ago
    Research & ScienceAuto-check: notes

More from OpenLAIR/dr-claw

All 36 skills in this repo
  • Analyzes reviewer comments and drafts venue-specific rebuttals for AI and computer science conferences, with an issue board, task list and paper edit plan.

    1.2k GitHub stars~4.9k tokensUpdated 23 days ago
    Auto-check: notes
  • Turns a research paper into a slide deck and, optionally, a narrated demo video, through script, slide generation, text-to-speech and video assembly stages you control.

    1.2k GitHub stars~1.5k tokensUpdated 23 days ago
    Auto-check passed
  • Clusters the latest news-feed results by topic and writes a briefing of research idea seeds with citations, plus a structured seeds file, without crawling new sources.

    1.2k GitHub stars~1.3k tokensUpdated 23 days ago
    Auto-check: notes
  • ML Dataset Discovery

    OpenLAIR/dr-claw

    Searches Hugging Face Hub, OpenML, GitHub and paper references for datasets that fit a research task and returns a ranked, de-duplicated table.

    1.2k GitHub stars~741 tokensUpdated 23 days ago
    Auto-check passed
  • Gemini Deep Research

    OpenLAIR/dr-claw

    Runs multi-source web research through Google's Gemini Deep Research Agent with a bundled Python script and saves a structured, cited report as files.

    1.2k GitHub stars~996 tokensUpdated 23 days ago
    Auto-check passed
  • Six-phase workflow for writing, revising and adapting grant proposals for NSF, NIH, DOE, DARPA, NASA and China's NSFC, from profiling through simulated peer review.

    1.2k GitHub stars~9.2k tokensUpdated 23 days ago
    Auto-check passed

Questions about Aris Semantic Scholar

What does Aris Semantic Scholar do?

Search published venue papers (IEEE, ACM, Springer, etc.) via Semantic Scholar API. Aris Semantic Scholar is an agent skill from OpenLAIR/dr-claw.) via Semantic Scholar API.

When should I use Aris Semantic Scholar?

Aris Semantic Scholar fits situations like: user says search semantic scholar; find IEEE papers; find journal papers; citation search.

How do I install Aris Semantic Scholar in Claude Code?

Run `npx skills add OpenLAIR/dr-claw --skill aris-semantic-scholar -a claude-code`. Or copy the skill folder (skills/aris-semantic-scholar in OpenLAIR/dr-claw) into .claude/skills/aris-semantic-scholar in your project. Claude Code loads it when a task matches its description.

How do I install Aris Semantic Scholar in Codex?

Run `npx skills add OpenLAIR/dr-claw --skill aris-semantic-scholar -a codex`. Or copy the skill folder (skills/aris-semantic-scholar in OpenLAIR/dr-claw) into .agents/skills/aris-semantic-scholar in your project. Codex loads it when a task matches its description.

Can I use Aris Semantic Scholar 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 OpenLAIR/dr-claw --skill aris-semantic-scholar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/aris-semantic-scholar, .gemini/skills/aris-semantic-scholar, .github/skills/aris-semantic-scholar and .opencode/skills/aris-semantic-scholar in your project.

What does Aris Semantic Scholar need to run?

Going by SKILL.md and its folder, Aris Semantic Scholar needs the command-line tools its instructions call (python3) and credentials named SEMANTIC_SCHOLAR_API_KEY. Our summary lists: Python 3; A credential in SEMANTIC_SCHOLAR_API_KEY. Its frontmatter pre-approves these tools: Bash(*), Read, Write.

Does Aris Semantic Scholar access the network?

SKILL.md names 3 domains. In commands or code: api.semanticscholar.org and doi.org; the agent is likely to contact these when it follows the instructions. As links in the text: semanticscholar.org. This is read from the text; nothing was executed.

Is Aris Semantic Scholar safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Aris Semantic Scholar use?

Aris Semantic Scholar is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Aris Semantic Scholar use?

About 2k tokens (SKILL.md is roughly 8.1k 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 Aris Semantic Scholar?

Skills that share tags, products or a category with Aris Semantic Scholar: Literature Review (neflibata-feng/MyArxiv-Agent, 126 stars), Paper Research on arXiv (XiaomiMiMo/MiMo-Code, 14k stars), Paper Search (openags/paper-search-mcp, 2.8k stars) and Literature Review Agent (Ar9av/PaperOrchestra, 679 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Aris Semantic Scholar?

OpenLAIR (a GitHub organization) maintains it in OpenLAIR/dr-claw, which has 1,155 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on September 17, 2026.

Source: OpenLAIR/dr-claw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.