CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

read

Fetches URLs and PDFs, then summarizes or returns clean Markdown; can also search the web through DeepSeek when built-in search is thin. Use when asked to read, fetch, quote, cite, convert, or save a URL or PDF. Not for local text files already in the repo.

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

78%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-engineered body: privacy-tier routing in tight tables, concrete commands and flags, structured failure reporting, and exemplary progressive disclosure with a single verified one-level reference. The main improvement space is consolidation — the proxy opt-in rule is repeated across sections and the core flow is scattered rather than presented as one ordered sequence.

Suggestions

State the core flow once as an ordered list (route → run method → check stderr tier status → recover per gotchas → emit output) so the sequence does not have to be assembled from five sections.

Deduplicate the proxy opt-in rule (currently in the Routing table, the Privacy and Fetch Tiers bullets, and the Hard rule) into a single authoritative statement.

Inline one-line usage for the most common commands (e.g. PDF extraction and deepseek.py search) in the Routing table so the common cases are executable without opening the reference file.

DimensionReasoningScore

Conciseness

The body uses dense routing and gotcha tables, concrete flags, and output templates with no explanations of concepts Claude already knows. Slight repetition (the proxy opt-in rule appears in both the Routing table and the Privacy section; the "user opt-in" caveat is stated three times) keeps it below the lean anchor 5.

4 / 5

Actionability

Concrete, executable guidance throughout: "bash fetch.sh --use-proxy URL", "pip install --user readability-lxml html2text", "head -n 200", a structured stderr contract ("[fetch] tier=<name> status=<ok|fail> reason=\"...\""), and two full output templates. Minor gaps: PDF-extraction and DeepSeek command syntax live entirely in the referenced file, so the body alone is not fully copy-paste ready.

4 / 5

Workflow Clarity

A clear sequence exists (route by input type → load references/read-methods.md → run the method → read the tier status stderr → apply gotcha recovery), with real feedback loops ("retry once" with proxy env vars, stop-and-warn on paywall shells, "tell the user what was tried and what failed"). It stays at 4 rather than 5 because the end-to-end order must be synthesized across five separate sections rather than stated as one ordered flow, and the multi-method fallback ordering is delegated to the script.

4 / 5

Progressive Disclosure

A single, clearly signaled, one-level-deep reference ("After routing, load references/read-methods.md and run the commands for the chosen method") with all referenced paths verified to exist (references/read-methods.md and scripts/fetch.sh, deepseek.py, fetch_feishu.py, fetch_local.py, fetch_weixin.py). The split is appropriate: a 115-line overview body with the 132-line command detail held back until routing decides it is needed.

5 / 5

Total

17

/

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.

A strong description: third-person, concrete about capabilities, with an explicit "Use when" trigger list and a boundary exclusion. Weaknesses are minor — a few natural trigger synonyms (download, webpage, .pdf) are absent, and the description omits a couple of capabilities the body covers (special-source handling, image download).

DimensionReasoningScore

Specificity

"Fetches URLs and PDFs, then summarizes or returns clean Markdown; can also search the web through DeepSeek" names four concrete actions, but coverage has minor gaps (special-cased sources like Feishu/WeChat and image downloading are unmentioned). Fits anchor 4 (several specific actions, minor gaps) rather than 5, whose example shows fully comprehensive coverage.

4 / 5

Completeness

Both parts are explicit: the "what" ("Fetches URLs and PDFs, then summarizes or returns clean Markdown") and the "when" ("Use when asked to read, fetch, quote, cite, convert, or save a URL or PDF"), plus an exclusion clause ("Not for local text files already in the repo") that sharpens scope. Matches the anchor-5 example structure of concrete capabilities followed by explicit triggers.

5 / 5

Trigger Term Quality

"Use when asked to read, fetch, quote, cite, convert, or save a URL or PDF" gives good natural-phrase coverage, but misses common variations like "download", "webpage/web page", "summarize", and the ".pdf" extension. Not 5 (no synonym/extension comprehensiveness); clearly above 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche (URL/PDF fetching and reading) with distinct triggers and an explicit negative boundary ("Not for local text files already in the repo") that prevents misfires against local-file skills. Minimal conflict risk, matching anchor 5; it is well above anchor 4's "minor overlap risk with closely related skills".

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

tw93/Waza

Path

skills/read/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.