defuddle

defuddle skill の概要

defuddle skill でできること

defuddle は、通常の Web ページを、単純な fetch よりもはるかにノイズの少ない、読みやすい markdown に変換する skill です。記事、ドキュメント、ガイド、ブログ投稿など、HTML ページの本文を読みたい場面に向いています。メニュー、広告、サイドバー、ナビゲーションのような要素がトークンを無駄にし、分析の邪魔になるケースで特に効果を発揮します。

Web Research で defuddle skill が向いているケース

defuddle for Web Research は、サイトの見た目や生の HTML を確認したいのではなく、ページ本文を読んだり、要約したり、比較したり、引用したり、分析したいときに使うのが最適です。いちばんの価値は、後続の推論や処理に適した、クリーンな入力を作れることにあります。ユーザーが一般的なページ URL を渡してきて、その中身を取り出したいのであれば、汎用的な web fetch より defuddle usage を起点にするほうが、たいていは適切です。

defuddle skill の主な制約と、使わないほうがよい場面

もっとも重要な境界はシンプルです。URL が .md で終わるページには defuddle を使わないでください。そうしたページはすでに markdown なので、直接 fetch したほうがきれいで、余計な変換も避けられます。また、厳密なページ構造、インタラクティブ要素、スクリプト、完全な DOM の忠実性が必要な用途にも向いていません。

なぜユーザーは defuddle skill を選ぶのか

実務上の違いは、「ページを取ってこられるか」ではなく、「主要な本文を、トークン効率のよい形式で素早く取り出せるか」にあります。だからこそ defuddle skill は、リサーチ用パイプライン、ノート収集、記事要約、ドキュメント読解のように、きれいな markdown が出力品質を大きく左右するワークフローで選ばれます。

defuddle skill の使い方

defuddle のインストールと基本コマンド

defuddle install については、リポジトリで Defuddle CLI 本体が案内されています。

npm install -g defuddle

基本コマンドはこちらです。

defuddle parse <url> --md

--md は一貫して付けるのがおすすめです。ほとんどの調査・分析ワークフローでは、この出力形式が推奨されます。見た目のノイズを落としつつ、読みやすい構造は保てるためです。

defuddle skill に必要な入力

defuddle skill に必要なのはページ URL と、できれば何をしたいのかが分かる明確な意図です。よい入力には、次の情報が含まれます。

• 正確な URL
• そのページから何を得たいか
• 完全な markdown が必要か、保存したいのか、メタデータだけでよいのか

例:

• 「この記事を読んで、主張の要点を要約して: <url>」
• 「この docs ページからクリーンな markdown を抽出して content.md に保存して: <url>」
• 「<url> のページタイトルと description だけ取得して」

便利なコマンド:

defuddle parse <url> --md -o content.md
defuddle parse <url> -p title
defuddle parse <url> -p description
defuddle parse <url> -p domain

あいまいな依頼を、効果的な defuddle プロンプトに変える

弱い依頼: 「この URL を見て」

よりよい defuddle guide 向けプロンプト:

• 「<url> に defuddle を markdown 出力で使って。サイトナビゲーションは無視して、そのあと要点を 5 つの箇条書きで要約し、最重要セクションを引用して。」
• 「このドキュメントページ <url> に defuddle を使って。markdown を抽出し、セットアップ手順、前提条件、注意点を特定して、チェックリスト形式に書き直して。」
• 「まず <url> からメタデータだけ取得して。title と description がテーマに合っていたら、その後に完全な markdown を抽出して。」

この形のほうがうまくいくのは、defuddle をどう呼び出すかだけでなく、整形後のコンテンツをその後どう扱うかまでエージェントに伝えられるからです。

おすすめのワークフローと、最初に読むべきファイル

この skill は意図的に小さくまとまっています。まず skills/defuddle/SKILL.md を読むのがおすすめです。インストール方法、パースコマンド、出力形式、メタデータのプロパティまで、実用に必要な流れがひと通り入っています。実際には、次の順番で進めるとスムーズです。

1. URL が通常の HTML ページか .md ファイルかを確認する。
2. defuddle parse <url> --md を実行する。
3. 再利用できる成果物として残したいなら -o content.md を付ける。
4. ルーティングや妥当性確認だけが目的なら、-p でメタデータを問い合わせる。
5. 整形済み markdown を要約、抽出、ノート化の処理に渡す。

defuddle skill の FAQ

defuddle skill は、普通のプロンプト＋fetch より優れていますか？

記事系のページでは、多くの場合 yes です。通常の fetch には、ヘッダー、フッター、Cookie 通知、ナビゲーションなどがそのまま含まれがちです。defuddle usage を挟むことで、分析前の段階でノイズを減らせるため、トークンコストを抑えやすくなり、無関係なページ要素に引っ張られた要約ミスも減らせます。

どんなときに defuddle skill を使うべきではありませんか？

.md URL、raw ファイル、厳密な HTML、埋め込みメディアの挙動、ページスクリプト、レイアウトの詳細が必要なケースでは defuddle は避けてください。これはコンテンツ抽出ツールであり、ブラウザ自動化ツールでも DOM 検査ツールでもありません。

defuddle skill は初心者にも使いやすいですか？

はい。コマンド体系は非常に小さく、基本は一度インストールして defuddle parse <url> --md を使うだけです。そのため defuddle skill は、調査やノート収集のために、まずはきれいな元テキストを取りたいだけという人でも導入しやすくなっています。

defuddle はどんな出力を返せますか？

--md で markdown、--json で JSON、デフォルトでは HTML、-p <name> で特定のメタデータを取得できます。多くの読解・調査タスクでは markdown が最適なデフォルトです。メタデータモードは、素早い妥当性確認や振り分けに役立ちます。

defuddle skill を改善する方法

defuddle には、狙ったページを正確に渡す

defuddle の結果を改善するいちばん簡単な方法は、ホームページ、検索結果ページ、一覧ページではなく、正規のコンテンツページを渡すことです。記事 URL や単一の docs ページは、ナビゲーションや重複リンクだらけのハブページより、きれいな markdown を生成しやすくなります。

defuddle skill では、抽出後の作業も同じ依頼に含める

defuddle skill は、抽出と次の作業をセットで依頼すると強みが出ます。単に「これを parse して」で終わらせず、次のような目的まで指定してください。

• 要約
• 主要な主張
• セットアップ手順
• FAQ
• 引用
• 比較ポイント

こうすることで、引き継ぎ時のあいまいさが減り、エージェントも本来の job-to-be-done に沿って出力を組み立てやすくなります。

URL が怪しいときは、先にメタデータモードで確認する

URL がリダイレクトするかもしれない、品質が低いかもしれない、そもそも目的のページではないかもしれない、という場合は、まず次を実行してください。

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

これはシンプルですが効果的な defuddle guide のコツです。まず関連性を確認し、その後で完全な markdown 抽出に手間をかけるようにします。

defuddle skill で起こりやすい失敗パターンと改善の回し方

出力が薄い、あるいは構造がおかしいと感じる場合、原因は CLI ではなく元ページにあることが少なくありません。より具体的な URL を試す、カテゴリーページではなく記事ページに切り替える、markdown を保存して手動で中身を確認するといった対応が有効です。最初の結果が広すぎるなら、defuddle for Web Research を「セットアップ手順だけ抽出して」「認証に関するセクションだけ引用して」のように、より狭い指示で再実行してください。