defuddle Skill for Claude: Turn Web Pages into Clean Markdown

Makes Claude read web pages through the Defuddle CLI, which returns clean Markdown instead of cluttered HTML.

Installs: 75.6K; on skills.sh
Stars: 50.6K; on GitHub
Updated: Sep 2026; last repo commit

defuddle makes Claude run the Defuddle command-line tool to turn a web page into clean Markdown. The skill tells the assistant to prefer it over WebFetch for standard web pages, because it removes navigation, ads and clutter and uses fewer tokens.

It needs the defuddle program on your machine, and the skill says to install it with npm if it is missing. The skill is one SKILL.md and bundles no scripts.

Good for

People who ask Claude to read articles, docs or blog posts and want fewer wasted tokens
Claude Code users who already work with Obsidian skills

Install defuddle

Claude Code

Copy this prompt.

Install the defuddle skill in Claude Code. Run this command:

npx skills add https://github.com/kepano/obsidian-skills --skill defuddle

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

Extract clean Markdown from HTML pages with Defuddle CLI.

Sections in SKILL.md

Usage
Output formats

Key facts

Author: kepano
Repo: kepano/obsidian-skills
License: MIT
Installs on skills.sh: 75,584 (Nov 2, 2026)
GitHub stars (whole repo): 50,577 (Nov 2, 2026)
Last commit to the repo: Sep 15, 2026
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk warn
Skill folder: 1 file: SKILL.md (counted from the GitHub folder)
Needs: The Defuddle CLI on your machine; the skill says to install it with npm if missing
Works in: Claude Code, Codex and OpenCode per the repo README; the Claude app is not documented

What it includes

Fetches a web page and prints it as clean Markdown
The skill says to always use --md. Navigation, ads and clutter are removed so the assistant reads less.
Try: “Read https://example.com/post and summarize it”
Network · defuddle parse <url> --md
Saves the Markdown to a file instead of printing it
Writes the cleaned page to a file you name.
Write · -o content.md
Pulls out one metadata property of the page
Returns only the page title, description or domain.
Network · -p title | description | domain
Returns JSON with both the HTML and the Markdown
Use when the assistant needs the raw HTML as well as the cleaned text.
Network · --json
Returns HTML
With no format flag the CLI returns HTML, so the skill says to use --md by default.
No flag

From the official docs

Permissions

Medium risk

The skill makes Claude run a command-line tool that downloads web pages and may install a global npm package. Install the Defuddle CLI yourself first and approve each command Claude wants to run.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It may install a global npm package
If defuddle is missing, the skill says to run npm install -g defuddle. Install it yourself first so you control the source and version.
It fetches any URL it is given
The CLI downloads whole pages from the network. Watch which addresses Claude asks it to fetch.
It can save pages to a file
The -o flag writes the Markdown to a path you name. Check the path before approving.

Technical details

Talks to	Any URL you or Claude pass to defuddle
Sign-in and keys	The SKILL.md names no account or key.

Questions

How do I install defuddle?

Use the install box above. The skill is one SKILL.md. The repo README also documents a Claude Code plugin install, the skills CLI and manual copying. The Defuddle program itself is a separate install, see the next question.

Do I need to install the Defuddle CLI too?

Yes. The skill only tells Claude to run the defuddle command. Its SKILL.md says to install the program with npm if it is not installed.

Does defuddle work in the Claude app or Codex?

The repo README documents Claude Code, Codex and OpenCode. It does not document the Claude app, and the skill depends on running a local command-line tool.

Is defuddle safe?

The skill is plain text, but it makes Claude run a command-line tool that downloads whatever URL it is given and may install a global npm package. Install the CLI yourself first if you want to know exactly what runs, and check what Claude fetches on your behalf.

defuddle vs WebFetch: which should I use?

The skill says to prefer Defuddle over WebFetch for standard web pages, because it strips navigation, ads and clutter and so reduces token usage. It does not describe pages where WebFetch is better.

Do I need Obsidian to use it?

The SKILL.md does not mention Obsidian. It sits in a repo of skills built for Obsidian, but the instructions only cover fetching pages as Markdown.

Information

updated Nov 2, 2026

Repository: kepano/obsidian-skills
Folder: skills/defuddle

kepano/obsidian-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

defuddle SKILL.md · github.com
kepano/obsidian-skills README · github.com
defuddle on skills.sh · skills.sh
kepano/obsidian-skills · github.com