CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

deepxiv

Search and progressively read open-access academic papers through DeepXiv. Use when the user wants layered paper access, section-level reading, trending papers, or DeepXiv-backed literature retrieval.

Quality

73%

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/skills-codex/deepxiv/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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-structured, highly actionable skill body: concrete bash commands for adapter and fallback paths, a clear six-step workflow with good decision rules, and disciplined depth escalation. Weaknesses are moderate redundancy (adapter chain and argument list each stated twice), placeholder-style command menus instead of ready-to-run invocations, and no error-handling/validation loop after command execution.

Suggestions

State the adapter-resolution chain once — keep the executable bash in Step 2 and reduce the Constants entry to the canonical name and fallback policy — and merge the 'Overrides' example list with the Step 1 argument spec.

Replace the seven-command menu in Step 3 with one concrete, substitution-ready invocation per mode (e.g. `python3 "$DEEPXIV_FETCHER" search "agent memory" --max 10`) so commands are copy-paste ready.

Add a lightweight validation step after execution: check the JSON output parsed correctly and define what to do when the resolved adapter fails (e.g. demote to raw `deepxiv` CLI and retry) instead of noting the gap.

DimensionReasoningScore

Conciseness

Mostly efficient — no explanations of concepts Claude already knows, and the positioning table is compact — but the adapter-resolution chain is described twice (Constants section plus a 15-line bash block in Step 2) and the argument list is duplicated between the 'Overrides' block and Step 1. Not 4 because this redundancy is real tightening work; not 2 because there is no concept-explanation padding or verbose filler.

3 / 5

Actionability

Provides concrete, executable bash for both the adapter path and the raw CLI fallback, with real flags (--days, --limit, --format json) and a copy-ready resolution script. Not 5 because Step 3 is a template menu of seven commands with unresolved placeholders (QUERY, ARXIV_ID, MAX_RESULTS) rather than one copy-paste-ready invocation per mode, and it acknowledges but does not handle a non-functional adapter ('not currently auto-demoted'). Not 3 because the commands given are fully executable, not pseudocode.

4 / 5

Workflow Clarity

Six clearly sequenced steps with explicit decision rules (default to 'brief' for bare arXiv IDs, fallback to raw CLI when the adapter is unresolved, 'ask before writing' to the wiki) and a well-defined depth-escalation progression. Not 5 because validation is thin — the smoke test is optional, errors from the adapter are not handled, and there is no verify-output checkpoint after execution. Not 3 because the sequence is coherent with most checkpoints (fallback, defaults, escalation gating) present and the operations are read-only rather than destructive.

4 / 5

Progressive Disclosure

Well-organized sections (Role & Positioning, Constants, Setup, Workflow, Key Rules) with clearly signaled one-level-deep references to shared-references/integration-contract.md including section pointers. Not 5 because the referenced contract file lives outside the skill directory and cannot be verified within this bundle, and the full raw-CLI fallback command list is inlined where a reference file would keep SKILL.md leaner; not 3 because navigation is easy and references are explicitly signaled, not buried.

4 / 5

Total

15

/

20

Passed

Description

67%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 solid description with an explicit what-and-when structure and a distinctive niche (progressive, section-level reading through DeepXiv). Its main weakness is trigger phrasing: several 'when' triggers are developer jargon ('layered paper access', 'DeepXiv-backed literature retrieval') rather than phrases users would naturally say, which weakens trigger quality and completeness.

Suggestions

Replace jargon triggers ('layered paper access', 'DeepXiv-backed literature retrieval') with natural user phrasings such as 'search papers', 'read a specific section of a paper', 'get a paper summary', or 'find trending papers'.

Broaden keyword coverage with synonyms users actually say, e.g. 'arXiv papers', 'paper search', 'literature search', 'read the Introduction of a paper'.

Enumerate a couple more concrete capabilities (paper briefs/head summaries, trending-paper feeds by day range, Semantic Scholar ID lookup) to lift specificity toward comprehensive coverage.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'Search', 'progressively read', 'section-level reading', 'trending papers' — anchored to a specific source (DeepXiv). Not 5 because coverage is not comprehensive (no mention of paper summaries/briefs, Semantic Scholar ID lookup, or day-range trending filters); not 3 because it goes beyond naming just 1-2 actions.

4 / 5

Completeness

Has a clear 'what' ('Search and progressively read open-access academic papers through DeepXiv') and an explicit 'when' ('Use when the user wants...'). Not 5 because the trigger phrases in the when-clause are semi-technical ('layered paper access', 'DeepXiv-backed literature retrieval') rather than concrete natural triggers; not 3 because the when-clause is explicit, not merely implied.

4 / 5

Trigger Term Quality

Relevant keywords like 'academic papers', 'trending papers', and 'section-level reading' are present, but common natural phrasings users would actually say ('find papers on', 'search arXiv', 'read this paper', 'paper summary') are missing, and triggers like 'layered paper access' and 'DeepXiv-backed literature retrieval' are jargon rather than natural user language. Not 2 because the keywords present are more than generic filler and are domain-relevant.

3 / 5

Distinctiveness Conflict Risk

'through DeepXiv', 'progressively read', and 'section-level reading' carve a clear niche distinct from generic paper-search skills, so conflict risk is mostly limited to closely related literature skills. Not 5 because 'search open-access academic papers' still broadly overlaps sibling paper-retrieval skills and the description gives no guidance on when to prefer DeepXiv over them.

4 / 5

Total

15

/

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

relative_links

Relative link issues: 3 suspicious

Warning

Total

15

/

16

Passed

Repository

wanshuiyin/Auto-claude-code-research-in-sleep

Path

skills/skills-codex/deepxiv/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.