CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

defuddle

Plan optional Defuddle extraction and retain already available local source files through reviewed filesystem capture. Use for defuddle, clean this URL, strip page clutter, readable Markdown from a web page, or preparing a web source for later wiki ingestion. Network extraction remains unavailable until an enforcing adapter is verified.

59

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/defuddle/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 delivers concrete, sequenced, safety-conscious operational guidance with real validation gates (dry-run sha256 approval, contracts verification, idempotent no-op semantics) and well-organized sections. Its weaknesses are moderate redundancy in the boundary-policy prose, a pinned commit/date that belongs in a reference, and undefined shell variables that keep the examples from being fully copy-paste ready.

Suggestions

Trim the repeated prohibition statements in 'Why execution stops here' into a single compact list, and move the pinned upstream commit hash and 'checked 2026-10-17' date into the referenced wiki documentation or a deprecated/notes section to avoid time-sensitive content penalization.

Define how $VAULT, $GENERATED_AT, and $OPERATION_ID are obtained (e.g., one line each) so the capture-apply commands become copy-paste ready.

Briefly state the expected action when 'contracts --verify' or a capture apply fails, converting the implicit error paths into explicit feedback loops.

DimensionReasoningScore

Conciseness

The body is dense and operational with no basic-concept padding, but the 'Why execution stops here' section repeats boundary statements ('never run it merely because it was found', 'Never relabel configured as verified', 'Do not execute… Do not silently substitute…') that could be tightened. The pinned commit hash 'checked 2026-10-17' is time-sensitive information not placed in a deprecated/old-patterns section, which the guidelines penalize. Matches anchor 3: mostly efficient but could be tightened.

3 / 5

Actionability

Concrete, mostly executable bash blocks are given: 'python3 "$CORE" capture external-plan url "HTTPS_URL"', 'capture plan --vault "$VAULT"', and the dry-run-then-'--approved-plan-sha256 "$APPROVAL_SHA256" --apply' sequence, with a comment explaining how to set APPROVAL_SHA256. Anchor 4 rather than 5 because $VAULT, $GENERATED_AT, and $OPERATION_ID are used but never defined, so it is not fully copy-paste ready.

4 / 5

Workflow Clarity

Both workflows are clearly sequenced with real checkpoints: 'test -f "$CORE"', 'contracts --verify', a dry-run plan whose 'approved_plan_sha256' must be reviewed before applying, 'Inspect the actual result and record extraction limitations', and the idempotency rule 'A repeated identical payload is a no-op'. Anchor 4 rather than 5 because error-recovery paths (what to do when verification or apply fails) are left implicit.

4 / 5

Progressive Disclosure

Sections are well organized (product root resolution, inert URL plan, execution-stop rationale, filesystem capture), and the single reference 'Use [operation-transactions.md](../wiki/references/operation-transactions.md) for custom capture drafts' is clearly signaled and one level deep. Anchor 4 rather than 5 because the reference resolves outside the skill bundle and the ~18-line inline policy rationale in 'Why execution stops here' could live in a reference file to keep SKILL.md lean; no bundle files (references/, scripts/, assets/) exist in this package.

4 / 5

Total

15

/

20

Passed

Description

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

The description uses third-person voice, includes an explicit 'Use for' clause with several natural trigger phrases, and defines a distinct niche around Defuddle web-page cleaning and filesystem capture. Its main weaknesses are limited action coverage (two actions) and jargon-heavy phrasing ('reviewed filesystem capture', 'enforcing adapter') that muddies the 'what'.

Suggestions

Add one or two more concrete capability verbs (e.g., 'report extraction plans and normalize hosts') so the action list moves from two actions toward comprehensive coverage.

Replace jargon such as 'reviewed filesystem capture' and 'enforcing adapter' with plainer phrasing (e.g., 'save local HTML/Markdown files into the vault for review') so the 'what' is immediately clear.

DimensionReasoningScore

Specificity

Quotes: 'Plan optional Defuddle extraction' and 'retain already available local source files through reviewed filesystem capture' name the domain plus two concrete actions in third person, but coverage is not comprehensive (no mention of reporting, plan states, or capture steps). Matches the '1-2 concrete actions, not comprehensive' anchor; not 4 because it does not list several specific actions.

3 / 5

Completeness

Both parts are present: a 'what' ('Plan optional Defuddle extraction and retain already available local source files through reviewed filesystem capture') and an explicit 'Use for…' when-clause with concrete triggers. Below anchor 5 because the 'what' is partially obscured by jargon such as 'reviewed filesystem capture' and 'enforcing adapter', leaving the actual operation less crisp than the exemplar.

4 / 5

Trigger Term Quality

Quotes: 'defuddle', 'clean this URL', 'strip page clutter', 'readable Markdown from a web page', 'preparing a web source for later wiki ingestion' are natural phrases a user would say. Good coverage, but common synonyms like 'extract article content', 'remove ads/boilerplate', or 'web page to markdown' are missing, so below the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The unique trigger 'defuddle' carves a clear niche with minimal conflict, but 'clean this URL' and 'readable Markdown from a web page' could overlap with general web-fetch or markdown-conversion skills. Mostly distinct with minor overlap risk, matching anchor 4.

4 / 5

Total

15

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

AgriciDaniel/claude-obsidian

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.