Agent skill

Curl Md

by wevm in wevm/curl.md

Fetch web pages and docs as optimized markdown with curl.md.

MITAuto-check passedDocuments & Office

Install Curl Md

skills CLI
$ npx skills add wevm/curl.md --skill curl-md -a claude-code

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

GitHub CLI
$ gh skill install wevm/curl.md curl-md --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/wevm/curl.md.git skills-src && mkdir -p .claude/skills && cp -r skills-src/public/.well-known/skills/curl-md .claude/skills/curl-md && 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
curl-md
GitHub stars
288
Token cost
~1.2k tokens
SKILL.md length
480 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Fetch web pages and docs as optimized markdown with curl.md.

  • The user shares a URL
  • SKILL.md covers When to Use, Preferred Entry Points, Stable Request Vocabulary and CLI, plus 5 more sections
  • Calls curl and npx; reaches curl.md; needs CURLMD_API_KEY
  • Asks about page content

What it does

Curl Md is an agent skill from wevm/curl.md. Fetch web pages and docs as optimized markdown with curl.md. Use when the user shares a URL, asks about page content, or you need to read web page or webfetch.

Its SKILL.md is about 1.2k 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 Markdown. The repository describes itself as: URL to markdown for agents. The licence is MIT.

When your agent uses it

  • The user shares a URL
  • Asks about page content
  • You need to read web page

Example prompts

  • “/curl-md”

Requirements

  • Node.js
  • A credential in CURLMD_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 72bab6a. 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
    • npx

    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:

    • curl.md

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • CURLMD_API_KEY

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

Context cost

Curl Md loads about 1.2k tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 480 words of instructions outside code blocks.

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

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 wevm/curl.md at commit 72bab6a, republished under its MIT licence (© wevm). 480 words, ~1,204 tokens.

Download SKILL.mdSave it as .claude/skills/curl-md/SKILL.md (or your agent's skills folder).
name
curl-md
description
Fetch web pages and docs as optimized markdown with curl.md. Use when the user shares a URL, asks about page content, or you need to read web page or webfetch.

curl.md

Use curl.md to turn URLs into agent-friendly markdown with less noise and fewer tokens.

When to Use

Use curl.md when:

  • The user shares a URL or asks what a page says
  • You just need to quickly fetch one page without setting up a deeper integration
  • You need docs, changelogs, articles, reference pages, or API docs as markdown before answering
  • You want to narrow a long page to a specific question or task
  • You need current curl.md usage for the CLI, hosted HTTP endpoint, skills, or MCP

Preferred Entry Points

Prefer these in order:

  • The local curl.md CLI or md alias when available
  • The hosted HTTP endpoint at https://curl.md/<url>
  • For curl.md's own docs, the canonical .md docs endpoints or Accept: text/markdown

For normal page fetches, prefer the stable top-level fetch interface (curl.md/<url> or client.fetch(...)). Avoid lower-level experimental /api routes unless the task is specifically about auth, orgs, tokens, invites, or request history.

Stable Request Vocabulary

Prefer these names in new usage:

  • objective — narrow output to a specific question or task
  • keywords — pre-filter the page before extraction; comma-separated in HTTP/CLI strings
  • mode — smart or rush; only matters with objective
  • fresh — bypass cache and force a fresh fetch
  • token — API key auth in the CLI; raw HTTP should prefer Authorization: Bearer <token>

smart is the default and best for most docs lookups. Use rush when speed matters more than recall.

HTTP aliases still work (q/o, k, m, f), but prefer the full names above in new examples and instructions.

CLI

Prefer the CLI when it is installed locally. It handles auth, organization context, higher-level commands, and agent-friendly workflows.

sh
# Basic fetch
curl.md example.com
md example.com

# Narrow to a specific task
curl.md docs.github.com/en/webhooks/webhook-events-and-payloads \
  --objective "pull request webhook event payload and actions" \
  --keywords pull_request

# Faster, less thorough pass
curl.md developers.cloudflare.com/d1/get-started \
  --objective "how to query D1 from a worker" \
  --keywords D1,bindings \
  --mode rush

# Force a fresh fetch
curl.md example.com --fresh

# Use API key auth
curl.md example.com --token "$CURLMD_API_KEY"

Notes:

  • No protocol required for the target URL. curl.md normalizes to HTTPS unless the URL already specifies http:// or https://.
  • curl.md fetch <url> is equivalent to the root curl.md <url> command.
  • If the user asks for latest or recent content, add --fresh.
Show full SKILL.md (172 more words)Show less

Hosted HTTP Endpoint

Use the hosted HTTP endpoint when the CLI is unavailable or when you just need to quickly fetch one page.

Examples

sh
# Default response is markdown
curl "https://curl.md/example.com"

# Narrow with stable query names
curl "https://curl.md/developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch?objective=streaming+response+body&keywords=ReadableStream,getReader"

# Force a fresh fetch
curl "https://curl.md/example.com?fresh"

# Request JSON instead of markdown
curl "https://curl.md/example.com" -H 'Accept: application/json'

# Authenticated request
curl "https://curl.md/example.com" -H "Authorization: Bearer $CURLMD_API_KEY"

Successful fetches return markdown by default. JSON responses have the shape:

json
{
  "content": "# Example\n..."
}

Agent Setup

When the user asks to install or wire curl.md into an agent/editor, use the current setup commands:

sh
# Install hosted skills
npx skills add https://curl.md --yes

# Sync CLI-generated skills into supported agents
curl.md skills add
curl.md skills add --no-global

# Run as MCP stdio server
curl.md --mcp

# Register the MCP server with an agent
curl.md mcp add
curl.md mcp add --agent claude-code

Prefer first-party plugins over raw CLI or MCP when the target agent has an official curl.md integration.

Best Practices

  • Use objective when only part of a long page matters.
  • Add keywords when you already know the terms that matter and want to shrink the search space first.
  • Use fresh for changelogs, status pages, release notes, or any request where freshness matters.
  • Use auth when the user needs higher limits, paid usage, or account/org-scoped behavior.
  • For curl.md docs, prefer .md docs pages or llms.txt over HTML fetches.

Limitations

  • Paywalled or authenticated content still requires valid access.
  • Some highly dynamic pages may still be incomplete or noisy.
  • Errors are returned as JSON with stable string code and human-readable message fields.

© wevm, MIT. 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 public/.well-known/skills/curl-md of wevm/curl.md.

Open the folder on GitHubat commit 72bab6a

Compare with similar skills

Curl Md 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.

Curl Md compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Curl Md this skillwevm/curl.md288—~1.2kAutomated safety check: PassMIT
Markdown Article FormatterJimLiu/baoyu-skills26k7 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0
Crosspostingwasp-lang/wasp19k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    26k GitHub starsUsed in 7 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • 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
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed
  • Crossposting

    wasp-lang/wasp

    Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.

    19k GitHub stars~1.1k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Review The Docs

    supabase/supabase

    Official

    Review Supabase docs changes locally in your supabase/supabase checkout — either an open PR (triage, classify, verify) or your own branch before opening a PR (local self-review).

    111k GitHub stars~4.6k tokensUpdated today
    Documents & OfficeAuto-check passed

More from wevm/curl.md

  • Fetch

    wevm/curl.md

    Fetches markdown from public URLs, docs pages, articles, or changelogs.

    288 GitHub stars~185 tokensUpdated 3 mo ago
    Auto-check passed

Questions about Curl Md

What does Curl Md do?

Fetch web pages and docs as optimized markdown with curl.md. md.md.

When should I use Curl Md?

Curl Md fits situations like: the user shares a URL; asks about page content; you need to read web page.

How do I install Curl Md in Claude Code?

Run `npx skills add wevm/curl.md --skill curl-md -a claude-code`. Or copy the skill folder (public/.well-known/skills/curl-md in wevm/curl.md) into .claude/skills/curl-md in your project. Claude Code loads it when a task matches its description.

How do I install Curl Md in Codex?

Run `npx skills add wevm/curl.md --skill curl-md -a codex`. Or copy the skill folder (public/.well-known/skills/curl-md in wevm/curl.md) into .agents/skills/curl-md in your project. Codex loads it when a task matches its description.

Can I use Curl Md 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 wevm/curl.md --skill curl-md -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/curl-md, .gemini/skills/curl-md, .github/skills/curl-md and .opencode/skills/curl-md in your project.

What does Curl Md need to run?

Going by SKILL.md and its folder, Curl Md needs the command-line tools its instructions call (curl and npx) and credentials named CURLMD_API_KEY. Our summary lists: Node.js; A credential in CURLMD_API_KEY.

Does Curl Md access the network?

SKILL.md names 1 domain. In commands or code: curl.md; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Curl Md 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 Curl Md use?

Curl Md is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Curl Md use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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 Curl Md?

Skills that share tags, products or a category with Curl Md: Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and Gzh Design (isjiamu/gzh-design-skill, 3.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Curl Md?

wevm (a GitHub organization) maintains it in wevm/curl.md, which has 288 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on July 8, 2026.

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