read

Fetch web pages and PDFs and convert them to Markdown.

Updated Oct 1, 2024
One-click install
npx skills add https://github.com/einargudnig/dotfiles --skill read-einargudnig
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: read
Source: https://github.com/einargudnig/dotfiles/tree/main/claude/skills/read
Command: npx skills add https://github.com/einargudnig/dotfiles --skill read-einargudnig

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, playwright, beautifulsoup4, lxml, agent-fetch, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Convert web pages, platform-specific documents, and PDFs into clean, readable Markdown automatically, eliminating manual copying, format cleanup, and tool chaining so users can quickly read, archive, or process content.

Core Features & Use Cases

  • Proxy cascade fetching: Tries defuddle.md and r.jina.ai then local tools as fallbacks to maximize coverage and preserve images and metadata.
  • Platform-specific handlers: Built-in Feishu/Lark API fetcher and a WeChat Playwright scraper plus GitHub raw/gh fallbacks for reliable retrieval.
  • PDF extraction & saving: Handles remote and local PDFs with multiple extraction strategies and saves results with YAML frontmatter to ~/Downloads.
  • Use Case: Give a URL to fetch a WeChat article or a PDF research paper, get a summarized header and a saved Markdown file for review or processing.

Quick Start

Use the read skill to fetch a URL or PDF and save the cleaned Markdown to your Downloads folder.

Frequently Asked Questions about read

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a web page or PDF into clean Markdown?

To convert a web page or PDF into clean Markdown, this Skill fetches the content using a proxy cascade and saves the extracted text with YAML frontmatter directly to your Downloads folder for easy reading and archival.

Can I extract content from Feishu documents and WeChat articles?

Yes, you can extract content from Feishu documents and WeChat articles using built-in platform-specific handlers, which utilize the Feishu API and a Playwright scraper to reliably retrieve and convert the text into Markdown.

Does the proxy cascade fetching mechanism work when direct web scraping fails?

The proxy cascade fetching mechanism uses defuddle.md and r.jina.ai before falling back to local tools, maximizing content coverage and preserving images and metadata even when standard direct web scraping fails.

How do I get raw file content from GitHub URLs into Markdown format?

To get raw file content from GitHub URLs into Markdown format, the Skill applies specific GitHub file page handlers with gh and raw fallback strategies to reliably retrieve and convert the source code or documentation.

What is the best way to extract text from both local and remote PDFs?

The best way to extract text from local and remote PDFs is using multiple extraction strategies with built-in retries and fallback logic, ensuring you get a summarized header and a cleanly saved Markdown file.

Do I need Playwright and BeautifulSoup installed to fetch WeChat articles?

Yes, you need Playwright and BeautifulSoup installed as dependencies, because the Skill relies on Playwright to drive the browser scraper and BeautifulSoup with lxml for parsing the fetched WeChat article HTML into Markdown.