CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

arxiv-search

Search arXiv preprint repository for papers in physics, mathematics, computer science, quantitative biology, and related fields

Quality

74%

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 ./skills_all/arxiv-search/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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 content delivers a clear, actionable single-command workflow with documented arguments, examples, expected output, and an explicit dependency-error recovery loop. Its weaknesses are moderate padding (Features section, near-duplicate examples, restated intro) and placeholder-based script paths that keep the guidance from being fully copy-paste ready.

Suggestions

Trim the "Features" section and the redundant intro paragraph, and collapse the three examples into one, to cut tokens that restate what the usage block already shows.

Replace the repeated `[YOUR_SKILLS_DIR]` placeholder prose with a single concrete invocation note, and state the script's actual location relative to the skill directory.

Move the subject-strength notes (cs.LG, q-bio, stat.ML) into the When-to-Use section so trigger guidance and domain strengths live in one place.

DimensionReasoningScore

Conciseness

The body is mostly efficient but includes padding that could be tightened: the "Features" section ("Fast retrieval: Direct API access", "Simple interface: Clean, easy-to-parse output") is marketing-style filler, the intro paragraph restates the frontmatter description, and the three Examples differ only in query string. This matches the anchor 'Mostly efficient but includes some unnecessary explanation or could be tightened' — below 4 because these padded sections are more than minor trimmable instances, above 2 because nothing explains concepts Claude wouldn't already know.

3 / 5

Actionability

Concrete, near-copy-paste commands are provided with documented arguments ("query (required)", "--max-papers (optional)") and a complete error-recovery path for the missing dependency ("If you see 'Error: arxiv package not installed'" → pip install commands). It sits at 4 rather than 5 because every command embeds a `[YOUR_SKILLS_DIR]` placeholder requiring substitution, and the referenced script `arxiv_search.py` is not present in this bundle, so the guidance is not fully executable as-is.

4 / 5

Workflow Clarity

This is a simple single-task skill whose single action is unambiguous — run the script with a query — satisfying the guideline that simple skills can score 5 when the action is clear. It even exceeds that bar with an explicit feedback loop: the expected output format is documented, and the missing-package error message is paired with install instructions and retry guidance, so error recovery is explicit.

5 / 5

Progressive Disclosure

The body is well-organized into clearly signaled sections (When to Use, Basic Usage, Examples, Output Format, Features, Dependencies, Notes) with all content appropriately inline for a single-script skill, matching the anchor 'Good structure; most content is appropriately placed; references mostly clear; minor organization gaps'. It does not reach 5 because the ~95-line body exceeds the under-50-line simple-skill case, and the core referenced artifact (`arxiv_search.py` at a placeholder external path) is not verifiable within the bundle.

4 / 5

Total

16

/

20

Passed

Description

61%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 has a clear, specific 'what' — searching arXiv for preprints across named disciplines — with strong natural keywords anchored by the distinctive "arXiv" term. Its main defect is the complete absence of any 'when to use' trigger guidance, which caps completeness and limits its usefulness for skill routing.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to find arXiv preprints, research papers, or pre-publication research in physics, math, CS, or quantitative biology, or wants results not yet indexed in PubMed."

Broaden natural phrasings to include synonyms users actually say, such as "research papers", "find papers", or "pre-print".

Consider adding one more concrete capability (e.g., limiting or sorting results) to raise specificity beyond the single "Search" action.

DimensionReasoningScore

Specificity

"Search arXiv preprint repository for papers in physics, mathematics, computer science, quantitative biology, and related fields" names the domain (arXiv preprints) and one concrete action (search for papers), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It stays at 3 rather than 4 because only a single action verb ("Search") is offered — no retrieval, download, or query-scope details — so coverage is not 'several specific actions'.

3 / 5

Completeness

The 'what' is clear ("Search arXiv preprint repository for papers in [fields]"), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the judging guidelines explicitly cap completeness at 3 in that case, matching the anchor 'Has a clear what but when is missing or only weakly implied'.

3 / 5

Trigger Term Quality

Natural triggers present include "arXiv", "preprint", "papers", and five field names ("physics, mathematics, computer science, quantitative biology") — good keyword coverage matching the anchor 'Good keyword coverage; a few natural terms missing'. It falls short of 5 because common phrasings users would actually say ("research papers", "find papers", "paper search", "citations") are absent.

4 / 5

Distinctiveness Conflict Risk

Naming the specific service "arXiv" gives the description a mostly distinct niche, matching the anchor 'Mostly distinct; minor overlap risk with closely related skills'. It does not reach 5 because without a when-clause, broad queries like "find papers on protein folding" could reasonably trigger a competing literature-search skill (e.g., PubMed search), so the conflict risk is minor but not minimal.

4 / 5

Total

14

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

Microck/ordinary-claude-skills

Path

skills_all/arxiv-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.