Przejdź do treści
Biblioteka skilli
Dokumenty i biuro · Konwersja i formaty

defuddle

/defuddle

Wyodrębnia czysty markdown ze stron internetowych przez Defuddle CLI, usuwając nawigację i zbędne elementy, aby oszczędzać tokeny przy czytaniu dokumentacji, artykułów i wpisów blogowych.

Repozytorium
tekhne ↗
Licencja
MIT
Ostatnia zmiana repozytorium
21.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
29
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
10
Przestarzałość

Brak sygnałów. Repozytorium zmienione 21.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Wyodrębnia czysty markdown ze stron internetowych przez Defuddle CLI, usuwając nawigację i zbędne elementy, aby oszczędzać tokeny przy czytaniu dokumentacji, artykułów i wpisów blogowych.

Oryginalny opis (EN)

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.

Jak działa

  1. Mindset
  2. Quick Start
  3. When to Use
  4. Usage
  5. Output formats
  6. Common Mistakes
  7. References
Sekcje z nagłówków SKILL.md, w oryginale · 142 linii, 621 słów
Podgląd SKILL.md
---
name: defuddle
description: 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.
---

# Defuddle

Use Defuddle CLI to extract clean readable content from web pages. Prefer over WebFetch for standard web pages — it removes navigation, ads, and clutter, reducing token usage.

If not installed: `npm install -g defuddle`

## Mindset

Defuddle is a server-side HTML stripper, not a browser. Think of it as getting the printed article without the magazine wrapper — it fetches raw HTML and removes boilerplate, always faster and cheaper than WebFetch for standard pages.

**When to apply:** Any standard HTTP page — documentation, articles, blog posts, wikis.
**When NOT to apply:** SPAs requiring JavaScript, login-gated pages, JSON API endpoints, or pages behind auth redirects.

When in doubt, try defuddle first; if the output is empty or navigation-only, fall back to WebFetch.

## Quick Start

1. Confirm the URL is a standard web page (not a SPA or auth-required page)
2. Run `defuddle parse <url> --md` to extract clean markdown
3. If output is empty or only navigation text, fall back to WebFetch
4. Save output with `-o file.md` when persistence is needed

## When to Use

Use this decision framework before fetching any URL:

| Scenario | Tool | Reason |
|----------|------|--------|
| Article, blog post, documentation page | **defuddle** (ALWAYS) | Removes clutter, saves tokens |
| Standard web page with readable text | **defuddle** (ALWAYS) | Cleaner output than WebFetch |
| JavaScript-heavy SPA (React/Vue app shell) | WebFetch or inform user | defuddle cannot execute JS |
| Login-gated or auth-required page | WebFetch or inform user | defuddle fetches without credentials |
| API endpoint returning JSON | Direct fetch or inform user | defuddle is for HTML pages |
| User asks for metadata only (title, description) | `defuddle parse <url> -p <field>` | Lightweight extraction |

**Mental model:** defuddle is a server-side HTML parser — it downloads the HTML, strips boilerplate, and returns clean prose. It cannot authenticate, execute JavaScript, or follow redirects that require cookies. When in doubt about a URL, try defuddle first; if the output is empty or only navigation text, fall back to WebFetch.

## Usage

ALWAYS use `--md` for markdown output:

```bash
defuddle parse <url> --md
```

Save to file:

```bash
defuddle parse <url> --md -o content.md
```

Extract specific metadata:

```bash
defuddle parse <url> -p title
defuddle parse <url> -p description
defuddle parse <url> -p domain
```

## Output formats

| Flag | Format |
|------|--------|
| `--md` | Markdown (default choice) |
| `--json` | JSON with both HTML and markdown |
| (none) | HTML |
| `-p <name>` | Specific metadata property |

## Common Mistakes

See [ANTI-PATTERNS.md](references/ANTI-PATTERNS.md) for full explanations of each mistake.

### 1. Using WebFetch when defuddle is available

**NEVER** use WebFetch for standard web pages when defuddle is available. Raw HTML commonly contains 5-10x more tokens than the extracted content.

BAD:

```bash
WebFetch("https://docs.example.com/guide")
```

GOOD:

```bash
defuddle parse https://docs.example.com/guide --md
```

### 2. Omitting the `--md` flag

**NEVER** call `defuddle parse` without `--md` when readable content is the goal. Without it, defuddle returns raw HTML — tag-heavy and token-wasteful.

BAD:

```bash
defuddle parse https://example.com/article
```

GOOD:

```bash
defuddle parse https://example.com/article --md
```

### 3. Using `-p` when full content is needed

**NEVER** use `-p` when the user wants the page body. It returns one metadata property and silently discards the entire body text.

BAD:

```bash
defuddle parse https://example.com/article -p title
```

GOOD:

```bash
defuddle parse https://example.com/article --md
```

### 4. Using shell redirection instead of `-o`

**NEVER** use `>` to save output — it can corrupt encoding on non-UTF-8 terminals. Always use `-o`.

BAD:

```bash
defuddle parse https://example.com/article --md > output.md
```

GOOD:

```bash
defuddle parse https://example.com/article --md -o output.md
```

## References

- [Defuddle npm](https://www.npmjs.com/package/defuddle)
- [Defuddle GitHub](https://github.com/kepano/defuddle)
Pliki w paczce (29)
  • SKILL.md 4 KB
  • .audits/latest 1 KB
  • .audits/2026-03-16/analysis.md 1 KB
  • .audits/2026-03-16/audit.json 1 KB
  • .audits/2026-03-16/remediation-plan.md 3 KB
  • .audits/2026-10-02/Analysis.md 1 KB
  • .audits/2026-10-02/Remediation.md 2 KB
  • .audits/2026-10-02/audit.json 1 KB
  • evals/instructions.json 3 KB
  • evals/summary.json 1 KB
  • evals/scenario-1/capability.txt 1 KB
  • evals/scenario-1/criteria.json 2 KB
  • evals/scenario-1/task.md 1 KB
  • evals/scenario-2/capability.txt 1 KB
  • evals/scenario-2/criteria.json 2 KB
  • evals/scenario-2/task.md 1 KB
  • evals/scenario-3/capability.txt 1 KB
  • evals/scenario-3/criteria.json 2 KB
  • evals/scenario-3/task.md 1 KB
  • evals/scenario-4/capability.txt 1 KB
  • evals/scenario-4/criteria.json 3 KB
  • evals/scenario-4/task.md 1 KB
  • evals/scenario-5/capability.txt 1 KB
  • evals/scenario-5/criteria.json 2 KB
  • evals/scenario-5/task.md 1 KB
  • evals/scenario-6/capability.txt 1 KB
  • evals/scenario-6/criteria.json 2 KB
  • evals/scenario-6/task.md 1 KB
  • references/ANTI-PATTERNS.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · pantheon-org/tekhne100MIT
FrancoStino/opencode-skills-collection100MIT
tonydzi/second-brain-starter-kit100MIT
galyarderlabs/galyarder-framework100MIT
galyarderlabs/galyarder-framework100MIT
LiHongwei-cn/lihongwei-cn100MIT
yeaight7/agent-powerups100Apache-2.0
pinkpixel-dev/skills-collection-1100Apache-2.0
agricidaniel/claude-obsidian95MIT

Migawka bazy z 13.11.2026 · wersja paczki 149a10873076 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100web-read
    Czyta strony i artykuły jako czysty Markdown przez CLI Defuddle, oszczędzając tokeny w porównaniu z WebFetch.
  • 100baoyu-url-to-markdown
    Pobiera dowolny adres URL i konwertuje go na Markdown przez Chrome CDP, zapisując migawkę HTML, z potokiem Defuddle, transkrypcjami YouTube i awaryjnym przejściem na API defuddle.md.
  • 100webpage-reader
    Pobiera stronę z URL i zwraca czysty Markdown bez nawigacji i reklam, do czytania artykułów, dokumentacji i publikacji.
  • 100baoyu-url-to-markdown
    Pobiera dowolny URL i konwertuje go na Markdown przez Chrome CDP, zapisując migawkę HTML, z potokiem Defuddle, transkryptami YouTube i awaryjnym powrotem do starszego potoku lub hostowanego API.
  • 100web-fetcher
    Pobiera dowolny adres jako czysty Markdown, także ze stron JS i platform wymagających logowania, zamiast zwykłego WebFetch.
  • 100web-to-markdown
    Zamienia adres URL w oczyszczony Markdown z deterministycznym wyborem strategii: r.jina.ai dla zwykłych stron, defuddle.md dla YouTube i ekstrakcja z imitacją przeglądarki dla WeChat, Zhihu i Feishu z Mozilla Readability.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.