CtrlK
BlogDocsLog inGet started
Tessl Logo

arxiv-paper-reader

Fetch and extract full text from arxiv paper HTML pages. Invoke when user asks to read an arxiv paper, analyze a paper's content, or when given an arxiv ID/URL.

66

Quality

78%

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 ./.trae/openclaw-skills/arxiv-paper-reader/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 compact, well-structured skill body with executable commands and accurate flag documentation that match the bundled script. Its main defects are the install-specific hardcoded script path repeated in every example, a duplicated long-paper tip, and the absence of an explicit error-recovery step for papers without an HTML version.

Suggestions

Replace the hardcoded '.trae/skills/arxiv-paper-reader/scripts/arxiv_reader.py' path with the skill-relative 'scripts/arxiv_reader.py' so the example commands work wherever the skill is installed.

Add a brief error-recovery step for the documented failure case: when the HTML version is missing, state the fallback (e.g. fetch the PDF or abs page) instead of just noting the script errors.

Deduplicate the long-paper '--output then Read in segments' guidance, which currently appears in both 示例 and 注意事项.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no padding about what arxiv or HTML is; the '核心原理' section only states the non-obvious fact (the /html/ endpoint carries the full LaTeXML text vs. the abstract-only abs page). It loses a point for redundancy: the long-paper '--output then Read in segments' tip appears twice (示例 and 注意事项) and 适用场景 restates the description's triggers.

4 / 5

Actionability

Commands are concrete and executable — real script invocations with actual flags (--output, --sections, --raw) covering the common cases, and the flags match the bundled script. The gap is that every example hardcodes the install-specific path '.trae/skills/arxiv-paper-reader/scripts/arxiv_reader.py' instead of the skill-relative 'scripts/arxiv_reader.py' that matches the actual bundle location, so a copy-pasted command fails outside that one install.

4 / 5

Workflow Clarity

For a simple single-action skill the sequence is unambiguous (extract the ID, run the script, optionally save to file), and failure modes are named ('部分论文可能没有 HTML 版本...此时脚本会报错'). However, there is no recovery checkpoint when the script errors — no fallback (e.g. PDF route) or retry guidance — which leaves a minor validation gap at anchor 4 rather than the explicit feedback loop of anchor 5.

4 / 5

Progressive Disclosure

The skill is short and simple with no need for external reference files, and the sections (适用场景/核心原理/使用步骤/示例/输出说明/注意事项) are well organized with a single one-level-deep pointer to the bundled script, which I verified exists at scripts/arxiv_reader.py. The mismatch between the body's hardcoded '.trae/skills/...' script path and the actual bundle location is a minor navigation gap, holding it just below anchor 5.

4 / 5

Total

16

/

20

Passed

Description

82%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, well-formed description: concrete about what it does, explicit about when to invoke, and tightly scoped to arxiv. The only soft spot is that the capability list is narrow (a single fetch-and-extract action) relative to what the bundled script actually supports.

DimensionReasoningScore

Specificity

The description names the domain (arxiv papers) and one concrete capability — 'Fetch and extract full text from arxiv paper HTML pages' — which matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It does not list the supporting operations (section separation, math cleanup, file output), so it is below anchor 4 ('several specific actions') but clearly above anchor 2, which would have only a generic action.

3 / 5

Completeness

It explicitly answers both questions: what ('Fetch and extract full text from arxiv paper HTML pages') and when ('Invoke when user asks to read an arxiv paper, analyze a paper's content, or when given an arxiv ID/URL'), with concrete trigger phrases. This matches the anchor-5 example structure of action list plus explicit 'Use when...' clause.

5 / 5

Trigger Term Quality

Phrases like 'read an arxiv paper', 'analyze a paper's content', and 'arxiv ID/URL' are natural user utterances with good coverage of the common triggers. It misses a few variations users might say (e.g. 'summarize a paper', 'get the paper text', mention of PDF), which keeps it below anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The arxiv niche is unmistakable — the triggers ('arxiv paper', 'arxiv ID/URL') are distinct and would not plausibly fire for a general document or web-reading skill. Clear niche with distinct triggers, minimal conflict risk.

5 / 5

Total

17

/

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
huangruiteng/CS-Notes
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.