arxiv-database

Search and retrieve scientific preprints from arXiv; use it when you need to find papers by keyword/author/category, fetch metadata (abstract, DOI, PDF URL), or download PDFs for offline reading.

Quality

68%

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

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Evidence Insight/arxiv-database/SKILL.md

Quality

Content

50%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.

The second half of the body is specific and executable, but it is undermined by a redundant, contradictory boilerplate first half and a missing validation step for the batch download operation. The reference file is underutilized because its content is duplicated inline.

Suggestions

Remove the generic boilerplate first half (the unnumbered When to Use / Key Features / Dependencies / Example Usage / Implementation Details sections) that duplicates sections 1-5, resolving the contradictory Python version specs and the bogus 'cd "20260316/..."' path.

Add a validation/verification step to the run plan for '--download' (e.g., confirm each PDF was saved and is non-empty) so the batch download workflow clears the workflow-clarity cap.

Replace the generic 'Reference material available in references/' pointer with an explicit named link to api_docs.md, and move the inlined query-syntax/category details there instead of duplicating them.

Dimension	Reasoning	Score
Conciseness	The first ~40 lines are generic boilerplate ('Use this skill when a evidence insight task needs a packaged method...', 'Reference material available in references/') duplicating the specific second half, which is noticeably verbose padding rather than value-adding content.	2 / 5
Actionability	Section 4 provides copy-paste-ready commands covering search, sort, ID lookup, and download-to-dir cases, but the duplicate first-half commands ('python -m py_compile', the bogus 'cd "20260316/..."' path) and contradictory dependency specs introduce minor ambiguity.	4 / 5
Workflow Clarity	The 'Example run plan' gives a 4-step sequence but lacks any validation checkpoint, and '--download' is a batch operation, so the rubric's batch-operation cap holds workflow clarity at 3.	3 / 5
Progressive Disclosure	Bundle files (references/api_docs.md, scripts/arxiv_search.py) are real, but the reference is named only generically ('Reference material available in references/') and query syntax/categories are inlined duplicating api_docs.md, fitting the 'references not clearly signaled / content that should be separate is inline' anchor.	3 / 5
	Total	12 / 20 Passed

Description

87%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, concrete description that clearly states both capability and trigger conditions for the arXiv skill. The only notable flaw is second-person voice, which costs it one specificity point per the rubric.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ('find papers by keyword/author/category', 'fetch metadata (abstract, DOI, PDF URL)', 'download PDFs') matching the 5 anchor, but the second-person 'use it when you need' triggers the rubric's -1 specificity penalty for non-third-person voice.	4 / 5
Completeness	Explicitly answers both what ('Search and retrieve scientific preprints from arXiv') and when ('use it when you need to find papers... or download PDFs') with concrete trigger phrases, matching the 5 anchor.	5 / 5
Trigger Term Quality	Good natural-term coverage ('papers', 'preprints', 'arXiv', 'PDF', 'metadata', 'keyword/author/category'), but a few common synonyms (e.g., 'articles', 'search papers') are missing, so it sits just below the comprehensive 5 anchor.	4 / 5
Distinctiveness Conflict Risk	The arXiv preprint niche with specific triggers (keyword/author/category, metadata, PDF download) is clearly distinct with minimal conflict risk against other skills.	5 / 5
	Total	18 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: aipoch/medical-research-skills
Path: scientific-skills/Evidence Insight/arxiv-database/SKILL.md
Commit: 63c61d3

Reviewed: 3 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.