CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

literature-search-arxiv

Search for scientific papers, preprints, and publications on arXiv. Extract metadata, abstracts, and download full-text PDFs or HTML versions of papers. Use when the user asks to find research papers, literature, or specific arXiv IDs.

Quality

89%

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-built operational skill: executable commands with full options, sensible rate-limit and safety guardrails, and a proper one-level reference split. Remaining gaps are small — an implicit PDF verification step without a command or retry loop, one garbled sentence about DOI fields, and an orphaned citation.bib reference file.

Suggestions

Make the workflow's verification step concrete: give an executable check (e.g., a file-size/non-empty test or `pdfinfo` invocation) and a short fix-and-retry loop for corrupted downloads, which would raise workflow clarity to the top anchor.

Fix the garbled DOI sentence ('if only an arXiv-issued DOI exists, this is DOI is not returned') and tighten low-value lines like 'Read the downloaded file using standard file reading tools' to improve conciseness.

Either reference references/citation.bib from SKILL.md (e.g., in a Reference or citation section explaining when to use it) or remove it, so every bundle file is discoverable from the overview.

DimensionReasoningScore

Conciseness

The body is efficient and operational — commands, options, and fielded metadata lists with little concept explanation Claude already knows — but has minor trimmable content (e.g., "Read the downloaded file using standard file reading tools") and a garbled sentence ("if only an arXiv-issued DOI exists, this is DOI is not returned"), placing it just below the lean-and-efficient top anchor.

4 / 5

Actionability

All three utility scripts get copy-paste-ready `uv run` commands with complete option tables, documented output fields, and practical examples (e.g., `--query "au:einstein AND ti:relativity"`), covering the common cases per the top anchor rather than having the 'minor gaps' of level 4.

5 / 5

Workflow Clarity

The Workflow section gives a clear four-step sequence including a verification step ("verify the PDF is not empty or corrupted"), but the verification is implicit — no concrete command or fix-and-retry feedback loop — matching 'clear sequence with most checkpoints present; minor validation gaps' rather than the explicit validation/recovery anchor at 5.

4 / 5

Progressive Disclosure

Structure is good: well-organized sections, advanced query syntax correctly split into a one-level-deep reference (references/query_syntax.md) that is clearly signaled in both the options and the Reference section. It falls short of the top anchor only because references/citation.bib exists in the bundle but is never mentioned or linked from SKILL.md, a minor navigation gap.

4 / 5

Total

17

/

20

Passed

Description

92%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 capabilities in third-person voice, an explicit 'Use when...' trigger clause with natural keywords, and a clearly bounded arXiv niche. The only weakness is modest keyword synonym coverage (e.g., no mention of scholarly/academic articles).

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Search for scientific papers, preprints, and publications on arXiv", "Extract metadata, abstracts", and "download full-text PDFs or HTML versions of papers" — comprehensively covering the skill's scope with no significant gaps, matching the top anchor rather than the 'minor gaps' level below.

5 / 5

Completeness

It explicitly answers both 'what' (search, extract metadata/abstracts, download PDFs/HTML) and 'when' ("Use when the user asks to find research papers, literature, or specific arXiv IDs") with concrete trigger phrases, matching the top anchor; a missing 'Use when' clause would have capped it at 3, but it is present and specific.

5 / 5

Trigger Term Quality

It includes natural phrases users would say — "research papers", "literature", "arXiv IDs", "preprints", "publications" — but omits a few common variations such as "academic/scholarly articles" or "scientific literature", fitting the 'good coverage, a few natural terms missing' anchor rather than comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to a clear niche — arXiv specifically, including "specific arXiv IDs" as a trigger — making it unlikely to fire for unrelated search or document skills, which matches the 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

google-deepmind/science-skills

Path

skills/literature_search_arxiv/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.