defuddle

Vue d’ensemble de la skill defuddle

Ce que fait la skill defuddle

La skill defuddle transforme une page web classique en un markdown propre et lisible, avec bien moins de bruit qu’un fetch brut. Elle est conçue pour les pages comme les articles, la documentation, les guides, les billets de blog et autres pages HTML où les menus, publicités, barres latérales et éléments de navigation gaspillent des tokens et parasitent l’analyse.

defuddle pour la recherche web : dans quels cas l’utiliser

Utilisez defuddle for Web Research lorsque votre objectif réel est de lire, résumer, comparer, citer ou analyser le contenu d’une page, et non d’inspecter le chrome du site ou le HTML brut. Sa valeur principale est de fournir une entrée plus propre pour le raisonnement en aval. Si un utilisateur vous donne l’URL d’une page standard et veut récupérer son contenu, l’usage de defuddle constitue généralement un meilleur point de départ qu’un fetch web générique.

Limites principales et cas où il vaut mieux s’en passer

La limite la plus importante est simple : n’utilisez pas defuddle sur des URL se terminant par .md. Ces pages sont déjà en markdown ; un fetch direct est donc plus propre et évite une transformation inutile. L’outil est aussi peu adapté si vous avez besoin de la structure exacte de la page, d’éléments interactifs, de scripts ou d’une fidélité complète au DOM.

Pourquoi les utilisateurs choisissent defuddle

Le vrai différenciateur n’est pas « peut-il récupérer une page ? », mais plutôt « peut-il me donner rapidement le texte principal dans un format économe en tokens ? ». C’est ce qui rend la skill defuddle intéressante pour les pipelines de recherche, la capture de notes, le résumé d’articles et la lecture de documentation, là où un markdown plus propre améliore concrètement la qualité du résultat.

Comment utiliser la skill defuddle

Installation de defuddle et commande de base

Pour l’installation de defuddle, le dépôt renvoie vers la Defuddle CLI elle-même :

npm install -g defuddle

Commande principale :

defuddle parse <url> --md

Utilisez --md de façon systématique. C’est le format recommandé pour la plupart des workflows de recherche et d’analyse, car il supprime le bruit visuel tout en conservant une structure lisible.

Les entrées dont la skill defuddle a besoin

La skill defuddle a besoin d’une URL de page et, idéalement, d’une intention claire. Une bonne entrée ressemble à ceci :

• l’URL exacte
• ce que vous voulez en tirer
• si vous souhaitez le markdown complet, une sortie enregistrée, ou seulement des métadonnées

Exemples :

• « Lis cet article et résume l’argument principal : <url> »
• « Extrait un markdown propre de cette page de docs et enregistre-le dans content.md : <url> »
• « Récupère uniquement le titre et la description de la page pour <url> »

Commandes utiles :

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

Transformer un objectif flou en prompt defuddle efficace

Requête faible : « Regarde cette URL. »

Meilleur prompt de guide defuddle :

• « Utilise defuddle sur <url> avec une sortie markdown. Ignore la navigation du site. Ensuite, résume les points clés en 5 puces et cite la section la plus importante. »
• « Utilise defuddle pour cette page de documentation : <url>. Extrait le markdown, identifie les étapes d’installation, les prérequis et les points de vigilance, puis réécris le tout sous forme de checklist. »
• « Commence par extraire uniquement les métadonnées de <url>. Si le titre et la description correspondent bien au sujet, extrait ensuite le markdown complet. »

Cette approche fonctionne mieux, car elle indique à l’agent à la fois comment appeler defuddle et quoi faire ensuite du contenu nettoyé.

Workflow recommandé et fichiers à lire en priorité

Cette skill est volontairement compacte. Commencez par lire skills/defuddle/SKILL.md, car ce fichier contient l’ensemble du workflow exploitable : installation, commande de parsing, formats de sortie et propriétés de métadonnées. En pratique, suivez cet enchaînement :

1. Vérifiez si l’URL pointe vers une page HTML classique ou un fichier .md.
2. Exécutez defuddle parse <url> --md.
3. Si vous avez besoin d’un artefact réutilisable, ajoutez -o content.md.
4. Si vous n’avez besoin que d’un routage ou d’une validation, interrogez les métadonnées avec -p.
5. Injectez ensuite le markdown nettoyé dans votre étape de résumé, d’extraction ou de prise de notes.

FAQ sur la skill defuddle

defuddle est-il préférable à un prompt classique avec fetch ?

Oui, dans la plupart des cas pour les pages de type article. Un fetch classique inclut souvent les en-têtes, pieds de page, bandeaux cookies et éléments de navigation. L’usage de defuddle améliore le rapport signal/bruit avant même le début de l’analyse, ce qui peut réduire le coût en tokens et limiter les erreurs de résumé causées par des éléments de page non pertinents.

Quand ne faut-il pas utiliser la skill defuddle ?

Évitez defuddle pour les URL en .md, les fichiers bruts ou les cas où vous avez besoin du HTML exact, du comportement des médias intégrés, des scripts de page ou de détails de mise en page. C’est un outil d’extraction de contenu, pas un outil d’automatisation navigateur ni d’inspection du DOM.

La skill defuddle est-elle adaptée aux débutants ?

Oui. La surface de commande est très réduite : une installation unique, puis defuddle parse <url> --md. Cela rend la skill defuddle facile à adopter, même si vous cherchez simplement à obtenir un texte source plus propre pour la recherche ou la prise de notes.

Quels types de sortie defuddle peut-il renvoyer ?

Vous pouvez obtenir du markdown avec --md, du JSON avec --json, du HTML par défaut, ou des métadonnées spécifiques avec -p <name>. Pour la plupart des tâches de lecture et de recherche, le markdown est le meilleur choix par défaut ; le mode métadonnées est utile pour une validation rapide et le routage.

Comment améliorer l’usage de la skill defuddle

Donner à defuddle une cible de page précise

Le moyen le plus simple d’améliorer les résultats de defuddle est de fournir la page de contenu canonique, et non une page d’accueil, une page de recherche ou une page de listing. Les URL d’articles et les pages de documentation uniques produisent un markdown plus propre que les hubs remplis de navigation et de liens répétés.

Demander la tâche en aval dans la même requête

La skill defuddle est plus performante quand l’extraction est associée à une étape suivante bien définie. Au lieu de dire seulement « parse cette page », demandez par exemple :

• un résumé
• les affirmations clés
• les étapes d’installation
• les FAQ
• des citations
• des points de comparaison

Cela réduit l’ambiguïté au moment du passage de relais et aide l’agent à structurer la sortie en fonction de votre objectif réel.

Utiliser le mode métadonnées avant l’extraction complète en cas de doute

Si l’URL peut rediriger, être de faible qualité ou ne pas être la bonne page, commencez par :

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

C’est une tactique simple mais efficace de guide defuddle : validez d’abord la pertinence, puis consacrez l’effort à l’extraction complète en markdown.

Modes d’échec courants et façons d’itérer

Si la sortie paraît trop pauvre ou bizarrement structurée, le problème vient souvent de la page source plutôt que de la CLI. Essayez une URL plus précise, passez d’une page de catégorie à une page d’article, ou enregistrez le markdown pour l’inspecter manuellement. Si le premier résultat est trop large, relancez defuddle for Web Research avec une consigne plus ciblée, par exemple « extrais uniquement les étapes d’installation » ou « cite uniquement les sections sur l’authentification ».