biorxiv-database

Efficient database search tool for bioRxiv preprint server. Use this skill when searching for life sciences preprints by keywords, authors, date ranges, or categories, retrieving paper metadata, downloading PDFs, or conducting literature reviews.

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./backend/cli/skills/databases/biorxiv-database/SKILL.md

Quality

Content

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

An actionable, code-rich skill body with clear search capabilities and a properly signaled reference file. Weaknesses are verbosity from duplicated/inlined content and missing validation checkpoints in batch-download workflows.

Suggestions

Remove the full emoji test-suite output block and the pandas DataFrame integration example, or move them into the reference file; keep SKILL.md to the test command and a one-line summary.

De-duplicate the Valid Categories list and Best Practices between SKILL.md and references/api_reference.md — keep them in one location and link from the other.

Add a validation/feedback step to batch PDF-download workflows (e.g., verify each download succeeded and retry on failure) so workflow clarity is not capped, and fix the inconsistent import path and the shell-in-Python Author Tracking loop so examples are executable.

Dimension	Reasoning	Score
Conciseness	Mostly concrete code, but padded with a full emoji test-suite output block, duplicated Valid Categories and Best Practices sections, and a pandas integration example that could be trimmed; not 2 because it is not concept-explanation padding, not 4 because several sections are genuinely removable.	3 / 5
Actionability	Provides concrete, mostly copy-paste-ready CLI commands and Python API calls with real methods, but has inconsistent import paths ('biorxiv_search' vs 'scripts.biorxiv_search') and a non-executable shell command embedded in a Python loop under Author Tracking.	4 / 5
Workflow Clarity	The Literature Review Workflow is sequenced, but batch PDF-download workflows lack validation checkpoints or feedback loops; per the batch-operation cap, this cannot exceed 3 even though steps are listed.	3 / 5
Progressive Disclosure	A real, one-level-deep reference (references/api_reference.md) is clearly signaled, but substantial content is duplicated inline — the full Valid Categories list, Best Practices, and the output-format JSON all appear in both SKILL.md and the reference — which is more than a minor organization gap.	3 / 5
	Total	13 / 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, third-person description that clearly states capabilities and provides an explicit 'Use this skill when' trigger clause with concrete, natural-language use cases. Minor gap: missing file-extension and synonym trigger terms.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'searching for life sciences preprints by keywords, authors, date ranges, or categories', 'retrieving paper metadata', 'downloading PDFs', 'conducting literature reviews' — giving comprehensive coverage; not the 4 anchor because no meaningful action gaps remain.	5 / 5
Completeness	Explicitly answers both what ('Efficient database search tool for bioRxiv preprint server... retrieving paper metadata, downloading PDFs') and when ('Use this skill when searching for... or conducting literature reviews') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Good natural keyword coverage ('bioRxiv', 'preprints', 'PDFs', 'literature reviews', 'keywords/authors/date ranges'), but lacks file extensions and common synonyms; not 5 because '.pdf' and synonym variants are absent.	4 / 5
Distinctiveness Conflict Risk	A clearly defined bioRxiv-preprint niche with distinct triggers and minimal overlap risk with other skills; not 4 because the niche is unambiguous.	5 / 5
	Total	19 / 20 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
metadata_version	'metadata.version' is missing	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: synthetic-sciences/openscience
Path: backend/cli/skills/databases/biorxiv-database/SKILL.md
Commit: 3a6c3a9

Reviewed: 1 day 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.