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

91%

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

The canonical home for this skill is read in tw93/Waza

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 body is an efficient, highly actionable overview: a routing table, an explicit fetch-tier privacy cascade with a machine-readable stderr contract, clear saving rules with anti-overwrite validation, and a Gotchas table providing error-recovery feedback loops. Detail is correctly deferred to a single well-signaled one-level-deep reference with no orphaned bundle files; only trivial redundancy between the Outcome Contract and Output templates keeps conciseness from a perfect score.

DimensionReasoningScore

Conciseness

The body is dense operational guidance with no explanations of concepts Claude already knows, but a few spots could be trimmed: the Outcome Contract's "Output" bullet overlaps the later Output templates, and the request-type bullets partially repeat it. This fits "efficient; minor instances of over-explanation that could be trimmed" rather than the fully lean level 5.

4 / 5

Actionability

Guidance is fully executable: exact scripts and flags ("fetch.sh --use-proxy", "scripts/deepseek.py"), a structured stderr contract ("[fetch] tier=<name> status=<ok|fail> reason=\"...\""), concrete install commands, "head -n 200" previewing, and copy-paste-ready commands in references/read-methods.md covering every routing case. Matches the level 5 anchor.

5 / 5

Workflow Clarity

Clear sequence (routing table → "After routing, load references/read-methods.md and run the commands" → inspect stderr on failure) with explicit validation steps (paywall/login-shell detection before saving, "Do not fabricate content", never-overwrite with -1/-2 suffixes) and feedback loops (proxy retry once, per-URL failure reporting for image batches, a Gotchas table that functions as an error-recovery checklist). Matches level 5.

5 / 5

Progressive Disclosure

SKILL.md is a concise overview (~115 lines of routing and policy), detailed per-method commands are split into one clearly signaled reference ("After routing, load `references/read-methods.md`"), and the bundle scripts are each reachable (fetch.sh and deepseek.py directly; fetch_feishu.py/fetch_weixin.py via read-methods.md; fetch_local.py as fetch.sh's internal helper). References are exactly one level deep with no orphaned files, matching level 5.

5 / 5

Total

19

/

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 with concrete capabilities, an explicit "Use when" clause full of natural trigger phrases, and a negative boundary that sharply reduces mis-triggering. The only shortfalls are minor: a few capability verbs (quote/cite/save) appear only as triggers and a handful of natural synonyms and file extensions are missing.

DimensionReasoningScore

Specificity

"Fetches URLs and PDFs, then summarizes or returns clean Markdown; can also search the web through DeepSeek" lists several concrete actions (fetch, summarize, Markdown conversion, web-search fallback), but quoting, citing, saving, and image downloading appear only as trigger verbs or not at all. This matches "several specific actions; minor gaps in coverage" rather than the comprehensive level 5, and clearly exceeds the 1-2 actions of level 3.

4 / 5

Completeness

It explicitly answers both: what ("Fetches URLs and PDFs, then summarizes or returns clean Markdown; can also search the web through DeepSeek") and when ("Use when asked to read, fetch, quote, cite, convert, or save a URL or PDF"), with concrete trigger phrases plus an explicit negative boundary ("Not for local text files already in the repo"). This is a direct match for the level 5 anchor.

5 / 5

Trigger Term Quality

"read, fetch, quote, cite, convert, or save a URL or PDF" gives good natural keyword coverage users would actually say. It falls short of level 5's comprehensive synonyms and extensions (missing "download", "summarize", "open this link", "webpage", ".pdf") but is well above level 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (URL/PDF retrieval and Markdown conversion), scopes the web-search capability as a fallback ("when built-in search is thin") to avoid overlap with search skills, and explicitly excludes local repo files. Minimal conflict risk, matching level 5.

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

plugins/waza/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.