defuddle

Visão geral da skill defuddle

O que a skill defuddle faz

A skill defuddle transforma uma página web comum em markdown limpo e legível, com bem menos ruído do que um fetch bruto. Ela foi feita para páginas como artigos, documentação, guias, posts de blog e outras páginas HTML em que menus, anúncios, barras laterais e navegação desperdiçam tokens e atrapalham a análise.

Melhor uso do defuddle para Web Research

Use defuddle para Web Research quando seu objetivo real for ler, resumir, comparar, citar ou analisar o conteúdo da página, e não inspecionar a interface do site ou o HTML bruto. O principal valor está em gerar uma entrada mais limpa para o raciocínio posterior. Se o usuário fornecer uma URL de página comum e quiser o conteúdo, o uso do defuddle normalmente é um ponto de partida melhor do que um fetch web genérico.

Principais limites e quando não usar

A principal fronteira é simples: não use defuddle em URLs que terminem em .md. Essas páginas já estão em markdown, então um fetch direto é mais limpo e evita uma transformação desnecessária. Ele também não é a melhor escolha quando você precisa da estrutura exata da página, de elementos interativos, scripts ou fidelidade total ao DOM.

Por que os usuários escolhem defuddle

O diferencial prático não é “ele consegue buscar uma página?”, e sim “ele consegue me entregar rapidamente o texto principal em um formato eficiente em tokens?”. É isso que torna a skill defuddle atraente para pipelines de pesquisa, captura de notas, resumo de artigos e leitura de documentação, em cenários em que um markdown mais limpo melhora de forma concreta a qualidade do resultado.

Como usar a skill defuddle

Instalação do defuddle e comando básico

Para instalar o defuddle, o repositório aponta para o próprio Defuddle CLI:

npm install -g defuddle

Comando principal:

defuddle parse <url> --md

Use --md de forma consistente. Esse é o formato recomendado para a maioria dos fluxos de pesquisa e análise, porque remove ruído visual sem perder uma estrutura legível.

Quais entradas a skill defuddle precisa

A skill defuddle precisa de uma URL de página e, idealmente, de uma intenção clara. Uma boa entrada inclui:

• a URL exata
• o que você precisa extrair dela
• se você quer markdown completo, saída salva em arquivo ou apenas metadados

Exemplos:

• “Leia este artigo e resuma o argumento principal: <url>”
• “Extraia markdown limpo desta página de documentação e salve em content.md: <url>”
• “Pegue apenas o título e a descrição da página para <url>”

Comandos úteis:

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

Como transformar um pedido vago em um prompt forte para defuddle

Pedido fraco: “Olhe esta URL.”

Prompt melhor no estilo guia de defuddle:

• “Use defuddle em <url> com saída em markdown. Ignore a navegação do site. Depois resuma os pontos principais em 5 bullets e cite a seção mais importante.”
• “Use defuddle nesta página de documentação: <url>. Extraia o markdown, identifique etapas de setup, pré-requisitos e ressalvas, e depois reescreva isso como um checklist.”
• “Extraia primeiro apenas os metadados de <url>. Se o título e a descrição corresponderem ao tema, então extraia o markdown completo.”

Isso funciona melhor porque informa ao agente tanto como chamar o defuddle quanto o que fazer depois com o conteúdo já limpo.

Fluxo de trabalho sugerido e o que ler primeiro

Esta skill é propositalmente pequena. Leia skills/defuddle/SKILL.md primeiro, porque ele reúne todo o fluxo realmente útil: instalação, comando de parsing, formatos de saída e propriedades de metadados. Na prática, use esta sequência:

1. Verifique se a URL é uma página HTML comum ou um arquivo .md.
2. Execute defuddle parse <url> --md.
3. Se precisar de um artefato reutilizável, adicione -o content.md.
4. Se você só precisar de roteamento ou validação, consulte metadados com -p.
5. Passe o markdown limpo para a etapa de resumo, extração ou tomada de notas.

FAQ da skill defuddle

O defuddle é melhor do que um prompt comum com fetch?

Na maioria dos casos, sim, para páginas no estilo artigo. Um fetch comum costuma incluir cabeçalhos, rodapés, avisos de cookies e navegação. O uso do defuddle melhora a relação sinal-ruído antes mesmo de a análise começar, o que pode reduzir custo de tokens e diminuir erros de resumo causados por elementos irrelevantes da página.

Quando eu não devo usar a skill defuddle?

Evite defuddle para URLs .md, arquivos brutos ou casos em que você precise do HTML exato, do comportamento de mídia incorporada, de scripts da página ou de detalhes de layout. É uma ferramenta de extração de conteúdo, não uma ferramenta de automação de navegador nem de inspeção de DOM.

A skill defuddle é amigável para iniciantes?

Sim. A superfície de comandos é bem pequena: instale uma vez e depois use defuddle parse <url> --md. Isso torna a skill defuddle fácil de adotar mesmo se você só quiser um texto-fonte mais limpo para pesquisa ou captura de notas.

Quais saídas o defuddle pode retornar?

Você pode obter markdown com --md, JSON com --json, HTML por padrão, ou metadados específicos com -p <name>. Para a maioria das tarefas de leitura e pesquisa, markdown é a melhor opção padrão; o modo de metadados é útil para validação rápida e roteamento.

Como melhorar a skill defuddle

Dê ao defuddle um alvo de página preciso

A forma mais simples de melhorar os resultados do defuddle é fornecer a página canônica de conteúdo, e não uma homepage, página de busca ou página de listagem. URLs de artigo e páginas únicas de documentação produzem markdown mais limpo do que hubs cheios de navegação e links repetidos.

Peça a tarefa seguinte na mesma solicitação

A skill defuddle funciona melhor quando a extração já vem acompanhada de um próximo passo concreto. Em vez de dizer apenas “parse isso”, peça:

• resumo
• principais afirmações
• etapas de setup
• FAQs
• citações
• pontos de comparação

Isso reduz a ambiguidade na passagem de contexto e ajuda o agente a estruturar a saída em torno do trabalho real que você precisa concluir.

Use o modo de metadados antes da extração completa quando houver dúvida

Se a URL puder redirecionar, tiver baixa qualidade ou talvez seja a página errada, comece com:

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

Essa é uma tática simples, mas eficaz, de guia de defuddle: valide primeiro a relevância e só depois invista esforço na extração completa em markdown.

Modos de falha comuns e como iterar

Se a saída parecer superficial ou com estrutura estranha, o problema muitas vezes está na página de origem, não no CLI. Tente uma URL mais específica, troque uma página de categoria por uma página de artigo, ou salve o markdown para inspecioná-lo manualmente. Se o primeiro resultado vier amplo demais, execute novamente defuddle para Web Research com uma instrução mais restrita, como “extraia apenas as etapas de setup” ou “cite apenas as seções sobre autenticação”.