Name: s2-cli
Author: huggingface

Imported from huggingface/s2-cli (SKILL.md). Install upstream with npx skills add huggingface/s2-cli. Copyright stays with the author.

The s2 CLI is read-only. It queries the Semantic Scholar Graph API and requires S2_API_KEY or PWC_SEMANTIC_SCHOLAR_API_KEY. Run s2 --help or a nested --help command when the live parser and this skill disagree; the parser is authoritative.

Install with uv tool install git+https://github.com/huggingface/s2-cli.git. Use compact TSV for reading. Add --json for programmatic filtering, joining, or schema-dependent processing.

PAPER accepts a modern or legacy arXiv ID, a DOI, a 40-character Semantic Scholar paper ID, a prefixed ID (ARXIV:, DOI:, CorpusId:, PMID:, URL:), an arXiv or Semantic Scholar URL, or a quoted title. Title matching uses Semantic Scholar's closest-title endpoint and prints a header with the matched title, ID, arXiv ID, and match score. If the header is wrong, rerun with an ID. Do not fall back to s2 search to resolve a specific paper.

Commands

s2 refs PAPER [--limit LIMIT] [--offset OFFSET] [--fields FIELDS] [--json] — papers this paper cites.
s2 citations PAPER [--limit LIMIT] [--offset OFFSET] [--fields FIELDS] [--json] — papers that cite this paper.
s2 search QUERY [--limit LIMIT] [--offset OFFSET] [--year YEAR] [--fields FIELDS] [--json] — search the Semantic Scholar graph.
s2 version — show CLI and API contract versions.

Default --limit is 20. Search max --limit is 100; refs/citations max is 1000. There is no --all. When stderr prints # more: rerun with --offset N, pass that offset. Citations must keep offset + limit <= 9999.

Research workflow

Use s2 search QUERY --limit 100 --json for graph-wide discovery.
Run a second s2 search QUERY --year 2025-2026 --limit 100 --json for a recent slice. Do not treat one search as both the classic and recent lists.
Use s2 refs PAPER for a bibliography and s2 citations PAPER for citing work. Quote titles. Prefer ARXIV: IDs after the first resolution.
Extract arXiv IDs from the arxiv TSV column or externalIds.ArXiv in JSON.
Do not curl api.semanticscholar.org while this CLI is available.

Output and limits

Stable exit codes are 0 success, 2 invalid usage or missing key, 3 network/rate-limit failure, and 4 not found or invalid API response.
Default request pacing is 1.5s. Do not page citations of famous papers up to the 10k cap unless the user explicitly asks.

{ "ocm": "1", "id": "huggingface-s2-cli-s2-cli", "kind": "skill", "name": "s2-cli", "description": "Semantic Scholar CLI (`s2`) for on-demand citation graph lookup: papers a work cites, papers that cite a work, and graph search across 200M+ papers. Use whenever the user asks for Semantic Scholar, S2, cited papers, references, bibliography, citing papers, citation count from Semantic Scholar, or papers outside a local catalog. Prefer `s2` over curl or ad-hoc Graph API requests.", "publisher": "huggingface", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Semantic Scholar CLI (`s2`) for on-demand citation graph lookup: papers a work cites, papers that cite a work, and graph search across 200M+ papers. Use whenever the user asks for Semantic Scholar, S2, cited papers, references, bibliography, citing papers, citation count from Semantic Scholar, or papers outside a local catalog. Prefer `s2` over curl or ad-hoc Graph API requests." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/huggingface/s2-cli", "path": "SKILL.md", "ref": "63dba8bc20c959a864b7017444fb8f2faffabd8c", "url": "https://github.com/huggingface/s2-cli/blob/63dba8bc20c959a864b7017444fb8f2faffabd8c/SKILL.md", "key": "huggingface/s2-cli/SKILL.md" } }, "instructions": "The `s2` CLI is read-only. It queries the Semantic Scholar Graph API and\nrequires `S2_API_KEY` or `PWC_SEMANTIC_SCHOLAR_API_KEY`. Run `s2 --help` or a\nnested `--help` command when the live parser and this skill disagree; the\nparser is authoritative.\n\nInstall with `uv tool install git+https://github.com/huggingface/s2-cli.git`.\nUse compact TSV for reading. Add `--json` for programmatic filtering, joining,\nor schema-dependent processing.\n\n`PAPER` accepts a modern or legacy arXiv ID, a DOI, a 40-character Semantic\nScholar paper ID, a prefixed ID (`ARXIV:`, `DOI:`, `CorpusId:`, `PMID:`,\n`URL:`), a", "cost": { "context_tokens": 594 } }

s2-cli

About

Commands

Research workflow

Output and limits

Use it

Manifest

Reviews