Agent skill

Defuddle Web Page Cleaner

by AgriciDaniel in AgriciDaniel/claude-obsidian

Plans, and with explicit network consent runs, an external Defuddle extractor that turns an article-like HTTPS page into clean Markdown for later wiki ingestion.

MITAuto-check passedKnowledge Management

Install Defuddle Web Page Cleaner

skills CLI
$ npx skills add AgriciDaniel/claude-obsidian --skill defuddle -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AgriciDaniel/claude-obsidian defuddle --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AgriciDaniel/claude-obsidian.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/defuddle .claude/skills/defuddle && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
defuddle
GitHub stars
15k
Token cost
~1.1k tokens
SKILL.md length
564 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Plans, and with explicit network consent runs, an external Defuddle extractor that turns an article-like HTTPS page into clean Markdown for later wiki ingestion.

  • Works in 5 steps: Resolve the user vault. → Hash the exact cleaned bytes with SHA-256. → Draft a new immutable payload such as → …
  • Cleaning a web article into readable Markdown before saving it
  • SKILL.md covers Safety contract, Plan first, Execute after consent and Optional raw capture
  • Calls python3

What it does

This skill treats Defuddle as an optional external extractor rather than a built-in capability, and keeps cleaning, raw capture, and wiki ingestion as three separate operations. It resolves its own tooling location from the skill's own directory, never from the selected Obsidian vault, and only accepts remote input as HTTPS URLs, rejecting credentials in the URL, local or private hosts, control characters, and sensitive query parameters.

Its first step builds an inert plan that validates the URL and runs no network call, reporting the normalized host, the redirect policy, and whether a configured Defuddle executable was even found. A redirect to a different host is treated as denied until that host is explicitly approved, and the skill states plainly that the URL and request metadata will leave the machine, requiring explicit consent before it runs the actual fetch.

It never installs a cleaner or silently switches to another fetcher, and it will not claim a fixed token reduction or extraction quality - the actual output is meant to be inspected instead.

When your agent uses it

  • Cleaning a web article into readable Markdown before saving it
  • Preparing a web source for ingestion into an Obsidian wiki
  • Stripping ads and clutter from a page before reading its content

Example prompts

  • “Defuddle this article URL into clean Markdown.”
  • “Clean this page up and get it ready for my wiki.”
  • “Strip the clutter from this blog post before I save it.”

Requirements

  • Network access with explicit user consent
  • An installed Defuddle executable

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Resolve the user vault.
  2. Hash the exact cleaned bytes with SHA-256.
  3. Draft a new immutable payload such as
  4. Use expected_hashes: null and mode: create. If that content-addressed
  5. Build, inspect, and apply one claude-obsidian.transaction.v1 capture

What it can do on your machine

Read from SKILL.md and the folder at commit 32ac5a0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Defuddle Web Page Cleaner loads about 1.1k tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 564 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~70
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AgriciDaniel/claude-obsidian at commit 32ac5a0, republished under its MIT licence (© AgriciDaniel). 564 words, ~1,145 tokens.

Download SKILL.mdSave it as .claude/skills/defuddle/SKILL.md (or your agent's skills folder).
name
defuddle
description
Plan and, with explicit network consent, use an optional external Defuddle cleaner to extract article-like HTTPS pages as Markdown. Use for defuddle, clean this URL, strip page clutter, readable Markdown from a web page, or preparing a web source for later wiki ingestion.

Defuddle

Treat Defuddle as an optional external extractor, not an internal capability. Cleaning, raw capture, and wiki ingestion are separate operations.

Resolve the installed product root from this skill's own location, never from the selected vault or process working directory:

bash
PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian
CORE="$PRODUCT_ROOT/scripts/claude-obsidian.py"
test -f "$CORE"

Every ../wiki/references/ link in this file resolves the same way, relative to this skill's own directory under $PRODUCT_ROOT, never relative to the selected vault's wiki/ directory.

If a separately installed kepano/obsidian-skills defuddle skill is available, prefer it for current CLI flags. Retain the privacy, consent, and transaction rules in this skill.

Safety contract

  • Accept remote inputs only as HTTPS URLs.
  • Reject credentials in URLs, fragments, private or local hosts, non-public IP addresses, control characters, and sensitive query parameters.
  • Never interpolate a URL into a shell string. Pass it as one argv element.
  • Treat redirects to a different host as denied until that host is explicitly approved.
  • State that the URL and request metadata will leave the machine. Network access requires explicit consent in the current request or a separate confirmation.
  • Do not install a cleaner, execute a placeholder runner, or silently switch to another network fetcher.
  • Do not claim a fixed token reduction or extraction quality. Inspect the actual output.

Plan first

Create an inert URL plan. This validates the URL and executes no network call:

bash
python3 "$CORE" capture external-plan url "HTTPS_URL"

Report the normalized host, network egress, redirect policy, optional external dependency, and execute: false. Then inspect whether this package can find a configured Defuddle executable:

bash
python3 "$CORE" contracts --verify --capability defuddle --vault VAULT

An available state means no executable was found; stop with the inert plan. A configured state means the executable was discovered, but this package has no bundled behavioral verifier for it. Show that state and reason, identify the resolved executable path, and require manual review of its provenance, version, and exact argv before execution. Never relabel configured as verified.

When unavailable or when manual review is declined, offer these honest fallbacks: let the user install/configure an external runner, accept a local HTML or Markdown file in inbox/, or leave the URL queued for later. Do not claim that content was cleaned, captured, or ingested.

Show full SKILL.md (219 more words)Show less

After network consent, configured-state detection, and manual executable review, invoke the approved executable with an argv equivalent to:

text
defuddle parse HTTPS_URL --md

Capture bounded stdout in a temporary draft outside shared vault state. Fail closed on a non-zero exit, empty output, unexpected binary output, an unapproved redirect, or a response that is clearly an authentication/error page. Preserve headings, links, code fences, tables, quotations, and source wording; do not invent missing content.

Preview the cleaned Markdown and report extraction limitations. If the user asked only to read or analyze it, keep the result transient.

Optional raw capture

When the user asks to retain the cleaned source:

  1. Resolve the user vault.
  2. Hash the exact cleaned bytes with SHA-256.
  3. Draft a new immutable payload such as .raw/captured/<sha256>.md and, when provenance metadata is needed, a new create-only sidecar with the normalized URL, retrieval date, extractor name and version, and content hash.
  4. Use expected_hashes: null and mode: create. If that content-addressed payload already exists with the same bytes, report a no-op; never overwrite it.
  5. Build, inspect, and apply one claude-obsidian.transaction.v1 capture bundle as described in operation-transactions.md.

Do not create wiki pages, update indexes, assess claims, or mark the source as ingested. Invoke wiki-ingest as a distinct requested operation if the user wants the captured payload incorporated into the knowledge base.

© AgriciDaniel, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/defuddle of AgriciDaniel/claude-obsidian.

Open the folder on GitHubat commit 32ac5a0

Compare with similar skills

Defuddle Web Page Cleaner next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Defuddle Web Page Cleaner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Defuddle Web Page Cleaner this skillAgriciDaniel/claude-obsidian15k—~1.1kAutomated safety check: PassMIT
Xiaohongshu Post Extractorchenxiachan/xhs-claude-skills421—~1.5kAutomated safety check: WarnMIT
Link Curator Obsidian Vaultdodo-reach/hermes-link-curator142—~2.8kAutomated safety check: PassMIT
Obsidian Web Clipper Templatesdavila7/claude-code-templates32k6 repos~632Automated safety check: PassMIT
Baoyu URL To Markdownsdyckjq-lab/llm-wiki-skill2.5k2 repos~3.2kAutomated safety check: PassNone
Obsidian CLIAtmosphere/atmosphere3.8k13 repos~795Automated safety check: PassApache-2.0

Similar skills

  • Xiaohongshu Post Extractor

    chenxiachan/xhs-claude-skills

    Pulls a Xiaohongshu post's text, image text and video subtitles or transcript into a Markdown note saved in an Obsidian folder, in Chinese.

    421 GitHub stars~1.5k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check: warnings
  • Link Curator Obsidian Vault

    dodo-reach/hermes-link-curator

    Archives links a user sends into a profile's Obsidian-style vault with a save script and replies with a one-word confirmation instead of a summary.

    142 GitHub stars~2.8k tokensUpdated 4 mo ago
    Knowledge ManagementAuto-check passed
  • Obsidian Web Clipper Templates

    davila7/claude-code-templates

    Builds importable JSON templates for the Obsidian Web Clipper by checking your Bases, analyzing a sample page and drafting the template.

    32k GitHub starsUsed in 6 repos~632 tokens
    Knowledge ManagementAuto-check passed
  • Baoyu URL To Markdown

    sdyckjq-lab/llm-wiki-skill

    Fetch any URL and convert to markdown using Chrome CDP. An agent skill from sdyckjq-lab/llm-wiki-skill.

    2.5k GitHub starsUsed in 2 repos~3.2k tokens
    Knowledge ManagementAuto-check passed
  • Obsidian CLI

    Atmosphere/atmosphere

    Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more.

    3.8k GitHub starsUsed in 13 repos~795 tokens
    Knowledge ManagementAuto-check passed
  • Hermes History Ingest

    Ar9av/obsidian-wiki

    Ingest Hermes agent history into Obsidian as distilled knowledge.

    3.5k GitHub starsUsed in 1 repo~2.2k tokens
    Knowledge ManagementAuto-check: notes

More from AgriciDaniel/claude-obsidian

All 15 skills in this repo
  • Bounded Autoresearch

    AgriciDaniel/claude-obsidian

    Runs a bounded, source-grounded research loop that drafts a cited dossier and can propose a separately reviewed merge into an Obsidian vault.

    15k GitHub stars~1.6k tokensUpdated 27 days ago
    Auto-check passed
  • Obsidian Canvas Boards

    AgriciDaniel/claude-obsidian

    Creates, inspects and updates Obsidian JSON Canvas boards in a vault, with text, file, link, group and edge nodes, using safe recoverable edits.

    15k GitHub stars~1.4k tokensUpdated 27 days ago
    Auto-check passed
  • Obsidian Wiki Vault Setup

    AgriciDaniel/claude-obsidian

    Sets up or adopts a separate Obsidian knowledge vault through the claude-obsidian core script and routes follow-up work to the right wiki sub-skill.

    15k GitHub stars~1.3k tokensUpdated 27 days ago
    Auto-check passed
  • Obsidian Wiki Log Fold

    AgriciDaniel/claude-obsidian

    Creates a bounded, extractive rollup of recent Obsidian wiki log entries, previewed by default, with one optional apply step and no changes to child pages.

    15k GitHub stars~1.2k tokensUpdated 27 days ago
    Auto-check passed
  • Obsidian Bases Editor

    AgriciDaniel/claude-obsidian

    Explains, drafts and validates Obsidian Bases .base files, building filters, formulas and table, card or list views, and applying edits only through one inspected transaction.

    15k GitHub stars~1.2k tokensUpdated 27 days ago
    Auto-check passed
  • Obsidian Markdown Syntax

    AgriciDaniel/claude-obsidian

    Explains, drafts and validates Obsidian Flavored Markdown such as properties, wikilinks, embeds, callouts and Mermaid, with vault edits applied through approved transactions.

    15k GitHub stars~1.1k tokensUpdated 27 days ago
    Auto-check passed

Works with

Questions about Defuddle Web Page Cleaner

What does Defuddle Web Page Cleaner do?

Plans, and with explicit network consent runs, an external Defuddle extractor that turns an article-like HTTPS page into clean Markdown for later wiki ingestion. This skill treats Defuddle as an optional external extractor rather than a built-in capability, and keeps cleaning, raw capture, and wiki ingestion as three separate operations. It resolves its own tooling location from the skill's own directory, never from the selected Obsidian vault, and only accepts remote input as HTTPS URLs, rejecting credentials in the URL, local or private hosts, control characters, and sensitive query parameters.

When should I use Defuddle Web Page Cleaner?

Defuddle Web Page Cleaner fits situations like: cleaning a web article into readable Markdown before saving it; preparing a web source for ingestion into an Obsidian wiki; stripping ads and clutter from a page before reading its content.

How do I install Defuddle Web Page Cleaner in Claude Code?

Run `npx skills add AgriciDaniel/claude-obsidian --skill defuddle -a claude-code`. Or copy the skill folder (skills/defuddle in AgriciDaniel/claude-obsidian) into .claude/skills/defuddle in your project. Claude Code loads it when a task matches its description.

How do I install Defuddle Web Page Cleaner in Codex?

Run `npx skills add AgriciDaniel/claude-obsidian --skill defuddle -a codex`. Or copy the skill folder (skills/defuddle in AgriciDaniel/claude-obsidian) into .agents/skills/defuddle in your project. Codex loads it when a task matches its description.

Can I use Defuddle Web Page Cleaner in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AgriciDaniel/claude-obsidian --skill defuddle -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/defuddle, .gemini/skills/defuddle, .github/skills/defuddle and .opencode/skills/defuddle in your project.

What does Defuddle Web Page Cleaner need to run?

Going by SKILL.md and its folder, Defuddle Web Page Cleaner needs the command-line tools its instructions call (python3). Our summary lists: Network access with explicit user consent; An installed Defuddle executable.

Does Defuddle Web Page Cleaner access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Defuddle Web Page Cleaner safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Defuddle Web Page Cleaner use?

Defuddle Web Page Cleaner is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Defuddle Web Page Cleaner use?

About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Defuddle Web Page Cleaner?

Skills that share tags, products or a category with Defuddle Web Page Cleaner: Xiaohongshu Post Extractor (chenxiachan/xhs-claude-skills, 421 stars), Link Curator Obsidian Vault (dodo-reach/hermes-link-curator, 142 stars), Obsidian Web Clipper Templates (davila7/claude-code-templates, 32k stars) and Baoyu URL To Markdown (sdyckjq-lab/llm-wiki-skill, 2.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Defuddle Web Page Cleaner?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/claude-obsidian, which has 15,379 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on September 10, 2026.

Source: AgriciDaniel/claude-obsidian on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.