defuddle

Descripción general de la skill defuddle

Qué hace la skill defuddle

La skill defuddle convierte una página web normal en markdown limpio y legible, con mucho menos ruido que un fetch sin procesar. Está pensada para páginas como artículos, documentación, guías, posts de blog y otras páginas HTML donde los menús, anuncios, barras laterales y la navegación consumen tokens y distraen el análisis.

Cuándo encaja mejor para investigación web

Usa defuddle para Web Research cuando tu objetivo real sea leer, resumir, comparar, citar o analizar el contenido de una página, en lugar de inspeccionar el chrome del sitio o el HTML sin procesar. Su valor principal es ofrecer una entrada más limpia para el razonamiento posterior. Si un usuario te da la URL de una página estándar y quiere acceder al contenido, el uso de defuddle suele ser un mejor punto de partida que un fetch web genérico.

Límites clave y cuándo no conviene usarla

El límite más importante es simple: no uses defuddle con URLs que terminen en .md. Esas páginas ya están en markdown, así que un fetch directo es más limpio y evita una transformación innecesaria. Tampoco encaja bien cuando necesitas la estructura exacta de la página, elementos interactivos, scripts o fidelidad completa del DOM.

Por qué los usuarios eligen defuddle

La diferencia práctica no es “si puede obtener una página”, sino “si puede darme el texto principal en un formato eficiente en tokens y rápido”. Eso hace que la skill defuddle resulte especialmente útil en flujos de investigación, captura de notas, resumen de artículos y lectura de documentación, donde un markdown más limpio mejora de forma tangible la calidad del resultado.

Cómo usar la skill defuddle

Instalación de defuddle y comando básico

Para la instalación de defuddle, el repositorio apunta directamente al Defuddle CLI:

npm install -g defuddle

Comando principal:

defuddle parse <url> --md

Usa --md de forma consistente. Es la salida recomendada para la mayoría de flujos de investigación y análisis, porque elimina ruido visual sin perder una estructura legible.

Qué entradas necesita la skill defuddle

La skill defuddle necesita una URL de página y, preferiblemente, una intención clara. Una buena entrada incluye:

• la URL exacta
• qué necesitas obtener de ella
• si quieres markdown completo, guardar la salida o solo metadatos

Ejemplos:

• “Lee este artículo y resume el argumento principal: <url>”
• “Extrae markdown limpio de esta página de documentación y guárdalo en content.md: <url>”
• “Obtén solo el título y la descripción de la página para <url>”

Comandos útiles:

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

Cómo convertir un objetivo difuso en un buen prompt para defuddle

Solicitud débil: “Mira esta URL”.

Mejor prompt de guía de defuddle:

• “Usa defuddle en <url> con salida markdown. Ignora la navegación del sitio. Después resume los puntos clave en 5 viñetas y cita la sección más importante.”
• “Usa defuddle para esta página de documentación: <url>. Extrae el markdown, identifica pasos de configuración, prerrequisitos y advertencias, y luego reescríbelos como una checklist.”
• “Extrae primero solo los metadatos de <url>. Si el título y la descripción coinciden con el tema, entonces extrae el markdown completo.”

Esto funciona mejor porque le indica al agente tanto cómo invocar defuddle como qué hacer después con el contenido ya limpio.

Flujo recomendado y qué leer primero

Esta skill es deliberadamente pequeña. Lee primero skills/defuddle/SKILL.md porque ahí está todo el flujo utilizable: instalación, comando de parsing, formatos de salida y propiedades de metadatos. En la práctica, usa esta secuencia:

1. Comprueba si la URL es una página HTML normal o un archivo .md.
2. Ejecuta defuddle parse <url> --md.
3. Si necesitas un artefacto reutilizable, añade -o content.md.
4. Si solo necesitas enrutamiento o validación, consulta metadatos con -p.
5. Pasa el markdown limpio a una fase de resumen, extracción o toma de notas.

Preguntas frecuentes sobre la skill defuddle

¿Es defuddle mejor que un prompt normal más fetch?

Por lo general, sí para páginas tipo artículo. Un fetch normal suele incluir cabeceras, pies de página, avisos de cookies y navegación. El uso de defuddle mejora la relación señal-ruido antes de que empiece el análisis, lo que puede reducir el coste en tokens y disminuir errores de resumen causados por elementos irrelevantes de la página.

¿Cuándo no debería usar la skill defuddle?

Evita defuddle en URLs .md, archivos en bruto o casos en los que necesites HTML exacto, comportamiento de medios incrustados, scripts de página o detalles de maquetación. Es una herramienta de extracción de contenido, no una herramienta de automatización de navegador ni de inspección del DOM.

¿La skill defuddle es apta para principiantes?

Sí. La superficie de comandos es muy pequeña: instalas una vez y luego usas defuddle parse <url> --md. Eso hace que la skill defuddle sea fácil de adoptar incluso si solo quieres texto fuente más limpio para investigación o captura de notas.

¿Qué salidas puede devolver defuddle?

Puedes obtener markdown con --md, JSON con --json, HTML por defecto o metadatos concretos con -p <name>. Para la mayoría de tareas de lectura e investigación, markdown es la mejor opción por defecto; el modo de metadatos resulta útil para validación rápida y enrutamiento.

Cómo mejorar la skill defuddle

Dale a defuddle una página de destino precisa

La forma más sencilla de mejorar los resultados de defuddle es proporcionar la página canónica de contenido, no una homepage, una página de búsqueda ni una página de listado. Las URLs de artículos y las páginas individuales de documentación generan markdown más limpio que los hubs llenos de navegación y enlaces repetidos.

Pide la tarea posterior en la misma solicitud

La skill defuddle funciona mejor cuando la extracción se combina con un siguiente paso concreto. En lugar de limitarte a decir “parsea esto”, pide:

• resumen
• afirmaciones clave
• pasos de configuración
• FAQs
• citas
• puntos de comparación

Eso reduce la ambigüedad en el traspaso y ayuda al agente a estructurar la salida en torno al trabajo real que necesitas resolver.

Usa el modo de metadatos antes de la extracción completa si tienes dudas

Si la URL puede redirigir, ser de baja calidad o no ser la página correcta, empieza con:

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

Esta es una táctica simple pero eficaz de guía de defuddle: primero valida la relevancia y después invierte esfuerzo en extraer el markdown completo.

Fallos habituales y cómo iterar con defuddle para Web Research

Si la salida se siente escasa o con una estructura extraña, el problema suele estar en la página de origen, no en el CLI. Prueba una URL más específica, cambia de una página de categoría a una página de artículo, o guarda el markdown para inspeccionarlo manualmente. Si el primer resultado es demasiado amplio, vuelve a ejecutar defuddle para Web Research con una instrucción más acotada, como “extrae solo los pasos de configuración” o “cita solo las secciones sobre autenticación”.