# Defuddle

> Extract clean markdown content from web pages using Defuddle CLI. ALWAYS use this instead of WebFetch when the user provides a URL to read or analyze. TRIGGER when: user provides any URL to a webpage, documentation, article, blog post, PDF link, DOI, arXiv, SSRN, Academia.edu page, or local PDF file path. DO NOT use WebFetch for these — use defuddle.

- **Type:** Skill
- **Install:** `agentstack add skill-spaceage64-claude-defuddle-claude-defuddle`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [spaceage64](https://agentstack.voostack.com/s/spaceage64)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [spaceage64](https://github.com/spaceage64)
- **Source:** https://github.com/spaceage64/claude-defuddle

## Install

```sh
agentstack add skill-spaceage64-claude-defuddle-claude-defuddle
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Defuddle

Use Defuddle CLI to extract clean readable content from any web page — including YouTube videos (transcript + chapters), Apple Podcasts episodes (transcript + chapters), academic papers (PDF → markdown via DOI, arXiv, SSRN, or Academia.edu), plain PDF URLs, and local PDF file paths.

## Fetch and present

```bash
python3 ~/.claude/skills/defuddle/defuddle.py --url ""
```

Use the output to answer the user's question or complete the task. The script automatically detects the source type (article, YouTube, podcast, paper) and handles fetching accordingly. For articles, it falls back to archive.org / archive.is if the page is JS-rendered or paywalled.

> [!warning] User Action Required — STOP
> If stderr contains "captcha" or "archive it" (from `--method archive-is` or `--method wayback`), **STOP immediately. Do not try other URLs or workarounds.** Show the user the URL printed in the message and ask them to visit it and let you know when done — then retry with the same command. Alternatively, ask the user if WebFetch should be used instead.

> [!warning] Apple Podcasts — Transcript Not Cached
> If stderr contains "Podcast transcript not found locally", **STOP immediately.** Show the user the `podcasts://` deep link printed in the message and ask them to open it, view the transcript in the Podcasts app, then let you know when done. Once confirmed, retry with the exact same command — the transcript will now be cached locally.

## Save to Vault

1. Ask: "Want to save this to the vault?"
2. If yes: determine a folder name from context (e.g. a project or topic name), or ask if unclear.
3. Run the script — it writes the file and prints the saved path:

```bash
python3 ~/.claude/skills/defuddle/defuddle.py \
  --url "" --project "{folder}" --created "{YYYY-MM-DD}" \
  [--filename "kebab-case-name"] [--method native|native-md|native-page|googlebot|wayback|archive-is]
```

- `--project`: subfolder name inside your vault (e.g. `my-project`, `research`)
- `--filename`: optional override; script auto-generates from the title via AI if omitted
- `--method`: force a specific fetch method instead of the auto-cascade (articles only)

Notes are saved to `{vault}/{folder}/defuddle/` regardless of source type.

The vault path is set via `VAULT_PATH` in `defuddle.py`. See README for setup.

4. Confirm the path printed by the script: "Saved to `{path}`"

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [spaceage64](https://github.com/spaceage64)
- **Source:** [spaceage64/claude-defuddle](https://github.com/spaceage64/claude-defuddle)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-spaceage64-claude-defuddle-claude-defuddle
- Seller: https://agentstack.voostack.com/s/spaceage64
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.