AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
SKILL verified Apache-2.0 Self-run

S2 Cli

skill-huggingface-s2-cli-s2-cli · by huggingface

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.

↗ Repository
— No reviews yet
0 installs
28 views
0.0% view→install

Install

$ agentstack add skill-huggingface-s2-cli-s2-cli

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ● Network access Used
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/skill-huggingface-s2-cli-s2-cli)

Reliability & compatibility

✓ Security review passed
0 installs to date
— no reviews yet
● 29d ago

Declared compatibility

Claude CodeClaude Desktop

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of S2 Cli? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

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

  1. There is no --all. When stderr prints # more: rerun with --offset N,

pass that offset. Citations must keep offset + limit <= 9999.

Research workflow

  1. Use s2 search QUERY --limit 100 --json for graph-wide discovery.
  2. 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.

  1. Use s2 refs PAPER for a bibliography and s2 citations PAPER for citing

work. Quote titles. Prefer ARXIV: IDs after the first resolution.

  1. Extract arXiv IDs from the arxiv TSV column or externalIds.ArXiv in JSON.
  2. 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.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet, be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Search