CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

semantic-scholar-search

Search Semantic Scholar for academic papers, fetch paper details by ID or DOI, retrieve author profiles, and analyse citation graphs. Preferred over google-scholar-search — uses the official API with no scraping. Triggers: search papers, find papers, semantic scholar, paper details, paper by DOI, paper by ID, author profile, citation analysis, references, literature search, paper discovery.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable body: every subcommand has executable examples with realistic IDs, and gotchas are surfaced as concrete BAD/GOOD pairs. The main deductions are the duplicated content between Mindset and Anti-Patterns, deferred error-handling guidance, and one broken bundle link (requirements.txt).

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (no explanations of what an API or DOI is), but the three Mindset points ("IDs over titles", "Author IDs, not names", "Rate limits apply without a key") restate three Anti-Patterns entries almost verbatim. Matches anchor 4 — efficient with minor trim opportunities; not 3 since there is no padding or explanation of known concepts.

4 / 5

Actionability

Copy-paste-ready commands for all four subcommands with realistic identifiers ("--paper-id \"arXiv:2005.11401\"", "--author-id \"1741101\"", a real DOI), plus a working python3 one-liner for extracting author IDs. Matches the top anchor: fully executable and covering the common cases.

5 / 5

Workflow Clarity

Five clearly sequenced steps (choose subcommand → setup → run → find author ID → present and hand off) with an explicit guard against batch exhaustion ("NEVER loop subcommands to exhaustion") and a user-confirmation checkpoint at handoff. Not 5: inline error handling (429 recovery, empty results) is absent and deferred wholly to the reference file; the destructive/batch cap does not apply since operations are read-only and the rate-limit guard is explicit.

4 / 5

Progressive Disclosure

The overview keeps SKILL.md lean and correctly defers setup detail to references/setup-and-troubleshooting.md (verified present, one level deep) and the script source. Not 5: the References section links to [requirements.txt](requirements.txt), which does not exist in the bundle — a broken navigation path.

4 / 5

Total

17

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete action list, explicit trigger clause, and explicit differentiation from google-scholar-search. The only weaknesses are a few missing natural trigger phrases and the slightly generic trigger term "references" that could over-fire.

DimensionReasoningScore

Specificity

"Search Semantic Scholar for academic papers, fetch paper details by ID or DOI, retrieve author profiles, and analyse citation graphs" lists four concrete actions covering the tool's full surface. Matches the anchor for multiple specific concrete actions with comprehensive coverage; not 4 because there are no gaps in the action list.

5 / 5

Completeness

Explicitly answers "what" (four concrete actions) and "when" via the explicit "Triggers: search papers, find papers, semantic scholar, ..." clause with concrete trigger phrases. Matches the top anchor; the "Use when" equivalent is fully present, so the completeness cap does not apply.

5 / 5

Trigger Term Quality

The trigger list "search papers, find papers, semantic scholar, paper details, paper by DOI, paper by ID, author profile, citation analysis, references, literature search, paper discovery" has good natural-phrase coverage with synonyms (search/find/discovery, literature search). Falls short of 5 because common user phrasings like "who cited this paper", "h-index", or "look up a paper" are missing.

4 / 5

Distinctiveness Conflict Risk

"Preferred over google-scholar-search — uses the official API with no scraping" explicitly disambiguates from the nearest competing skill, and the Semantic Scholar niche is clear. Not 5: the generic trigger term "references" could fire on unrelated tasks (e.g., code reference lookups), creating minor overlap risk.

4 / 5

Total

18

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

13

/

16

Passed

Repository

pantheon-org/tekhne

Path

skills/documentation/research/semantic-scholar-search/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.