CtrlK
BlogDocsLog inGet started
Tessl Logo

read

Fetches URLs and PDFs, then summarizes or returns clean Markdown. Use when asked to read, fetch, quote, cite, convert, or save a URL or PDF. Not for local text files already in the repo.

70

Quality

88%

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

85%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 instruction-style skill body: tight tables replace prose, execution detail is correctly pushed to a single one-level reference with real scripts, and the fetch/save workflow carries explicit failure inspection, retry, and non-overwrite validation. The only costs are slight redundancy between the Outcome Contract and later sections, and the absence of inline copy-paste commands in SKILL.md itself.

DimensionReasoningScore

Conciseness

The body is dense and rule-driven (routing table, fetch tiers, gotcha table) and assumes Claude's competence throughout, e.g. 'fetch.sh URL ... falls back to a stdlib HTML stripper'. Minor over-explanation could be trimmed — the four-part 'Outcome Contract' (Outcome/Done when/Evidence/Output) partially duplicates the later Routing/Saving/Output sections, and the 🥷 prefix line is decorative. Above the 'mostly efficient but some unnecessary explanation' anchor, short of the lean 5 anchor where every token earns its place.

4 / 5

Actionability

Concrete guidance dominates: a routing table mapping exact domains to methods, 'load references/read-methods.md and run the commands', 'pip install --user readability-lxml html2text', 'fetch.sh --use-proxy URL', the structured stderr contract '[fetch] tier=<name> status=<ok|fail> reason="..."', and exact save/output templates. Mostly executable with minor gaps — the body itself carries few copy-paste code blocks (the actual commands live in the reference file), matching the 'mostly executable guidance' anchor rather than the fully copy-paste-ready 5.

4 / 5

Workflow Clarity

The sequence is explicit (route → load read-methods.md → run command → inspect stderr tier → save or display → report) with validation checkpoints and feedback loops: 'Read the stderr if a fetch fails; it names the specific tier and reason', 'Network failures → prepend local proxy env vars ... and retry once', 'Built-in fetcher first; WeChat browser script if extraction fails', and a Gotchas table of failure modes with recovery rules. Save operations are guarded ('append -1, -2 ... Never overwrite without confirmation'), so the destructive/batch cap does not apply. Matches the 5 anchor's explicit validation, error-recovery loops, and failure checklist.

5 / 5

Progressive Disclosure

SKILL.md is a true overview: routing, policy, and output contracts inline, with the command detail delegated by a clearly signaled single reference ('After routing, load references/read-methods.md and run the commands for the chosen method'). The reference exists, is one level deep, and contains the executable commands per method; the referenced scripts (fetch.sh, fetch_feishu.py, fetch_weixin.py, fetch_local.py) all exist in scripts/. Matches the 5 anchor's clear overview with well-signaled one-level-deep references.

5 / 5

Total

18

/

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 third-person description that states concrete capabilities, an explicit 'Use when' trigger clause with natural verb phrasings, and a negative boundary that demarcates it from local-file skills. Only minor gaps: a few natural synonyms ('link', 'webpage', 'download') and edge actions are unlisted.

DimensionReasoningScore

Specificity

Quotes 'Fetches URLs and PDFs, then summarizes or returns clean Markdown' plus the action verbs 'read, fetch, quote, cite, convert, or save' — several concrete actions with minor gaps (image download and extraction variants are not surfaced). Fits the 'several specific actions; minor gaps' anchor, not the 5 anchor whose coverage is exhaustive, and clearly above the 1-2-action anchor.

4 / 5

Completeness

It explicitly answers both what ('Fetches URLs and PDFs, then summarizes or returns clean Markdown') and when ('Use when asked to read, fetch, quote, cite, convert, or save a URL or PDF') with concrete trigger phrases, and adds a boundary ('Not for local text files already in the repo'). This matches the 5 anchor exactly; the 4 anchor's weaker 'when' clause is clearly surpassed.

5 / 5

Trigger Term Quality

'read, fetch, quote, cite, convert, or save a URL or PDF' covers natural phrasings plus 'URL' and 'PDF', matching the good-coverage anchor. Falls short of the 5 anchor ('comprehensive ... including synonyms and file extensions') because common synonyms like 'link', 'webpage', 'download', and a '.pdf' extension token are absent.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (remote URLs and PDFs → summary/Markdown) with distinct triggers and an explicit exclusion ('Not for local text files already in the repo') that sharply reduces overlap with local-file or document-editing skills. Matches the 5 anchor's 'clear niche with distinct triggers; minimal conflict risk'.

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