AGENT SKILL

markdown-url

Route any website you need to visit through markdown.new by prefixing the URL. **WHEN TO USE:** - You would normally open a website link to read content (docs, blog posts, changelogs, GitHub issues, etc.) - You need a cleaner, Markdown-friendly view for copying notes or summarizing

适用职业内容创作者
使用场景文档处理
License 许可
MIT
最近更新
2026-04-11
Stars
★ 3
Forks
0

01 前言 Front Matter

name
markdown-url
description
Route any website you need to visit through markdown.new by prefixing the URL. **WHEN TO USE:** - You would normally open a website link to read content (docs, blog posts, changelogs, GitHub issues, etc.) - You need a cleaner, Markdown-friendly view for copying notes or summarizing

02 资源文件 1

03 SKILL.md 正文

markdown.new URL Prefix

Whenever you need to visit a website URL, you must:

  1. rewrite it to go through https://markdown.new/, then
  2. visit the rewritten URL, and
  3. pull the Markdown content from that page for use in your answer/notes.

Rewrite Rule

  1. Normalize the destination into an absolute URL with a scheme (https:// preferred).
  2. Prefix it with https://markdown.new/ (do not drop the original scheme).

Examples

  • https://example.com -> https://markdown.new/https://example.com
  • https://example.com/docs?a=1#b -> https://markdown.new/https://example.com/docs?a=1#b
  • example.com -> https://markdown.new/https://example.com

Agent Workflow (Required)

When you would normally open a website to read it:

  1. Produce the rewritten markdown.new URL.
  2. Visit the rewritten URL first (not the original), but only when it is likely to work (see Policy below).
  3. Extract the page content from the Markdown view (the rendered Markdown and/or the raw Markdown).
  4. Use that extracted Markdown as the source for summaries, quotes, checklists, or copy/pasteable notes.

If the markdown.new view fails to load or breaks critical functionality, fall back to the original URL for browsing, but still prefer markdown.new for any content extraction if possible.

Policy: When To Use markdown.new (Required)

Do NOT route every site through markdown.new. Use it primarily for "read-only" pages where you want clean, extractable text:

  • Documentation pages
  • Blog posts / announcements / changelogs
  • GitHub issues/PR discussions (when you just need readable text)
  • Articles and guides

Skip markdown.new and go straight to the original URL when the destination is likely to be blocked or requires the original site behavior:

  • Login, OAuth, checkout, payment, or any authenticated workflow
  • Sites that gate content behind JS apps, CAPTCHAs, bot detection, or paywalls
  • File uploads, forms, editors, dashboards, interactive widgets
  • Anything where cookies/session state must be preserved

Block/Failure Signals (Treat As Blocked)

If you try markdown.new and see any of the below, stop retrying and fall back to the original URL:

  • HTTP 401/403/429, "Access denied", "Forbidden", "rate limited"
  • CAPTCHA / "verify you are human"
  • Empty/partial content that clearly does not match the page
  • Redirect loops or repeated navigation failures

Fallback Behavior

  1. Attempt markdown.new once when appropriate.
  2. On block/failure, immediately switch to the original URL for browsing.
  3. If you still need extractable text, try to extract from the original page (reader mode / copy text) and clearly note that markdown.new was blocked.

Notes / Exceptions

  • Keep this for reading/browsing. For API endpoints, OAuth flows, file uploads, or anything that depends on cookies/login state, use the original URL if the proxy breaks functionality.
  • Do not rewrite local paths (./README.md) or non-HTTP(S) schemes.

Optional CLI Helper

Convert a URL into its markdown.new-prefixed form:

node skills/markdown-url/scripts/markdown-url.js "https://example.com/docs"

04 同仓库更多 Skills

0xharryriddle
0xharryriddle/codex-field-kit

vercel-react-best-practices

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

前端开发
★ 3
0xharryriddle
0xharryriddle/codex-field-kit

swarm-planner

[EXPLICIT INVOCATION ONLY] Creates dependency-aware implementation plans optimized for parallel multi-agent execution.

★ 3
0xharryriddle
0xharryriddle/codex-field-kit

super-swarm-spark

Only to be triggered by explicit super-swarm-spark commands.

★ 3
0xharryriddle
0xharryriddle/codex-field-kit

role-creator

Create and install Codex custom agent roles in ~/.codex/config.toml, generate role config files, enforce supported keys, and guide users through required role inputs (model, reasoning effort, developer_instructions).

★ 3
0xharryriddle
0xharryriddle/codex-field-kit

read-github

Read and search GitHub repository documentation via gitmcp.io MCP service. **WHEN TO USE:** - User provides a GitHub URL - User mentions a specific repo in owner/repo format - User asks "what does this repo do?", "read the docs for X repo", or similar - User wants to search code or docs within a repo

Skill与智能体开发
★ 3
0xharryriddle
0xharryriddle/codex-field-kit

planner

Create comprehensive, phased implementation plans with sprints and atomic tasks. Use when user says: "make a plan", "create a plan", "plan this out", "plan the implementation", "help me plan", "design a plan", "draft a plan", "write a plan", "outline the steps", "break this down into tasks", "what's the plan for", or any similar planning request. Also triggers on explicit "/planner" or "/plan" commands.

★ 3