CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

79%

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

Fix and improve this skill with Tessl

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

Quality

Content

63%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 skill's second half (sections 1–5) is genuinely good — executable commands, clear flag documentation, concrete use cases — but it is preceded by a redundant, boilerplate first half repeating the same five section headings with generic filler. The references/ directory is never pointed to specifically, and inline query-syntax detail duplicates what should live in references/api_docs.md.

Suggestions

Delete the first, generic half of the body (the unnumbered 'When to Use' through 'Implementation Details' sections) — it duplicates the numbered sections 1–5 with boilerplate and roughly doubles token cost with no new information.

Replace the vague "Reference material available in `references/`" mentions with an explicit link, e.g. "**Query syntax & categories**: See [references/api_docs.md](references/api_docs.md)", and move the inline prefix/category detail out of section 5 into that reference.

Add a brief error-recovery checkpoint to the run plan (e.g., what to do when the arXiv API returns no results or the download fails), giving the batch `--download` path a real feedback loop.

DimensionReasoningScore

Conciseness

Nearly the first half of the body is generic boilerplate that duplicates the section structure of the second half ("Scope-focused workflow aligned to:", "Use this skill when a evidence insight task needs a packaged method instead of ad-hoc freeform output", "Output discipline: keep results reproducible..."). Several padded, unnecessary sections match anchor 2; it is not score 1 because it never explains concepts Claude already knows.

2 / 5

Actionability

Fully executable, copy-paste-ready commands covering common cases: `pip install "arxiv>=1.4.0"` plus invocations exercising `--query "cat:cs.AI AND reinforcement learning" --max-results 5`, `--sort-by SubmittedDate`, `id:2101.12345 --download`, and `--dir ./papers`. This matches the anchor-5 example of specific examples covering common cases.

5 / 5

Workflow Clarity

The "Example run plan" gives a clear sequence (confirm inputs → run script → "Review the generated output and return the final artifact with any assumptions called out"), so a verification step exists for the batch download use case. Checkpoints are weak (no error-recovery guidance for API failures) and the duplicated sections muddy navigation, keeping it at anchor 4 rather than 5.

4 / 5

Progressive Disclosure

The bundle contains `references/api_docs.md`, but the body never names or links it — only vague mentions like "Reference material available in `references/`" and "`references/` contains supporting rules, prompts, or checklists" — while query-syntax detail that duplicates the reference is inlined in section 5. This matches anchor 3: references present but not clearly signaled, content that should be separate is inline.

3 / 5

Total

14

/

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.

The description is strong: it explicitly covers what the skill does and when to use it, with concrete actions and natural trigger terms anchored to the arXiv domain. It only falls slightly short on trigger synonym breadth and unmentioned capabilities like ID-based lookup and sorting.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "find papers by keyword/author/category, fetch metadata (abstract, DOI, PDF URL), or download PDFs" — with the search domain named explicitly (arXiv). Minor gaps (known-ID lookup, sorting) keep it below the comprehensive anchor 5.

4 / 5

Completeness

Both parts are explicit: what — "Search and retrieve scientific preprints from arXiv... fetch metadata (abstract, DOI, PDF URL), or download PDFs"; when — "use it when you need to find papers by keyword/author/category... or download PDFs for offline reading". This matches the anchor-5 example pattern of concrete what + concrete trigger phrases.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "papers", "preprints" (synonym pair), "arXiv", "PDF", "abstract", "DOI", "download", "offline reading" — phrases a user would naturally say. A few common variations ("articles", "literature search", ".pdf") are missing, matching anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche ("scientific preprints from arXiv") with distinct trigger terms ("arXiv", "preprints", "papers", "PDF"); minimal overlap risk with other skills, matching anchor 5. Not 4, since no closely related skill domain shares these triggers.

5 / 5

Total

18

/

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

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

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.