CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

defuddle

Extract clean markdown content from web pages using Defuddle CLI, removing clutter and navigation to save tokens. Use instead of WebFetch when the user provides a URL to read or analyze, for online documentation, articles, blog posts, or any standard web page.

3.07x
Quality

90%

Does it follow best practices?

Impact

80%

3.07x

Average score across 3 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is defuddle in kepano/obsidian-skills

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.

A tight, command-first reference for a simple single-tool skill: every command is executable and the structure is easy to navigate. The only improvements are micro-trims — collapsing the three redundant metadata command lines and deduplicating the `--md` advice between prose and table.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no concept explanations, just install, usage commands, and a format table — matching the level-4 anchor of efficient with minor trimming possible. It is not a 5 because of small redundancies: the intro sentence repeats the frontmatter description ("Prefer over WebFetch for standard web pages — it removes navigation, ads, and clutter"), "Always use `--md`" duplicates the table's "Markdown (default choice)", and the three metadata lines (`-p title`, `-p description`, `-p domain`) could collapse into one `defuddle parse <url> -p <property>` line.

4 / 5

Actionability

All guidance is copy-paste ready: the install command (`npm install -g defuddle`), the core command (`defuddle parse <url> --md`), saving to file, metadata extraction, and a table of output-format flags. These cover the common cases for a single-tool skill, matching the level-5 anchor of fully executable, copy-paste-ready commands covering common cases.

5 / 5

Workflow Clarity

This is a simple single-task skill, and the single action is unambiguous: run `defuddle parse <url> --md`, with the install fallback stated for when the tool is missing. Per the rubric's simple-skill exception, a single unambiguous action scores 5; there are no destructive or batch operations, so the validation cap does not apply.

5 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references (none exist in the bundle, and none are warranted for this scope), and the body is organized into clear sections (intro, install, Usage, Output formats). Per the rubric's guidance for short skills with no need for external references, well-organized sections alone merit a 5.

5 / 5

Total

19

/

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 description that clearly states what the skill does and when to use it, with an explicit disambiguation against WebFetch. The main gap is that the capability list is thin (one to two actions) and a few natural trigger synonyms are missing.

DimensionReasoningScore

Specificity

The description names the domain and one to two concrete actions — "Extract clean markdown content from web pages" and "removing clutter and navigation" — which matches the anchor for naming a domain with 1-2 concrete actions but not comprehensive coverage. It does not list several distinct actions (the way the level-4 example does: "extracts text, fills forms, converts pages"), and "to save tokens" is a purpose statement rather than a capability, so it does not rise to 4.

3 / 5

Completeness

Both parts are explicitly answered: the "what" is "Extract clean markdown content from web pages using Defuddle CLI, removing clutter and navigation to save tokens" and the "when" is "Use instead of WebFetch when the user provides a URL to read or analyze, for online documentation, articles, blog posts, or any standard web page" — concrete trigger phrases attached to an explicit when-clause. This clearly matches the level-5 anchor; the level-4 anchor (when only weakly implied or less specific) does not apply.

5 / 5

Trigger Term Quality

Natural trigger phrases are well covered: "when the user provides a URL to read or analyze", "online documentation", "articles", "blog posts", "any standard web page". A few common synonyms users would naturally say are missing (e.g., "website", "link", "webpage" as one word), which matches the level-4 anchor of good coverage with a few natural terms missing rather than the comprehensive synonym coverage of level 5.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche — web content extraction via a specific CLI — and explicitly disambiguates against the nearest competing tool ("Use instead of WebFetch"), which resolves the most likely confusion rather than creating it. Trigger terms (URLs, articles, blog posts, documentation pages) are distinct from generic file/document skills, matching the level-5 anchor of a clear niche with 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

valeriibeck-star/claude-skills

Path

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