Agent skill

Pullmd

by AeternaLabsHQ in AeternaLabsHQ/pullmd

Read any web page, document, or YouTube video as clean Markdown using PullMD.

AGPL-3.0Auto-check passedDocuments & Office

Install Pullmd

skills CLI
$ npx skills add AeternaLabsHQ/pullmd --skill pullmd -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AeternaLabsHQ/pullmd pullmd --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AeternaLabsHQ/pullmd.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skill/pullmd/skills/pullmd .claude/skills/pullmd && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pullmd
GitHub stars
486
Token cost
~2.6k tokens
SKILL.md length
970 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Read any web page, document, or YouTube video as clean Markdown using PullMD.

  • Works in 3 steps: Fetch via PullMD → Check if it worked → Fallback to WebFetch
  • You need to fetch
  • SKILL.md covers Why PullMD over WebFetch, How to use, Decision flow and Tips
  • Calls curl; reaches reddit.com and youtube.com

What it does

Pullmd is an agent skill from AeternaLabsHQ/pullmd. Read any web page, document, or YouTube video as clean Markdown using PullMD. Use this skill whenever you need to fetch, read, extract, or summarize content from a URL — web articles, Reddit threads, PDF/Word/PowerPoint/Excel/EPUB documents, or YouTube transcripts. This includes when the user says 'read this page', 'what does this URL say', 'fetch this article', 'summarize this PDF', 'get the transcript of this video', or when you need web content as context for another task. Also use this when WebFetch fails or…

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering Video and podcast notes, PDF and PowerPoint presentations. It works with YouTube, Reddit, Microsoft Excel and Microsoft PowerPoint. The repository describes itself as: Self-hosted URL- and file-to-Markdown service for humans and AI agents - web pages, documents, images, audio, YouTube. PWA + REST + MCP + Claude Code skill, Reddit-aware… The licence is AGPL-3.0.

When your agent uses it

  • You need to fetch
  • Summarize content from a URL — web articles
  • PDF/Word/PowerPoint/Excel/EPUB documents
  • YouTube transcripts

Example prompts

  • “read this page”
  • “what does this URL say”
  • “fetch this article”
  • “/pullmd”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Fetch via PullMD
  2. Check if it worked
  3. Fallback to WebFetch

What it can do on your machine

Read from SKILL.md and the folder at commit 64abf90. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • reddit.com
    • youtube.com
    • mistral.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pullmd loads about 2.6k tokens when it runs. Until then it costs about 174 tokens; SKILL.md has 970 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~174
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AeternaLabsHQ/pullmd at commit 64abf90, republished under its AGPL-3.0 licence (© AeternaLabsHQ). 970 words, ~2,630 tokens.

Download SKILL.mdSave it as .claude/skills/pullmd/SKILL.md (or your agent's skills folder).
name
pullmd
description
Read any web page, document, or YouTube video as clean Markdown using PullMD. Use this skill whenever you need to fetch, read, extract, or summarize content from a URL — web articles, Reddit threads, PDF/Word/PowerPoint/Excel/EPUB documents, or YouTube transcripts. This includes when the user says 'read this page', 'what does this URL say', 'fetch this article', 'summarize this PDF', 'get the transcript of this video', or when you need web content as context for another task. Also use this when WebFetch fails or returns poor results — PullMD produces cleaner Markdown than raw HTML parsing. Do NOT use this for GitHub URLs (use gh CLI instead) or for API endpoints that return JSON.

PullMD Integration

Read web pages, documents, and YouTube videos as clean, structured Markdown via the self-hosted PullMD service. Falls back gracefully to WebFetch if PullMD is unavailable.

Why PullMD over WebFetch

PullMD routes each URL through the extraction path that fits it:

  1. Reddit — auto-detected URLs go through Reddit's JSON API with full comment trees.
  2. Hacker News — auto-detected item pages, comment permalinks, and listings (/news, /newest, /ask, /show, /jobs, /best) go through the HN API and come back as a clean nested comment tree.
  3. Cloudflare — sites that support Accept: text/markdown get native Markdown directly.
  4. Static HTML — Mozilla Readability and Trafilatura run in parallel; the higher-quality output wins.
  5. Headless Chromium fallback — when static extraction returns body-soup or low-quality output (typical for Next.js / SPA pages), the page is rendered in a real browser before extracting.
  6. Documents — direct links to PDF, Word, PowerPoint, Excel, EPUB, ZIP, CSV, JSON, or XML files are converted to Markdown (requires the markitdown sidecar on the instance).
  7. YouTube — video URLs return title, description, and the transcript with clickable timecodes (when enabled on the instance).
  8. Images & audio — captioned / transcribed when the instance has a vision or STT provider configured; metadata-only otherwise.

The result is much cleaner than the raw HTML that WebFetch returns, and it works on JavaScript-heavy sites and binary formats that WebFetch can't handle at all.

How to use

Step 1: Fetch via PullMD

Use Bash to curl the PullMD API. This is preferred over WebFetch because it returns clean Markdown directly:

bash
curl -s "__PULLMD_URL__/api?url=<URL>"

The response is text/markdown — ready to use as-is.

Available parameters:

ParamDefaultNotes
url—Required.
commentstrueInclude Reddit / Hacker News comments. Ignored for other URLs.
comment_depth3Comment nesting depth (1–10), Reddit and Hacker News.
comment_limitnoneMax top-level Reddit comments (Reddit returns ~200 without a cap).
frontmatterfalsePrepend YAML metadata (title, source, quality, share id, …).
formatmdtext strips Markdown; json returns a structured response with metadata.
nocachefalseBypass the 1-hour cache and refetch from source.
renderautoforce → always render via Playwright. skip → never render. Bypasses cache.
extractorautoForce readability / trafilatura / playwright, skipping the quality pick. Bypasses cache.
pdf—ocr → high-quality OCR conversion for PDFs (table-grade output; needs a server-side OCR key). Bypasses cache.
yt_timecodeslinksYouTube transcripts: links (clickable timestamps), plain ([MM:SS]), none.
yt_chunk30YouTube transcript block size in seconds; 0 = per original snippet.
query—Set this when you need specific information from a page rather than the whole document: pass the question you are trying to answer, in natural language, and get back only the matching sections - typically 70-95% fewer tokens on long pages. No LLM involved. Empty/absent = full page, unchanged.
max_tokens600Token budget for query (64–20000). No effect without query. Raise it when the answer likely spans several sections; leave the default for single-fact lookups. Only validated when query is set.
langdeLanguage for the comments-section header (de or en).

Response headers worth checking:

  • X-Source — reddit · hackernews · cloudflare · readability · readability-fallback · trafilatura · playwright · recipe-content · coverage-guard · markitdown · youtube · image-caption · audio-transcript · pdf-ocr
  • X-Quality — 0.0–1.0 extraction confidence (low values mean the static extraction was thin or noisy)
  • X-Share-Id — 8-hex permalink, openable as __PULLMD_URL__/s/<id> (absent for /api/html — local conversions are never cached or shared)
  • X-Suggested-Filename — a ready-made filename for this conversion (e.g. YT-some-talk-dQw4w9WgXcQ.md); use it when you save the output to a file instead of inventing a name.
  • X-Transcript-Status — YouTube only: ok / none / blocked / error. blocked and error are transient (rate limit) and not cached — retry later; none means the video has no transcript at all.
  • X-Extracted / X-Extract-Confidence / X-Extract-Sections / X-Extract-Original-Tokens / X-Extract-Returned-Tokens — only when query is active; the last two show how much context the extraction saved.

Example calls:

bash
# Read an article
curl -s "__PULLMD_URL__/api?url=https://example.com/article"

# Read a Reddit post with comments
curl -s "__PULLMD_URL__/api?url=https://reddit.com/r/node/comments/abc/title/&comments=true"

# Convert a PDF / Office document by URL
curl -s "__PULLMD_URL__/api?url=https://example.com/report.pdf"

# Table-heavy PDF via the OCR tier (if enabled on the instance)
curl -s "__PULLMD_URL__/api?url=https://example.com/report.pdf&pdf=ocr"

# YouTube transcript with clickable timecodes (if enabled on the instance)
curl -s "__PULLMD_URL__/api?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ"

# Long page, but you only need one thing: get just the relevant sections
curl -s "__PULLMD_URL__/api?url=https://example.com/long-doc&query=rate+limit+headers&max_tokens=800"

# Get fresh (uncached) content
curl -s "__PULLMD_URL__/api?url=https://example.com/news&nocache=true"

# Force the Playwright fallback for a JS-rendered page that didn't trigger
# the auto-detection (or where you want to be sure)
curl -s "__PULLMD_URL__/api?url=https://mistral.ai/pricing&render=force"

# Convert a local HTML file you already have (never cached, no share link; X-Filename keeps the name out of access logs)
curl -s -X POST --data-binary @page.html -H 'Content-Type: text/html' -H 'X-Filename: page.html' "__PULLMD_URL__/api/html"

# Upload a local document (PDF/DOCX/…, max 25 MB)
curl -s -X POST --data-binary @report.pdf -H 'Content-Type: application/pdf' -H 'X-Filename: report.pdf' "__PULLMD_URL__/api/file"
Show full SKILL.md (363 more words)Show less
Step 2: Check if it worked

If curl returns valid Markdown (starts with # or contains readable text), use that content. The X-Source response header tells you which extraction method was used. If X-Source: playwright, the page needed JavaScript rendering — that's normal for SPAs (Next.js, React, Vue dashboards, …).

Step 3: Fallback to WebFetch

If PullMD fails (network error, timeout, empty response), fall back to the built-in WebFetch tool:

WebFetch(url="<URL>", prompt="Extract the main content of this page")

This still works but produces noisier output since it processes raw HTML. (For document and YouTube URLs there is no WebFetch equivalent — report the failure instead.)

Decision flow

Need to read a URL?
├── Is it a GitHub URL? → Use `gh` CLI instead
├── Is it a JSON API? → Use curl/fetch directly
└── Anything else (web page, PDF/Office doc, YouTube, image, audio):
    ├── Try: curl PullMD API
    │   ├── Success (got Markdown) → Use it
    │   └── Failed (error/timeout/empty) → Fallback below
    └── Fallback: WebFetch tool (web pages only)

Tips

  • PullMD caches results for 1 hour. Use nocache=true if you need the latest version. render=force|skip, extractor=, pdf=ocr, and explicit yt_* params also bypass the cache.
  • For pages with important comments or discussions (forums, HN, Reddit), add comments=true to include the discussion below the post. Reddit and Hacker News URLs are auto-detected and use dedicated pipelines; comment_depth controls how deep the tree goes.
  • When you need specific information from a page rather than the whole document, add query=<the question you are trying to answer>, phrased in natural language - it returns just the matching sections (typically 70-95% fewer tokens on long pages) and reports the saving in X-Extract-*. It falls back to the full page when nothing matches, so it is safe to try. Omit it only when you genuinely need the complete document - summarizing, translating, archiving.
  • For JS-rendered apps where the auto-fallback didn't fire (e.g. content lives in a tab the heuristic didn't reach), render=force re-extracts via headless Chromium.
  • Reddit URLs are automatically detected (incl. redd.it short links and /r/<sub>/s/<id> share links) and use a specialized extraction pipeline that handles posts, comments, galleries, and videos.
  • Add frontmatter=true when you want metadata: extraction source and quality always; for Reddit posts also subreddit, author, upvotes, and publish date; for media/YouTube/OCR results duration, image size, and LLM token usage (cost tracking).
  • The /api/history endpoint shows recent conversions — useful for checking what's been fetched: curl -s "__PULLMD_URL__/api/history?limit=5".
  • Persistent share links: every successful conversion gets an 8-hex share_id. GET __PULLMD_URL__/s/<id> returns the cached markdown and re-fetches from source if older than one hour — useful as a stable URL that always returns fresh content.

© AeternaLabsHQ, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skill/pullmd/skills/pullmd of AeternaLabsHQ/pullmd.

Open the folder on GitHubat commit 64abf90

Compare with similar skills

Pullmd next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pullmd compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pullmd this skillAeternaLabsHQ/pullmd486—~2.6kAutomated safety check: PassAGPL-3.0
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Markitdownjimmc414/Kosmos5942 repos~1.7kAutomated safety check: PassNone
To MarkdownMathews-Tom/armory328—~2kAutomated safety check: PassMIT
Markdown ConverterTeam-Commonly/commonly1.4k—~557Automated safety check: PassApache-2.0
Document ConverterBlackBeltTechnology/pi-agent-dashboard315—~999Automated safety check: PassMIT

Similar skills

  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Markitdown

    jimmc414/Kosmos

    Convert various file formats (PDF, Office documents, images, audio, web content, structured data) to Markdown optimized for LLM processing.

    594 GitHub starsUsed in 2 repos~1.7k tokens
    Documents & OfficeAuto-check passed
  • To Markdown

    Mathews-Tom/armory

    Convert any file or URL to clean Markdown: PDF, DOCX, XLSX, PPTX, HTML, images (OCR), audio, CSV, YouTube.

    328 GitHub stars~2k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Markdown Converter

    Team-Commonly/commonly

    Convert binary documents (PDF, DOCX, XLSX, PPTX, HTML, EPUB, images) to clean LLM-friendly Markdown using Microsoft's markitdown Python tool.

    1.4k GitHub stars~557 tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Document Converter

    BlackBeltTechnology/pi-agent-dashboard

    Convert documents bidirectionally via the pi-doc-engine facade: ingest PDF/DOCX/PPTX/XLSX to provenance-stamped Markdown (with OCR), and produce templated DOCX/PDF from Markdown with diagrams, TOC…

    315 GitHub stars~999 tokensUpdated today
    Documents & OfficeAuto-check passed
  • Process, convert, OCR, extract, redact, sign, and fill documents using the Nutrient DWS API.

    275k GitHub starsUsed in 4 repos~1.5k tokens
    Documents & OfficeAuto-check passed

Questions about Pullmd

What does Pullmd do?

Read any web page, document, or YouTube video as clean Markdown using PullMD. Pullmd is an agent skill from AeternaLabsHQ/pullmd. Read any web page, document, or YouTube video as clean Markdown using PullMD.

When should I use Pullmd?

Pullmd fits situations like: you need to fetch; summarize content from a URL — web articles; PDF/Word/PowerPoint/Excel/EPUB documents; youTube transcripts.

How do I install Pullmd in Claude Code?

Run `npx skills add AeternaLabsHQ/pullmd --skill pullmd -a claude-code`. Or copy the skill folder (skill/pullmd/skills/pullmd in AeternaLabsHQ/pullmd) into .claude/skills/pullmd in your project. Claude Code loads it when a task matches its description.

How do I install Pullmd in Codex?

Run `npx skills add AeternaLabsHQ/pullmd --skill pullmd -a codex`. Or copy the skill folder (skill/pullmd/skills/pullmd in AeternaLabsHQ/pullmd) into .agents/skills/pullmd in your project. Codex loads it when a task matches its description.

Can I use Pullmd in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AeternaLabsHQ/pullmd --skill pullmd -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pullmd, .gemini/skills/pullmd, .github/skills/pullmd and .opencode/skills/pullmd in your project.

What does Pullmd need to run?

Going by SKILL.md and its folder, Pullmd needs the command-line tools its instructions call (curl).

Does Pullmd access the network?

SKILL.md names 3 domains. In commands or code: reddit.com, youtube.com and mistral.ai; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Pullmd safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Pullmd use?

Pullmd is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pullmd use?

About 2.6k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pullmd?

Skills that share tags, products or a category with Pullmd: Markitdown (ImCa0/just-laws, 781 stars), Markitdown (jimmc414/Kosmos, 594 stars), To Markdown (Mathews-Tom/armory, 328 stars) and Markdown Converter (Team-Commonly/commonly, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pullmd?

AeternaLabsHQ (a GitHub organization) maintains it in AeternaLabsHQ/pullmd, which has 486 GitHub stars. The repository was last updated on September 21, 2026.

Source: AeternaLabsHQ/pullmd on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.