aris-semantic-scholar

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.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

77%

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

The body is highly actionable with a clear, validated workflow and concrete executable commands. Its main weakness is token efficiency and progressive disclosure: duplicated guidance across Key Rules and the workflow, and a monolithic structure that could offload detail to reference files.

Suggestions

Collapse the "Key Rules" section into the relevant workflow steps to remove duplication of citation-ranking, DOI-canonical, and filter-default guidance.

Move the recommended filter-combo table and the detailed per-paper summary template into a separate reference file, keeping SKILL.md as a lean overview with a one-level-deep pointer.

Trim explanatory prose (e.g. the linguistics/psychology noise aside) since Claude can infer why default filters matter from the flag semantics.

Dimension	Reasoning	Score
Conciseness	Mostly task-relevant but could be tightened: the "Key Rules" section restates workflow points (citation-is-gold, DOI-as-canonical) and the recommended-filter-combos table duplicates flags already shown in Step 2.	2 / 3
Actionability	Provides fully executable bash commands with concrete flags, exact ID-pattern matching, and a documented inline-Python fallback — copy-paste ready.	3 / 3
Workflow Clarity	Seven clearly sequenced steps with error-recovery feedback (429 rate-limit retry, script-not-found fallback, API-unreachable fallback skills) and a dedup checkpoint; the operations are read-only so no destructive-validation cap applies.	3 / 3
Progressive Disclosure	Well-sectioned but monolithic (~170 lines) with inline filter-combo tables and detailed summary templates that could be split into reference files; the only referenced script is external with an inline fallback rather than a bundled progressive reference.	2 / 3
	Total	10 / 12 Passed

Description

100%

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

The description is excellent: third-person voice, concrete capabilities, explicit trigger terms, and a clear niche distinct from the arXiv skill. It answers both "what" and "when" unambiguously.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete capabilities — "Search published venue papers", "citation counts, venue metadata, and TLDR", and complements /aris-arxiv — rather than vague language.	3 / 3
Completeness	Explicitly states what it does (search published venue papers via Semantic Scholar with citation/venue/TLDR data) and when to use it via a clear "Use when user says..." trigger clause.	3 / 3
Trigger Term Quality	Provides strong coverage of natural phrases users would say: "search semantic scholar", "find IEEE papers", "find journal papers", "venue papers", "citation search".	3 / 3
Distinctiveness Conflict Risk	Carves a clear niche as the published-venue counterpart to /aris-arxiv preprints with distinct triggers like "venue papers" and "find IEEE papers", making wrong-skill conflicts unlikely.	3 / 3
	Total	12 / 12 Passed

Validation

87%

Warnings & errors only

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

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
allowed_tools_field	'allowed-tools' contains unusual tool name(s)	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: OpenLAIR/dr-claw
Path: skills/aris-semantic-scholar/SKILL.md
Commit: 6da7f7c

Reviewed: about 8 hours ago

Table of Contents

Discovery Implementation Validation

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.