ops-url-reader

name

ops-url-reader

description

Read the main content of a specific webpage URL when the user asks to summarize, inspect, cite, reference, or extract facts from that URL, including "read this", "look at this link", "based on this article", or equivalent reference requests. Prefer defuddle.md for public webpage main-content extraction, and fall back only when extraction is empty, incomplete, or errors. Do not use for broad web search, URL string edits in code/config, test execution, private or login-gated URLs, or domains with a more specific available tool such as OpenAI docs or GitHub.

URL Reader

Goal

Read the main content of a specific webpage URL and use only the relevant extracted content to answer the user's request.

Success Criteria

A good result:

• Extracts enough page body content to answer the user.
• Distinguishes article/content text from metadata, navigation, ads, and boilerplate.
• Cites or names the original URL when making factual claims from the page.
• Clearly reports extraction failure and uses the smallest useful fallback when the page cannot be read.

Constraints

Use this for concrete URLs the user wants read, summarized, inspected, cited, or extracted. Do not use it as a broad web search tool for finding pages.

Prefer dedicated tools or skills when available for a domain, such as OpenAI docs, GitHub PRs/issues, local browser testing, app connector data, or code/test execution. Use this skill only for raw public webpage main-content extraction.

Do not send private, login-gated, intranet, token-bearing, or sensitive URLs to defuddle.md. Ask for pasted content or use an authorized local/browser/app method when the URL cannot safely be sent to a public extraction service.

Retrieval Budget

Default to one defuddle.md extraction. If it returns empty content, an obvious error page, or content that is visibly incomplete for the user's question, try one small fallback. Continue only when:

• the core question is still unanswered
• a required fact, date, owner, parameter, or source is missing
• the user asked for exhaustive coverage or comparison
• the specified URL must be read and the first extraction failed

Stop once the relevant content or facts are available. Do not fetch again just to improve phrasing, add decorative examples, or support nonessential wording.

Defuddle Command

defuddle.md is a public service that extracts the main content from a webpage and returns Markdown with YAML frontmatter.

curl -sL "https://defuddle.md/<url>"

The request URL uses https://defuddle.md/.... Strip https:// or http:// from the target URL before appending it.

Examples:

curl -sL "https://defuddle.md/example.com/blog/some-post"
curl -sL "https://defuddle.md/x.com/username/status/123456789"

Use -sL for silent mode and redirect following.

Output

Answer in the shape the user requested: summary, extraction, fact check, reference, or synthesis. Do not dump the full extracted Markdown unless the user asks for raw content or excerpts.

If extraction fails, state what was tried, what failed, and the smallest useful next step.

Stop Rules

Stop when the extracted content is enough to answer the user's core request. Do not repeatedly retry the same extraction method. If key evidence is missing after the allowed fallback, name the gap and ask for or propose the smallest missing source.